automatically updated release notes for mega-20190903

[Build] Fix build error after rename flash layouts
Merge pull request #2596 from jimmys01/gitignore
2026-07-28 04:07:47 +00:00 · 2019-09-03 04:00:13 +02:00 · 2019-09-02 23:20:37 +02:00 · 2019-09-02 13:18:20 +02:00 · 2019-09-02 13:15:38 +02:00 · 2019-09-02 14:12:24 +03:00
1694 changed files with 260873 additions and 17122 deletions
@@ -0,0 +1,22 @@
+# cmd: "cd {PROJECT_PATH}; platformio"
+cmd: "platformio"
+name: "Build with error highlighting (dev_ESP8266_4096)"
+args:
+  - run --environment dev_ESP8266_4096
+sh: true
+cwd: "{PROJECT_PATH}"
+# env:
+#   VARIABLE1: "VALUE1"
+#   VARIABLE2: "VALUE2"
+errorMatch:
+  - "(?<file>[\\/0-9a-zA-Z\\._]+):(?<line>\\d+):(?<col>\\d+):\\s+error:\\s+(?<message>.+)"
+
+warningMatch:
+  - "(?<file>[\\/0-9a-zA-Z\\._]+):(?<line>\\d+):(?<col>\\d+):\\s+warning:\\s+(?<message>.+)"
+# keymap: <keymap string>
+# atomCommandName: namespace:command
+# targets:
+#   extraTargetName:
+#       cmd: "<command to execute>"
+#       args:
+#       # (any previous options are viable here except `targets` itself)
@@ -0,0 +1,33 @@
+# Contributing to ESPEasy
+
+:+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
+
+## Issue tracker
+
+* The issue tracker is NOT a support forum. For support questions go to our forum: https://www.letscontrolit.com/forum/viewforum.php?f=1
+
+* Only post an issue if you're 100% sure you've hit a bug. If your not sure, post on the forum first to see if anyone can confirm it.
+
+This way we keep the issue tracker as short as possible, which saves our developers a lot of time.
+
+Also there are more people on the forum that can help you with support.
+
+## Pull requests
+
+ * Make sure your code compiles.
+
+ * Make sure your code does not have warnings. (Warnings will be treated as errors by our Travis system.)
+
+ * Try to create different pull requests for different features/fixes.
+
+ * Dont combine a lot of different stuff in one huge pull request.
+
+ * The v2.0 branch should get only fixes, new stuff should go into the mega-branch. (We will merge those fixes from v2.0 to mega)
+
+ * Incomplete or unstable plugins should have a PLUGIN_BUILD_DEV #ifdef around them. Also add [DEVELOPMENT] to the name.
+
+ * Do not modify any of the variables passed to your PLUGIN_WRITE handler.
+
+ * New plugins that seem to be working correctly should have a PLUGIN_BUILD_TESTING around until they are tested enough. Also add [TESTING] to the name
+
+ * Also see our general guidelines at: https://www.letscontrolit.com/wiki/index.php/ESPEasyDevelopmentGuidelines
@@ -0,0 +1,68 @@
+### Checklist
+- [ ] The title of this issue is "to the point" and descriptive.
+- [ ] This issue describes what is happening.
+- [ ] This issue describes what components are affected (e.g. name of plugin/controller)
+- [ ] This issue describes how to reproduce it.
+- [ ] This issue describes when it was introduced (when known) and what version is now showing the problem.
+
+### I have...
+- [ ] searched the [issue tracker](https://github.com/letscontrolit/ESPEasy/issues) or the [forum](https://www.letscontrolit.com/forum/viewforum.php?f=1) for a similar issue. (include links when applicable)
+- [ ] entered a system description using "Copy info to clipboard" on the sysinfo page. (when possible)
+- [ ] entered the full filename of the used version (e.g. `ESP_Easy_mega-20181001_test_ESP8266_4096_VCC.bin` )
+- [ ] given a list of active plugins or controllers when applicable.
+- [ ] filled out all applicable fields below.
+
+### Steps already tried...
+- [ ] Tried a clean install (empty `.bin` files are included in the ZIP)
+- [ ] Tested previous/other build (mention which one already tested)
+- [ ] Tested on other node to make sure hardware isn't defective.
+- [ ] Verified if the problem is limited to a single plugin/controller
+
+
+
+### If you self compile, please state this and PLEASE try to ONLY REPORT ISSUES WITH OFFICIAL BUILDS! ###
+<!--- If you self compile, please state this and PLEASE try to ONLY REPORT ISSUES WITH OFFICIAL BUILDS!  --->
+<!--- NOTE: This is not a support forum! For questions and support go here: --->
+<!--- https://www.letscontrolit.com/forum/viewforum.php?f=1 --->
+<!--- Remove topics that are not applicable to your feature request of issue --->
+<!--- Remember to have a "to the point" TITLE --->
+
+
+### Summarize of the problem/feature request
+<!--- Describe the problem or feature request --->
+YOUR TEXT GOES HERE
+
+### Expected behavior
+<!--- Tell us what should happen? --->
+YOUR TEXT GOES HERE
+
+### Actual behavior
+<!--- Tell us what happens instead? --->
+YOUR TEXT GOES HERE
+
+### Steps to reproduce
+<!--- How can we trigger this problem? --->
+1. 
+2. 
+3. 
+
+<!--- Does the problem persists after powering off and on? (just resetting isn't enough sometimes) --->
+<!--- Please document if you have restarted the unit and if the problem is then gone etc. etc. --->
+### System configuration
+<!--- Please add as much information and screenshots as possible  --->
+Hardware:
+
+<!--- You should also provide links to hardware pages etc where we can find more info  --->
+<!--- If you self compile, please state this and PLEASE try to ONLY REPORT ISSUES WITH OFFICIAL BUILDS!  --->
+ESP Easy version: 
+
+<!--- In order to have a better readablity of your issue then you should place screenshots here  --->
+<!--- Simply drag and drop them onto this template, move the text string below the "ESP Easy settings/screenshots" topic  --->
+ESP Easy settings/screenshots: 
+
+### Rules or log data
+<!--- place your code/rules between the two ``` rows  --->
+<!--- remove if not applicable!  --->
+```
+
+```
@@ -1,4 +1,40 @@
+## OS Specific Hidden Files ####
+
+# MacOSX Finder *****
+.DS_Store
+
+# Fuse FileSystem ***
+.fuse_hidden*
+
+
+## PlatformIO ##################
 .pioenvs
 .clang_complete
 .gcc-flags.json
 .piolibdeps
+pre_extra_script.py
+
+## Project #####################
+lib/readme.txt
+src/Custom.h
+/ESPEasy
+test/output_export.cpp
+.vscode
+.vscode/.browse.c_cpp.db*
+.vscode/c_cpp_properties.json
+.vscode/launch.json
+src/ESPEasy.ino.cpp
+
+docs/build/
+
+\.pio/
+
+docs/source/_build/
+
+venv/
+
+.idea/
+
+tools/vagrant/.vagrant/
+
+tools/vagrant/build/
@@ -1,9 +0,0 @@
-[submodule "lib/Adafruit_NeoPixel"]
-	path = lib/Adafruit_NeoPixel
-	url = https://github.com/adafruit/Adafruit_NeoPixel.git
-[submodule "lib/ArduinoJson"]
-	path = lib/ArduinoJson
-	url = https://github.com/bblanchon/ArduinoJson.git
-[submodule "lib/IRremoteESP8266"]
-	path = lib/IRremoteESP8266
-	url = https://github.com/sebastienwarin/IRremoteESP8266.git
@@ -1,15 +1,39 @@
 language: python
 python:
- '2.7'
+  - '2.7'
+
+#we want a newer cppcheck, so use trusty
+dist: trusty
+
 sudo: false
+
 cache:
  directories:
  - "~/.platformio"
  - "./.pioenvs"
+
+
+
+addons:
+  apt:
+    packages:
+    - cppcheck
+    - binutils
+
+
 install:
- pip install -U platformio
+  - pip install -U platformio sphinx recommonmark sphinx_bootstrap_theme
+
 script:
- platformio run
+  - platformio update
+  # patch platformio core libs for PUYA bug (https://github.com/letscontrolit/ESPEasy/issues/650)
+  - cd patches; ./check_puya_patch; cd ..
+
+  # - bash ./preflight.sh # make sure input files are OK before wasting time with prereqs
+  # - cppcheck --enable=warning src/*.ino -q --force -I src --include=src/ESPEasy.ino --error-exitcode=1
+  # - ./memanalyzer.py ~/.platformio/packages/toolchain-xtensa/bin/xtensa-lx106-elf-objdump
+  - PLATFORMIO_BUILD_FLAGS="-D CONTINUOUS_INTEGRATION" platformio run --target clean
+  - PLATFORMIO_BUILD_FLAGS="-D CONTINUOUS_INTEGRATION" platformio run

 before_deploy:
  - ./before_deploy
@@ -0,0 +1,8 @@
+The scripts in this directory are so called GIT hooks.
+Purpose is to do automatic changes after merge, commit and checkout.
+
+Those files are for a Linux-like environment with basic tools ln, grep, sed and bash.
+
+Windows users can see them as template.
+
+To use them simply copy those files into your ESPEasy/.git/hooks directory.
@@ -1,11 +1,43 @@
-# ESPEasy (mega branch)
+|Latest Nightly  | Build Status | Downloads | Docs | Patreon | Ko-Fi | PayPal |
+|-------|-------|-------|-------|-------|-------|-------|
+| [![GitHub version](https://img.shields.io/github/release/letscontrolit/ESPEasy/all.svg)](https://github.com/letscontrolit/ESPEasy/releases/latest) | [![Build Status](https://travis-ci.org/letscontrolit/ESPEasy.svg?branch=mega)](https://travis-ci.org/letscontrolit/ESPEasy) | [![Downloads](https://img.shields.io/github/downloads/letscontrolit/ESPEasy/total.svg)](https://github.com/letscontrolit/ESPEasy/releases) | [![Documentation Status](https://readthedocs.org/projects/espeasy/badge/?version=latest)](https://espeasy.readthedocs.io/en/latest/?badge=latest) | [![donate](https://img.shields.io/badge/donate-Patreon-blue.svg)](https://www.patreon.com/GrovkillenTDer) | [![donate](https://img.shields.io/badge/donate-KoFi-blue.svg)](https://ko-fi.com/grovkillentder) | [![donate](https://img.shields.io/badge/donate-PayPal-blue.svg)](https://www.paypal.me/espeasy) |

-Build status: [![Build Status](https://travis-ci.org/letscontrolit/ESPEasy.svg?branch=mega)](https://travis-ci.org/letscontrolit/ESPEasy)
+For ways to *support* us, see [this announcement on the forum](https://www.letscontrolit.com/forum/viewtopic.php?f=14&t=5787), or have a look at the [Patreon](https://www.patreon.com/GrovkillenTDer), [Ko-Fi](https://ko-fi.com/grovkillentder) or [PayPal](https://www.paypal.me/espeasy) links above.
+
+# ESPEasy (development branch)
+
+
+Introduction and wiki: https://www.letscontrolit.com/wiki/index.php/ESPEasy#Introduction
+
+**MEGA**
+:warning:This is the development branch of ESPEasy. All new untested features go into this branch. If you want to do a bugfix, do it on the stable branch, we will merge the fix to the development branch as well.:warning:

-This is the development branch for the next upcoming release (2.0.0). This is also known as ESPEasyMega.

 Check here to learn how to use this branch and help us improving ESPEasy: http://www.letscontrolit.com/wiki/index.php/ESPEasy#Source_code_development

-Binary development releases are here: https://github.com/letscontrolit/ESPEasy/releases

-Details and discussion are on the Experimental forum: http://www.letscontrolit.com/forum/viewtopic.php?f=18&t=2257&p=13600#p13600
+## Automated binary releases
+
+Every night our build-bot will build a new binary release: https://github.com/letscontrolit/ESPEasy/releases
+
+The releases are named something like 'mega-20190225' (last number is the build date)
+
+Depending on your needs, we release different types of files:
+
+Firmware name                                 | Hardware                | Included plugins            |
+----------------------------------------------|-------------------------|-----------------------------|
+ESPEasy_mega-20190225_normal_ESP8266_1M.bin  | ESP8266 with 1MB flash  | Stable                      |
+ESPEasy_mega-20190225_test_ESP8266_1M.bin    | ESP8266 with 1MB flash  | Stable + Test               |
+ESPEasy_mega-20190225_dev_ESP8266_1M.bin     | ESP8266 with 1MB flash  | Stable + Test + Development |
+ESPEasy_mega-20190225_normal_ESP8266_4M.bin  | ESP8266 with 4MB flash  | Stable                      |
+ESPEasy_mega-20190225_test_ESP8266_4M.bin    | ESP8266 with 4MB flash  | Stable + Test               |
+ESPEasy_mega-20190225_dev_ESP8266_4M.bin     | ESP8266 with 4MB flash  | Stable + Test + Development |
+ESPEasy_mega-20190225_normal_ESP8285_1M.bin  | ESP8285 with 1MB flash  | Stable                      |
+ESPEasy_mega-20190225_test_ESP8285_1M.bin    | ESP8285 with 1MB flash  | Stable + Test               |
+ESPEasy_mega-20190225_dev_ESP8285_1M.bin     | ESP8285 with 1MB flash  | Stable + Test + Development |
+
+## More info
+
+Details and discussion are on the "Experimental" section of the forum: https://www.letscontrolit.com/forum/viewforum.php?f=18
+
+Automated builds of the (new) documentation can be found at [ESPEasy.readthedocs.io](https://espeasy.readthedocs.io/en/latest/)
@@ -1,25 +1,137 @@
 #!/bin/bash

 VERSION=$(git describe)
-echo "Creating release archives for $VERSION ..."
-#binaries
-# cp .pioenvs/mini_512/firmware.bin dist/"ESPEasy_$VERSION""_mini_512.bin"
+TMP_DIST=`mktemp -d`
+CURPATH=`pwd`

-cp .pioenvs/normal_1024/firmware.bin dist/"ESPEasy_$VERSION""_normal_1024.bin"
-cp .pioenvs/normal_4096/firmware.bin dist/"ESPEasy_$VERSION""_normal_4096.bin"
+# PIO 3.x :
+# BINARY_PATH=".pioenvs"

-cp .pioenvs/test_1024/firmware.bin dist/"ESPEasy_$VERSION""_test_1024.bin"
-cp .pioenvs/test_4096/firmware.bin dist/"ESPEasy_$VERSION""_test_4096.bin"
+# PIO 4.0 and newer:
+BINARY_PATH=".pio/build"

-cp .pioenvs/dev_1024/firmware.bin dist/"ESPEasy_$VERSION""_dev_1024.bin"
-cp .pioenvs/dev_4096/firmware.bin dist/"ESPEasy_$VERSION""_dev_4096.bin"
+while getopts d: option
+do
+case "${option}"
+in
+d) VERSION=${OPTARG};;
+esac
+done
+
+
+if [ ! -d ${TMP_DIST} ]; then
+  # Could not create temp dir, so exit
+  exit 1
+fi
+
+#Naming convention:
+# ESP_Easy_[github version]_[plugin set]_[chip type]_[flash memory].bin
+
+mkdir -p ${TMP_DIST}
+cp -r dist/* ${TMP_DIST}/
+
+if [ -d "docs/build" ]; then
+  # Docs have been created
+  mkdir -p ${TMP_DIST}/docs
+  cp -r docs/build/* ${TMP_DIST}/docs/
+fi
+
+mkdir -p ${TMP_DIST}/memstats
+
+for ENV in \
+  custom_ESP8266_4M1M\
+  dev_ESP8266_4M1M\
+  esp-wrover-kit_test_1M8_partition\
+  esp32test_1M8_partition\
+  hard_SONOFF_POW_4M1M\
+  hard_Ventus_W266\
+  hard_core_252_SONOFF_POW_4M1M\
+  hard_core_252_Shelly_1_2M256\
+  hard_core_252_other_POW_ESP8285_1M\
+  hard_other_POW_ESP8285_1M\
+  minimal_IRext_ESP8266_1M\
+  minimal_IRext_ESP8266_4M1M\
+  minimal_IRext_ESP8266_4M2M\
+  minimal_core_242_ESP8266_1M_OTA\
+  minimal_core_242_ESP8285_1M_OTA\
+  minimal_core_252_ESP8266_1M_OTA\
+  minimal_core_252_ESP8285_1M_OTA\
+  normal_ESP8266_1M\
+  normal_ESP8266_1M_VCC\
+  normal_ESP8266_4M1M\
+  normal_ESP8285_1M\
+  normal_WROOM02_2M\
+  normal_core_241_ESP8266_1M\
+  normal_core_241_ESP8266_4M1M\
+  normal_core_242_ESP8266_1M\
+  normal_core_252_ESP8266_16M\
+  normal_core_252_ESP8266_1M\
+  normal_core_252_ESP8266_4M1M\
+  normal_core_252_WROOM02_2M256\
+  normal_core_260_sdk222_alpha_ESP8266_16M\
+  normal_core_260_sdk222_alpha_ESP8266_4M1M\
+  test_ESP8266_4M_VCC\
+  test_core_242_ESP8266_4M1M\
+  test_core_252_ESP8266_16M\
+  test_core_252_ESP8266_4M1M\
+  test_core_260_sdk222_alpha_ESP8266_16M\
+  test_core_260_sdk222_alpha_ESP8266_4M1M\
+  test_core_260_sdk3_alpha_ESP8266_16M\
+  test_core_260_sdk3_alpha_ESP8266_4M1M;\
+do
+  MAX_FILESIZE=1044464
+  if [[ ${ENV} == *"1M"* ]]; then
+    # max 871 kiB
+    MAX_FILESIZE=892912
+  fi
+  if [[ ${ENV} == *"1M_OTA"* ]]; then
+    # max 602 kiB
+    MAX_FILESIZE=616448
+  fi
+  if [[ ${ENV} == *"esp32"* ]]; then
+    MAX_FILESIZE=1310720
+  fi
+  if [[ ${ENV} == *"1M8_partition"* ]]; then
+    MAX_FILESIZE=1900544
+  fi
+
+  FIRMWARE_BIN=`echo "${BINARY_PATH}/${ENV}/firmware.bin"`
+  if [ -f $FIRMWARE_BIN ]; then
+    FILESIZE=$(stat -c%s `echo "${FIRMWARE_BIN}"` )
+    if (( FILESIZE < MAX_FILESIZE )); then
+      echo
+      echo "### Deploying environment $ENV for version $VERSION"
+      BIN=${BINARY_PATH}/${ENV}/ESP_Easy_${VERSION}_${ENV}.bin
+      cp ${FIRMWARE_BIN} $BIN
+      python2 crc2.py $BIN
+      mv $BIN "${TMP_DIST}/bin/ESP_Easy_${VERSION}_${ENV}.bin"
+    else
+      echo "Build too large for $ENV $FILESIZE > $MAX_FILESIZE "
+    fi
+  fi
+
+  ELFFILE=`echo "${BINARY_PATH}/${ENV}/firmware.elf"`
+  if [ -f $ELFFILE ]; then
+    SYMBOLS_STATS=`echo "${TMP_DIST}/memstats/symbols_${ENV}.txt"`
+    STRINGS_STATS=`echo "${TMP_DIST}/memstats/strings_${ENV}.txt"`
+    readelf -a ${ELFFILE} |grep 3ff |sort -n -k 3 > ${SYMBOLS_STATS}
+    objdump  -s -j .rodata ${ELFFILE} > ${STRINGS_STATS}
+  fi
+done

 #create a source structure that is the same as the original ESPEasy project (and works with the howto on the wiki)
-rm -rf dist/Source 2>/dev/null
-mkdir dist/Source
-cp -r lib dist/Source/
-cp -r src dist/Source/
-cp platformio.ini dist/Source/
+#rm -rf dist/Source 2>/dev/null

-cd dist
-zip ../ESPEasy_$VERSION.zip -r .
+mkdir -p ${TMP_DIST}/source
+cp -r lib ${TMP_DIST}/source/
+cp -r src ${TMP_DIST}/source/
+cp platformio.ini ${TMP_DIST}/source/
+
+cd ${TMP_DIST}
+
+echo
+echo "### Creating zip archive"
+zip -qq ${CURPATH}/ESPEasy_$VERSION.zip -r .
+
+rm -Rf ${TMP_DIST}/* 2>/dev/null
+rmdir ${TMP_DIST}
@@ -0,0 +1,116 @@
+
+import sys
+import binascii
+import struct
+import md5
+import os
+MD5DUMMY      = "MD5_MD5_MD5_MD5_BoundariesOfTheSegmentsGoHere..." #48 chars
+FILENAMEDUMMY = "ThisIsTheDummyPlaceHolderForTheBinaryFilename64ByteLongFilenames" #64 chars
+
+MemorySegmentStart,MemorySegmentEnd,MemoryContent=[],[],[]
+
+##################################################################
+# this subroutine shows the segments of a  part
+##################################################################
+def showSegments (fileContent,offset):
+    global MemorySegmentStart, MemorySegmentEnd, MemoryContent
+    header = struct.unpack("ii", fileContent[offset:offset+8])
+    herestr =""
+    herestr2 =""
+    MemorySegmentStart.append(struct.pack("I",header[0]))
+    MemorySegmentEnd.append(struct.pack("I",header[0]+header[1]))
+    MemoryContent.append(fileContent[offset+8:offset+8+header[1]])
+    if  fileContent.find( MD5DUMMY, offset+8, offset+8+header[1]) >0 :
+        herestr= " <-- CRC is here."
+    if  fileContent.find( FILENAMEDUMMY, offset+8, offset+8+header[1]) >0 :
+        herestr2= " <-- filename is here."
+    print ("SEGMENT "+ str(len(MemorySegmentStart)-1)+ ": memory position: " + hex(header[0])+" to " + hex(header[0]+header[1]) +  " length: " + hex(header[1])+herestr+herestr2)
+    #print ("first byte positoin in file: " + hex( offset+8))
+    #print ("last byte postion in file: " + hex(offset+8+header[1]-1))
+    return (8+offset+ header[1]); # return start of next segment
+
+##################################################################
+# this subroutine shows the  parts of a binary file
+##################################################################
+def showParts(fileContent, offset):
+    header = struct.unpack("BBBBi", fileContent[offset:offset+8])
+    print ('\n\nBINARY PART\nSegments: ') + (hex(header[1]))
+    nextpos =offset+8
+    for x in range (0,header[1]):
+        nextpos = showSegments(fileContent,nextpos)
+    nextSegmentOffset = (fileContent.find("\xe9", nextpos))
+    return nextSegmentOffset
+
+##################################################################
+# MAIN
+##################################################################
+
+#if len(sys.argv) !=2 :
+#    print ("please give a filename")
+#    k=input("press close to exit")
+#    sys.exit(1)
+FileName = sys.argv[1]#"C:/ArduinoPortable/sketchbooks/build/sketch_jan15a.ino.bin"
+#FileName =  "C:/ArduinoPortable/sketchbooks/build/sketch_jan15a.ino.bin"
+print( "\n\nReplacing dummy MD5 checksum in .bin file")
+
+
+
+with open(FileName, mode='rb') as file: # b is important -> binary
+    nextpos =0;
+    fileContent = file.read()
+    while nextpos >=0:
+        nextpos = showParts(fileContent,nextpos)
+
+startArray,endArray,hashString = "","",""
+includeStr = "hash includes segments:"
+# memory sections:
+# 0: bootloader (not readable)
+# 1: program memory (SPI flash)
+# 2: unknown but stable
+# 3: RAM (initialized by bin file. Can be read but changes as you go :-( )
+# 4: RAM
+
+for i in (1,2 ):     # use only stable segments, must be 4 in total. We use 2.
+    startArray =startArray + MemorySegmentStart[i]
+    endArray =  endArray   + MemorySegmentEnd[i]
+    hashString =hashString + MemoryContent[i]
+    with open(FileName+str(i), mode='wb') as file: # b is important -> binary
+      file.write(MemoryContent[i])
+    includeStr = includeStr +" "+ str(i)
+print (includeStr)
+# IMPORTANT: pad array with zeros if you use only 3 segments (see above)
+while len(startArray) < 16 :
+	startArray =startArray + struct.pack("I",0)
+	endArray =  endArray   + struct.pack("I",0)
+# debug print (binascii.hexlify(startArray))
+# debug print (binascii.hexlify(endArray))
+if (len(endArray) + len (startArray)) != 32 :
+    print("ERROR: please make sure you add / remove padding if you change the semgents.")
+
+BinaryFileName = "";
+if  fileContent.find( FILENAMEDUMMY) < 0:
+    print("ERROR: FILENAMEDUMMY dummy not found in binary")
+else:
+	BinaryFileName=os.path.basename(FileName) +"\0"
+	if len(BinaryFileName) >64:								# check that filename is <48 chars
+		BinaryFileName=BinaryFileName[0:64]					# truncate if necessary. 49th char in ESP is zero already
+	else:
+		BinaryFileName= BinaryFileName.ljust(64,'\0');		# pad with zeros.
+
+
+if  fileContent.find( MD5DUMMY) < 0:
+    print("ERROR: MD5 dummy not found in binary")
+else:
+    hashString=hashString.replace (MD5DUMMY,"",1)
+    m = md5.new()
+    m.update (hashString) #use segment 1
+    md5hash = m.digest()
+    print("MD5 hash: "+ m.hexdigest())
+    print("\nwriting output file:\n" + FileName)
+
+    fileContent=fileContent.replace(MD5DUMMY,md5hash+startArray+endArray)
+    fileContent=fileContent.replace(FILENAMEDUMMY,BinaryFileName)
+
+    with open(FileName, mode='wb') as file: # b is important -> binary
+      file.write(fileContent)
+#k=input("press close to exit")
@@ -0,0 +1,86 @@
+  _____ ____  ____
+ | ____/ ___||  _ \ ___  __ _ ___ _   _
+ |  _| \___ \| |_) / _ \/ _` / __| | | |
+ | |___ ___) |  __/  __/ (_| \__ \ |_| |
+ |_____|____/|_|   \___|\__,_|___/\__, |
+                                  |___/
+
+
+This is the distribution folder for ESPeasy.
+In here you will find a flash tool to program the ESP module.
+
+Also a number of binary images is included.
+
+The filename is quite descriptive:
+  ESP_Easy_mega-<date>_<buildType>_<chip>_<memorySize>.bin
+
+Build type can be:  (differ in included plugins)
+- normal  => Only Stable plugins and controllers
+- test    => Stable + Testing
+- dev     => Stable + Testing + Development
+
+There is also a number of special builds:
+- normal_IR => "Normal" + IR receiver/transmitter plugins and library
+- hard_xxxxx => Special builds for some off-the-shelf hardware.
+- minimal_ESP82xx_1M_OTA => Minimum number of plugins and a limited set of controllers included to be able to perform a 2-step OTA on 1 MB flash nodes.
+- normal_core_241 => "Normal" using core 2.4.1, since 2.4.2 has issues with PWM
+- xxx_core_260_sdk2_alpha -> core 2.6.0 alpha version (under development) using SDK 2.2.1
+- xxx_core_260_sdk222_alpha -> core 2.6.0 alpha version (under development) using SDK 2.2.2
+- xxx_core_260_sdk3_alpha -> core 2.6.0 alpha version (under development) using SDK 3.0.0-dev (under development too)
+
+
+Chip can be:
+- ESP8266      => Most likely option
+- ESP8285      => Used in some Sonoff modules
+- ESP32        => Experimental support at this moment
+
+MemorySize can be:
+- 1M  => 1 MB flash modules (e.g. almost all Sonoff modules)
+- 2M  => 2 MB flash modules (e.g. Shelly1/WROOM02)
+- 4M  => 4 MB flash modules (e.g. NodeMCU/ESP32)
+- 16M => 16 MB flash modules (e.g. Wemos D1 mini pro)
+
+Please note that the performance of 14MB SPIFFS (16M flash modules) is really slow.
+All file access takes a lot longer and since the settings are also read from flash, the entire node will perform slower.
+See [Arduino issue - SPIFFS file access slow on 16/14M flash config](https://github.com/esp8266/Arduino/issues/5932)
+
+If these speed issues will be fixed, it is very likely the SPIFFS must then be re-partitioned, thus loosing all data in the SPIFFS.
+
+
+Special memory partitioning:
+- 2M256  => 2 MB flash modules (e.g. Shelly1/WROOM02) with 256k SPIFFS (only core 2.5.0 or newer)
+- 1M8_partition => For ESP32 with 4MB flash, sketch size is set to 1.8 MByte (default: 1.4 MByte)
+
+
+ESP32 now has 3 builds:
+- esp32dev   Using the default partition layout (1.4 MB for the sketch)
+- esp32test_1M8_partition   Larger sketch partition (1.8MB) smaller SPIFFS (316 kB)
+- esp-wrover-kit_test_1M8_partition  A build for ESP32 including build flags for the official WRover test kit.
+
+Please note that changing between those versions will destroy the settings!
+The SPIFFS partition will be lost and that contains all settings.
+
+
+To help recover from a bad flash, there are also blank images included.
+- blank_1MB.bin
+- blank_2MB.bin
+- blank_4MB.bin
+- blank_16MB.bin
+
+When the wrong image is flashed, or the module behaves unstable, or is in a reboot loop,
+flash these images first and then the right image for the module.
+
+ESP.Easy.Flasher.exe...
+... is the new flashing tool for ESP Easy. You need to run it in elevated mode (as admin)
+for it to fetch the COM ports correctly. If you want you may save YOUR settings using the
+"Save as default settings" button in the lower left corner. If the window is too big or
+too small you can experiment with the "Pixels Per Inch" variable in the
+..\Settings\Default.ini file. Setting it to =96 is working for most users but the
+application will try to find the most optimal value by default. Sometimes it fails to
+do that. More information about the tool is found here:
+https://github.com/Grovkillen/ESP_Easy_Flasher
+You can also have custom serial commands entered in a txt file. One command per line.
+
+Further reading:
+For more information, see: https://github.com/letscontrolit/ESPEasy
+Or our forum: https://www.letscontrolit.com/forum/
@@ -0,0 +1,19 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
@@ -0,0 +1,34 @@
+{"ESP_Easy_info":[
+ {
+   "MessageTitle":"Please support us",
+   "MessageBody":"We are in need for support. Currently we need to do a whole lot of consulting to keep us floating. If we could get funding for at least 50% of our time we could make a lot more than with our current 10-15%. Ideal would be 100% funding but we're realistic :) <br><br>We will add extra goodies for those who support us through monthly payments using Patreon.<br><br><br>Thanks for your support (from TD-er and Grovkillen)!",
+   "MessagePicture":"",
+   "MessageWriter":"Grovkillen",
+   "MessageColorBG":"",
+   "MessageColorFont":"",
+   "MessageDate":"2019-01-07",
+   "MessageType":"general",
+   "MessageLink1text":"Patreon",
+   "MessageLink1":"",
+   "MessageLink2text":"Ko-Fi",
+   "MessageLink2":"",
+   "MessageLink3text":"Paypal",
+   "MessageLink3":""
+ },{
+   "MessageTitle":"First announcement test",
+   "MessageBody":"We're planning on using the ESP Easy Flasher to push announcements to the users. Hopefully this will work out good and make more people aware of how things are evolving. This will be used as a channel for pretty much anything regarding the prject. Thanks for your support!",
+   "MessagePicture":"",
+   "MessageWriter":"Grovkillen",
+   "MessageColorBG":"",
+   "MessageColorFont":"",
+   "MessageDate":"2019-01-06",
+   "MessageType":"mega",
+   "MessageLink1text":"",
+   "MessageLink1":"",
+   "MessageLink2text":"",
+   "MessageLink2":"",
+   "MessageLink3text":"",
+   "MessageLink3":""
+ }
+]
+}
@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+
+:end
+popd
@@ -0,0 +1,3 @@
+recommonmark==0.4.0
+Sphinx==1.8.4
+sphinx-bootstrap-theme==0.6.5
@@ -0,0 +1,22 @@
+These scripts are used to render screenshots of the GUI.
+We use phantomJS (available on Win/Mac/Linux http://phantomjs.org/quick-start.html)
+and you control the script by passing arguments to the JavaScript files:
+
+########## rasterize.js ##########
+argument1: url (ampersand & need to be closed with "&")
+argument2: output file name (you can use .png or .pdf as output format)
+argument3: horisontalXvertical size (OPTIONAL)
+argument4: zoom ("entire page" or "window" or <value> OPTIONAL)
+....Example CLI....
+
+phantomjs rasterize.js http://95.143.204.227/devices?index=1"&"page=1 P001_Setup_Switch_1.png
+
+or
+
+phantomjs rasterize.js http://95.143.204.227/devices?index=1"&"page=1 P001_Setup_Switch_1.png 1200px 2
+
+WE USE THE SECOND EXAMPLE by default (you might need to change zoomFactor if the page is too big).
+
+If the rendering is not working you can use this CLI (arg --debug=true):
+
+phantomjs --debug=true rasterize.js http://95.143.204.227/devices?index=1"&"page=1 P001_Setup_Switch_1.png 1200px 2
@@ -0,0 +1,52 @@
+//removed use strict GROVKILLEN
+var page = require('webpage').create(),
+    system = require('system'),
+    address, output, size;
+
+if (system.args.length < 3 || system.args.length > 5) {
+    console.log('Usage: rasterize.js URL filename [paperwidth*paperheight|paperformat] [zoom]');
+    console.log('  image (png/jpg output) examples: "1920px" entire page, window width 1920px');
+    console.log('                                   "800px*600px" window, clipped to 800x600');
+    phantom.exit(1);
+} else {
+    address = system.args[1];
+    output = system.args[2];
+    page.viewportSize = { width: 600, height: 600 };
+    if (system.args.length > 3 && system.args[2].substr(-4) === ".pdf") {
+        size = system.args[3].split('*');
+        page.paperSize = size.length === 2 ? { width: size[0], height: size[1], margin: '0px' }
+                                           : { format: system.args[3], orientation: 'portrait', margin: '1cm' };
+    } else if (system.args.length > 3 && system.args[3].substr(-2) === "px") {
+        size = system.args[3].split('*');
+        if (size.length === 2) {
+            pageWidth = parseInt(size[0], 10);
+            pageHeight = parseInt(size[1], 10);
+            page.viewportSize = { width: pageWidth, height: pageHeight };
+            page.clipRect = { top: 0, left: 0, width: pageWidth, height: pageHeight };
+        } else {
+            console.log("size:", system.args[3]);
+            pageWidth = parseInt(system.args[3], 10);
+            pageHeight = parseInt(pageWidth * 3/4, 10); // it's as good an assumption as any
+            console.log ("pageHeight:",pageHeight);
+            page.viewportSize = { width: pageWidth, height: pageHeight };
+        }
+    }
+    if (system.args.length > 4) {
+        page.zoomFactor = system.args[4];
+    }
+    page.open(address, function (status) {
+        if (status !== 'success') {
+            console.log('Unable to load the address!');
+            phantom.exit(1);
+        } else {
+            window.setTimeout(function () {
+                //This is injected because of bug in phantomjs (rendering black background: http://phantomjs.org/tips-and-tricks.html) GROVKILLEN
+                page.evaluate(function() {
+                  document.body.bgColor = 'white';
+                });
+                page.render(output);
+                phantom.exit();
+            }, 200);
+        }
+    });
+}
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C001_page:
+
+|C001_typename|
+==================================================
+
+|C001_shortinfo|
+
+Controller details
+------------------
+
+Type: |C001_type|
+
+Name: |C001_name|
+
+Status: |C001_status|
+
+GitHub: |C001_github|_
+
+Maintainer: |C001_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C002_page:
+
+|C002_typename|
+==================================================
+
+|C002_shortinfo|
+
+Controller details
+------------------
+
+Type: |C002_type|
+
+Name: |C002_name|
+
+Status: |C002_status|
+
+GitHub: |C002_github|_
+
+Maintainer: |C002_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C003_page:
+
+|C003_typename|
+==================================================
+
+|C003_shortinfo|
+
+Controller details
+------------------
+
+Type: |C003_type|
+
+Name: |C003_name|
+
+Status: |C003_status|
+
+GitHub: |C003_github|_
+
+Maintainer: |C003_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C004_page:
+
+|C004_typename|
+==================================================
+
+|C004_shortinfo|
+
+Controller details
+------------------
+
+Type: |C004_type|
+
+Name: |C004_name|
+
+Status: |C004_status|
+
+GitHub: |C004_github|_
+
+Maintainer: |C004_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C005_page:
+
+|C005_typename|
+==================================================
+
+|C005_shortinfo|
+
+Controller details
+------------------
+
+Type: |C005_type|
+
+Name: |C005_name|
+
+Status: |C005_status|
+
+GitHub: |C005_github|_
+
+Maintainer: |C005_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C006_page:
+
+|C006_typename|
+==================================================
+
+|C006_shortinfo|
+
+Controller details
+------------------
+
+Type: |C006_type|
+
+Name: |C006_name|
+
+Status: |C006_status|
+
+GitHub: |C006_github|_
+
+Maintainer: |C006_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C007_page:
+
+|C007_typename|
+==================================================
+
+|C007_shortinfo|
+
+Controller details
+------------------
+
+Type: |C007_type|
+
+Name: |C007_name|
+
+Status: |C007_status|
+
+GitHub: |C007_github|_
+
+Maintainer: |C007_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C008_page:
+
+|C008_typename|
+==================================================
+
+|C008_shortinfo|
+
+Controller details
+------------------
+
+Type: |C008_type|
+
+Name: |C008_name|
+
+Status: |C008_status|
+
+GitHub: |C008_github|_
+
+Maintainer: |C008_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C009_page:
+
+|C009_typename|
+==================================================
+
+|C009_shortinfo|
+
+Controller details
+------------------
+
+Type: |C009_type|
+
+Name: |C009_name|
+
+Status: |C009_status|
+
+GitHub: |C009_github|_
+
+Maintainer: |C009_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C010_page:
+
+|C010_typename|
+==================================================
+
+|C010_shortinfo|
+
+Controller details
+------------------
+
+Type: |C010_type|
+
+Name: |C010_name|
+
+Status: |C010_status|
+
+GitHub: |C010_github|_
+
+Maintainer: |C010_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C011_page:
+
+|C011_typename|
+==================================================
+
+|C011_shortinfo|
+
+Controller details
+------------------
+
+Type: |C011_type|
+
+Name: |C011_name|
+
+Status: |C011_status|
+
+GitHub: |C011_github|_
+
+Maintainer: |C011_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,39 @@
+.. include:: _controller_substitutions.repl
+
+.. _C012_page:
+
+|C012_typename|
+==================================================
+
+|C012_shortinfo|
+
+Controller details
+------------------
+
+Type: |C012_type|
+
+Name: |C012_name|
+
+Status: |C012_status|
+
+GitHub: |C012_github|_
+
+Maintainer: |C012_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,315 @@
+.. include:: _controller_substitutions.repl
+
+.. _C013_page:
+
+|C013_typename|
+==================================================
+
+|C013_shortinfo|
+
+Controller details
+------------------
+
+Type: |C013_type|
+
+Name: |C013_name|
+
+Status: |C013_status|
+
+GitHub: |C013_github|_
+
+Maintainer: |C013_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0 
+  ...
+
+  |improved|
+  Implementation of secure communication and check for valid data.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
+
+ESPEasy is able to communicate between nodes itself.
+It is an IANA registered service: `espeasy-p2p <https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml?search=8266#ESPeasy>`_
+
+* Service Name:  espeasy-p2p
+* Port Number: 8266
+* Transport Protocol:  UDP
+* Description: ESPeasy peer-2-peer communication
+* Registration date: 2018-11-28
+
+This protocol is targeted specific for use by ESPeasy to let ESPeasy nodes
+communicate with each other to create a big swarm of nodes working together
+without the need for a hosted service like MQTT, which needs a central broker.
+
+It is currently used for:
+
+* Discovery of nodes
+* Sharing sensor data among nodes
+
+Later updates may add:
+
+* Distribution of settings
+* Sending commands
+
+
+Sharing Plugins among Nodes
+---------------------------
+
+It is possible to share the data collected by a plugin on one node so it can be used on another node.
+This data can be used as if it is actually being run on the second node.
+
+For example, a Dallas DS18b20 sensor on Node-1 is shared using the ESPeasy p2p controller.
+This plugin can then automatically be setup on Node-2 and using the data collected by Node-1.
+
+This is a rather non-intuitive process to setup.
+
+Prerequisites
+^^^^^^^^^^^^^
+
+* Same UDP port must be setup on both nodes. (preferrably UDP port 8266) This can be done in Tools -> Advanced -> UDP port
+* Nodes must be rebooted after UDP port has changed.
+* Each node must have an unique unit number. This must not be 0 and not 255, but anything inbetween is fine.
+
+
+How to share a plugin
+^^^^^^^^^^^^^^^^^^^^^
+
+* Check to see if all nodes can see eachother. This will be visible on the main page showing a list of all nodes.
+* Enable p2p networking controller on receiving node
+* Make sure the receiving node has the spot free which is being used on the 'sending' node (For example slot 12)
+* Enable p2p networking controller on sending node
+* Set the plugin you want to share to use the p2p controller
+
+Any node that is setup to receive data like this will see a plugin being added if the spot in the device list was still free.
+
+Builds made after 2019/08/08 will show in the device overview page from which unit the shared plugin does get its data.
+This also means the plugin must be removed and re-created if the sending node is changed. (e.g. another node or change of unit number)
+
+In later builds there will be added an option to update this node number.
+
+
+Some tips on trouble shooting
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Make sure to reboot the node after changing the UDP port.
+* Make sure all nodes have an unique unit number and share the same UDP port.
+* If you have ArduinoOTA enabled, use another port for ESPeasy p2p UDP (port suggested in most OTA examples use port 8266)
+* Ping the nodes from some other host to keep their WiFi awake.
+* Disable "Eco mode" in the advanced settings.
+* Sharing a plugin to be auto installed on another node is only sent right after the plugin is set to use the p2p controller. So if you don't see it appear on the other node, save it again on the source node.
+* Make sure the same plugin is available in the build on both nodes. (e.g. both supporting Dallas DS18b20, if that's the one you want to share)
+* When using the "Guest" feature of an access point, some will not allow direct communication between clients on the same AP. This will also prevent this p2p protocol to share data.
+* If updating from builds before 2019/08/08, you may need to remove and add again a plugin receiving data from a remote node.
+
+
+
+Sending & Known Nodes
+---------------------
+
+ESPEasy keeps track of all nodes advertising themselves via Sysinfo messages.
+
+This knowledge is kept in a ``NodeStruct`` for at least 10 minutes.
+If a node is not sending a Sysinfo message in this period, it will be removed from the list.
+
+Data Format Versions
+--------------------
+
+During the IANA port assignment assessment, a number of issues were pointed out by their experts.
+
+* Versioning
+* Security
+* Data validation
+* Traffic limiting and congestion handling
+
+There are now 2 versions available:
+
+* Version "0" - No security, no data validation.
+* Version "1" - Introduced in ESPeasy build <???>
+
+Data Format Version 0
+---------------------
+
+Sending and receiving is causing issues when the swarm of nodes increases.
+
+* All nodes with this service enabled will advertise their presence every 30 seconds via broadcast
+* Nodes can not subscribe to receiving sensor data updates
+* Non broadcast messages are sent to each individual known node, regardless if the receiving node will use the data
+* Sensor Data messages are sent to each individual known node
+* Sensor Info updates are sent to each individual known node when a plugin coupled to this plugin is saved.
+
+Of each known node the following data is kept:
+
+.. code-block:: C++
+
+  struct NodeStruct
+  {
+    String nodeName;
+    byte ip[4];
+    uint16_t build;
+    byte age;
+    byte nodeType;
+  };
+
+The key to index this ``NodeStruct`` is the nodes unit number.
+
+ASCII Data
+~~~~~~~~~~
+
+Command Message
+***************
+
+First byte is not 0xFF.
+
+The entire message processed as a command like this:
+
+.. code-block:: C++
+
+  packetBuffer[len] = 0;
+  String request = &packetBuffer[0];
+  struct EventStruct TempEvent;
+  parseCommandString(&TempEvent, request);
+  TempEvent.Source = VALUE_SOURCE_SYSTEM;
+  if (!PluginCall(PLUGIN_WRITE, &TempEvent, request)) {
+    ExecuteCommand(VALUE_SOURCE_SYSTEM, &packetBuffer[0]);
+  }
+
+As can be seen, no checks for size, and it is just expected to be a valid ESPeasy command.
+Also no check to see if the command is supported by the receiving end and no feedback to the sender.
+
+Binary Data
+~~~~~~~~~~~
+
+Binary data is marked with the first byte 0xFF.
+
+On the receiving end, it is packed in an event in the ``Data`` field and processed like this:
+
+.. code-block:: C++
+
+  struct EventStruct TempEvent;
+  TempEvent.Data = reinterpret_cast<byte*>(&packetBuffer[0]);
+  TempEvent.Par1 = remoteIP[3];
+  TempEvent.Par2 = len;
+  PluginCall(PLUGIN_UDP_IN, &TempEvent, dummyString);
+  CPluginCall(CPLUGIN_UDP_IN, &TempEvent);
+
+N.B. only the controller C013 implements code for handling UDP data.
+
+Message types supported, determined by the 2nd byte:
+
+* 1: Sysinfo message
+* 2: Sensor info pull request (not implemented)
+* 3: Sensor info
+* 4: Sensor data pull request (not implemented)
+* 5: Sensor data
+
+Sysinfo Message
+***************
+
+There are 2 types of Sysinfo messages, a standard and an extended message.
+The extended message starts with the same information as the standard one.
+
+Standard Sysinfo message (13 bytes):
+
+* 2 bytes marker (255 , 1)
+* 6 byte MAC address
+* 4 byte IP address
+* 1 byte unit number
+
+Extended Sysinfo message (13 + 28 = 41 bytes):
+
+* 2 bytes ESPeasy data version number (LSB, MSB)
+* 25 bytes node name
+* 1 byte node type
+
+The node type is defined as:
+
+*  1 = "ESP Easy"
+* 17 = "ESP Easy Mega"
+* 33 = "ESP Easy 32"
+* 65 = "Arduino Easy"
+* 81 = "Nano Easy"
+
+Sensor Info message
+*******************
+
+Sensor Info messages are just a description of a shared sensor.
+It contains some information to setup a new sensor on the receiving end.
+
+These messages are just a serialized byte stream of ``struct C013_SensorInfoStruct`` .
+
+.. code-block:: C++
+
+  struct C013_SensorInfoStruct
+  {
+    byte header = 255;
+    byte ID = 3;
+    byte sourcelUnit;
+    byte destUnit;
+    byte sourceTaskIndex;
+    byte destTaskIndex;
+    byte deviceNumber;
+    char taskName[26];
+    char ValueNames[VARS_PER_TASK][26];
+  };
+
+
+Sensor Data message
+*******************
+
+
+These messages are just a serialized byte stream of ``struct C013_SensorDataStruct`` .
+
+.. code-block:: C++
+
+  struct C013_SensorDataStruct
+  {
+    byte header = 255;
+    byte ID = 5;
+    byte sourcelUnit;
+    byte destUnit;
+    byte sourceTaskIndex;
+    byte destTaskIndex;
+    float Values[VARS_PER_TASK];
+  };
+
+
+Data Format Version 1
+---------------------
+
+This version remains compatible with version 0 for backwards compatibility.
+It is using the "next" unused marker.
+
+All messages will have a standard packet data format:
+
+* 2 bytes Marker (255 , 6)
+* 2 bytes Version   => also determines data offset (header length)
+* 2 bytes Message type
+* 2 bytes Size of data block in "N" blocks of 16 bytes
+* 2 bytes Key/group selector
+* 2 bytes Sequence number
+* (16 x N) bytes Data block AES encrypted data (including 2 bytes checksum)
+* 2 bytes Packet checksum
+
+This allows to:
+
+* Distinguish data format versions
+* Filter on message type before allocating large buffers
+* Use multiple (pre-shared) encryption keys to have several levels of security or just several groups.
+* Validate correct transmission of packet (last 2 checksum bytes) before decrypting data.
+* Allow for larger messages to be sent in sequences. (e.g. firmware upgrades?)
+* Validate sender and content of data block, since it contains a checksum too, which is part of the encrypted data block.
+
+Since AES has a block size of 16 bytes (128 bit), the size of the data block is defined as a block of 16 bytes.
+This allows up-to 1 MB of messages. (2^16 * 2^4 = 2^20)
+An UDP datagram sent over IPv4 cannot exceed 65,507 bytes (65,535 - 8 byte UDP header - 20 byte IP header).
+In IPv6 jumbograms it is possible to have UDP packets of size greater than 65,535 bytes.
@@ -0,0 +1,151 @@
+.. include:: _controller_substitutions.repl
+
+.. _C014_page:
+
+|C014_typename|
+==================================================
+
+|C014_shortinfo|
+
+Controller details
+------------------
+
+Type: |C014_type|
+
+Name: |C014_name|
+
+Status: |C014_status|
+
+GitHub: |C014_github|_
+
+Maintainer: |C014_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added| 2019/04/25
+  Initial alpha version of this plug-in.
+
+Description
+-----------
+
+This controller connects to a MQTT Server providing auto-discover information and a communication protocol according to the Homie convention 3.0.1 and the future development version 4.0.0.
+
+For more information head over to `Homie convention <https://homieiot.github.io/>`_
+
+Idea is to provide an easy way to include ESPEasy in modern home automation systems without any or with as less effort as possible. Imagine your device pops up in openHAB 2.4 or higher as a new device and you only have to pic the values you are interested in. You can immediately see measurements or switch GPIOs without a single line of code.
+
+When a MQTT connection is established after (re-)boot the controller sends auto-discovery information for system services like commands, basic GPIO functions and for all configured devices and there values. When all messages where sent successfully a homie compatible home automation server/hub or other compatible controllers should be able to detect the unit and establish two way communication.
+
+The :ref:`P086_page` plug-in can be used to set values and trigger actions / rules.
+
+MQTT topic scheme
+-----------------
+
+A homie topic scheme always starts with the root topic homie followed by the **unit name** (homie uses the term **device**), **device name** (**node** in homie) and a **value name**.
+
+``homie/%unitname%/%devicename%/%valname%``
+
+updates or commands can be sent by appending ``/set`` to the topics for values which can receive data.
+
+``homie/%unitname%/%devicename%/%valname%/set``
+
+Prequesites
+-----------
+
+A MQTT server capable of storing messages sent with ``retain=true`` when  ``QoS=0``. Due to limitation (intentional not implemented due to low memory footprint and performance considerations) of the MQTT library (pubsubclient) used in ESPEasy it is only possible to send messages with ``QoS=0`` which basically means `fire and forget`. The current MQTT specification says that the server SHOULD store these messages when they arrive via ``QoS=0``. Some servers like the MQTT server currently build into openHAB 2.4 (moquette) is configured to ignore the retain flag and drop the message after delivery to the currently subscribed clients when ``QoS=0``. Mosquito on the other hand store messages when retain flag is set even when they are sent with ``QOS=0``.
+Check with a MQTT client like MQTTspy or MQTTfx if the auto-discover messages are stored (retained).
+
+A home automation server/controller capable talking Homie like openHAB since 2.4. (Be aware there are issues in the Homie implementation 2.4 including 2.5M1 milestone release not working as expected after restart). Recent snapshot builds should work.
+
+Setup
+-------------
+
+- add the Homie **Homie MQTT (Version 4.0.0 dev)** or **Homie MQTT (Version 3.0.1 dev)** controller to your controller lists depending on your build.
+- insert your broker address
+- and user credentials if necessary
+- the publish scheme is fixed to meet the homie requirements to ``homie/%sysname%/%tskname%/%valname%``
+- the subscription scheme can be modified. Current defaults to ``homie/%sysname%/+/+/set`` to reduce incoming traffic to a minimum. Homie only expects messages via the ``homie/%sysname%/%tskname%/%valname%/set`` topic.
+- last will topic (LWT) should set to ``homie/%sysname%/$state``
+- LWT Connect Message to ``ready``
+- LWT Disconnect Message to ``lost``
+- save and reboot, best with connected serial monitor or syslog server with debug set to 4 (debug) or greater (alternatively use a MQTT client and subscribe to ``homie/%sysname%/#`` - replace %sysname% by the unit-name shown on the top of the webpage).
+
+.. image:: C0014_Setup_0.png
+
+- ``homie/%sysname%/$nodes`` enumerating all devices will be sent as final message of the auto-discover header.
+- The final event log should look like this:
+
+.. code-block:: html
+
+  5584 : EVENT: MQTT#Connected
+  5754 : C014 : autodiscover information of 4 Devices and 6 Nodes sent with no errors! (26 messages)
+
+Troubleshoot
+------------
+
+The auto-discover information is sent through a big number of messages (usual more than 20). If your controller software not recognize your device or shows errors during the auto-discover process try the following steps:
+
+- For testing purposes start with a basic setup with none or only one device configured and enabled.
+- More devices can be added or (re-)enabled later.
+- Disable already configured devices (devices without the enabled box ticked will be ignored)
+- Check with a MQTT client if all messages are sent. The last message sent is ``$nodes`` attribute listing minimum the ``SYSTEM`` node if no other devices are enabled.
+- check your WIFI connection. Perhaps bring your device nearer to your access point. (only necessary during the setup process because the messages should be stored by the broker)
+- check via syslog or serial console if the messages are sent successful (you normaly can't see the log output in the web log)
+- use the `mqqt-forget <https://www.npmjs.com/package/mqtt-forget>`_ tool to delete unused retained messages from your broker via wildcards
+
+Features
+--------
+
+The controller currently supports these features
+
+- send auto-discover nodes for all sending and enabled plug-ins to ``homie/%unitName%/%deviceName%/%valueName%``
+- receive commands through the ``homie/%unitName%/SYSTEM/cmd/set`` topic.
+- switch GPIOs through ``homie/%unitName%/SYSTEM/gpio#/set`` topic. The GPIO port must be set to **default low** or **default high** in the hardware tab to be included during auto-discover.
+- send updates of GPIO ports to ``homie/%unitName%/SYSTEM/gpio#`` regardless from where the change is triggered (to be fully tested).
+- in conjunction with :ref:`P086_page` actuators can be used according to the Homie convetion using rules.
+- receive values for dummy devices via ``homie/%unitName%/%dummyDeviceName%/%valueName%/set``. From there the values can be processed further by using rules.
+- handle ``$state`` attribute (for complete list see attribute table below)
+
+  - ``init`` during boot process
+  - ``ready`` during normal operation and as a heartbeat every 30sec (to be tested)
+  - ``alert`` currently only if auto-discover fails. But if sending the auto-discover messages fails it is more than likely that sending the alert message will fail to. (ToDo: inform about other error states like low ram or stack available, repeating reboots or failed sensors)
+  - ``sleeping`` sent before deep sleep
+  - ``lost`` configured as LWT
+  - ``disconnected`` sent to the old topic if the unit name changes to inform that the old topic is not valid any more. Auto-discover messages are sent automagically to the new topics afterwards.
+
+- acknowledge received message by the ``homie/%unitName%/%deviceName%/%valueName%/set`` topic to the corresponding value ``homie/%unitName%/%deviceName%/%valueName%`` even if the value was changed by a different source like HTTP or rule to keep the state in your home automation system allays up to date. (Needs further testing)
+
+Future / planned features
+-------------------------
+
+- a special Homie Plugin is in devolopment to pass ``\set`` messages to rules for further handling. Here ``$datatype`` and ``$format`` attributes for ``$setable`` values can be specified there. This will enable ESPEasy to handle direct inputs to plug-ins like dimmers (%,0:100), colors (RGB & HSV, 255,255,255), enum devices like remote controls (Play, Pause, Vol+, Vol-, ...). :yellow:`Testing` see :ref:`P086_page`
+- Further in field testing with different MQTT brokers and home automation systems.
+- Handling units via the ``$unit`` attribute. As ESPEasy is currenty "unitless" this needs a global concept within ESPEasy
+- Handling ``$datatype`` attribute. Currenly all values (except cmd and gpio) are defined as ``float``. :yellow:`Testing` see :ref:`P086_page` 
+- Prepare some "working examples".
+
+Under the hood
+--------------
+
+Auto-dicover information is sent by several $attributes
+
+currently the following attributes will be sent during boot
+
+Unit (Device) attributes
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. include:: C014_attributes.repl
+
+Device (Node) attributes
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. include:: C014_node_attributes.repl
+
+Value attributes
+^^^^^^^^^^^^^^^^
+
+.. include:: C014_property_attributes.repl
@@ -0,0 +1,16 @@
+.. csv-table::
+        :header: "Attribute", "Description", "Example", "3.0.1","Spec.","4.0.0","Spec."
+        :widths: 10, 35, 15, 10, 5, 10, 5
+
+        "``$name``", "Friendly name of the device", "EPSEasy#1", "YES", ":green:`required`", "YES", ":green:`required`"
+        "``$homie``", "The implemented Homie convention version", "4.0.0", "YES",":green:`required`", "YES", ":green:`required`"
+        "``$state``", "See chapter features", "ready", "YES",":green:`required`", "YES", ":green:`required`"
+        "``$localip``", "IP of the device on the local network", "192.168.2.10", "YES", ":green:`required`", "NO", ":red:`void`"
+        "``$mac``", "Mac address of the device network interface.", "A1:B2:C3:D4:E5:F6", "YES", ":green:`required`", "NO", ":red:`void`"
+        "``$fw/name``", "Name of the firmware running on the device.", "ESPEasy mega", "YES", ":green:`required`", "NO", ":red:`void`"
+        "``$fw/version``", "Version of the firmware running on the device.", "20103 - Mega", "YES", ":green:`required`", "NO", ":red:`void`"
+        "``$nodes``", "Nodes which the device exposes separated by commas. Sent at the end for performance reasons.", "SYSTEM,SysInfo", "YES",":green:`required`", "YES", ":green:`required`"
+        "``$implementation``", "An identifier for the Homie implementation.", "ESP8266", "YES", ":green:`required`", "NO", ":red:`void`"
+        "``$stats/interval``", "Interval in seconds at which the device refreshes.", "60", "YES", ":green:`required`", "NO", ":red:`void`"
+        "``$stats/uptime``", "Time elapsed in seconds since the boot of the device.", "12345", "YES", ":green:`required`", "NO", ":red:`void`"
+        "``$stats/signal``", "Signal strength in %.", "75", "YES", ":blue:`optional`", "NO", ":red:`void`"
@@ -0,0 +1,7 @@
+.. csv-table::
+        :header: "Attribute", "Description", "Example", "3.0.1","Spec.","4.0.0","Spec."
+        :widths: 10, 35, 15, 10, 5, 10, 5
+
+        "``$name``","Friendly name of the Node","SYSTEM", "YES",":green:`required`", "YES",":green:`required`"
+        "``$type``","Type of the node","System commands", "YES",":green:`required`", "YES",":green:`required`"
+        "``$properties``","Exposed properties. Separated by , for multiple ones.","value1,value2", "YES",":green:`required`", "YES",":green:`required`"
@@ -0,0 +1,10 @@
+.. csv-table::
+        :header: "Attribute", "Description", "Example", "3.0.1","Spec.","4.0.0","Spec."
+        :widths: 10, 40, 10, 5, 15, 5, 15
+
+        "``$name``","Friendly name of the property.","Command", "YES",":green:`required`", "YES",":green:`required`"
+        "``$datatype``","Describes the format of data.	integer/float/boolean/string/enum/color","float", "YES",":green:`required`", "YES",":green:`required`"
+        "``$settable``","Specifies whether the property is settable (true) or read-only (default false). True for cmd, GPIO and dummy device values.","true", "YES",":yellow:`required true` for settable values", "YES",":yellow:`required true` for settable values"
+        "``$retained``","Specifies whether the property is retained (true) or non-retained (false).","false", "NO",":green:`required`", "NO",":blue:`optional`"
+        "``$unit``","A string containing the unit of this property.","°C", "NO",":blue:`optional`", "NO",":blue:`optional`"
+        "``$format``","Describes what are valid values for this property.","-30:40", "NO",":blue:`optional`", "NO",":blue:`optional`"
@@ -0,0 +1,70 @@
+.. include:: _controller_substitutions.repl
+
+.. _C016_page:
+
+|C016_typename|
+==================================================
+
+|C016_shortinfo|
+
+Controller details
+------------------
+
+Type: |C016_type|
+
+Name: |C016_name|
+
+Status: |C016_status|
+
+GitHub: |C016_github|_
+
+Maintainer: |C016_maintainer|
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added| 2019/04/05
+  Initial pre-alpha version of this plugin.
+
+Description
+-----------
+
+This controller is a cache layer to collect data while not connected to a network.
+
+The data will first be stored in RTC memory, which will survive a crash/reboot and even an OTA update.
+
+If this RTC buffer is full, it will be flushed to whatever is set here as storage.
+
+Data Format
+-----------
+
+Each time a plugin sends data to this controller, a sample set is stored.
+
+A typical sample set contains:
+
+- UNIX timestamp
+- task index delivering the data
+- 4 float values
+
+Storage
+-------
+
+The controller can save the samples from RTC memory to several places on the flash:
+
+- Files on SPIFFS
+- Part reserved for OTA update (TODO)
+- Unused flash after the partitioned space (TODO)
+
+Data Delivery
+-------------
+
+The controller can deliver the data to:
+
+- Upload bin files to some server (HTTP post?) (TODO)
+- Provide a sample to any connected controller (TODO)
+- Do nothing and let some extern host pull the data from the node. (TODO)
+- JavaScript to process the data inside the browser. (TODO)
+- Feed it to some plugin (e.g. a display to show a chart) (TODO)
@@ -0,0 +1,33 @@
+.. include:: _controller_substitutions.repl
+
+.. _C017_page:
+
+|C017_typename|
+==================================================
+
+|C017_shortinfo|
+
+Controller details
+------------------
+
+Type: |C017_type|
+
+Name: |C017_name|
+
+Status: |C017_status|
+
+GitHub: |C017_github|_
+
+Maintainer: |C017_maintainer|
+
+Change log
+----------
+
+.. versionadded:: 2.0 
+  ...
+
+  |added|
+  Initial release version.
+
+Description
+-----------
@@ -0,0 +1,157 @@
+.. include:: _controller_substitutions.repl
+
+.. _C018_page:
+
+|C018_typename|
+==================================================
+
+|C018_shortinfo|
+
+Controller details
+------------------
+
+Type: |C018_type|
+
+Name: |C018_name|
+
+Status: |C018_status|
+
+GitHub: |C018_github|_
+
+Maintainer: |C018_maintainer|
+
+Change log
+----------
+
+.. versionadded:: 2.0 
+  ...
+
+  |added|
+  2019/08/13 First occurrence in the source.
+
+Description
+-----------
+
+`The Things Network (TTN) <https://www.thethingsnetwork.org/>`_ is a global open LoRaWAN network.
+LoRaWAN allows low power communication over distances of several km.
+
+A typical use case is a sensor "in the field" which only has to send a few sample values every few minutes.
+Such a sensor node does broadcast its message and hopefully one or more gateways may hear the message and route it over the connected network to a server.
+
+The data packets for this kind of cummunication have to be very short (max. 50 bytes) and a sender is only allowed to send for a limited amount of time.
+On most frequencies used for the LoRa networks there is a limit of 1% of the time allowed to send.
+
+Such a time limit does also apply for a gateway. This implies that most traffic will be "uplink" data from a node to a gateway.
+The analogy here is that the gateway is often mounted as high as possible while the node is at ground level ("in the field")
+
+There is "downlink" traffic possible, for example to notify some change of settings to a node, or simply to help the node to join the network.
+
+In order to communicate with the gateways in the TTN network, you need a LoRa/LoRaWAN radio module.
+
+The radio module does communicate via the LoRa protocol. On top of that you also need a layer for authentication, encryption and routing of data packets.
+This layer is called LoRaWAN.
+
+There are several modules available:
+
+- RFM95  & SX127x.  These are LoRa modules which needs to have the LoRaWAN stack implemented in software
+- Microchip RN2384/RN2903. These are the modules supported in this controller. They have the full LoRaWAN stack present in the module.
+
+
+Nodes, Gateways, Application
+----------------------------
+
+A typical flow of data on The Things Network (TTN) is to have multiple nodes collecting data for a specific use case.
+
+Such a use case is called an "Application" on The Things Network.
+For example, a farmer likes to keep track of the feeding machines for his cattle.
+
+So let us call this application "farmer-john-cattle".
+
+For this application, a number of nodes is needed to keep track of the feeding machines in the field.
+These nodes are called "Devices" in TTH terms.
+For example a device is needed to measure the amount of water in the water tank and one for the food supply.
+
+Such a device must be defined on the TTN console page.
+
+There are two means of authenticating a device to the network (this is called "Join" in TTN terms):
+- OTAA - Over-The-Air Authentication
+- ABP - activation by personalization
+
+With OTAA, a device broadcasts a join request and one of the gateways in the neighborhood that received this request, 
+will return a reply with the appropriate application- and network- session keys to handle further communication.
+
+This means the device can only continue if there is a gateway in range at the moment of joining.
+It may happen that a gateway does receive the join request, but the device is unable to receive the reply.
+When that's happening, the device will not be able to send data to the network since it cannot complete the join.
+Another disadvantage of OTAA authenticating is the extra time needed to wait for the reply.
+Especially on battery powered devices the extra energy needed may shorten the battery life significantly.
+
+With OTAA, the device is given 3 keys to perform the join:
+
+- Device EUI - An unique 64 bit key on the network.
+- Application EUI - An unique 64 bit key generated for the application.
+- App Key - A 128 bit key needed to exchange keys with the application.
+
+The result of such an OTAA join is again a set of 3 keys:
+
+- Device Address - An almost unique 32 bit address of your device.
+- Network Session Key - 128 bit key to access the network.
+- Application Session Key - 128 bit key to encrypt the data for your application.
+
+
+The other method of authenticating a device is via ABP.
+ABP is nothing other than storing the last 3 keys directly on the device itself and thus skipping the OTAA join request.
+This means you don't need to receive data on the device and can start sending immediately, and even more important, let your device sleep immediately after sending.
+
+A disadvantage is the deployment of the device. Every device does need to have an unique set of ABP keys generated and stored on the device.
+
+Updating session keys may also be a bit hard to do, since it does need to ask for an update and must also be able to receive that update.
+
+
+
+Hybrid OTAA/ABP
+---------------
+
+TODO TD-er.
+
+
+
+
+
+
+Configure LoRaWAN node for TTN
+------------------------------
+
+A LoRaWAN device must join the network in order to be able to route the packets to the right user account.
+
+Prerequisites:
+
+- An user account on the TTN network.
+- A TTN gateway in range to send data to (and receive data from)
+- Microchip RN2384 or RN2903 LoRaWAN module connected to a node running ESPeasy. (UART connection)
+
+On the TTN network:
+- Create an application
+- Add a device to the application, either using OTAA or ABP.
+
+In order to create a new device using OTAA, one must either copy the hardware Device EUI key from the device to the TTN console page, 
+or generate one and enter it into the controller setup page in ESPeasy.
+The Application EUI and App Key must be copied from the TTN console page to the ESPeasy controller configuration page.
+
+Using these steps, a device address is generated. 
+Such an address looks like this: "26 01 20 47"
+Also the Network Session Key and Application Session Key can be retrieved from this page and can even be used as if the device is using ABP to join the network.
+But keep in mind, these 3 keys will be changed as soon as an OTAA join is performed.
+
+Device configuration with solely an ABP setup are more persistent.
+
+
+Decoding Data
+-------------
+
+
+Controller Settings
+-------------------
+
+
+
@@ -0,0 +1,101 @@
+.. include:: _controller_substitutions.repl
+
+Controller
+**********
+
+A controller is a component to enable a plugin to send data elsewhere.
+
+- Up-to 3 controllers can be active in ESPEasy.
+- Per plugin up-to 3 active controllers can be selected.
+- For some controllers an additional parameter can be given.
+
+For example, Domoticz needs an 'IDX' value to identify the configured entry in
+Domoticz for which new data is sent.
+
+Controller Plugins
+==================
+
+.. csv-table::
+   :header: "Plugin name", "Plugin status", "Plugin number"
+   :widths: 10, 8, 5
+
+   ":ref:`C001_page`","|C001_status|","C001"
+   ":ref:`C002_page`","|C002_status|","C002"
+   ":ref:`C003_page`","|C003_status|","C003"
+   ":ref:`C004_page`","|C004_status|","C004"
+   ":ref:`C005_page`","|C005_status|","C005"
+   ":ref:`C006_page`","|C006_status|","C006"
+   ":ref:`C007_page`","|C007_status|","C007"
+   ":ref:`C008_page`","|C008_status|","C008"
+   ":ref:`C009_page`","|C009_status|","C009"
+   ":ref:`C010_page`","|C010_status|","C010"
+   ":ref:`C011_page`","|C011_status|","C011"
+   ":ref:`C012_page`","|C012_status|","C012"
+   ":ref:`C013_page`","|C013_status|","C013"
+   ":ref:`C014_page`","|C014_status|","C014"
+   ":ref:`C016_page`","|C016_status|","C016"
+   ":ref:`C017_page`","|C017_status|","C017"
+   ":ref:`C018_page`","|C018_status|","C018"
+
+
+Controller Parameters
+=====================
+
+Generic fields
+--------------
+
+- **Protocol** - The type of controller (e.g. ThingSpeak/OpenHAB MQTT/etc.)
+- **Locate Controller** - Selection between hostname/IP
+- **Controller Hostname/IP**  - The address to reach the selected service
+- **Controller Port** - TCP/UDP Port number (0...65536)
+- **Enabled** - Whether or not the controller is active.
+
+Send queue parameters
+---------------------
+
+Controllers have a queue to keep unsent messages.
+This queue is used to handle message bursts and also store messages which are recorded
+before WiFi connection is made or during lost connection.
+
+- **Minimum Send Interval** - Minimum time between two messages in msec.
+- **Max Queue Depth** - Maximum length of the buffer queue to keep unsent messages.
+- **Max Retries** - Maximum number of retries to send a message.
+- **Full Queue Action** - How to handle when queue is full, ignore new or delete oldest message.
+- **Check Reply** - When set to false, a sent message is considered always successful.
+- **Client Timeout** - Timeout in msec for an network connection used by the controller.
+- **Sample Set Initiator** - Some controllers (e.g. C018 LoRa/TTN) can mark samples to belong to a set of samples. A new sample from set task index will increment this counter.
+  Especially useful for controllers which cannot send samples in a burst. This makes the receiving time stamp useless to detect what samples were taken around the same time.
+  The sample set counter value can help matching received samples to a single set.
+
+
+
+Sample ThingSpeak configuration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Some controllers, like ThingSpeak, need a specific configuration.
+ThingSpeak only allows a message every 15 seconds for the free accounts.
+
+- **Minimum Send Interval** - 15000 msec
+- **Max Queue Depth** - 1 (only report the last value)
+- **Max Retries** - 2
+- **Full Queue Action** - Delete Oldest
+- **Check Reply** - Check Acknowledgment (VERY IMPORTANT)
+- **Client Timeout** - 500 msec (server is online, so timeout must be a bit longer)
+
+
+Controller user credentials
+---------------------------
+
+- **Controller User** - User name (optional)
+- **Controller Password** - Password (optional)
+
+MQTT related settings
+---------------------
+
+- **Controller Subscribe** - Subscribe to the given topic.
+- **Controller Publish** - Publish to the given topic.
+- **Controller lwl topic** - Topic to which LWT (Last Will Testament) messages should be sent.
+- **LWT Connect Message** - Connection established message.
+- **LWT Disconnect Message** - Connection lost message (sent to broker during connect and published by broker when connection is lost)
+
+
@@ -0,0 +1,189 @@
+
+
+
+.. |C001_name| replace:: :cyan:`Domoticz HTTP`
+.. |C001_type| replace:: :cyan:`Controller`
+.. |C001_typename| replace:: :cyan:`Controller - Domoticz HTTP`
+.. |C001_status| replace:: :green:`NORMAL`
+.. |C001_github| replace:: C001.ino
+.. _C001_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C001.ino
+.. |C001_usedby| replace:: `.`
+.. |C001_shortinfo| replace:: `.`
+.. |C001_maintainer| replace:: `.`
+.. |C001_compileinfo| replace:: `.`
+
+.. |C002_name| replace:: :cyan:`Domoticz MQTT`
+.. |C002_type| replace:: :cyan:`Controller`
+.. |C002_typename| replace:: :cyan:`Controller - Domoticz MQTT`
+.. |C002_status| replace:: :green:`NORMAL`
+.. |C002_github| replace:: C002.ino
+.. _C002_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C002.ino
+.. |C002_usedby| replace:: `.`
+.. |C002_shortinfo| replace:: `.`
+.. |C002_maintainer| replace:: `.`
+.. |C002_compileinfo| replace:: `.`
+
+.. |C003_name| replace:: :cyan:`Nodo Telnet`
+.. |C003_type| replace:: :cyan:`Controller`
+.. |C003_typename| replace:: :cyan:`Controller - Nodo Telnet`
+.. |C003_status| replace:: :green:`NORMAL`
+.. |C003_github| replace:: C003.ino
+.. _C003_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C003.ino
+.. |C003_usedby| replace:: `.`
+.. |C003_shortinfo| replace:: `.`
+.. |C003_maintainer| replace:: `.`
+.. |C003_compileinfo| replace:: `.`
+
+.. |C004_name| replace:: :cyan:`ThingSpeak`
+.. |C004_type| replace:: :cyan:`Controller`
+.. |C004_typename| replace:: :cyan:`Controller - ThingSpeak`
+.. |C004_status| replace:: :green:`NORMAL`
+.. |C004_github| replace:: C004.ino
+.. _C004_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C004.ino
+.. |C004_usedby| replace:: `.`
+.. |C004_shortinfo| replace:: `.`
+.. |C004_maintainer| replace:: `.`
+.. |C004_compileinfo| replace:: `.`
+
+.. |C005_name| replace:: :cyan:`Home Assistant (openHAB) MQTT`
+.. |C005_type| replace:: :cyan:`Controller`
+.. |C005_typename| replace:: :cyan:`Controller - Home Assistant (openHAB) MQTT`
+.. |C005_status| replace:: :green:`NORMAL`
+.. |C005_github| replace:: C005.ino
+.. _C005_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C005.ino
+.. |C005_usedby| replace:: `.`
+.. |C005_shortinfo| replace:: `.`
+.. |C005_maintainer| replace:: `.`
+.. |C005_compileinfo| replace:: `.`
+
+.. |C006_name| replace:: :cyan:`PiDome MQTT`
+.. |C006_type| replace:: :cyan:`Controller`
+.. |C006_typename| replace:: :cyan:`Controller - PiDome MQTT`
+.. |C006_status| replace:: :green:`NORMAL`
+.. |C006_github| replace:: C006.ino
+.. _C006_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C006.ino
+.. |C006_usedby| replace:: `.`
+.. |C006_shortinfo| replace:: `.`
+.. |C006_maintainer| replace:: `.`
+.. |C006_compileinfo| replace:: `.`
+
+.. |C007_name| replace:: :cyan:`Emoncms`
+.. |C007_type| replace:: :cyan:`Controller`
+.. |C007_typename| replace:: :cyan:`Controller - Emoncms`
+.. |C007_status| replace:: :green:`NORMAL`
+.. |C007_github| replace:: C007.ino
+.. _C007_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C007.ino
+.. |C007_usedby| replace:: `.`
+.. |C007_shortinfo| replace:: `.`
+.. |C007_maintainer| replace:: `.`
+.. |C007_compileinfo| replace:: `.`
+
+.. |C008_name| replace:: :cyan:`Generic HTTP`
+.. |C008_type| replace:: :cyan:`Controller`
+.. |C008_typename| replace:: :cyan:`Controller - Generic HTTP`
+.. |C008_status| replace:: :green:`NORMAL`
+.. |C008_github| replace:: C008.ino
+.. _C008_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C008.ino
+.. |C008_usedby| replace:: `.`
+.. |C008_shortinfo| replace:: `.`
+.. |C008_maintainer| replace:: `.`
+.. |C008_compileinfo| replace:: `.`
+
+.. |C009_name| replace:: :cyan:`FHEM HTTP`
+.. |C009_type| replace:: :cyan:`Controller`
+.. |C009_typename| replace:: :cyan:`Controller - FHEM HTTP`
+.. |C009_status| replace:: :green:`NORMAL`
+.. |C009_github| replace:: C009.ino
+.. _C009_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C009.ino
+.. |C009_usedby| replace:: `.`
+.. |C009_shortinfo| replace:: `.`
+.. |C009_maintainer| replace:: `.`
+.. |C009_compileinfo| replace:: `.`
+
+.. |C010_name| replace:: :cyan:`Generic UDP`
+.. |C010_type| replace:: :cyan:`Controller`
+.. |C010_typename| replace:: :cyan:`Controller - Generic UDP`
+.. |C010_status| replace:: :green:`NORMAL`
+.. |C010_github| replace:: C010.ino
+.. _C010_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C010.ino
+.. |C010_usedby| replace:: `.`
+.. |C010_shortinfo| replace:: `.`
+.. |C010_maintainer| replace:: `.`
+.. |C010_compileinfo| replace:: `.`
+
+.. |C011_name| replace:: :cyan:`Generic HTTP`
+.. |C011_type| replace:: :cyan:`Controller`
+.. |C011_typename| replace:: :cyan:`Controller - Generic HTTP`
+.. |C011_status| replace:: :yellow:`TESTING`
+.. |C011_github| replace:: C011.ino
+.. _C011_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C011.ino
+.. |C011_usedby| replace:: `.`
+.. |C011_shortinfo| replace:: `.`
+.. |C011_maintainer| replace:: `.`
+.. |C011_compileinfo| replace:: `.`
+
+.. |C012_name| replace:: :cyan:`Blynk`
+.. |C012_type| replace:: :cyan:`Controller`
+.. |C012_typename| replace:: :cyan:`Controller - Blynk`
+.. |C012_status| replace:: :yellow:`TESTING`
+.. |C012_github| replace:: C012.ino
+.. _C012_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C012.ino
+.. |C012_usedby| replace:: `.`
+.. |C012_shortinfo| replace:: `.`
+.. |C012_maintainer| replace:: `.`
+.. |C012_compileinfo| replace:: `.`
+
+.. |C013_name| replace:: :cyan:`ESPEasy P2P Networking`
+.. |C013_type| replace:: :cyan:`Controller`
+.. |C013_typename| replace:: :cyan:`Controller - ESPEasy P2P Networking`
+.. |C013_status| replace:: :green:`NORMAL`
+.. |C013_github| replace:: C013.ino
+.. _C013_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C013.ino
+.. |C013_usedby| replace:: `.`
+.. |C013_shortinfo| replace:: `.`
+.. |C013_maintainer| replace:: `TD-er`
+.. |C013_compileinfo| replace:: `.`
+
+.. |C014_name| replace:: :cyan:`Homie MQTT (Version 3.0.1 & 4.0.0dev)`
+.. |C014_type| replace:: :cyan:`Controller`
+.. |C014_typename| replace:: :cyan:`Controller - Homie MQTT convention`
+.. |C014_status| replace:: :yellow:`TESTING`
+.. |C014_github| replace:: C014.ino
+.. _C014_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C014.ino
+.. |C014_usedby| replace:: `.`
+.. |C014_shortinfo| replace:: `Controller for communication following the Homie convention`
+.. |C014_maintainer| replace:: `.`
+.. |C014_compileinfo| replace:: `Can be compiled for Homie 3.0.1 or 4.0.0dev`
+
+.. |C016_name| replace:: :cyan:`Cache`
+.. |C016_type| replace:: :cyan:`Controller`
+.. |C016_typename| replace:: :cyan:`Controller - Cache`
+.. |C016_status| replace:: :red:`DEVELOPMENT`
+.. |C016_github| replace:: C016.ino
+.. _C016_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C016.ino
+.. |C016_usedby| replace:: `.`
+.. |C016_shortinfo| replace:: `Cache layer to collect data while offline`
+.. |C016_maintainer| replace:: `TD-er`
+.. |C016_compileinfo| replace:: `Not in nightly builds. Only pre-built for special builds.`
+
+.. |C017_name| replace:: :cyan:`Zabbix`
+.. |C017_type| replace:: :cyan:`Controller`
+.. |C017_typename| replace:: :cyan:`Controller - Zabbix`
+.. |C017_status| replace:: :yellow:`TESTING`
+.. |C017_github| replace:: C017.ino
+.. _C017_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C017.ino
+.. |C017_usedby| replace:: `.`
+.. |C017_shortinfo| replace:: `.`
+.. |C017_maintainer| replace:: `.`
+.. |C017_compileinfo| replace:: `.`
+
+.. |C018_name| replace:: :cyan:`LoRa TTN - RN2483/RN2903`
+.. |C018_type| replace:: :cyan:`Controller`
+.. |C018_typename| replace:: :cyan:`Controller - LoRa TTN - RN2483/RN2903`
+.. |C018_status| replace:: :yellow:`TESTING`
+.. |C018_github| replace:: C018.ino
+.. _C018_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_C018.ino
+.. |C018_usedby| replace:: `.`
+.. |C018_shortinfo| replace:: `Controller for the LoRaWAN/TTN network supporting RN2384 (434/868 MHz) and RN2903 (915 MHz)`
+.. |C018_maintainer| replace:: `TD-er`
+.. |C018_compileinfo| replace:: `.`
@@ -0,0 +1,138 @@
+About Us
+********
+The ESP Easy project is being handled by the core team of TD-er and Grovkillen.
+TD-er being the head of backend and Grovkillen being head of the frontend.
+We both dig down into each others areas of responsible on a daily basis though.
+
+Other than us we have around 100 volunteers that helping us maintain
+and improve the source code.
+
+History
+=======
+ESP Easy has gone through a lot of changes over the last years and here's some
+of the major milestones.
+
+Early days (Nodo Uno)
+---------------------
+It's somewhat unknown how it all started but Paul Tonkes (part of the Nodo team)
+built a IR (infrared) to Kaku controller because he was not happy with the
+commercial version. That unit came to the world named as Nodo (Uno).
+
+04/2010 (Nodo Due)
+------------------
+Taken from the old Nodo website at the time that the Nodo update was introduced
+(named Nodo Due). During this time, a nice production class Arduino Shield was
+also built.
+
+10/2011 (Joining the Nodo community)
+------------------------------------
+The founder of the ESP Easy project, Mvb, read about the Nodo project and
+ordered his first Nodo Arduino board from the Nodo shop. He was using it to
+control Kaku lights around his house.
+
+03/2012 (Nodo Mega)
+--------------------
+Beta Nodo Mega was released, based on Arduino Mega 2560 board with Ethernet
+Shield. Using a hosted web application.
+
+05/2013 (Nodo NES Shield)
+-------------------------
+The hardware guys from the Nodo team released a shield for Arduino Mega 2560
+that contains everything needed to run Nodo Mega with the web application.
+
+01/2014 (Exploring new wireless capabilities)
+---------------------------------------------
+Nodo got its first 2.4GHz communication plugin, using the well known NRF24L01.
+This had solved limitations of the 433MHz OOK modules and at the same time it
+reduced the load on that frequency so Kaku became more reliable.
+
+Mvb decided to run a setup with two Nodo Mega units in the house. First unit
+runs the NES board for 433MHz communication, second board was dedicated for
+NRF24L01 communications. Both Mega's could communicate through I2C or Ethernet.
+
+02/2015 (Entering the Wi-Fi solution)
+-------------------------------------
+Nodo got its first ESP Wi-Fi plugin, using it as a serial to Wi-Fi bridge.
+At that time we were using the stock firmware that came with the module.
+
+04/2015 (ESP Connexio)
+----------------------
+The ESP Connexio project was initiated as the first effort to port the original
+Nodo code to the ESP platform using early version of the ESP8266 Arduino Core.
+The team had to workaround a lot of issues but got it working reasonably.
+
+05/2015 (ESP Easy initiative)
+-----------------------------
+ESP Easy was initiated, mainly because the Nodo Connexio concept was a bit
+over complicated. It had the same event list as the original Nodo project.
+Quite powerful but also complicated to end users. So the idea was to have
+something plug and play to hook up sensors to Domoticz. That decision of
+targeting Domoticz is still present in current source code since many plugins
+from the early days have the values setup in such a way that Domoticz can
+import them with little effort.
+
+09/2015 (ESP Easy R020)
+-----------------------
+As of R017 the Nodo Plugin mechanism was also implemented within ESP Easy.
+Some other inconvenient bugs were fixed, help buttons added and it was decided
+that R020 could be the first production edition.
+
+ESP Easy was launched on Sourceforge as the very first production edition.
+No programming required.
+
+02/2016 (ESP Easy R078)
+-----------------------
+To make things even more easy, edition R078 was provided as binary images
+with a simple installer. No need for a complicated Arduino IDE setup.
+And it also introduced OTA, so subsequent updates could be done without
+connecting the module to a serial port.
+
+08/2016 (ESP Easy R120)
+-----------------------
+Lots of fixes and additional features:
+
+* Rules engine
+* Custom dummy device
+* GlobalSync
+* More commands
+* More controllers
+* More devices
+
+Estimated user count was at this time around 7 000.
+
+11/2016 (ESP Easy Mega)
+-----------------------
+ESP Easy Mega was initiated (only for ESP Modules with at least 1MB flash
+memory). We had to many limitations in ESP Easy, due to the code size that
+exceeded the 512kB modules flash size. Decided to drop support for these
+classic modules and went forward with this version.
+
+02/2017 (Change of roles)
+-------------------------
+Psy0rz took over lead development of ESP Easy Mega (2.0.0), he moved the
+source code onto the GitHub page and started to modularize the code. He also
+made ESP Easy support multiple controllers and fallback Wi-Fi. During this time
+nightly releases was introduced and user counts had grown to around 20 000.
+
+08/2018 (New core team)
+-----------------------
+With both Mvb and Psy0rz having little time to spend on the project two of the
+most eager contributors Grovkillen (mainly wiki documentation and help tools
+at that time) and TD-er (had already implemented the event based Wi-Fi and
+scheduler for better timing) stepped in. The aim for the core team is to
+make the ESP Easy OS as great as can be by dedicating full time commitment to
+the project.
+
+User count was at this point approximately around 32 000 and 24 hour download
+count around 280.
+
+.. 11/2018 (First stable 2+ version)
+   ----------------------------------
+   The first stable release of the new 2.0.0 version was finally released. Much
+   of the features added had been in the nightly releases for more than a year
+   but in the process of modularizing the source code a lot of bugs were fixed,
+   much better timing added, but also some new bugs came into the light. The
+   team wanted to have the official stable release to be just that, stable.
+
+   Estimated user count was at this point around 40 000 and 24 hour download count
+   around 540.
@@ -0,0 +1,2 @@
+ESP Easy Function Blocks
+************************
@@ -0,0 +1,45 @@
+Documentation
+*************
+
+For documentation we use Sphinx and this will be read by ReadTheDocs.
+We use the `Sphinx Bootstrap Theme <https://github.com/ryan-roemer/sphinx-bootstrap-theme>`_
+
+This documentation is included in the GitHub repository.
+It allows us to create documentation per version of ESPEasy.
+
+See also the `ESPEasy wiki <https://www.letscontrolit.com/wiki/index.php/ESPEasy>`_
+for more documentation which has not been moved here.
+
+Needed Python packages::
+
+   pip install sphinx recommonmark sphinx_bootstrap_theme
+
+PlatformIO with Atom
+====================
+
+With the ESPEasy project open in Atom, open the PIO terminal in Atom.
+
+Install dependencies::
+
+   cd docs
+   pip install ... (see needed Python packages above)
+
+Build on Windows::
+
+   cd docs
+   .\make.bat html
+
+Build on Linux/Mac::
+
+   cd docs
+   ./make html
+
+
+LaTeX (PDF) build on Linux
+==========================
+
+To build a PDF document of this documentation, you need to have LaTeX installed and some texlive packages.
+
+Via apt-get installed packages::
+
+  sudo apt-get install xzdec texlive-fonts-recommended texlive-latex-recommended texlive-latex-extra
@@ -0,0 +1,112 @@
+PlatformIO
+**********
+
+ESP easy can be built using the Arduino IDE or PlatformIO (PIO).
+Arduino IDE is not being used during development, so it may take some more effort to get it setup for building ESPeasy.
+
+We advice to use PlatformIO as build environment.
+
+PlatformIO is just the build, test and upload environment for many micro controllers like the ESP8266 and ESP32 we use.
+
+On top of that you need to use an editor, or so called IDE in which PlatformIO will be used.
+
+The two main choices are:
+
+* Atom
+* Microsoft Visual Studio Code. (MS VS-Code)
+
+Both are free to use and are available for Windows, MacOS and Linux.
+
+Apart from these two, there are more available, like Eclipse and probably more.
+
+PlatformIO with Atom
+====================
+
+
+
+PlatformIO with VS-Code
+=======================
+
+install
+-------
+
+For development of ESPeasy, a number of extensions has to be installed in VS-Code:
+
+* PlatformIO IDE (by PlatformIO)
+* C/C++ IntelliSense (by Microsoft)
+* Arduino for Visual Studio Code (by Microsoft)
+* Uncrustify (by Laurent Tréguier)
+
+Uncrustify
+----------
+
+The extension Uncrustify is mainly to format the code using a standard code format definition.
+This code format standard is defined in the file uncrustify.cfg in the main directory of this repository.
+For new code contributions, it is highly appreciated if the code is formatted using this tool.
+
+To do so:
+
+* Right click mouse in editor
+* "Format Document"
+
+The first time (after installing uncrustify) it must be confirmed to use Uncrustify as formatter and using the default suggested config file.
+
+
+Load a project using PlatformIO
+-------------------------------
+
+If you have PIO installed and the source tree cloned to your hard drive, then you can open the main dir of the repository.
+The main directory of the repository is the level with platformio.ini in it.
+
+Then in a few moments after opening the directory, on the left there will appear an alien logo, the logo of PlatformIO.
+If you click that one, you will get a tree with lots and lots of project tasks and environments.
+
+It is important  to note that PlatformIO does everything based on environments, which are defined in the platformio.ini file.
+In the PlatformIO menu (on the left) everything is grouped per environment.
+
+An environment entry has several tasks, like:
+
+* Build
+* Upload
+* Monitor
+* Upload and Monitor
+* ... many more.
+
+Some of these options only are available when you have registered with PlatformIO and some are only for paid subscriptions.
+At least the basic ones used for almost any user are available with the free account.
+
+The environment definitions all have at least the used micro controller in the name and the amount of flash memory used.
+
+For example:
+
+* ..._ESP8266_4M -> ESP8266 has external flash, which can vary in size from 512 kB to 16 MB.
+* ..._ESP8285_1M -> ESP8285 has the flash internal, so is always 1 MB.
+* ..._ESP32_1M8_partition -> ESP32 with 4 MB flash and a 1.8 MB partition for the sketch.
+
+Make a custom build using PlatformIO
+------------------------------------
+
+The easiest is to go for the environment "env:custom_ESP8266_4M" and unfold that one.
+Then select "Build" to see if it will start building.
+
+If that's working, you can open the file "pre_extra_script.py" and add or remove the plugins and controllers you need.
+That Python file is used in the "env:custom_ESP8266_4M" to define what should be embedded and what not.
+
+For example to have only the controller "C014", you can remove "CONTROLLER_SET_ALL", and just add "USES_C014", 
+The same for the plugins you need.
+
+The file is built in the ".pio/build/...." directory right under the main repository directory (the one with the platformio.ini in it)
+
+All builds will be made in a directory with the same name as the environment used.
+
+
+
+Upload to ESP
+=============
+
+
+
+Linux
+-----
+
+For Linux, you may need to install 99-platformio-udev.rules to make PlatformIO upload tools work in vscode.
@@ -0,0 +1,54 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P000_page:
+
+|P000_typename|
+==================================================
+
+|P000_shortinfo|
+
+Plugin details
+--------------
+
+Type: |P000_type|
+
+Name: |P000_name|
+
+Status: |P000_status|
+
+GitHub: |P000_github|_
+
+Maintainer: |P000_maintainer|
+
+Used libraries: |P000_usedlibraries|
+
+
+Supported hardware
+------------------
+
+|P000_usedby_GPIO|, |P000_usedby_RTTTL|
+
+Commands available
+------------------
+
+.. include:: P001_commands_GPIO.repl
+.. include:: P001_commands_RTTTL.repl
+
+.. Events
+.. ~~~~~~
+
+.. .. include:: P000_events.repl
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
@@ -0,0 +1,106 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P000_Buzzer_page:
+
+Buzzer (RTTTL)
+==============
+
+|P000_typename|
+|P000_status|
+
+.. image:: P000_Buzzer_RTTTL_1.jpg
+
+Introduction
+------------
+
+RTTTL (Ring Tone [Text] Transfer Language) was developed by Nokia to play more "easy on the ear" melodies as ringtones for mobile phones. The tunes over all characteristics are created by using three different commands:
+
+**d** - duration
+
+**o** - octave
+
+**b** - tempo (beat)
+
+After that the actual tune is then created using standard notes (a, b, c, d, e, f, and g), before the note the duration is set, after the note the octave is set:
+
+.. code-block:: html
+
+   <duration><note><octave>
+
+To compose a jingle you separate the notes with a comma.
+
+Specifications:
+ * Output sound
+
+
+Wiring
+------
+
+.. code-block:: html
+
+  ESP               Buzzer
+  GPIO       <-->   I/O
+
+  Power
+  3.3V       <-->   VCC
+  GND        <-->   GND
+
+
+Setup
+-----
+
+No device is needed, generally you use rules to activate different notifications, or you send commands to activate them. Below you find more information on how to do this.
+
+Rules examples
+--------------
+
+From ESP Easy v2.0.0 its possible to play melodies via `RTTTL <https://en.wikipedia.org/wiki/Ring_Tone_Transfer_Language#Technical_specification>`_ (don't forget to remove the spaces and replace # with -, this might be fixed in future releases):
+
+.. code-block:: html
+
+   http://<ESP IP address>/control?cmd=rtttl,14:d=4,o=5,b=112:8a,8a,a,8a,8a,a,8a,8c6,8f.,16g,2a,8a-,8a-,8a-.,16a-,8a-,8a,8a.,16a,8a,8g,8g,8a,g,c6
+
+This plays a melody on pin 14.
+
+You can also use these from rules. We use it to let our alarm system give feedback to the user via a piezo speaker.
+
+To make a boot-sound on startup, create a rule like this:
+
+.. code-block:: html
+
+   On System#Boot do
+     rtttl,14:d=10,o=6,b=180,c,e,g
+   endon
+
+`A place to find more tunes <http://www.picaxe.com/RTTTL-Ringtones-for-Tune-Command/>`_, all saved as txt files.
+
+Besides RTTTL it's also possible to play a single tone on a pin, via a buzzer, speaker or piezo element:
+
+.. code-block:: html
+
+   http://<ESP IP address>/control?cmd=tone,14,1300,200
+
+Plays a 1300 Hz tone for 200 ms on GPIO-14.
+
+Indicators (recommended settings)
+---------------------------------
+
+No device is needed.
+
+Commands
+--------
+
+.. include:: P001_commands_RTTTL.repl
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/cMvVWYS4>`_"
+
+|affiliate|
+
+.. More pictures
+.. -------------
@@ -0,0 +1,125 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P000_Level_converter_page:
+
+Level converter
+===============
+
+.. image:: P000_Level_converter_1.jpg
+
+Introduction
+------------
+
+Level-converters, aka level-shifters, aka voltage dividers, are used to adapt between a 3.3V device like the ESP8266 and devices using 5V or more internally.
+The ESP8266 runs with 3.3V - many devices need 5V or more, for example a LCD display or a Wiegand card reader. It is said that the ESP8266 can
+take 5V at its inputs. Basically this is correct and confirmand by Espressif, the manufacturer. Anyways this as always has some limitations.
+
+**First**, overcurrent. If you use a GPIO as input and the output of the connected device has 5V it should work. But if the internal resistance
+of the device is low the current might exceed the limits of the ESP8266. With some specific settings of the ESP8266 the GPIO can not take 5V,
+who checks every plugin or never made a setting mistake? So for making sure no GPIO is blown accidentally or by a bug some measurements should be taken.
+
+**Second**, some devices need higher voltage if GPIO used as output. For example the PCF8574 or the MCP23017, port multiplexer. This chips use
+3.3V or 5V as you choose. For some purpose higher voltage is useful. If using 5V there is a point you have to take care for:
+
+The High and Low levels depend on the voltage!
+
+With the PCF8574 the minimum "High" level Vih = 0.7 × Vdd, with 5V as Vdd it is 3.5V. With the MCP23017 the Vih = 0.8 × Vdd, with 5V as Vdd it is 4V.
+(Vdd is the supplied voltage) So with 3.3V max from the ESP we are too low. It might work, it might fail. Worse, it might work with one chip
+and fail with another one due to tolerances. In this case a level-converter is needed.
+
+Specifications:
+ * Level shifter, aka logic converter. Used to turn logics of higher voltage (5V) down to ESP friendly voltage (3.3V).
+
+.. note::
+   **Troubleshooting**:
+   If your level converter does not work, please check cabling first. As said cabling mistakes and slack joints with the usual cheap breadboard cables are the most likely reason.
+   If you use breakout board type level converters have a second one at hand. We've seen some "dead on arrival", other died by electrostatic discharge.
+   And again, breadboards are somewhat unreliable. Use a digital multi-meter to check contacts and wires.
+
+Wiring
+------
+
+.. warning::
+   Be careful with wiring. A wrong connection from 5V to the 3.3V rail can cause damages of the ESP and/or the power supply.
+   A direct connection by mistake from 5V to a GPIO may fry your ESP! Handle level-shifters with some care.
+   The used FET transistors are somewhat sensible against electrostatic discharge. Use a anti-static mat.
+
+.. code-block:: html
+
+  ESP                 Level converter             Connected hardware
+  GPIO (X)     <-->   3A, LV1, A1 etc.     <-->   5A, HV1, B2 etc.
+  GPIO (Y)     <-->   3B, LV2, A2 etc.     <-->   5B, HV2, B2 etc.
+
+  Power
+  3.3V         <-->   3V3, LV, VA, 3V etc.
+  5.0V         <-->   VIN, HV, VB, +5V etc.
+  GND          <-->   GND
+
+Different ways of level converting
+----------------------------------
+
+Other than using a level converter it is possible to do it "manually" through resistors.
+
+Just Input - simple unidirectional
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+As an example we will use a HC-SR04 ultrasonic distance metering module. The HC-SR04 needs 5V, it will not work with 3.3V.
+It works like bat ears, sending ultrasonic pulses and waiting for the echo. It has an input "Trigger" for sending ultrasonic pulses and an output "Echo" for the received signals.
+The "trigger" input is no problem as it can take 3.3V for "High". Just connect it to the desired GPIO. But the "Echo" pin sends back 5V signals!
+As this signaling is working just in one direction ("unidirectional") from the HC-SR04 to the ESP8266, a simple voltage divider does the job. Look at the schematic:
+
+.. image:: P000_Level_converter_2.jpg
+
+Note the two resistors R1 and R2, configured as a voltage divider. The divider gives 2.2/(1.2+2.2) = 0.65 so with 5V you get 5V × 0.65 = 3.25V at the GPIO pin.
+
+Just Input - precise unidirectional
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The simple circuit with two resistors has one disadvantage. It is calculated for 5V. For other voltages you have to calculate another pair of resistor values. And worse,
+spikes, short spikes of high voltage from unstable power supply or other reasons) pass through the divider. A better and more precise way is using a Zener diode.
+A Zener diode simplified is a semiconductor that gets conductive at a specific voltage.
+
+.. image:: P000_Level_converter_3.jpg
+
+Here a Zener diode is used as voltage limiter. The resistor must not be omitted, it is necessary to limit the current. If a 5V signal comes the diode gets conductive - it would
+short circuit the device output without the resistor. This circuit is dimensioned for input voltages from 5V to 9V (resistor should have 0.25W!). It can be used nicely for Wiegand
+card readers for example. You may use even higher voltages, for example if you want to check a 24V pump. You need an adapted resistor value for that.
+
+Input and Output - Bidirectional Level Converter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For devices that use one wire for input and output ("bidirectional") or devices that need higher voltage on an input an active level converter is necessary.
+This applies mainly to I²C devices as SCL (the clock signal) comes with 3.3V from the ESP and the SDA (data signal) goes in both directions. There are
+specialized chips for this purpose. Most of them have 8 channels - bit of an overkill for an ESP. There is a much simpler way you can buy as a cheap
+breakout board or solder together yourself.
+
+.. image:: P000_Level_converter_4.jpg
+
+A little FET and two resistors do the job. This is the circuit most level shifters you can buy at the market use.
+
+How does it work? Lets have a simplified look in a nutshell. A FET gets conductive if the voltage at the gate (pin 1) is higher then the voltage at
+the source (pin 2). So if the ESP gives 3.3V (High), gate and source have same voltage - the FET isolates both sides (pin 2 & 3) from each other.
+If the ESP goes to 0.3V (Low), the gate still has 3.3V - now the FET gets conductive pulling the 5V-side down. If the 5V-side goes to zero (low)
+because your device sends data, the diode inside the FET gets conductive and pulls the 3.3V side down to nearly zero (Low).
+
+Use of a dedicated level converter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Quite an easy job. The pins on a level shifter are usually divided in a LV (Low Voltage) and a HV (High Voltage) side. Sometimes it is just called 3V and 5V.
+Connect the 3V pin to 3.3V from ESP and the 5V pin to 5V from your device, for example a LCD display. Don't forget ground, some breakouts have some additional
+capacitors which need it. Then connect the GPIOs from the ESP to the LV side, the equivalent pins from your 5V device to the HV side. That's all.
+
+.. image:: P000_Level_converter_5.jpg
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/c5dMH05S>`_"
+
+|affiliate|
+
+.. More pictures
+.. -------------
@@ -0,0 +1,104 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P000_Piezo_element_page:
+
+Piezo element
+=============
+
+|P000_typename|
+|P000_status|
+
+.. image:: P000_Piezo_element_RTTTL_1.jpg
+
+Introduction
+------------
+
+RTTTL (Ring Tone [Text] Transfer Language) was developed by Nokia to play more "easy on the ear" melodies as ringtones for mobile phones. The tunes over all characteristics are created by using three different commands:
+
+**d** - duration
+
+**o** - octave
+
+**b** - tempo (beat)
+
+After that the actual tune is then created using standard notes (a, b, c, d, e, f, and g), before the note the duration is set, after the note the octave is set:
+
+.. code-block:: html
+
+   <duration><note><octave>
+
+To compose a jingle you separate the notes with a comma.
+
+Specifications:
+ * Output sound
+
+
+Wiring
+------
+
+.. code-block:: html
+
+  ESP              Piezo
+  GPIO     <-->    Positive (red)
+  GND      <-->    Negative (black)
+
+
+Setup
+-----
+
+No device is needed, generally you use rules to activate different notifications, or you send commands to activate them. Below you find more information on how to do this.
+
+Rules examples
+--------------
+
+From ESP Easy v2.0.0 its possible to play melodies via `RTTTL <https://en.wikipedia.org/wiki/Ring_Tone_Transfer_Language#Technical_specification>`_ (don't forget to remove the spaces and replace # with -, this might be fixed in future releases):
+
+.. code-block:: html
+
+   http://<ESP IP address>/control?cmd=rtttl,14:d=4,o=5,b=112:8a,8a,a,8a,8a,a,8a,8c6,8f.,16g,2a,8a-,8a-,8a-.,16a-,8a-,8a,8a.,16a,8a,8g,8g,8a,g,c6
+
+This plays a melody on pin 14.
+
+You can also use these from rules. We use it to let our alarm system give feedback to the user via a piezo speaker.
+
+To make a boot-sound on startup, create a rule like this:
+
+.. code-block:: html
+
+   On System#Boot do
+     rtttl,14:d=10,o=6,b=180,c,e,g
+   endon
+
+`A place to find more tunes <http://www.picaxe.com/RTTTL-Ringtones-for-Tune-Command/>`_, all saved as txt files.
+
+Besides RTTTL it's also possible to play a single tone on a pin, via a buzzer, speaker or piezo element:
+
+.. code-block:: html
+
+   http://<ESP IP address>/control?cmd=tone,14,1300,200
+
+Plays a 1300 Hz tone for 200 ms on GPIO-14.
+
+Indicators (recommended settings)
+---------------------------------
+
+No device is needed.
+
+Commands
+--------
+
+.. include:: P001_commands_RTTTL.repl
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/CG00mPI>`_"
+
+|affiliate|
+
+
+.. More pictures
+.. -------------
@@ -0,0 +1,340 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P000_Relay_page:
+
+Relay
+=====
+
+|P000_typename|
+|P000_status|
+
+.. image:: P000_Relay_1.jpg
+
+Introduction
+------------
+
+The ESP8266 can't switch high currents or voltages and no AC at all. But it can switch a relay that can switch high load, isolating high
+voltage from the ESP circuit. There are several relay types in the wild.
+
+The ESP can control a relay using one of it's GPIO pins. All relay boards that work with Arduino should also work with the ESP module.
+Note this is only a possible application of the ESPs ability to send a logic 1/0 (TTL at 3.3V) on a GPIO. These relay are usually available
+as 1,2,4,8,16 Relay modules and work electromagnetically. They can switch both AC/DC(or imitate a button press of a remote for example)
+as they are "power operated mechanical switches". Each relay has the screw terminal. The middle one is usually "always connected" terminal.
+The NC contact will be connected to the middle terminal when the relay is not powered. The NO is connected when the relay is powered
+and activated. Note that there are "active high" and "active low" versions of these relays.
+
+There are mainly two relay types in the wild: The good old mechanical relay with the nice "click-clack" sound and the electronic relays, so called
+"Solid State Relays" (SSR) which are completely silent.
+
+Specifications:
+ * Opto coupler (mechanical)
+ * Solid state (SSR)
+
+Relays are the most used actuators in home automation. Most people use breakout boards with a relay on it. Sadly there is no "standard" relay board.
+It seems every small manufacturing garage in china has it's own layout and schematic. Some use 5V, some use 12V, some do with opto couplers, some without...
+the perfect chaos. Several problems result from this chaos. Relays keeping switched on no mater what your ESP says. Relays not switching at all.
+And last but not least - sometimes they work. Let's get some order into that chaos.
+
+.. note::
+   You have just got your brand new relay board and it does not work. What to do?
+   At first you should check the switching level. Is it switching on with "high" or with "low"?
+
+   * Connect the board to power only (5V or 12V usually).
+   * Plug a jumper cable to one of the inputs.
+   * With the other end of the cable touch GND and +Vcc (5V or 12V).
+
+   On one of these touches the relay should switch. If it switches when connecting to GND the board uses "low" as active (relay on) signal.
+   In this case diodes or a transistor / FET as described above might help.
+
+   Connect the board to the ESP carefully. Check voltages, the power supply should be able to deliver enough current for the relays!
+   Check the connection cables. Jumper cables are well known for slack joints.
+
+Mechanical relay
+----------------
+
+The mechanical relay is a simple construction.
+It consist of a coil, one or more contacts and a spring. The spring keeps the contact in the "open" position. If the coil gets current, the magnetic
+field pulls the contact into the second position, the contact closes. As soon as the current is switched off the spring pulls the contact back.
+Mechanical relays may just have one contact switching to closed if the coil works (Normally open or NO). The contact might be a changeover contact which
+has a "common" connector and a NO (open without coil current, "normally open") and a NC (closed without coil current, "normally closed") connection.
+There might even be several contacts in one relay.
+
+There are several special types of mechanical relay
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Latching relay:
+
+.. image:: P000_Relay_2.jpg
+
+One current pulse switches on and keeps on when current goes off, a second pulse switches off.
+
+
+Polarized relay:
+
+.. image:: P000_Relay_3.jpg
+
+These relays have a defined + and - pin for the coil that must be followed.
+
+.. warning:: These micro relays can not switch mains voltage! Use them for low voltage door openers or similar.
+
+Pros and cons of mechanical relays
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+:green:`+` Several contacts in one relay available.
+
+:green:`+` NO/NC available.
+
+:green:`+` Limited resistance to overload and overvoltage.
+
+:red:`-` Noisy, might disturb in a living room or bedroom.
+
+:red:`-` Mechanical, moving parts that might wear out over time.
+
+:red:`-` Contact bumping when switching.
+
+:red:`-` High current for the coil, needs a transistor or FET for driving and generates peaks on power supply.
+
+:red:`-` The coil induces high voltage when switching off.
+
+Solid state relay
+-----------------
+
+The solid state relay, SSR for short, is a complex electronic circuit. It uses an opto coupler for input, this isolating the driving circuit from the load voltage.
+Isolation voltage is usually 2000V, 4000V or more. The switching element usually is a triac for AC switching types. For DC there are types with a MOSFET as switching element.
+
+There are several special types of SSR relay
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. image:: P000_Relay_4.jpg
+
+As with the mechanical relays there are specialized types of SSR's.
+
+**AC Type** : Can only (!!) switch AC. AC with zero crossing circuit. This type switches on and off if the AC voltage is at the zero point. **Expensive** and necessary only for special applications.
+
+**DC Type** : Can only (!!) switch DC! And a lot more that are reserved for special cases.
+
+Pros and cons of SSR relays
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+:green:`+` Completely noiseless
+
+:green:`+` Low driving current and voltage available. Some types can be driven directly from the ESP.
+
+:green:`+` No mechanical parts, no wearing out.
+
+:green:`+` No contact bumping.
+
+:green:`+` No voltage peaks on the low voltage side.
+
+:green:`+` Available for very high current for an affordable price.
+
+:red:`-` Very sensitive to overvoltage and overcurrent.
+
+:red:`-` No NC available usually.
+
+:red:`-` Usually with only one or sometimes three "normally open" circuits.
+
+:red:`-` Needs cooling! Smaller relays up to 5A must be mounted with at least 1cm distance to other parts.
+
+:red:`-` Bigger relays usually need a heat sink. Watch out: Heat sink may carry mains voltage with some types!
+
+:red:`-` Leak current! These relays leak some current even if switched off.
+
+Leak currents
+~~~~~~~~~~~~~
+
+Leak Current from SSR's might lead into problems under certain circumstances.
+The both types shown above ("Hoymk D3805KH" and "Mager GJ-6-L", 5A AC) were tested here.
+The Mager GJ-5-L showed a low leaking current and is useable for most purposes.
+The D3805HK showed a really high leaking current, enough for a 10W LED to glow and a small solenoid valve to keep open!
+This is not recommended for normal use.
+
+Meanwhile a third sample arrived: The SSR-D32A380/5 sold by Pollin.
+Similar to the D3805HK it shows a leaking current, as the test LED is slightly glowing in the dark when off.
+It seems to be a lower leaking then with the D3805HK, this is subject to some further investigation.
+The advantage of the Pollin SSR: It contains a small LED on the top indicating if the relay is on.
+This SSR is a bit bigger then the other two types tested, it just fits the case. So holes for the LEDs
+can be drilled on the top side of the case.
+
+.. danger::
+   Always remember that a switched-off SSR is not completely switched off!
+   Even a small leaking current is enough to give a shock. Nice surprise if you're on the ladder changing bulbs....
+
+Choosing your relay
+~~~~~~~~~~~~~~~~~~~
+
+Which relay should be used?
+
+Well, this depends on what you want to switch. If you control a heavy motor or pump, I'd always prefer a mechanical relay.
+The resistance against short overcurrent is a good point here.
+For experimenting we prefer mechanical relays too - we just love the "click" sound, i.e. we don't have to connect a load to see if it works.
+If noise counts or if you place the relay in a dusty or humid environment a SSR is the better choice. It's completely encapsulated so dust
+and humidity can't damage it. As it has no mechanical parts it is completely noise-free. So it's the perfect choice to switch lighting in a living room or sleeping room.
+Of course you have to chose a relay that fits your parameters.
+
+Which voltage you want to switch? AC or DC? Which current?
+
+If you want to use a SSR for high current you have to calculate the space for a heat sink and you have to use a vented case. All these parameters
+have to be figured into your project. It is also possible to use a small SSR to drive a really heavy external relay for a heavy machine for example.
+
+Wiring
+------
+
+.. code-block:: html
+
+  ESP               Relay (board)
+  GPIO (X)   <-->   IN1
+  GPIO (Y)   <-->   IN2
+
+  Power
+  5.0V       <-->   VCC
+  GND        <-->   GND
+
+
+Setup
+-----
+
+No device is needed, generally you use rules to activate relays, or you send commands to activate them. Below you
+find more information on how to do this.
+
+.. note::
+  If you want to monitor and have the GPIO state published you do this by adding as a |P001_typename| ,
+  it will not be a switch per say but you will get the state published automatically.
+
+
+Rules examples
+--------------
+
+.. code-block:: html
+
+    On Switch#State Do
+     if [Switch#State]=1
+      GPIO,12,1
+     else
+      GPIO,12,0
+     endif
+    EndOn
+
+This rule will turn the relay ON when the button is pressed, and OFF when released.
+
+Indicators (recommended settings)
+---------------------------------
+
+No device is needed.
+
+Commands
+--------
+
+.. include:: P001_commands_GPIO.repl
+
+How to connect your relay
+-------------------------
+
+You can connect the relay in multiple ways, we explain them all below.
+
+Basic ESP circuit: mechanical relays
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The basic circuit is simple.
+As the relay usually consumes more current as the ESP can handle it needs a transistor or FET to drive the relay.
+To suppress the voltage peak when switching off the coil a free-wheeling diode is needed. This can be a standard silicium diode, a 1N4148 for example.
+
+.. image:: P000_Relay_5.jpg
+
+Well, there is another way to switch the relay. In the above example we used a NPN transistor or a N-channel FET. A PNP transistor or P-Channel FET can be used too.
+Some board manufacturers do this and now we run into problems promptly. The relays usually need some higher voltage then the ESP, 5V or 12 V in most cases.
+The PNP transistor in the example is connected to +5V. It will switch the relay to "on" if the voltage at the input is at least 0.7V below the Vcc of 5V.
+The ESP delivers a maximum of 3.3V if the GPIO is "high", around 0.5V if it is "low". Both voltages are far below the 5V-0.7V = 4.3V threshhold of the relay board.
+The relay is permanently on, no matter what your ESP says. We can get this to work in a simple way with a 5V relay board. A standard diode has a loss of around 0.7V.
+We can use this to get a higher output level from the ESP. We simply use two diodes in the connection between relay board and ESP. This raises the voltage from the
+ESP up to 3.3v + 1.4V = 4.7V. This is above the threshhold of 4.3V. If the board uses a FET it might be necessary to use three diodes. That usually will work.
+On top: This circuit switches the relay off if the GPIO is "high", this leading to irritations sometimes.
+The picture shows the basic circuit with a PNP transistor, and the " 2 Diodes " solution:
+
+.. image:: P000_Relay_6.jpg
+
+More complex: using an opto coupler
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Many widespread relay boards use opto couplers. Honestly we don't know the reason besides it looks good in advertising.
+In theory the opto coupler isolates the relay coil from the ESP circuit. Well, that's nice theory. In real world we use the same power supply for relays and ESP.
+This bridges the opto coupler as the circuits are connected via power supply making the opto coupler completely useless. Anyways the relay isolates the load from
+the ESP anyways. It might be useful only if relay switching interferes with the ESP. In this case you might try a separate power supply for relay coils.
+This isolates the ESP completely from the coil circuits. Note that a jumper has to be set for that on some boards.
+Again there are two possible ways to use this circuit. The opto coupler input has one pin to the ESP and one to ground - this works without any problem but it is not widespread.
+
+.. image:: P000_Relay_7.jpg
+
+Most boards we've seen connect the opto coupler to 5V or 12V and the other input pin to the ESP.
+
+.. image:: P000_Relay_8.jpg
+
+This runs into same issues as with the PNP transistor above. The high voltage of 3.3V from ESP is far below 5V, this keeping the relay permanently active.
+The solution is same as with the transistor board above. Use some diodes between ESP and relay board usually does the job with relay boards using 5V.
+Depending on the circuit you will have to experiment how many diodes are necessary.
+
+Boards with 12V
+~~~~~~~~~~~~~~~
+
+If your relay board uses 12V and needs "Low" to switch the relay on it gets somewhat more complex. Basically it is possible to use a lot of diodes but
+it's not very handy. You may try a Zener diode of around 8.5.. 8.7 V. Honestly we don't recommend it. In this case it is better to use an additional
+transistor or FET to get it to work. This has one advantage: It inverts the switching signal so a "low" output says the relay is off.
+
+.. image:: P000_Relay_9.jpg
+
+Special designed boards
+~~~~~~~~~~~~~~~~~~~~~~~
+
+There are some boards in the wild which can be configured if "low" or "high" should switch the relay on.
+With this boards you will have to experiment a bit with your ESP and the board, there should be a combination that works.
+
+.. image:: P000_Relay_10.jpg
+
+Note the jumpers down left - that's the configuration for switching on high or low level.
+
+Basic ESP circuit: SSR
+~~~~~~~~~~~~~~~~~~~~~~
+
+This is more simple. If you got a SSR that has an input of "3...12V" or "3...30V" it usually can be driven directly from the ESP.
+The only thing you should keep in mind: Do not omit the varistor (RVx in the schematics). It protects the SSR from voltage peaks that
+may kill it within some milliseconds. Instead of the varistor a TVS diode can be used, for example a P6K400CA.
+Be careful, you have to use a bidirectional type!
+
+.. image:: P000_Relay_11.jpg
+
+It is possible to direct drive a SSR from the ESP but we won't recommend this. We prefer the same circuit as with the mechanical relay.
+It makes the relay circuit more universal and reduces load on the ESP.
+
+.. image:: P000_Relay_12.jpg
+
+Instead of the 2N2222/BC547 you may use a small FET, a BSS138 or 2N7000 / 7002. Omit the 22K resistor if useing a FET.
+R2 is needed if your relay can't take the Vcc directly. If you use a "3...30V" input SSR it's not necessary.
+
+Any opto coupler is completely needless if you use a SSR. The SSR has an opto coupler built in to isolate the load from the ESP.
+At this time there are not that much relay boards with SSR in the market, this will change over time as they get more popular.
+From what is on the market be careful what you buy. Most boards we've seen nowadays on AliExpress and Ebay have a DC relay installed - they can switch DC only! They can't switch mains voltage.
+
+Some words about DIY relay boards
+---------------------------------
+All in all it's no problem to build your own relay board fitting your needs exactly. But watch out if you want to switch
+mains voltage. There is a reason why in some countries the policies specify a minimum distance between the parts with high
+voltage and the low voltage circuits. Do not use experimental PCB's with copper pads or stripes!
+Good breakout boards are milled out, there is a gap in the PCB for isolating mains from low voltage.
+Prefer these boards over others without milling.
+
+.. danger::
+   Be very careful - mains voltage can burn your home or kill you. In case of doubt ask an expert!
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/cM59HXVq>`_ `Link 2 ($) <http://s.click.aliexpress.com/e/cerop6s0>`_"
+
+|affiliate|
+
+
+.. More pictures
+.. -------------
@@ -0,0 +1,88 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P000_Servo_motor_page:
+
+Servo motor
+===========
+
+|P000_typename|
+|P000_status|
+
+.. image:: P000_Servo_motor_1.jpg
+
+Introduction
+------------
+
+Usual servos can turn about 180° (90° in both directions from zero point).
+There are some rare servos with 270° turn. If you use a 180° type you may turn it 90° to the left or to the right.
+
+.. danger::
+   Trying to turn a servo more then what it can handle will run the servo against a stopper inside the gear.
+   As ESP Easy tries to go further the servo starts humming and gets hot, it will die over time.
+
+The third type "continuous turn servo" is not supported at this time.
+
+Specifications:
+ * Controlling servo motors using PWM
+
+
+Wiring
+------
+
+
+.. code-block:: html
+
+  ESP               Servo
+  GPIO (X)   <-->   S (signal)
+
+  Power
+  5.0V       <-->   VCC
+  GND        <-->   GND
+
+
+Setup
+-----
+
+No device is needed, generally you use rules to activate servos, or you send commands to activate them. Below you
+find more information on how to do this.
+
+Rules examples
+--------------
+
+.. code-block:: html
+
+  On Switch#State Do
+   if [Switch#State]=1
+    Servo,12,1,-45
+    Servo,14,2,45
+   else
+    Servo,12,1,0
+    Servo,14,2,0
+   endif
+  EndOn
+
+This rule will tilt the servos 45° when the button is pressed, and it'll go back to 0 once released.
+
+Indicators (recommended settings)
+---------------------------------
+
+No device is needed.
+
+Commands
+--------
+
+.. include:: P001_commands_GPIO.repl
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/c5RaXUgu>`_"
+
+|affiliate|
+
+
+.. More pictures
+.. -------------
@@ -0,0 +1,104 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P000_Speaker_page:
+
+Speaker
+=======
+
+|P000_typename|
+|P000_status|
+
+.. image:: P000_Speaker_RTTTL_1.jpg
+
+Introduction
+------------
+
+RTTTL (Ring Tone [Text] Transfer Language) was developed by Nokia to play more "easy on the ear" melodies as ringtones for mobile phones. The tunes over all characteristics are created by using three different commands:
+
+**d** - duration
+
+**o** - octave
+
+**b** - tempo (beat)
+
+After that the actual tune is then created using standard notes (a, b, c, d, e, f, and g), before the note the duration is set, after the note the octave is set:
+
+.. code-block:: html
+
+   <duration><note><octave>
+
+To compose a jingle you separate the notes with a comma.
+
+Specifications:
+ * Output sound
+
+
+Wiring
+------
+
+.. code-block:: html
+
+  ESP              Speaker
+  GPIO     <-->    Positive (red)
+  GND      <-->    Negative (black)
+
+
+Setup
+-----
+
+No device is needed, generally you use rules to activate different notifications, or you send commands to activate them. Below you find more information on how to do this.
+
+Rules examples
+--------------
+
+From ESP Easy v2.0.0 its possible to play melodies via `RTTTL <https://en.wikipedia.org/wiki/Ring_Tone_Transfer_Language#Technical_specification>`_ (don't forget to remove the spaces and replace # with -, this might be fixed in future releases):
+
+.. code-block:: html
+
+   http://<ESP IP address>/control?cmd=rtttl,14:d=4,o=5,b=112:8a,8a,a,8a,8a,a,8a,8c6,8f.,16g,2a,8a-,8a-,8a-.,16a-,8a-,8a,8a.,16a,8a,8g,8g,8a,g,c6
+
+This plays a melody on pin 14.
+
+You can also use these from rules. We use it to let our alarm system give feedback to the user via a piezo speaker.
+
+To make a boot-sound on startup, create a rule like this:
+
+.. code-block:: html
+
+   On System#Boot do
+     rtttl,14:d=10,o=6,b=180,c,e,g
+   endon
+
+`A place to find more tunes <http://www.picaxe.com/RTTTL-Ringtones-for-Tune-Command/>`_, all saved as txt files.
+
+Besides RTTTL it's also possible to play a single tone on a pin, via a buzzer, speaker or piezo element:
+
+.. code-block:: html
+
+   http://<ESP IP address>/control?cmd=tone,14,1300,200
+
+Plays a 1300 Hz tone for 200 ms on GPIO-14.
+
+Indicators (recommended settings)
+---------------------------------
+
+No device is needed.
+
+Commands
+--------
+
+.. include:: P001_commands_RTTTL.repl
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/cPcaaQXI>`_"
+
+|affiliate|
+
+
+.. More pictures
+.. -------------
@@ -0,0 +1,264 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+
+.. csv-table::
+    :header: "Command", "Class", "Purpose / Syntax"
+    :widths: 8, 5, 30
+
+    "Debug","
+    :red:`Internal`","
+    Change Serial port debug level
+
+    ``Debug,<1-4>``"
+    "
+    IP","
+    :red:`Internal`","
+    Change IP address
+
+    ``IP,<IP address>``"
+    "
+    Let","
+    :red:`Internal`","
+    Set the value of n (1..16).
+
+    ``Let,<n>,<value>``"
+    "
+    LogEntry","
+    :red:`Internal`","
+    Add string to log
+
+    ``LogEntry,<string>``"
+    "
+    Name","
+    :red:`Internal`","
+    Set the name of the unit
+
+    ``Name,<new name>``"
+    "
+    Password","
+    :red:`Internal`","
+    Set the password of the unit
+
+    ``Password,<new password>``"
+    "
+    Reboot","
+    :red:`Internal`","
+    Reboot the ESP
+
+    ``Reboot``"
+    "
+    Reset","
+    :red:`Internal`","
+    Reset config to factory default. Caution, all settings will be lost!
+
+    ``Reset``"
+    "
+    Reset Flash Write Counter","
+    :red:`Internal`","
+    Reset flash write to zero.
+
+    ``ResetFlashWriteCounter``"
+    "
+    Rules","
+    :red:`Internal`","
+    Rules enabled (1) or rules disabled (0)
+
+    ``Rules,<1/0>``"
+    "
+    Save","
+    :red:`Internal`","
+    Save config to persistent flash memory
+
+    ``Save``"
+    "
+    Settings","
+    :red:`Internal`","
+    Show settings on serial terminal
+
+    ``Settings``"
+    "
+    TaskClear","
+    :red:`Internal`","
+    Delete the given task/device
+
+    ``TaskClear,<task/device nr>``"
+    "
+    TaskClearAll","
+    :red:`Internal`","
+    Delete ALL task/device
+
+    ``TaskClearAll``"
+    "
+    TaskRun","
+    :red:`Internal`","
+    Run/excecute the given task/device, use to manually force an update/read of the task.
+
+    ``TaskRun,<task/device nr>``"
+    "
+    Unit","
+    :red:`Internal`","
+    Set the unit number
+
+    ``Unit,<unit number>``"
+    "
+    WifiAPKey","
+    :red:`Internal`","
+    Change AP WPA key
+
+    ``WifiAPKey,<WPA key>``"
+    "
+    WifiAPMode","
+    :red:`Internal`","
+    Force the unit into AP mode.
+
+    ``WifiAPMode``"
+    "
+    WifiConnect","
+    :red:`Internal`","
+    Connect to configured wireless network
+
+    ``WifiConnect``"
+    "
+    WifiDisconnect","
+    :red:`Internal`","
+    Disconnect from wireless network
+
+    ``WifiDisconnect``"
+    "
+    WifiKey","
+    :red:`Internal`","
+    Change WPA key for primary WiFi
+
+    ``WifiKey,<Wifi WPA key>``"
+    "
+    WifiKey2","
+    :red:`Internal`","
+    Change WPA key for secondary WiFi
+
+    ``WifiKey2,<Wifi WPA key>``"
+    "
+    WifiScan","
+    :red:`Internal`","
+    Scan Wireless networks
+
+    ``WifiScan``"
+    "
+    WifiSSID","
+    :red:`Internal`","
+    Change SSID to connect as primary WiFi
+
+    ``WifiSSID,<SSID>``"
+    "
+    WifiSSID2","
+    :red:`Internal`","
+    Change SSID to connect as secondry WiFi
+
+    ``WifiSSID2,<SSID>``"
+    "
+    Delay","
+    :green:`Rules`","
+    Delay rule processing
+
+    ``Delay,<delay in milliSeconds>``"
+    "
+    Publish","
+    :green:`Rules`","
+    Send command using MQTT broker service
+
+    ``Publish,<topic>,<value>``"
+    "
+    SendTo","
+    :green:`Rules`","
+    Send command to other ESP (using UDP)
+
+    ``SendTo,<unit nr>,<command>``"
+    "
+    SendToHTTP","
+    :green:`Rules`","
+    Send command to other network device using HTTP
+
+    ``SendToHTTP,<IP address>,<Portnumber>,<command>``
+
+    ``SendToHTTP,<domain>,<Portnumber>,</url>``"
+    "
+    SendToUDP","
+    :green:`Rules`","
+    Send command to other network device using UDP (non-ESP Easy units)
+
+    ``SendToUDP,<IP address>,<Portnumber>,<command>``"
+    "
+    TaskValueSet","
+    :green:`Rules`","
+    Set values on a **Dummy Task** (device)
+
+    ``TaskValueSet,<task/device nr>,<value nr>,<value/formula>``"
+    "
+    TimerSet","
+    :green:`Rules`","
+    Start a timed event
+
+    ``TimerSet,<timernr>,<timeInSeconds>``
+
+    ``TimerSet,<timernr>,0`` disables the timer"
+    "
+    Event","
+    :blue:`Special`","
+    Create an event, it's possible to send a float value along as well.
+
+    See event syntax below..."
+
+
+Event command
+~~~~~~~~~~~~~
+
+The event command is a special command used to trigger an event. This event can then be acted upon from the rules.
+You can send 0..4 event values along with the event.
+
+
+.. csv-table::
+    :header: "Event / Info"
+    :widths: 1
+
+    "
+    ``Event,SingleEvent``
+
+    The event (triggered by any of the launch ways) will make the unit publish a message.
+
+    **Rules example**
+
+    .. code-block:: html
+
+        on SingleEvent do
+          Publish,%sysname%/Info,A single event has been triggered!
+        endon
+    "
+    "
+    ``Event,SingleValue=123``
+
+    The event value ``123`` is intercepted and published.
+
+    **Rules example**
+
+    .. code-block:: html
+
+      on SingleValue do
+        Publish,%sysname%/Info,An event has been sent (%eventvalue%)!
+      endon
+    "
+    "
+    ``Event,Multi=1,2,3,99``
+
+    The event value ``99`` (4) is intercepted and the rule ``TaskValueSet...`` is
+    triggered, value of task 12 value 1 is then ``1 + 2`` = ``3`` or ``1 - 2`` = ``-1``.
+
+    **Rules example**
+
+    .. code-block:: html
+
+      on Multi do
+        if %eventvalue4%=99
+          TaskValueSet,12,1,[%eventvalue1%+%eventvalue2%]
+        else
+          TaskValueSet,12,1,[%eventvalue3%-%eventvalue2%]
+        endif
+      endon
+    "
@@ -0,0 +1,245 @@
+.. csv-table::
+   :header: "Event", "Example"
+   :widths: 30, 20
+
+   "
+   ``<taskname>#<valuename>``
+   As described already, each task can produced one or more events, one for each measured value. You should not name your devices and value names so that the combination equals to any of the below listed system events!
+   ","
+
+   .. code-block:: html
+
+        on DHT11Outside#Temperature>20 do
+         GPIO,2,1
+        endon
+
+   "
+   "
+   ``System#Wake``
+   Triggered after power on.
+   ","
+
+   .. code-block:: html
+
+        on System#Wake do
+          GPIO,15,1
+        endon
+
+   "
+   "
+   ``System#Boot``
+   Triggered at boot time.
+   ","
+
+   .. code-block:: html
+
+      on System#Boot do
+        GPIO,2,1
+        timerSet,1,30
+      endon
+
+   "
+   "
+   ``System#Sleep``
+   Triggered just before the ESP goes to deep sleep.
+   ","
+
+   .. code-block:: html
+
+	   on System#Sleep do
+	    GPIO,2,0
+	   endon
+
+   "
+   "
+   ``MQTT#Connected``
+   Triggered when the ESP has connected to broker.
+   ","
+
+   .. code-block:: html
+
+	   on MQTT#Connected do
+	    Publish,%sysname%/status,First message!
+	   endon
+
+   "
+   "
+   ``MQTT#Disconnected``
+   Triggered when the ESP has disconnected from the broker.
+   ","
+
+   .. code-block:: html
+
+	   on MQTT#Disconnected do
+	    Reboot
+	   endon
+
+   "
+   "
+   ``MQTTimport#Connected``
+   Triggered when the ESP has connected to broker (the MQTT Import plugin uses a separate connection than the generic one).
+   ","
+
+   .. code-block:: html
+
+	   on MQTTimport#Connected do
+	    Publish,%sysname%/status,MQTT Import is now operational
+	   endon
+
+   "
+   "
+   ``MQTTimport#Disconnected``
+   Triggered when the ESP has disconnected from the broker (the MQTT Import plugin uses a separate connection than the generic one).
+   ","
+
+   .. code-block:: html
+
+	   on MQTTimport#Disconnected do
+	    Reboot
+	   endon
+
+   "
+   "
+   ``WiFi#Connected``
+   Triggered when the ESP has connected to Wi-Fi.
+   ","
+
+   .. code-block:: html
+
+	   on WiFi#Connected do
+	    SendToHTTP,url.com,80,/report.php?hash=123abc456&t=[temp2#out]
+	   endon
+
+   "
+   "
+   ``WiFi#ChangedAccesspoint``
+   Triggered when the ESP has changed to access point, will also trigger first time the unit connects to the Wi-Fi.
+   ","
+
+   .. code-block:: html
+
+	   on WiFi#ChangedAccesspoint do
+	    Publish,%sysname%/status,AP changed
+	   endon
+
+   "
+   "
+   ``WiFi#APmodeEnabled``
+   Triggered when the ESP has set the AP mode (access point) active.
+   This may happen when no valid WiFi settings are found or the ESP cannot connect to the set AP, but it can also be enabled via some command.
+   N.B. Sending a publish command may not be very useful on this event, since this will mainly happen when there is no WiFi connection.
+   ","
+
+   .. code-block:: html
+
+	   on WiFi#APmodeEnabled do
+	    ... // Some command
+	   endon
+
+   "
+   "
+   ``WiFi#APmodeDisabled``
+   Triggered when the ESP has disabled the AP mode (access point).
+   This can happen some time (default 60 seconds) after a WiFi connection has been made. Or disabled using some command.
+   ","
+
+   .. code-block:: html
+
+	   on WiFi#APmodeDisabled do
+	    Publish,%sysname%/status,AP disabled
+	   endon
+
+   "
+   "
+   ``Login#Failed``
+   Triggered when (someone) has tried to login to a ESP unit with admin password enabled, but have failed to enter correct password.
+   ","
+
+   .. code-block:: html
+
+	   on Login#Failed do
+	    Publish,%sysname%/warning,Intruder alert!
+	   endon
+
+   "
+   "
+   ``Time#Initialized``
+   Triggered the first time (after boot) NTP is updating the unit.
+   ","
+
+   .. code-block:: html
+
+	   on Time#Initialized do
+	    Publish,%sysname%/Time,%systime%
+	   endon
+
+   "
+   "
+   ``Time#Set``
+   Triggered when the time is set by an update from NTP.
+   ","
+
+   .. code-block:: html
+
+	   on Time#Set do
+	    Publish,%sysname%/Time,%systime%
+	    Publish,%sysname%/NTP,Updated time at: %systime%
+	   endon
+
+   "
+   "
+   ``Rules#Timer=``
+   As described already, triggered when a rules timer ends (setting a timer to 0 will disable the timer).
+   ","
+
+   .. code-block:: html
+
+	   on Rules#Timer=1 do
+	    GPIO,2,1
+	   endon
+
+   "
+   "
+   ``Clock#Time=``
+   Triggered every minute with day and time like: Mon,12:30 or Tue,14:45. You can define triggers on specific days or all days using 'All' for days indicator. You can also use wildcards in the time setting like All,**:00 to run every hour.
+   ","
+
+   .. code-block:: html
+
+	   on Clock#Time=All,12:00 do //will run once a day at noon
+	    GPIO,2,1
+	   endon
+
+	   on Clock#Time=All,**:30 do //will run half past every hour
+	    GPIO,2,1
+	   endon
+
+	   on Clock#Time=All,%sunrise% do //will run at sunrise  (%sunset% is also available)
+	    GPIO,2,1
+	   endon
+
+   "
+   "
+   ``GPIO#N``
+   If the command 'Monitor' is used to monitor a given pin you will receive an event for that GPIO as soon as it's state changes. As seen in the example you can always use the square brackets together with the task/value name of ``Plugin#GPIO#Pinstate#N`` to get the state, but to trigger events you need to add the monitor command (preferably at boot).
+   ","
+
+   .. code-block:: html
+
+       on System#Boot do
+        Monitor GPIO,15
+       endon
+
+        on GPIO#15=0 do
+         if [Plugin#GPIO#Pinstate#13]=0
+          // do something
+         endif
+        endon
+
+        on GPIO#15=1 do
+         if [Plugin#GPIO#Pinstate#13]=1
+          // do something
+         endif
+        endon
+
+   "
@@ -0,0 +1,55 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P001_page:
+
+|P001_typename|
+==================================================
+
+|P001_shortinfo|
+
+Plugin details
+--------------
+
+Type: |P001_type|
+
+Name: |P001_name|
+
+Status: |P001_status|
+
+GitHub: |P001_github|_
+
+Maintainer: |P001_maintainer|
+
+
+Supported hardware
+------------------
+
+|P001_usedby|
+
+Commands available
+------------------
+
+.. include:: P001_commands_GPIO.repl
+.. include:: P001_commands_RTTTL.repl
+
+.. Events
+.. ~~~~~~
+
+.. .. include:: PXXX_events.repl
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+  |improved|
+  2019/02/26 Changed default name of value from "Switch" to "State".
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
@@ -0,0 +1,147 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P001_Door_switch_page:
+
+Door switch
+===========
+
+|P001_typename|
+|P001_status|
+
+.. image:: P001_Door_switch_1.jpg
+
+Introduction
+------------
+
+Any door switch module can be used as an digital input. Most none contact door switches use a technology called
+reed switch. By using a magnet (the part with no wires) the reed inside the other part (with wires) will connect
+the two parts of the reed and making a signal go low or high depending on how you have connected the switch.
+You may use it by simply connect it to either a GPIO that is normally high (pull-up) or normally low (pull-down).
+
+Specifications:
+ * Give a high or low signal to a GPIO
+ * Power needed: 3.3V (typically)
+ * Output voltage: same as input (typically)
+
+Wiring
+------
+
+.. code-block:: html
+
+  ESP               Door switch
+  GPIO (X)   <-->   Signal
+
+  Power
+  3.3V       <-->   Signal
+              or
+  GND        <-->   Signal
+
+
+Setup
+-----
+
+.. image:: P001_Setup_Door_switch_1.png
+
+Task settings
+~~~~~~~~~~~~~
+
+* **Device**: Name of plugin
+* **Name**: Name of the task (example name **Door**)
+* **Enable**: Should the task be enabled or not
+
+Sensor
+^^^^^^
+
+* **Internal pull-up**: Check if you want to use the internal pull-up of the ESP (not all GPIO pins have this internal pull-up.)
+* **Inverse logic**: Sometimes you may want the physical high value to be published as a low value. For example if the button is
+  triggering a high (1) value when you push it you maybe use it to turn of a LED so the :code:`Switch#State` would then logically be
+  preferred to be set as 0 and thus used as a variable for controlling that LED. See rules example below.
+
+* **GPIO**: Which GPIO should be used, recommended to not use a latching switch that may set the ESP into flash mode if left
+  to high/low.
+
+* **Switch type**: Set the switch type to either "Switch" or "Dimmer". Door (reed) switch is a "Switch".
+
+  * Switch: The default way of handling a switch is by a on/off button. It's either on (:code:`1`) or off (:code:`0`).
+
+  * Dimmer: Not used by door (reed) switches, if you still want to use it you can have a look at the
+    :ref:`P001_Switch_page` page.
+
+* **Switch button type**: Set the type of switch, "Normal switch", "Push button active low", or "Push button active high".
+  * Normal switch: This is the general setting to use for a PIR switch.
+
+  * Push button active low: Not used by door (reed) switches (in general), if you still want to use it you can have a look at the
+    :ref:`P001_Switch_page` page.
+
+* **Send boot state**: If checked the unit will publish the switch state when booting. If not checked you may find yourself
+  with a latching switch caught in limbo. This means that the unit is registering a low/high value but the physical state of
+  the switch might be the opposite. If you use a mechanical switch that may be physically set to a state you should check this
+  option.
+
+Advanced event management
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* **De-bounce (ms)**: How long should the pulse (the time you press the button) be, if set to high you need to have it published
+  for a longer time before the unit will register it as an state change. You could experiment with this setting to find a good
+  behavior of the button if you feel that it's not responding according to your preferences.
+
+* **Double click event**: Not used by door (reed) switches (in general), if you still want to use it you can have a look at the
+  :ref:`P001_Switch_page` page.
+
+* **Double click max interval (ms)**: Same as above..
+* **Long press event**: Same as above..
+* **Long press min interval (ms)**: Same as above..
+* **Use safe button (slower)**: Same as above..
+
+Data acquisition
+^^^^^^^^^^^^^^^^
+
+* **Send to controller** 1..3: Check which controller (if any) you want to publish to. All or no controller can be used.
+* **Interval**: How often should the task publish its value (optional for switch plugins).
+
+Indicators/values (recommended settings)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. csv-table::
+  :header: "Indicator", "Value Name", "Interval", "Decimals", "Extra information"
+  :widths: 8, 5, 5, 5, 40
+
+  "State", "State", "0", "N/A", "Usually you just want the state being published when door is actually being opened/closed. If you want a continuous publishing of the state you may use the interval setting to do so."
+
+
+Rules examples
+--------------
+
+.. code-block:: html
+
+    on Door#State=1 do
+      timerSet,1,1
+    endon
+
+    on rules#timer=1 do
+     if [Door#State]=0
+      //Action if door is closed
+     else
+      //Action if door is opened
+     endif
+    endon
+
+.. Commands available
+.. ~~~~~~~~~~~~~~~~~~
+
+.. .. include:: P001_commands.repl
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Type", "Link"
+  :widths: 5, 40
+
+  "Door switch","`AliExpress 1 ($) <http://s.click.aliexpress.com/e/ccCdXCVi>`_ `Banggood 1 ($) <https://www.banggood.com/search/reed-door.html?p=V3270422659778201806&custlinkid=76099>`_ `eBay 1 ($) <http://rover.ebay.com/rover/1/711-53200-19255-0/1?ff3=4&pub=5575404073&toolid=10001&campid=5338336929&customid=&mpre=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_odkw%3Ddoor%2Bswitch%26_osacat%3D0%26_from%3DR40%26_trksid%3Dm570.l1313%26_nkw%3Dreed%2Bdoor%26_sacat%3D0>`_"
+  "Reed switch","`AliExpress 2 ($) <http://s.click.aliexpress.com/e/0gMmOoY>`_ `Banggood 2 ($) <https://www.banggood.com/search/reed-switch.html?p=V3270422659778201806&custlinkid=76096>`_ `eBay 2 ($) <http://rover.ebay.com/rover/1/711-53200-19255-0/1?ff3=4&pub=5575404073&toolid=10001&campid=5338336929&customid=&mpre=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_odkw%3Dreed%2Bdoor%26_osacat%3D0%26_from%3DR40%26_trksid%3Dm570.l1313%26_nkw%3Dreed%2Bswitch%26_sacat%3D0>`_"
+
+|affiliate|
+
+
+.. More pictures
+.. -------------
@@ -0,0 +1,154 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P001_PIR_sensor_page:
+
+PIR sensor
+==========
+
+|P001_typename|
+|P001_status|
+
+.. image:: P001_PIR_sensor_1.jpg
+
+Introduction
+------------
+
+A big difference from the regular tactile buttons and a PIR is that a PIR will output a high or low Signal
+without someone actually pushing a physical button. The PIR uses a pyro detector which will detect change
+in radiated heat. A person or an animal is always radiating some level of heat and when someone enters
+the vision of the PIR the amount of heat will change and the PIR will trigger a signal.
+
+Specifications:
+ * Motion (change in heat)
+ * Power needed: 5V (typically)
+ * Output voltage: 3.3V (typically)
+
+.. note::
+   Some PIR sensor boards have a jumper which will allow you to have the unit send a single pulse when
+   the motion is detected or send a single repeatedly as long as motion is detected. Good boards also
+   have a sensitivity adjustment and time delay setting which lets you tweak the way the unit is behaving,
+   that could be really helpful if the default settings are triggering too much or not enough.
+
+Wiring
+------
+
+.. code-block:: html
+
+  ESP               PIR
+  GPIO (X)   <-->   I/O or OUT
+
+  Power
+  5V         <-->   VCC
+  GND        <-->   GND
+
+
+Setup
+-----
+
+.. image:: P001_Setup_PIR_sensor_1.png
+
+Task settings
+~~~~~~~~~~~~~
+
+* **Device**: Name of plugin
+* **Name**: Name of the task (example name **Motion**)
+* **Enable**: Should the task be enabled or not
+
+Sensor
+^^^^^^
+
+* **Internal pull-up**: Check if you want to use the internal pull-up of the ESP (not all GPIO pins have this internal pull-up.)
+* **Inverse logic**: Sometimes you may want the physical high value to be published as a low value. For example if the button is
+  triggering a high (1) value when you push it you maybe use it to turn of a LED so the :code:`Switch#State` would then logically be
+  preferred to be set as 0 and thus used as a variable for controlling that LED. See rules example below.
+
+* **GPIO**: Which GPIO should be used, recommended to not use a latching switch that may set the ESP into flash mode if left
+  to high/low.
+
+* **Switch type**: Set the switch type to either "Switch" or "Dimmer". PIR is a "Switch".
+
+  * Switch: The default way of handling a switch is by a on/off button. It's either on (:code:`1`) or off (:code:`0`).
+
+  * Dimmer: Not used by PIR switches, if you still want to use it you can have a look at the
+    :ref:`P001_Switch_page` page.
+
+
+* **Switch button type**: Set the type of switch, "Normal switch", "Push button active low", or "Push button active high".
+  * Normal switch: This is the general setting to use for a door (reed) switch.
+
+  * Push button active low: Not used by PIR switches (in general), if you still want to use it you can have a look at the
+    :ref:`P001_Switch_page` page.
+
+* **Send boot state**: If checked the unit will publish the switch state when booting. If not checked you may find yourself
+  with a latching switch caught in limbo. This means that the unit is registering a low/high value but the physical state of
+  the switch might be the opposite. If you use a mechanical switch that may be physically set to a state you should check this
+  option.
+
+Advanced event management
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* **De-bounce (ms)**: How long should the pulse (the time you press the button) be, if set to high you need to have it published
+  for a longer time before the unit will register it as an state change. You could experiment with this setting to find a good
+  behavior of the button if you feel that it's not responding according to your preferences.
+
+* **Double click event**: Not used by PIR switches (in general), if you still want to use it you can have a look at the
+  :ref:`P001_Switch_page` page.
+
+* **Double click max interval (ms)**: Same as above..
+* **Long press event**: Same as above..
+* **Long press min interval (ms)**: Same as above..
+* **Use safe button (slower)**: Same as above..
+
+Data acquisition
+^^^^^^^^^^^^^^^^
+
+* **Send to controller** 1..3: Check which controller (if any) you want to publish to. All or no controller can be used.
+* **Interval**: How often should the task publish its value (optional for switch plugins).
+
+Indicators/values (recommended settings)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. csv-table::
+  :header: "Indicator", "Value Name", "Interval", "Decimals", "Extra information"
+  :widths: 8, 5, 5, 5, 40
+
+  "State", "Detection", "0", "N/A", "Usually you just want the state being published when door is actually being opened/closed. If you want a continuous publishing of the state you may use the interval setting to do so."
+
+
+Rules examples
+--------------
+
+.. code-block:: html
+
+    on Motion#Detection=1 do
+      timerSet,1,1
+    endon
+
+    on rules#timer=1 do
+     if [Motion#Detection]=0
+      //Action if NO motion is detected
+     else
+      //Action if motion is detected
+     endif
+    endon
+
+.. Commands available
+.. ~~~~~~~~~~~~~~~~~~
+
+.. .. include:: P001_commands.repl
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/j0xC1UU>`_"
+  "Banggood","`Link 2 ($) <https://www.banggood.com/RobotDyn-5V-PIR-Motion-Sensor-Adjustable-Time-Delay-Sensitive-Module-For-Arduino-p-1244536.html?p=V3270422659778201806>`_"
+  "eBay","`Link 3 ($) <https://rover.ebay.com/rover/1/711-53200-19255-0/1?icep_id=114&ipn=icep&toolid=20004&campid=5338336929&mpre=https%3A%2F%2Fwww.ebay.com%2Fitm%2FNew-HC-SR501-Infrared-PIR-Motion-Sensor-Module-for-Arduino-Raspberry-pi%2F132113984394%3Fepid%3D14013121702%26hash%3Ditem1ec29b6b8a%3Ag%3AkusAAOSwT5xZTInL>`_"
+
+|affiliate|
+
+
+More pictures
+-------------
@@ -0,0 +1,166 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P001_Switch_page:
+
+Switch
+======
+
+|P001_typename|
+|P001_status|
+
+.. image:: P001_Switch_1.jpg
+
+Introduction
+------------
+
+Any switch module can be used as an digital input. In everyday language the switch is often referred to as a "button".
+You may use it by simply connect it to either a GPIO that is normally high (pull-up) or normally low (pull-down). Other
+types of switches are door switches (reed switch), sound activated switches and pulse activated switches.
+
+Specifications:
+ * Give a high or low signal to a GPIO
+ * Power needed: 3.3V (typically)
+ * Output voltage: same as input (typically)
+
+Wiring
+------
+
+.. code-block:: html
+
+  ESP               Switch/button
+  GPIO (X)   <-->   Signal
+
+  Power
+  3.3V       <-->   Signal
+              or
+  GND        <-->   Signal
+
+
+Setup
+-----
+
+.. image:: P001_Setup_Switch_1.png
+
+Task settings
+~~~~~~~~~~~~~
+
+* **Device**: Name of plugin
+* **Name**: Name of the task (recommended name **SwitchN**, where N is a number)
+* **Enable**: Should the task be enabled or not
+
+Sensor
+^^^^^^
+
+* **Internal pull-up**: Check if you want to use the internal pull-up of the ESP (not all GPIO pins have this internal pull-up.)
+* **Inverse logic**: Sometimes you may want the physical high value to be published as a low value. For example if the button is
+  triggering a high (1) value when you push it you maybe use it to turn of a LED so the :code:`Switch#State` would then logically be
+  preferred to be set as 0 and thus used as a variable for controlling that LED. See rules example below.
+
+* **GPIO**: Which GPIO should be used, recommended to not use a latching switch that may set the ESP into flash mode if left
+  to high/low.
+
+* **Switch type**: Set the switch type to either "Switch" or "Dimmer". Dimmer is used if you have a knob that can be turned and
+  thus give multiple switch trigger signals.
+
+  * Switch: The default way of handling a switch is by a on/off button. It's either on (:code:`1`) or off (:code:`0`).
+  * Dimmer: If you use the dimmer option you will be able to control the device using a dimmer (knob that can be turned).
+    The value allowed for dimmers are :code:`0..255` and a new setting is added to the web form (Dim value).
+
+
+* **Switch button type**: Set the type of switch, "Normal switch", "Push button active low", or "Push button active high".
+  * Normal switch: If you use a normal switch you should use this (you can always start with this setting).
+
+  * Push button active low: If you use a momentary switch you may want the state to be activated when you have it published
+    and not wait for it to be released. Depending on your setup you can then experiment with the active low / active high
+    to make it behave as you want.
+
+  * Push button active high: See bullet point above.
+
+* **Send boot state**: If checked the unit will publish the switch state when booting. If not checked you may find yourself
+  with a latching switch caught in limbo. This means that the unit is registering a low/high value but the physical state of
+  the switch might be the opposite. If you use a mechanical switch that may be physically set to a state you should check this
+  option.
+
+Advanced event management
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* **De-bounce (ms)**: How long should the pulse (the time you press the button) be, if set to high you need to have it published
+  for a longer time before the unit will register it as an state change. You could experiment with this setting to find a good
+  behavior of the button if you feel that it's not responding according to your preferences.
+
+* **Double click event**: If enabled the unit will detect double clicks which are within the set interval (see below). The double
+  click event is identified as :code:`Switch#State=3`. There's three options for the double click:
+  * Active only on low: the double clicks will be counted by how many low signals that is triggered within the set time.
+  * Active only on high: the double clicks will be counted by how many high signals that is triggered within the set time.
+
+  * Active on high & low: the double clicks will be counted by how many high and low signals that is triggered within the set time.
+    This means that a double click could be registered as a press and release of a button. So not actually double click.
+
+* **Double click max interval (ms)**: This is the interval that you need to perform the double click within.
+
+* **Long press event**: If enabled the unit will detect a long press of a button. There's three different behaviors of the long press:
+
+  * Active only on low: this means that the unit will only be triggering the long press event if the signal is low. Two different event
+    values are used, :code:`10` if the state goes from 0 to 1 (:code:`Switch#State=10`), and  :code:`11` if the state goes
+    from 1 to 0 (:code:`Switch#State=11`).
+
+  * Active only on high: same as above but only triggered on high signal.
+  * Active on high & low: the long press will be triggered both on high and low signals.
+
+* **Long press min interval (ms)**: This is the interval that you need to press the button before the long press event is triggered.
+
+* **Use safe button (slower)**:
+
+Data acquisition
+^^^^^^^^^^^^^^^^
+
+* **Send to controller** 1..3: Check which controller (if any) you want to publish to. All or no controller can be used.
+* **Interval**: How often should the task publish its value (optional for switch plugins).
+
+Indicators/values (recommended settings)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. csv-table::
+  :header: "Indicator", "Value Name", "Interval", "Decimals", "Extra information"
+  :widths: 8, 5, 5, 5, 40
+
+  "State", "State", "0", "N/A", "Usually you just want the state being published when an actual push has been happening. If you want a continuous publishing of the state you may use the interval setting to do so."
+
+Rules examples
+--------------
+
+.. code-block:: html
+
+    on Switch#State do
+     if [Switch#State]=3
+      //double click triggered!
+      GPIO,12,0
+     else
+      GPIO,2,[Switch#State]
+      GPIO,12,1
+     endif
+    endon
+
+.. Commands available
+.. ~~~~~~~~~~~~~~~~~~
+
+.. .. include:: P001_commands.repl
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "Toggle switch","`AliExpress 1 ($) <http://s.click.aliexpress.com/e/fY7OgXO>`_ `Banggood 1 ($) <https://www.banggood.com/5pcs-12V-Round-Rocker-Toggle-ONOFF-Switch-3-Pins-p-1046835.html?p=V3270422659778201806>`_ `Banggood 2 ($) <https://www.banggood.com/Red-3-Pin-ON-ON-SPDT-Mini-Toggle-Switch-AC-6A125V-3A250V-p-967014.html?p=V3270422659778201806>`_ `eBay 1 ($) <https://rover.ebay.com/rover/1/711-53200-19255-0/1?icep_id=114&ipn=icep&toolid=20004&campid=5338336929&mpre=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_from%3DR40%26_trksid%3Dm570.l1313%26_nkw%3Dtoggle%2Bswitch%26_sacat%3D0%26LH_TitleDesc%3D0%26_osacat%3D0%26_odkw%3DMomentary%2Bswitch>`_"
+  "Float switch","`AliExpress 2 ($) <http://s.click.aliexpress.com/e/clw6aFEY>`_ `Banggood 3 ($) <https://www.banggood.com/10W-Black-Side-Mount-Water-Level-Sensor-Controller-Liquid-Float-Switch-p-961256.html?p=V3270422659778201806>`_ `Banggood 4 ($) <https://www.banggood.com/Side-mounted-Liquid-Water-Level-Sensor-Right-Angle-Float-Switch-p-945298.html?p=V3270422659778201806>`_ `eBay 2 ($) <https://rover.ebay.com/rover/1/711-53200-19255-0/1?icep_id=114&ipn=icep&toolid=20004&campid=5338336929&mpre=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_from%3DR40%26_trksid%3Dm570.l1313%26_nkw%3DFloat%2Bswitch%26_sacat%3D0%26LH_TitleDesc%3D0%26_osacat%3D0%26_odkw%3DMembrane%2Bswitch>`_"
+  "Membrane switch","`AliExpress 3 ($) <http://s.click.aliexpress.com/e/ZkI1ov6>`_ `Banggood 5 ($) <https://www.banggood.com/4-x-3-Matrix-12-Key-Array-Membrane-Switch-Keypad-Keyboard-For-Arduino-p-87370.html?p=V3270422659778201806>`_ `Banggood 6 ($) <https://www.banggood.com/5Pcs-DC-4-Key-Matrix-Membrane-Switch-Control-Keypad-Keyboard-With-LED-p-965091.html?p=V3270422659778201806>`_ `eBay 3 ($) <https://rover.ebay.com/rover/1/711-53200-19255-0/1?icep_id=114&ipn=icep&toolid=20004&campid=5338336929&mpre=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_from%3DR40%26_trksid%3Dm570.l1313%26_nkw%3DMembrane%2Bswitch%26_sacat%3D0%26LH_TitleDesc%3D0%26_osacat%3D0%26_odkw%3DCapacitive%2Btouch%2Bswitch>`_"
+  "Capacitive (touch) switch","`AliExpress 4 ($) <http://s.click.aliexpress.com/e/cMIem1Nq>`_ `Banggood 7 ($) <https://www.banggood.com/TTP223B-Digital-Touch-Sensor-Capacitive-Touch-Switch-Module-For-Arduino-p-1158322.html?p=V3270422659778201806>`_ `Banggood 8 ($) <https://www.banggood.com/Jog-Type-Touch-Sensor-Module-Capacitive-Touch-Switch-Module-p-916212.html?p=V3270422659778201806>`_ `Banggood 9 ($) <https://www.banggood.com/2_7V-6V-HTTM-Series-Capacitive-Touch-Switch-Button-Module-p-1245166.html?p=V3270422659778201806>`_ `eBay 4 ($) <https://rover.ebay.com/rover/1/711-53200-19255-0/1?icep_id=114&ipn=icep&toolid=20004&campid=5338336929&mpre=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_from%3DR40%26_trksid%3Dm570.l1313%26_nkw%3DCapacitive%2Btouch%2Bswitch%26_sacat%3D0>`_"
+  "Limit switch","`AliExpress 5 ($) <http://s.click.aliexpress.com/e/bWOekFqo>`_ `Banggood 10 ($) <https://www.banggood.com/10Pcs-Micro-Limit-Switch-Roller-Lever-5A-125V-Open-Close-Switch-p-945733.html?p=V3270422659778201806>`_ `Banggood 11 ($) <https://www.banggood.com/10-Types-250VAC-Limit-Switch-IP65-Adjustable-Actuator-Roller-Arm-Rod-Spring-Coil-Endstop-Switch-p-1297617.html?p=V3270422659778201806>`_ `eBay 5 ($) <https://rover.ebay.com/rover/1/711-53200-19255-0/1?icep_id=114&ipn=icep&toolid=20004&campid=5338336929&mpre=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_from%3DR40%26_trksid%3Dm570.l1313%26_nkw%3DLimit%2Bswitch%26_sacat%3D0%26LH_TitleDesc%3D0%26_osacat%3D0%26_odkw%3DMagnetic%2Breed%2Bswitch>`_"
+  "Momentary switch","`AliExpress 6 ($) <http://s.click.aliexpress.com/e/bPEYQDfw>`_ `Banggood 12 ($) <https://www.banggood.com/420pcs-14-Types-Momentary-Tact-Tactile-Push-Button-Switch-SMD-Assortment-Kit-Set-p-1154674.html?p=V3270422659778201806>`_ `Banggood 13 ($) <https://www.banggood.com/100-Pcs-Micro-Switch-Tact-Cap-Slim-Cap-Tactile-Push-Button-Switch-Momentary-Tact-p-1277707.html?p=V3270422659778201806>`_ `Banggood 14 ($) <https://www.banggood.com/36V-2A-12mm-Momentary-Push-Button-Switch-LED-Switch-Waterproof-Switch-p-994547.html?p=V3270422659778201806>`_ `eBay 6 ($) <https://rover.ebay.com/rover/1/711-53200-19255-0/1?icep_id=114&ipn=icep&toolid=20004&campid=5338336929&mpre=https%3A%2F%2Fwww.ebay.com%2Fsch%2Fi.html%3F_from%3DR40%26_trksid%3Dm570.l1313%26_nkw%3DMomentary%2Bswitch%26_sacat%3D0%26LH_TitleDesc%3D0%26_osacat%3D0%26_odkw%3DLimit%2Bswitch>`_"
+
+
+|affiliate|
+
+.. More pictures
+.. -------------
@@ -0,0 +1,134 @@
+.. These P001 commands should be moved to core (P000)...
+
+:ref:`P000_page` |P000_status|
+
+Supported hardware: |P000_usedby_GPIO|
+
+.. csv-table::
+  :header: "Command (GPIO/Value)", "Extra information"
+  :widths: 20, 30
+
+  "
+  ``GPIO,<GPIO>,<state>``
+
+  GPIO: 0 ... 16
+
+  State:
+
+  **2** (HIGH-Z, input)
+
+  **1** (HIGH, output)
+
+  **0** (LOW, output)
+  ","
+  **Basic on/off.**.
+  We can control a pin with simple http URL commands. To change the pin to high or low steady output. Setting GPIO to **2** means
+  that it will be able to detect low level relays (with high impedance, Z).
+  "
+  "
+  ``GPIOtoggle,<GPIO>``
+
+  GPIO: 0 ... 16
+
+  ","
+  **Toggle on/off.**.
+  Toggle the current (output) state of the given GPIO pin.
+  This will only be executed on pins set to be in output mode.
+  "
+  "
+  ``LongPulse,<GPIO>,<state>,<duration>``
+
+  GPIO: 0 ... 16
+
+  State: 1/0
+
+  Duration: 1 ... 999 S
+  ","
+  **To send a *long* pulse to a certain pin.**.
+  A long pulse is basically the same as the plain pulse.  Duration is defined in seconds, which makes it more suitable for longer duration.
+  This command is not blocking, but will send 2 events to start and stop the pulse. This may have some variation depending on the system load of the module.
+  Variation is typically up-to 10 msec, but may be up-to a second, depending on active plugins and controllers performing blocking operations.
+  "
+  "
+  ``LongPulse_mS,<GPIO>,<state>,<duration>``
+
+  GPIO: 0 ... 16
+
+  State: 1/0
+
+  Duration: 10 ... 15000 msec
+  ","
+  **To send a *long* pulse to a certain pin.**
+  A ``LongPulse_mS`` is the same as the regular ``LongPulse``. The only difference is the time base in milliseconds rather than in seconds.
+  "
+  "
+  ``Pulse,<GPIO>,<state>,<duration>``
+
+  GPIO: 0 ... 16
+
+  State: 1/0
+
+  Duration: 0 ... 1000 msec
+  ","
+  **To send a *short* pulse to a certain pin.**
+  Example to send an active high (1) pulse on GPIO 14 for 500 mSeconds. Pulse duration is in milliseconds. State is 1 or 0.
+  N.B. this is a blocking call, meaning no other actions will be performed during the pulse.
+  "
+  "
+  ``PWM,<GPIO>,<duty>``
+
+  ``PWM,<GPIO>,<duty>,<duration>``
+
+  ``PWM,<GPIO>,<duty>,<duration>,<frequency>``
+
+  GPIO: 0 ... **15**
+
+  Duty: 0 ... 1023
+
+  Duration: 100 ... 15000 msec (optional)
+
+  Frequency: 100 ... 40000 Hz (optional)
+  ","
+  **To set a certain PWM level.**
+  If you have set a certain GPIO to a PWM level and want to use it as a regular HIGH/LOW pin you need to reset by setting the PWM level to 0.
+
+  Duration (in msec) parameter will create a fading.
+  Value of 0 will not set a duration.
+
+  Frequency (in Hz) will be set to 1000 Hz when not given.
+  Frequencies above 30 kHz are not stable and will likely crash the ESP.
+  "
+  "
+  ``Servo,<servo>,<GPIO>,<position>``
+
+  GPIO: 0 ... **15**
+
+  Servo: 1/2
+
+  Position: -180 ... 180 (see warning below)
+  ","
+  **To control a servo motor.**
+  We currently support a maximum of two servo motors so you can build a pan & tilt device if you like.
+
+  .. warning::
+     Most servos are not able to turn full 360°! Normally the servos are able to go from **-90°** to **90°**, some rare servos do allow for -135° to 135°.
+
+  A position value of 9000 will stop the PWM signal.
+  This can be useful to save energy on servos which do not need power to remain at the same position.
+  "
+  "
+  ``Monitor,<GPIO>``
+
+  GPIO: 0 ... 16
+  ","
+  **To monitor a GPIO state.**
+  By the use of the command you will receive events when the GPIO state of that pin is changed from 1 to 0 and from 0 to 1.
+  "
+  "
+  ``GPIOtoggle,<GPIO>``
+
+  GPIO: 0 ... 16
+  ","
+  **To toggle a GPIO state.**
+  With this command you can change the given state of a pin from either 1 to 0 or from 0 to 1.
+  "
@@ -0,0 +1,46 @@
+.. These P001 commands should be moved to core (P000)...
+
+:ref:`P000_page` |P000_status|
+
+Supported hardware: |P000_usedby_RTTTL| (Ringtones etc.)
+
+.. csv-table::
+  :header: "Command (GPIO/Value)", "Extra information"
+  :widths: 20, 30
+
+  "
+  ``tone,<gpio>,<tone>,<duration>``
+
+  GPIO: 12 ... 16
+
+  Tone: 20 ... 13000 Hz
+
+  Duration: 100 ... 15000 msec
+  ","
+  You should try to use GPIO 12...16 since these generally aren't used.
+  The recommended tone range is 20 Hz ... 13 kHz.
+  Up-to 40 kHz should be possible to generate, but will be inaudible for humans.
+  Frequencies above 30 kHz are not stable and will likely crash the ESP.
+
+  Duration is set in ms.
+
+  N.B. tones with a duration less than 50 msec will be blocking.
+  Longer duration will use the scheduler, which may cause some fluctuations in the duration.
+  "
+  "
+  ``rtttl,<gpio>,<value>``
+
+  GPIO: 12 ... 16
+
+  Value: d=<duration>,o=<octave>,b=<tempo>,<notes...>
+  ","
+  You should try to use GPIO 12...16 since these generally aren't used by ESP internal functions.
+  N.B. Playing a tune is blocking for as long as the tune is playing.
+
+  Value can be defined like <name_of_melody:duration,octave,beat,notes....>
+
+  For example:
+  ``rtttl,14,test:d=8,o=5,b=180,c6,b,c6,p,g,g-``
+
+  `More RTTTL Ringtone Downloads <http://www.picaxe.com/RTTTL-Ringtones-for-Tune-Command/>`_
+  "
@@ -0,0 +1,52 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P002_page:
+
+|P002_typename|
+==================================================
+
+|P002_shortinfo|
+
+Plugin details
+--------------
+
+Type: |P002_type|
+
+Name: |P002_name|
+
+Status: |P002_status|
+
+GitHub: |P002_github|_
+
+Maintainer: |P002_maintainer|
+
+Used libraries: |P002_usedlibraries|
+
+Supported hardware
+------------------
+
+|P002_usedby|
+
+.. Commands available
+.. ^^^^^^^^^^^^^^^^^^
+
+.. .. include:: P002_commands.repl
+
+.. Events
+.. ~~~~~~
+
+.. .. include:: P002_events.repl
+
+Change log
+----------
+
+.. versionchanged:: 2.0
+  ...
+
+  |added|
+  Major overhaul for 2.0 release.
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.
@@ -0,0 +1,71 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+
+.. _P002_ESP82XX_internal_page:
+
+ESP82XX internal
+================
+
+|P002_typename|
+|P002_status|
+
+
+Introduction
+------------
+
+
+Specifications:
+ * Analog signal (0-1V)
+
+
+Wiring
+------
+
+
+.. code-block:: html
+
+  ESP               S8
+  GPIO (X)   <-->   TX
+  GPIO (X)   <-->   RX
+
+
+  Power
+  5.0V       <-->   VCC
+  GND        <-->   GND
+
+
+Setup
+-----
+
+
+
+Rules examples
+--------------
+
+.. code-block:: html
+
+  //Code below...
+
+
+Indicators (recommended settings)
+---------------------------------
+
+.. csv-table::
+  :header: "Indicator", "Value Name", "Interval", "Decimals", "Extra information"
+  :widths: 8, 5, 5, 5, 40
+
+  "XXXXXX", "N/A", "", "", ""
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/cg1fhDDI>`_"
+
+|affiliate|
+
+
+More pictures
+-------------
@@ -0,0 +1,70 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P002_PCF8591_page:
+
+PCF8591
+=======
+
+|P002_typename|
+|P002_status|
+
+
+Introduction
+------------
+
+
+Specifications:
+ * Analog signal (0-5V)
+
+
+Wiring
+------
+
+
+.. code-block:: html
+
+  ESP               S8
+  GPIO (X)   <-->   TX
+  GPIO (X)   <-->   RX
+
+
+  Power
+  5.0V       <-->   VCC
+  GND        <-->   GND
+
+
+Setup
+-----
+
+
+
+Rules examples
+--------------
+
+.. code-block:: html
+
+  //Code below...
+
+
+Indicators (recommended settings)
+---------------------------------
+
+.. csv-table::
+  :header: "Indicator", "Value Name", "Interval", "Decimals", "Extra information"
+  :widths: 8, 5, 5, 5, 40
+
+  "XXXXXX", "N/A", "", "", ""
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/cg1fhDDI>`_"
+
+|affiliate|
+
+
+More pictures
+-------------
@@ -0,0 +1,71 @@
+.. include:: ../Plugin/_plugin_substitutions_p00x.repl
+.. _P002_Photosensitive_resistor_page:
+
+Photosensitive resistor
+=======================
+
+|P002_typename|
+|P002_status|
+
+
+Introduction
+------------
+
+
+Specifications:
+ * Light intensity
+ * Analog 1-100% or Binary above/below trigger value
+
+
+Wiring
+------
+
+
+.. code-block:: html
+
+  ESP               S8
+  GPIO (X)   <-->   TX
+  GPIO (X)   <-->   RX
+
+
+  Power
+  5.0V       <-->   VCC
+  GND        <-->   GND
+
+
+Setup
+-----
+
+
+
+Rules examples
+--------------
+
+.. code-block:: html
+
+  //Code below...
+
+
+Indicators (recommended settings)
+---------------------------------
+
+.. csv-table::
+  :header: "Indicator", "Value Name", "Interval", "Decimals", "Extra information"
+  :widths: 8, 5, 5, 5, 40
+
+  "XXXXXX", "N/A", "", "", ""
+
+Where to buy
+------------
+
+.. csv-table::
+  :header: "Store", "Link"
+  :widths: 5, 40
+
+  "AliExpress","`Link 1 ($) <http://s.click.aliexpress.com/e/cg1fhDDI>`_"
+
+|affiliate|
+
+
+More pictures
+-------------
--- a/Show More
+++ b/Show More