Add DALI docs

docs/DALI.md

@@ -0,0 +1,44 @@
+??? note "This feature is included in tasmota32 binaries"     
+
+    When [compiling your build](Compile-your-build) add the following to `user_config_override.h`:
+    ```arduino
+    #ifndef USE_DALI
+    #define USE_DALI        // Add support for DALI gateway (+5k code)
+    #endif
+    ```
+
+## What is DALI?
+
+[DALI](https://en.wikipedia.org/wiki/Digital_Addressable_Lighting_Interface) is a trademark for network-based products that control lighting.
+
+A DALI network consists of at least one application controller and bus power supply (which may be built into any of the products) as well as input devices (e.g. sensors and push-buttons), control gear (e.g., electrical ballasts, LED drivers and dimmers) with DALI interfaces.
+
+Application controllers can control, configure or query each device by means of a bi-directional data exchange. Unlike DMX, multiple controllers can co-exist on the bus.
+
+The DALI protocol permits addressing devices individually, in groups or via broadcast.
+
+Scenes can be stored in the devices, for recall on an individual, group or broadcast basis. Groups and scenes are used to ensure simultaneous execution of level changes, since each packet requires about 25 ms - or 1.5 seconds if all 64 addresses were to change level.
+
+## Implemented Features
+
+Tasmota DALI gateway is an application controller. It defaults to supporting Device Type 6 (DT6) or Part207 single color LED lighting controller using standard Tasmota light controls.
+
+## Hardware
+
+The driver is supported on both ESP8266 and ESP32. It has been tested using [DALI Click](https://www.mikroe.com/dali-click) with GPIO settings `DALI TX` and `DALI RX` and a Busch-Jaeger Rotary dimmer acting as a DALI bus power supply.
+
+The ESP32-C3 based [Shelly DALI Dimmer Gen3](https://www.shelly.com/products/shelly-dali-dimmer-gen3) is supported using template `{"NAME":"Shelly DALI Dimmer Gen3","GPIO":[34,4736,0,3840,11360,11392,128,129,0,1,576,0,0,0,0,0,0,0,0,1,1,1],"FLAG":0,"BASE":1}` and additional commands `Backlog AdcGpio1 10000,10000,4000; ButtonTopic 0; SetOption1 1; SetOption11 0; SetOption32 20; DimmerStep 5; LedTable 0`.<br>The following rule `rule1 on button1#state=2 do dimmer + endon on button2#state=2 do dimmer - endon on button1#state=3 do power 2 endon on button2#state=3 do power 2 endon` allows dimmer control using two buttons.<br>Notice that the Shelly DALI dimmer uses inverted DALI GPIO's `DALI TX_i` and `DALI_RX_i` and provides a limited DALI bus power supply of 10mA, enough for 5 DALI control gear.
+
+## Commands
+
+Command|Parameters
+:---|:---
+DaliSend<a class="cmnd" id="dalisend"></a>|`<byte1\>,<byte2\>` = Execute DALI code and do not expect a DALI backward frame.<br>`<0xA3\>,<byte2\>,<byte3\>,<byte4\>` = Set DALI parameter using DTR0 and do not expect a DALI backward frame.
+DaliQuery<a class="cmnd" id="daliquery"></a>|`<byte1\>,<byte2\>` = Execute DALI code and report result (DALI backward frame).
+DaliScan<a class="cmnd" id="daliscan"></a>|`1` = Reset and commission new device addresses.<br>`2` = Reset and commission additional device addresses.
+DaliGear<a class="cmnd" id="daligear"></a>|Display current max address.<br>`1..64` = Set max address to speed up DaliGroup result (default = `64`).
+DaliGroup<x\><a class="cmnd" id="daligear"></a>|Display current group contents.<br>`[+]<device\>,<device\>...` = Add devices to group.<br>`-<device\>,<device\>...` = Remove devices from group.<br><br><x\> = 1 to 16.
+DaliPower<x\><a class="cmnd" id="dalipower"></a>|Display current power state.<br>`0` = Turn power off.<br>`1` = Restore power to last dimmer value.<br>`2` = Toggle power.<br>`3` to `254` = Set absolute brightness.<br><br><x\> = 0 for broadcast, 1 to 64 for individual gear or 101 to 116 for group.
+DaliDimmer<x\><a class="cmnd" id="dalidimmer"></a>|Display current dimmer state.<br>`0` = Turn power off.<br>`1` to `100` = Percentage of brightness.<br><br><x\> = 0 for broadcast, 1 to 64 for individual gear or 101 to 116 for group.
+DaliLight<a class="cmnd" id="dalilight"></a>|Display current state.<br>`0` = Disable Tasmota light control for DaliTarget device.<br>`1` = Enable Tasmota light control for DaliTarget device (default).
+DaliTarget<a class="cmnd" id="dalitarget"></a>|Display current target.<br>`0` = Broadcast (default).<br>`1` to `64` = Individual gear.<br>`101` to `116` = group.

mkdocs.yml

@@ -154,6 +154,7 @@ nav:
     - Protocol Bridging:
       - Arduino MCU: TasmotaClient.md
       - BLE Gateway: Bluetooth.md
+      - DALI.md
       - HDMI CEC: HDMI_CEC.md
       - IR Communication: Tasmota-IR.md
       - LCD/DLP Projector Control: Projector.md