Merge branch 'UweKaditz' of https://github.com/uwekaditz/ESPEasy into UweKaditz

docs/source/Plugin/P092.rst

@@ -0,0 +1,36 @@
+.. include:: ../Plugin/_plugin_substitutions_p09x.repl
+.. _P092_page:
+
+|P092_typename|
+==================================================
+
+|P092_shortinfo|
+
+Plugin details
+--------------
+
+Type: |P092_type|
+
+Name: |P092_name|
+
+Status: |P092_status|
+
+GitHub: |P092_github|_
+
+Maintainer: |P092_maintainer|
+
+Used libraries: |P092_usedlibraries|
+
+Supported hardware
+------------------
+
+|P092_usedby|
+
+Change log
+----------
+
+.. versionadded:: 1.0
+  ...
+
+  |added|
+  Initial release version.

docs/source/Plugin/P092_DLbus.rst

@@ -0,0 +1,50 @@
+.. include:: ../Plugin/_plugin_substitutions_p09x.repl
+.. _P092_DLbus_page:
+
+DL bus
+======
+
+|P092_typename|
+|P092_status|
+
+Introduction
+------------
+
+The DL-Bus is used in control units e.g. sold by `Technische Alternative <http://www.ta.co.at/>`_.
+The DL-Bus serves as a bus line for various external sensors and modules.
+The DL-Bus is a bidirectional data line and only compatible with products of Technische Alternative.
+
+The data transmission looks as follows:
+ * In an infinite loop, a logging data frame is created by the control one after the others on the data line.
+
+Up to 4 sensor measured value queries (master/slave) can be made between the individual logging data frames on the DL bus.
+ * So that the beginning of a data frame can be detected, a SYNC of 16 high bits is sent before the first data byte.
+ * The data transmission is carried out as Manchester code (EXOR linked) with a display clock of 50 or 488Hz (depending on control type).
+
+This is necessary to ensure the supply voltage of the logger and DL sensors from the data signal.
+If the receiver is synchronized to the display clock, the correct bit value appears always during the second half period of the data bit (inverted in the first half period).
+
+Wiring
+------
+
+The DL-Bus consists of 2 wires: DL and GND (sensor ground).
+The power supply for the DL-Bus sensors is supplied via the DL-Bus itself.
+Some DL-Bus devices can/must be powered via a 12V source, e.g. that of the CAN bus (this is explicitly noted in the operating manual of that sensor).
+The cable routing can be star-shaped or serial (from one device to the next).
+Any cable with a cross-section of 0.75 mm2 up to a maximum length of 30 m can be used as a data cable.
+Over 30 m, the use of shielded cables is recommended, which increases the permissible length of the cable to 100 m.
+
+Protocol
+--------
+
+Transmission of a data byte
+.. image:: P092_DL_bus_databyte.png
+
+Transmission of a data frame
+.. image:: P092_DL_bus_dataframe.png
+
+Data frame on the DL bus
+.. image:: P092_DL_bus_dataframelog.png
+
+Display clock
+.. image:: P092_DL_bus_displayclock.png

docs/source/Plugin/P092_ESR21.rst

@@ -0,0 +1,76 @@
+.. include:: ../Plugin/_plugin_substitutions_p09x.repl
+.. _P092_ESR21_page:
+
+ESR21
+=====
+
+|P092_typename|
+|P092_status|
+
+Introduction
+------------
+
+The ESR21 unit is a simple solar control.
+The ESR21 unit is a differential control that can be used in many ways
+
+The DL bus runs at 12 volts.
+The data frame consist of 30 bytes (excluding sync and CRC).
+The data are transmitted @ 488Hz, therefore the transmission of one data set takes about 0.67 seconds.
+.. image:: P092_ESR21.png
+
+Wiring
+------
+
+.. image:: P092_12V_Wiring.png
+
+Protocol
+--------
+
+.. image:: P092_ESR21_Protocol.png
+
+Setup
+-----
+
+.. note:: A new device task must be created for each value to be read from the DL bus!
+
+.. image:: P092_Setup.png
+
+Task settings
+~~~~~~~~~~~~~
+
+* **Device**: Heating - DL-Bus (Technische Alternative)
+* **Name**: Name of the task (example name **ValueN**, where N is a number).
+* **Enable**: Should the task be enabled or not
+
+Sensor
+^^^^^^
+
+* **1st GPIO**: DL bus input e.g. **GPIO 14 (D5)**
+* **DL-Bus Type**: **ESR21**
+
+.. note:: The settings for **1st GPIO** and **DL-Bus Type** must be the same for all used DL bus tasks!
+
+Inputs
+^^^^^^
+
+.. note:: The description of the **Frame data** and the related **Frame bytes** can be found in the section **Protocol**!
+
+.. csv-table::
+  :header: "Frame data", "Frame bytes", "Value", "Index", "Decimals"
+  :widths: 16, 8, 8, 5, 5
+
+  "Sensor1 ... Sensor3", "3 ... 8", "Sensor", "1 - 3", "1"
+  "Ext1 ... Ext6", "9 ... 20", "Ext. Sensor", "1 - 6", "1"
+  "Output byte", "21", "Digital Output", "", "0"
+  "Speed step", "22", "Speed step", "", "0"
+  "Analog output", "23", "Analog output", "", "1"
+  "Current power", "25,26", "Heat power [kW]", "", "1"
+  "Heat quantity", "27 ... 30", "Heat meter [MWh]", "", "4"
+
+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 (10..60 seconds is normal).
+
+.. note:: Intervall not less than **10 seconds**! The reading of the DL bus happens twice per intervall.

