add mqtt config

docs/configure_mqtt.md

@@ -0,0 +1,80 @@
+# Configure MQTT on Tasmota
+
+Configure your MQTT Server in Tasmota.
+See Tasmota [MQTT Documentation](https://tasmota.github.io/docs/MQTT/) for more details.
+
+![tasmota-mqtt-config](img/tasmota-mqtt-config.png)
+
+Please leave the Full Topic as it is in default configuration (and on the screenshot).
+
+Change the topic to something unique for your panel, you will need this topic later in the configuration of your panel in appdaemon / apps.yaml
+
+# Configure MQTT Connection on AppDaemon
+
+For the app to work you need a working MQTT Configuration in AppDaemon. Please add the configuration of your mqtt server, user and password to your existing `appdaemon.yaml`
+
+NOTE: This are not the options of the AppDaemon Addon in Home Assistant. 
+You will find this file in the following location: `config/appdaemon/appdeamon.yaml`
+
+```yaml
+---
+secrets: /config/secrets.yaml
+appdaemon:
+  latitude: 52.0
+  longitude: 4.0
+  elevation: 2
+  time_zone: Europe/Berlin
+  plugins:
+    HASS:
+      type: hass
+    MQTT:
+      type: mqtt
+      namespace: mqtt
+      client_id: "appdaemon"
+      client_host: 192.168.75.30
+      client_port: 1883
+      client_user: "mqttuser"
+      client_password: "mqttpassword"
+      client_topics: NONE
+http:
+  url: http://127.0.0.1:5050
+admin:
+api:
+hadashboard:
+```
+
+# Configure NsPanel on AppDaemon
+
+Please add the following minimal configuration to your apps.yaml, which is located in `config/appdaemon/apps/apps.yaml`
+
+```yaml
+---
+nspanel-1:
+  module: nspanel-lovelace-ui
+  class: NsPanelLovelaceUIManager
+  config:
+    panelRecvTopic: "tele/tasmota_your_mqtt_topic/RESULT"
+    panelSendTopic: "cmnd/tasmota_your_mqtt_topic/CustomSend"
+```
+
+Please adjust `tasmota_your_mqtt_topic` to the topic used in Tasmota MQTT Configuration.
+
+<details>
+<summary>Note: You can add multiple panels to this configuration:</summary>
+<br>
+```yaml
+---
+nspanel-1:
+  module: nspanel-lovelace-ui
+  class: NsPanelLovelaceUIManager
+  config:
+    panelRecvTopic: "tele/first-nspanel-topic/RESULT"
+    panelSendTopic: "cmnd/first-nspanel-topic/CustomSend"
+nspanel-2:
+  module: nspanel-lovelace-ui
+  class: NsPanelLovelaceUIManager
+  config:
+    panelRecvTopic: "tele/second-nspanel-topic/RESULT"
+    panelSendTopic: "cmnd/second-nspanel-topic/CustomSend"
+```
+</details>