docs/source/Plugin/P092_UVR1611.rst

@@ -0,0 +1,80 @@
+.. include:: ../Plugin/_plugin_substitutions_p09x.repl
+.. _P092_UVR1611_page:
+
+UVR1611
+=======
+
+|P092_typename|
+|P092_status|
+
+Introduction
+------------
+
+The UVR1611 unit is a freely programmable universal control system.
+The UVR1611 universal controller can be freely programmed using function modules to match any system configuration for heating room management.
+
+The DL bus runs at 12 volts.
+The data frame consist of 63 bytes (excluding sync and CRC).
+The data are transmitted @ 488Hz, therefore the transmission of one data set takes about 1.4 seconds.
+.. image:: P092_UVR1611.png
+
+Wiring
+------
+
+.. image:: P092_12V_Wiring.png
+
+Protocol
+--------
+
+.. image:: P092_UVR1611_Protocol.png
+
+Setup
+-----
+
+.. note:: A new device task must be created for each value to be read from the DL bus!
+
+.. image:: P092_Setup.png
+
+Task settings
+~~~~~~~~~~~~~
+
+* **Device**: Heating - DL-Bus (Technische Alternative)
+* **Name**: Name of the task (example name **ValueN**, where N is a number).
+* **Enable**: Should the task be enabled or not
+
+Sensor
+^^^^^^
+
+* **1st GPIO**: DL bus input e.g. **GPIO 14 (D5)**
+* **DL-Bus Type**: **UVR1611**
+
+.. note:: The settings for **1st GPIO** and **DL-Bus Type** must be the same for all used DL bus tasks!
+
+Inputs
+^^^^^^
+
+.. note:: The description of the **Frame data** and the related **Frame bytes** can be found in the section **Protocol**!
+
+.. csv-table::
+  :header: "Frame data", "Frame bytes", "Value", "Index", "Decimals"
+  :widths: 16, 8, 8, 5, 5
+
+  "Sensor1 ... Sensor16", "9 ... 40", "Sensor", "1 - 16", "1"
+  "Output A1 ... A7", "41", "Digital Output", "1 - 7", "0"
+  "Output A9 ... A13", "42", "Digital Output", "9 - 13", "0"
+  "Speed step A1", "43", "Speed step", "1", "0"
+  "Speed step A2", "44", "Speed step", "2", "0"
+  "Speed step A6", "45", "Speed step", "3", "0"
+  "Speed step A7", "46", "Speed step", "4", "0"
+  "Current power 1", "48 ... 51", "Heat power [kW]", "1", "2"
+  "Current power 2", "56 ... 59", "Heat power [kW]", "2", "2"
+  "Heat quantity 1", "52 ... 55", "Heat meter [MWh]", "1", "4"
+  "Heat quantity 2", "60 ... 64", "Heat meter [MWh]", "2", "4"
+
+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 (10..60 seconds is normal).
+
+.. note:: Intervall not less than **10 seconds**! The reading of the DL bus happens twice per intervall.

docs/source/Plugin/P092_UVR31.rst

@@ -0,0 +1,71 @@
+.. include:: ../Plugin/_plugin_substitutions_p09x.repl
+.. _P092_UVR31_page:
+
+UVR31
+=====
+
+|P092_typename|
+|P092_status|
+
+Introduction
+------------
+
+The UVR31 unit is a single-circuit universal control system.
+The UVR31 unit is designed for simple solar installations and heating systems (storage charging, domestic hot water preparation)
+
+The DL bus runs at 24 volts.
+The data frame consist of 8 bytes (excluding sync).
+The data are transmitted @ 50Hz, therefore the transmission of one data set takes about 1.92 seconds.
+.. image:: P092_UVR31.png
+
+Wiring
+------
+
+.. image:: P092_24V_Wiring.png
+
+Protocol
+--------
+
+.. image:: P092_UVR31_Protocol.png
+
+Setup
+-----
+
+.. note:: A new device task must be created for each value to be read from the DL bus!
+
+.. image:: P092_Setup.png
+
+Task settings
+~~~~~~~~~~~~~
+
+* **Device**: Heating - DL-Bus (Technische Alternative)
+* **Name**: Name of the task (example name **ValueN**, where N is a number).
+* **Enable**: Should the task be enabled or not
+
+Sensor
+^^^^^^
+
+* **1st GPIO**: DL bus input e.g. **GPIO 14 (D5)**
+* **DL-Bus Type**: **UVR31**
+
+.. note:: The settings for **1st GPIO** and **DL-Bus Type** must be the same for all used DL bus tasks!
+
+Inputs
+^^^^^^
+
+.. note:: The description of the **Frame data** and the related **Frame bytes** can be found in the section **Protocol**!
+
+.. csv-table::
+  :header: "Frame data", "Frame bytes", "Value", "Index", "Decimals"
+  :widths: 16, 8, 8, 5, 5
+
+  "Temp1 ... Temp3", "2 ... 7", "Sensor", "1 - 3", "1"
+  "Output byte", "8", "Digital Output", "", "0"
+
+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 (20..60 seconds is normal).
+
+.. note:: Intervall not less than **20 seconds**! The reading of the DL bus happens twice per intervall.

docs/source/Plugin/P092_UVR61-3.rst

@@ -0,0 +1,76 @@
+.. include:: ../Plugin/_plugin_substitutions_p09x.repl
+.. _P092_UVR61-3_page:
+
+UVR61-3
+=======
+
+|P092_typename|
+|P092_status|
+
+Introduction
+------------
+
+The UVR61-3 unit is a three-circuit universal control system.
+The UVR61-3 unit is designed for an energy-saving and cost-effective drying of cellars and other parts of buildings by means of fan control.
+The UVR61-3 three-circuit controllers has various thermostat, differential temperature and speed control functions for use in solar and heating systems, too.
+
+The DL bus runs at 12 volts.
+The data frame consist of 34 bytes (excluding sync and CRC).
+The data are transmitted @ 488Hz, therefore the transmission of one data set takes about 0.8 seconds.
+.. image:: P092_UVR61-3.png
+
+Wiring
+------
+
+.. image:: P092_12V_Wiring.png
+
+Protocol
+--------
+
+.. image:: P092_UVR61-3_Protocol.png
+
+Setup
+-----
+
+.. note:: A new device task must be created for each value to be read from the DL bus!
+
+.. image:: P092_Setup.png
+
+Task settings
+~~~~~~~~~~~~~
+
+* **Device**: Heating - DL-Bus (Technische Alternative)
+* **Name**: Name of the task (example name **ValueN**, where N is a number).
+* **Enable**: Should the task be enabled or not
+
+Sensor
+^^^^^^
+
+* **1st GPIO**: DL bus input e.g. **GPIO 14 (D5)**
+* **DL-Bus Type**: **UVR61-3 v8.2**
+
+.. note:: The settings for **1st GPIO** and **DL-Bus Type** must be the same for all used DL bus tasks!
+
+Inputs
+^^^^^^
+
+.. note:: The description of the **Frame data** and the related **Frame bytes** can be found in the section **Protocol**!
+
+.. csv-table::
+  :header: "Frame data", "Frame bytes", "Value", "Index", "Decimals"
+  :widths: 16, 8, 8, 5, 5
+
+  "Sensor1 ... Sensor6", "9 ... 20", "Sensor", "1 - 6", "1"
+  "Output A1 ... A3", "21", "Digital Output", "1 - 3", "0"
+  "Speed step", "22", "Speed step", "", "0"
+  "Analog output", "23", "Analog output", "", "1"
+  "Current power", "27,28", "Heat power [kW]", "", "1"
+  "Heat quantity", "29 ... 34", "Heat meter [MWh]", "", "4"
+
+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 (10..60 seconds is normal).
+
+.. note:: Intervall not less than **10 seconds**! The reading of the DL bus happens twice per intervall.

docs/source/Plugin/_Plugin.rst

@@ -114,6 +114,7 @@ There's three different released versions of ESP Easy:
    ":ref:`P088_page`","|P088_status|","P088"
    ":ref:`P089_page`","|P089_status|","P089"
    ":ref:`P090_page`","|P090_status|","P090"
+   ":ref:`P092_page`","|P092_status|","P092"
 
 
 Internal GPIO handling

docs/source/Plugin/_plugin_substitutions_p09x.repl

@@ -8,4 +8,15 @@
 .. |P090_shortinfo| replace:: `.`
 .. |P090_maintainer| replace:: `TD-er`
 .. |P090_compileinfo| replace:: `.`
-.. |P090_usedlibraries| replace:: `.`
+.. |P090_usedlibraries| replace:: `.`
+.. |P092_name| replace:: :cyan:`DL-Bus (Technische Alternative)`
+.. |P092_type| replace:: :cyan:`Heating`
+.. |P092_typename| replace:: :cyan:`Heating - DL-Bus (Technische Alternative)`
+.. |P092_status| replace:: :yellow:`TESTING`
+.. |P092_github| replace:: P092_DLbus.ino
+.. _P092_github: https://github.com/letscontrolit/ESPEasy/blob/mega/src/_P092_DLbus.ino
+.. |P092_usedby| replace:: `.`
+.. |P092_shortinfo| replace:: `.`
+.. |P092_maintainer| replace:: `.`
+.. |P092_compileinfo| replace:: `.`
+.. |P092_usedlibraries| replace:: `.`