Move DE docs to repo

These docs won't be maintained from now.

docs/de/blueprint.md

@@ -0,0 +1,233 @@
+Dieser Artikel befasst sich mit den Einstellungen in der Blueprint Automatisierung. 
+
+Die Blueprint Automation ist das zentrale Konfigurationselement dieser Lösung für das NSPanel. 
+Im Prinzip ist die Einrichtung der Automatisierung selbsterklärend. Nachfolgend werden die einzelnen Elemente des Blueprints beschrieben.
+
+
+Es ist möglich, sowohl die Farbe der Labels als auch der Icons für die meisten Elemente auf den einzelnen Screens zu verändern.
+
+Standard für die Farbe ist "65535". Der gewünschten Nextion Farbcode kann unter ```https://nodtem66.github.io/nextion-hmi-color-convert/index.html herausgesucht werden.```
+
+Die Icons unter folgendem Link können verwendet werden: 
+```https://htmlpreview.github.io/?https://github.com/jobr99/Generate-HASP-Fonts/blob/master/cheatsheet.html```
+
+Es wird der Übersichtlichkeit halber in der folgenden Dokumentation nicht gesondert auf die Menüeinträge "Icon Color" und "Label Color" eingegangen.
+
+    
+# Parameter
+### ESPhome Node Name 
+
+Bezieht sich auf den ESPhome-Gerätenamen. **Zulässig sind die Zeichen "__",a-z, 0-9, jedoch keine Sonder- und Leerzeichen**. Dies ist eine Einschränkung seitens HA, da aus dem Device-Name des Blueprints die jeweiligen Entity_IDs generiert werden.
+
+### Language for NSPanel 
+
+Über das Dropdown Menü kann die Sprache ausgewählt werden. Unterstützt werden derzeit 26 Sprachen.
+
+### Delay to avoid synchronization problems
+
+Es kann bei schlechtem WLAN Signal vorkommen, dass Menüs nicht komplett geladen werden. Sollte dies vorkommen, kann hier ein Delay in ms Schritten eingestellt werden, um dies zu kompensieren.
+
+
+
+## Weather and Temperature
+
+### Weather Integration
+
+Auswahl zwischen der HA Weather Integration oder dem genaueren Accuweather.
+
+### Weather entity from HA
+
+Dropdown Menü zur Auswahl der zu verwendenden Weather Entität. Beispiel: Wenn in Punkt 7 "Accuweather" ausgewählt wird, so muss hier die Entität für Accuweather ausgewählt werden.
+
+### Outdoor Temperature Sensor (Optional)
+
+Optional kann hier der Wert eines Aussentemperatur Sensor verwendet werden. Falls kein separater Sensor verwendet wird, wird der Wert der Wetter-Integration verwendet.
+
+### Outdoor Temperature Sensor - LABEL COLOR (Optional)
+
+Hier kann die Farbe der Beschriftung des Labels geändert werden. Siehe Link oben im Artikel.
+
+### Indoor Temperature Sensor (Optional)
+
+Optional kann hier der Wert eines InnentemperaturSensor verwendet werden. Wird das Feld leer gelassen, wird der Temperatursensor des NSPanels verwendet. Zusätzlich ist unter HA Devices eine Temperaturkorrektur für den NSPanel-Sensor möglich. 
+
+
+
+## Sensor Home Page
+
+### Sensor 01-03 - Entity (Optional)
+
+Bis zu drei Sensoren können auf dem Home Screen dargestellt werden. Hierzu die HA Entität auswählen.
+
+
+
+## Chips
+
+### Chip 01-07 - Entity (Optional)
+
+Zur Darstellung von HA Entities auf dem Home Screen. Kann verwendet werden um bspw. den Status eines bestimmten Schalters auf dem NSPanel darzustellen. 
+
+
+
+## Climate
+
+### Climate to Control (Optional)
+
+Wenn eine Climate Integration gesteuert werden soll, muss diese hier eingegeben werden. Erreichbar ist diese dann über die Temperatur auf dem Home Screen des NSPanels.
+
+### Climate Control optimistic Mode (Optional)
+
+Abhängig von der Klima Steuerung, kann für ein besseres Ansprechverhalten der Optimistic Mode verwendet werden. Die vorgenommenen Änderungen werden erst bei verlassen des Screens auf das Device übertragen.
+
+### Hot Water Charge Button (Optional)
+
+Optionaler Schalter um bspw. einen Boiler an- bzw. aus zu schalten.
+
+
+
+## QR Code
+
+### Activate QR Code - TRUE/FALSE (Optional)
+
+Aktiviert die QR Code Page sowie den Button auf dem Home Screen.
+
+### QR Code content - VALUE (optional)
+
+String, der als QR Code dargestellt werden soll. Dies kann ein Text sein, eine URL oder beispielsweise auch für einen vereinfachten Login ins WiFi verwendet werden (hier einfach SSID und Password ersetzen sowie entweder "WPA" oder "WEP" verwenden):
+
+```WIFI:S:SSID;T:WPA/WEP;P:PASSWORD;;``` 
+
+
+
+## Hardware Buttons
+
+### Delay for HW-Buttons hold in seconds - VALUE
+
+Einstellung, wie lange ein Button gedrückt bleiben muss, um einen "hold" zu erkennen. Default: 1 Sekunde.
+
+### Activate Relay x local Fallback (Optional)
+
+Normalerweise werden die internen Relays über HA getriggert. Ist dieser Menüpunkt aktiviert, so wird das jeweilige Relays bei betätigen des Linken bzw. Rechten Hardware Buttons geschaltet, sollte HA offline sein.
+
+### Left/Right Hardware Button - Entity (Optional)
+
+Hier kann die Entitiy ausgewählt werden, welche mit dem linken/rechten Hardware Button geschaltet werden soll.
+
+### Left/Right Hardware Button Name - Label (Optional)
+
+Text auf dem Screen über dem jeweiligen Hardware Button (Home Screen)
+
+### Left/Right Hardware Button hold assignment - VALUE (optional)
+
+Auswahl, welche Action passieren soll, wenn der Button länger gedrückt bleibt.
+
+### Left/Right Hardware Button custom hold action - VALUE (Optional)
+
+Auswahl der zu startenden Action beim Halten des Buttons.
+
+
+
+## Button Page 01-04
+
+### Button Page 01-04 name - LABEL (Optional)
+
+Text auf den jeweiligen Button Screens.
+
+### Buttons 01 - 32 (Optional)
+Die Buttons sind durch Wischen auf dem Home Screen zu erreichen und in ihrer Funktion völlig identisch.
+Entweder können nacheinander die einzelnen Button Pages durch Wischen nach links erreicht werden, oder direkt auf die Button Pages durch Wischen nach oben, unten oder rechts angesprungen werden.
+
+Die Buttons sind wie folgt nummeriert:
+
+ |         | Button Page 1 | Button Page 2 | Button Page 3 | Button Page 4 |
+ | ------- | ------------- | ------------- | ------------- | ------------- |
+| Zeile 1 | 01 02 03 04   | 09 10 11 12   | 17 18 19 20   | 25 26 27 28   |
+ | Zeile 2 | 05 06 07 08   | 13 14 15 16   | 21 22 23 24   | 29 30 31 32   |
+
+Es können folgende Entitäten hinterlegt werden:
+- Light
+- Switch
+- Cover
+- Input Boolean
+- Automation
+- Button
+- Input Button
+- Scene
+- Person
+- Script
+- Binary Sensor
+- Fan
+- Climate
+
+Wenn der jeweilige Button gedrückt wird, wird automatisch die korrespondierende Seite aufgerufen, bspw. bei Cover die Coversteuerung etc.
+Für jeden Button kann optional ein eigener Name angegeben werden.
+Alle Buttons bieten die Möglichkeit, die Ausführung der Aktion optional bestätigen zu lassen. Dies kann separat für jeden Button über *"Confirm execution of the button press"* aktiviert bzw. deaktiviert werden.
+
+
+
+## Entity Page 01-04
+
+### Activate Entity Page - TRUE/FALSE (Optional)
+
+Hiermit können die Entity Pages auf dem Home Screen aktiviert werden. Diese können verwendet werden, um bspw. Werte oder Status von Entitäten auf den einzelnen Pages darzustellen.
+
+### Entity Page 01-04 name - LABEL (Optional)
+
+Text auf den jeweiligen Entity Screens.
+
+### Entity 01 - 32 (Optional)
+
+Die Entity Pages sind durch drücken auf das Entity Symbol auf dem Home Screen zu erreichen und in ihrer Funktion völlig identisch.
+
+Die Entities sind wie folgt nummeriert:
+
+|         | Entity Page 1 | Entity Page 2 | Entity Page 3 | Entity Page 4 |
+| ------- | ------------- | ------------- | ------------- | ------------- |
+| Zeile 1 | 01 02 03 04   | 09 10 11 12   | 17 18 19 20   | 25 26 27 28   |
+| Zeile 2 | 05 06 07 08   | 13 14 15 16   | 21 22 23 24   | 29 30 31 32   |
+
+Zusätzlich besteht die Möglichkeit, ein Icon für jede Entität aus derzeit 6896 Icons auszuwählen.
+Natürlich gibt es auch die Möglichkeit, eine eigene Entitätsbezeichnung einzugeben und eine Bezeichnung für die 4 Seiten zu vergeben. Wenn kein Entity-Label gesetzt ist, wird der Friendly Name von HA übernommen.
+
+Die derzeit verfügbaren Icons finden sich hier: https://htmlpreview.github.io/?https://github.com/jobr99/Generate-HASP-Fonts/blob/master/cheatsheet.html
+
+Zum Einfügen des ausgewählten Icons auf das "U" des Icons klicken und in das jeweilige Feld im Blueprint einfügen. Es wird danach ein "komisches" Symbol im Blueprint angezeigt, dies ist jedoch korrekt.
+
+ 
+
+## Custom Configuration
+
+### Hot Water Temperatur Sensor (Optional)
+
+Optionaler Heiß Wasser Sensor.
+
+### Top 04 Flame
+
+Zeigt ein Flammen-Symbol auf dem Home Screen an, bspw. wenn eine Therme angeschaltet (On) ist.
+
+### Nextion TFT File Folder
+
+Kann freigelassen werden. Wird aber benötigt, wenn eine eigene TFT Konfiguration verwendet werden soll.
+
+### Synchronization of all all values (Optional)
+
+Light und Cover Seiten (Werte) werden kontinuierlich upgedatet (kann zu Flackern führen).
+
+### Synchronization of all all Sliders (Optional)
+
+Light und Cover Seiten (Position der Cover) werden kontinuierlich upgedatet (kann zu Flackern führen).
+
+
+
+
+***
+
+Beispiel Screenshots:
+
+![image-20230317162851693](./assets/image-20230317162851693.png)
+
+![image-20230317162944247](./assets/image-20230317162944247.png)
+
+![image-20230317163012105](./assets/image-20230317163012105.png)
+
+![image-20230317163035519](./assets/image-20230317163035519.png)

docs/de/error_initializing.md

@@ -0,0 +1,29 @@
+Es müssen verschiedene Dinge eingerichtet werden. Wenn diese nicht oder falsch eingerichtet sind, bleibt das NSPanel bei der Initialisierung stehen:<br>
+![boot](https://user-images.githubusercontent.com/123868814/215597698-b89eb275-6c67-480a-a9d5-623ab17bee1b.png)
+<br><br>
+
+#### 1. Wurde ESPHome korrekt geflashed
+Stellen Sie sicher, dass Sie die ESPHome-Konfiguration auf dem NSPanel installiert haben<br>
+<br>
+
+#### 2. ESPHome Name
+Der Gerätename in ESPHome darf nur Kleinbuchstaben, Zahlen oder einen Unterstrich (\_) enthalten. Wenn Bindestriche (-) verwendet werden, kommt es zu Problemen.<br>
+![Screenshot 2023-01-30 212555](https://user-images.githubusercontent.com/123868814/215598710-af41f2f6-7184-4469-9e45-a91504803722.png)<br>
+<br>
+
+#### 3. NSPanel zu HA hinzugefügt
+Die ESPHome-Integration muss für jedes NSPanel  im HA hinzugefügt werden:
+![HAESPHomeIntegration](https://user-images.githubusercontent.com/123868814/215600125-a9e8cb72-17b3-4517-8132-bb3c5da5a50a.png)<br>
+<br>
+
+#### 4. Blueprint installiert und Automation aktiviert
+Sicherstellen, dass der Blueprint installiert ist:<br>
+ [![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2FBlackymas%2FNSPanel_HA_Blueprint%2Fblob%2Fmain%2Fnspanel_blueprint.yaml)<br>
+![Screenshot 2023-01-30 213511](https://user-images.githubusercontent.com/123868814/215600277-4c66bc36-91d5-40c9-9d81-21bd8be4b114.png)
+
+Sicherstellen, dass eine Automatisierung für das NSPanel erstellt wurde und dass der **ESP Node Name** exakt dem Namen im ESPHome entspricht
+![Screenshot 2023-01-30 214156](https://user-images.githubusercontent.com/123868814/215601843-bb5c31f7-6827-4c95-ac01-6b94e6dfdff4.png)
+
+<br><br><br>
+
+Sobald diese Schritte vorgenommen wurden, sollte sich das Display nach einem kurzen Delay verbinden.

docs/de/howto.md

@@ -0,0 +1,309 @@
+
+In diesem Beitrag werden wir alle wichtigen Dinge zu verschiedenen Themen zusammen tragen, die im Laufe der Zeit uns auffallen. 
+> ### _**HINWEIS! sollte dir bei der Konfiguration etwas auffallen oder du irgendein Problem hattest und es lösen konntest, wäre es für uns und alle anderen in der Community super, wenn du dein Wissen mit uns teilst. Dazu kannst du mir ein kurze Nachricht schreiben und ich nehme es in diesem Beitrag dann mit auf.**_ 
+
+   
+> ### WICHTIG! Wenn du ein Problem bei der Einrichtung oder einer Funktion hast und ein _**"Issue auf Github"**_ eröffnest, beschreibe dein Problem bitte so genau wie möglich. Auch Bilder können hier helfen.
+
+   
+> ### WICHTIG! Wenn du ein _**"Issue"**_ eröffnest, folge bitter der Anleitung sieh hier [Wie erstelle ich "Issues"](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#1-wie-erstelle-ich-issues-wenn-ich-ein-problem-habe)
+
+   
+   
+
+***
+
+    
+# Inhalt:
+
+1. [Wie erstelle ich "Issues" wenn ich ein Problem habe ](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#1-wie-erstelle-ich-issues-wenn-ich-ein-problem-habe) 
+1. [Update Blueprint](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#2-update-blueprint)
+1. [Update ESPHome](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#3-update-esphome)
+1. [Update TFT](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#4-update-tft)
+1. Manueller TFT Upload über lokalen HA (in Arbeit)
+1. Upload TFT Fehler und Lösung (in Arbeit)
+1. [Notification via HA](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#7-notification-via-ha)
+1. [Climate für Relays](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#8-climate-für-relays)
+1. [Interne Switches als Lampe darstellen in HA](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#9-interne-switches-als-lampe-darstellen-in-ha)
+1. Schnell Navigation (in Arbeit)
+1. [Bestimmte Seiten direkt aufrufen](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#11-bestimmte-seiten-direkt-aufrufen)
+1. [RTTTL Sound abspielen](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#12-rtttl-sound-abspielen)
+1. Erweiterte Funktionen und Automatisierungen (in Arbeit)
+1. [Automationen starten via Input_Boolean](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte#14-automationen-starten-via-input_boolean)
+
+
+
+   
+
+***
+
+  
+
+## 1. Wie erstelle ich "Issues" wenn ich ein Problem habe
+> _**Um dein Problem lösen zu können, ist es für uns wichtig so viele Informationen wie möglich zu haben**_
+
+* Probleme können auf DE oder EN erstellt werden.
+* Beschreibe dein Problem so genau wie möglich.
+* Schreibe bitte deine ESPHome und Home Assistant Version 
+* gehe bitte auf deine Automation und dann auf die "3 Punkte" und danach auf _**Als YAML bearbeiten**_. Kopiere den kompletten Code und füge es dem Ticket bei
+* Ein wichtiger "Helfer" beim lösen der Probleme ist der Trace einer Automation. Den Trace findest du unter _**Einstellungen --> Automatisierungen & Szenen --> deine NSPanel Automatisierung --> Traces (rechts oben)**_
+
+> TRACES! Bitte führe erneut aus, was nicht funktioniert und öffne danach sofort den Trace. Oft muss auch nach dem Reboot der trace geöffnet werden. Im Boot werden die meisten Dinge geladen.
+
+> WICHTIG! im Trace kannst du anhand der _**"Orangen"**_ Linien sehen welchen Weg die Automation gegangen ist. Bitte teile uns diesen Weg mit. Außerdem erstelle bitte davon ein oder mehrer Screenshots die du deinem Ticket hinzufügst. Besonders wichtig ist für uns wo die _**"Orangen"**_ Linie aufhört, denn meist ist dort auch das Problem
+
+> WICHTIG! Wenn du den Trace geöffnet hast, gibt es ganz oben die _**"Zeitstempel"**_. Es ist wichtig das du den richtigen Zeitstempel auswählst.
+
+
+### Beispiel Trace nach Reboot:
+![Bildschirmfoto 2022-11-27 um 14 54 58](https://user-images.githubusercontent.com/41958506/204139082-70d3a8d1-1c82-43cb-88f2-573f2e276a48.png)
+
+### Beispiel Automatisierungen Blueprint:
+```
+alias: YYXYYXYYX - NSPanel Configuration
+description: ""
+use_blueprint:
+  path: nspanel_configuration.yaml
+  input:
+    nspanel_name: nspanel_dev
+    language: DE
+    sync_value_ha: select_no
+    sync_slider_ha: select_no
+    weather: AccuWeather
+    accuweather: home_wetter
+    outdoortemp: sensor.terrasse_garage_motion_sensor_temperature
+    humidity: sensor.kinderzimmer_lea_temperatur_sensor_humidity
+    hotwatertemp: sensor.hotwater_temp
+    hotwatercharge: switch.charge
+    heatingsystemflame: binary_sensor.flamestatus
+    climate: climate.nspanel_buro
+    left_button_entity: light.haustur_spot_2
+    right_button_entity: light.haustur_spot_1
+    entity01: light.buro_sideboard
+    entity01_name: Sideboard
+    entity02: cover.kuche_rollo
+    entity02_name: Küche Rollo
+    entity03: switch.buro_dart_beleuchtung
+    entity03_name: Dart Licht
+    delay: 2
+    right_button_name: Test 1
+    left_button_name: Test 2
+```
+
+------
+
+## 2. Update Blueprint
+
+>Derzeit bietet HA nicht die Möglichkeit, Blueprints direkt über das UI upzudaten. Dies muss manuell bspw. über den File Editor geschehen.
+
+>WICHTIG! Um eine neue Version des NSPanels zu installieren, muss zwingend der Blueprint, ESPHome sowie das TFT upgedatet werden!
+
+1. Letztes Release des Blueprints von Github aus dem Repository laden.
+2. Das existierende YAML File "nspanel_blueprint.yaml" im Folder ***./config/blueprints/automation/Blackymas*** mit der neuen Version ersetzen.
+3. Automationen neu laden oder Home Assistant neu starten.
+4. Der neue Blueprint steht zur Verfügung. Bereits vorgenommene Einstellungen werden übernommen.
+   ![BlueprintUpdate](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/BlueprintUpdate.PNG)
+
+------
+
+## 3. Update ESPHome
+
+>WICHTIG! Um eine neue Version des NSPanels zu installieren, muss zwingend der Blueprint, ESPHome sowie das TFT upgedatet werden!
+
+Zum ESPHome Update auf die ESPHome Integration gehen. 
+
+Dann die Konfiguration validieren:
+
+![image-20230203111717731](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/image-20230203111717731.png)
+
+Wenn die Validierung durchgelaufen ist, erscheint ein grünes Checkmark im oberen Bereich des Fensters. Danach auf "Install" klicken:
+
+![image-20230203111838285](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/image-20230203111838285.png)
+
+Ein neues Fenster öffnet sich, hier die gewünschte Verbindung zum Panel auswählen:
+
+![image-20230203111919475](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/image-20230203111919475.png)
+
+Danach startet der Installationsvorgang. Dies kann ein paar Minuten in Anspruch nehmen:
+
+![image-20230203112632305](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/image-20230203112632305.png)
+
+------
+
+## 4. Update TFT
+
+>WICHTIG! Um eine neue Version des NSPanels zu installieren, muss zwingend der Blueprint, ESPHome sowie das TFT upgedatet werden!
+
+Das Update des Displays kann über das UI erfolgen:
+
+1. Im Menü ***Einstellungen --> Geräte & Services  --> Integrationen*** unter der ESPHome Integration das Display auswählen.
+
+2. Unter Configuration den Switch "Update TFT Display" drücken.
+
+3. Das Display beginnt den Update Prozess und startet anschließend neu.
+
+   ![DisplayUpdate](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/DisplayUpdate.PNG)
+
+------
+
+## 5. Manueller TFT Upload über lokalen HA
+
+In Arbeit
+
+------
+
+## 6. Upload TFT Fehler und Lösung 
+
+In Arbeit
+
+------
+
+## 7. Notification via HA
+
+Um eine Notification auf dem NSPanel anzeigen zu lassen, kann folgender Service Call verwendet werden:
+
+```
+service: esphome.panelname_notification_show
+data:
+  label: Example text
+  text: Example text
+```
+
+Um die Notifications auf dem Panel zu bestätigen, kann folgender Service Call verwendet werden:
+
+```
+service: esphome.panelname_notification_clear
+data: {}
+```
+
+
+Die Notifications können einfach in eine Automation mit aufgenommen werden:
+
+```
+description: ""
+mode: single
+trigger:
+  - platform: state
+    entity_id:
+      - binary_sensor.motion_detector
+    to: "on"
+    condition: []
+    action:
+  - service: esphome.panelname_notification_show
+    data:
+      label: Motion Detected
+      text: Example for a Notification on the Panel Screen
+```
+
+
+------
+
+## 8. Climate für Relays
+
+Um das NSPanel zur Steuerung eines Heizkörpers oder einer Fussbodenheizung zu nutzen, muss im HA mindestens ein Generic Thermostat angelegt sein. Siehe hierzu: https://www.home-assistant.io/integrations/generic_thermostat/
+
+Beispielkonfiguration Generic Thermostat:
+
+```
+climate:
+  - platform: generic_thermostat
+    name: Study
+    heater: switch.study_heater ## Wenn das NSPanel Relays den Heizkreis Regler schaltet, kann dieser hier definiert werden
+    target_sensor: sensor.study_temperature ## Hier kann der NSPanel Sensor verwendet werden
+    min_temp: 15
+    max_temp: 21
+    ac_mode: false
+    target_temp: 17
+    cold_tolerance: 0.3
+    hot_tolerance: 0
+    min_cycle_duration:
+      seconds: 5
+    keep_alive:
+      minutes: 3
+    initial_hvac_mode: "off"
+    away_temp: 16
+    precision: 0.1
+```
+
+Danach muss die climate.entity noch entsprechend in der Panel Configuration hinterlegt werden:![climate](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/climate.PNG)
+
+------
+
+## 9. Interne Switches als Lampe darstellen in HA
+
+In der Welt von Home Assistant ist das Relays im NSPanel ein Schalter. Und obwohl das im Allgemeinen richtig ist, werden diese Relays oft z. B. für eine Leuchte oder einen Ventilator verwendet. Wenn nun bspw. eine Lampe direkt mit dem Relays geschaltet wird, so ist es wünschenswert, dass auch im HA der Switch als Lampe angezeigt wird oder diese "Lampe" einer Lichter-Gruppe hinzugefügt werden soll.
+
+Mit der Switch as X-Integration können diese Schalter in die Entitätstypen umwandeln, die dem jeweiligen Anwendungsfall am besten entsprechen: https://www.home-assistant.io/integrations/switch_as_x/ 
+
+![Swichasx](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/Swichasx.png)
+
+
+
+------
+
+## 10. Schnell Navigation
+
+In Arbeit
+
+------
+
+## 11. Bestimmte Seiten direkt aufrufen
+
+Manchmal kann es Sinn machen, automatisch eine bestimmte Seite des Displays anzeigen zu lassen. Um dies zu tun, kann folgender Service genutzt werden:
+
+```
+service: esphome.nspanel_send_command_printf
+data:
+  cmd: page home
+```
+
+Um bspw. direkt die Button Page 2 anzuzeigen, muss "home" durch "buttonpage02" ersetzt werden.
+
+Folgende Seiten sind derzeit verfügbar:
+
+![img](./assets/Bildschirmfoto_2023-03-21_um_00.24.01.png)
+
+------
+
+## 12. RTTTL Sound abspielen
+
+HA kann ein RTTTL an das NSPanel schicken, dabei sind eigene Melodien möglich. 
+
+Hierzu wird folgender Service verwendet: ***nspanel_play_rtttl*** 
+
+Man findet viele RTTTL-Strings im Web, wichtig ist, dass diese mit dem Namen und dann einem Doppelpunkt beginnen müssen. 
+
+Hier ein Beispiel:
+
+```
+The Simpsons:d=4,o=5,b=160:c.6,e6,f#6,8a6,g.6,e6,c6,8a,8f#,8f#,8f#,2g,8p,8p,8f#,8f#,8f#,8g,a#.,8c6,8c6,8c6,c6
+```
+
+![image-20230320222454441](./assets/image-20230320222454441.png)
+
+Mehr Informationen unter: https://esphome.io/components/rtttl.html#common-beeps
+
+Mehr Songs hier: https://codebender.cc/sketch:109888#RTTTL%20Songs.ino
+
+------
+
+## 13. Erweiterte Funktionen und Automatisierungen
+
+In Arbeit
+
+------
+
+## 14. Automationen starten via Input_Boolean
+
+Obwohl mit dem NSPanel Scripts direkt über die Buttons gestartet werden können, gibt es auch die Möglichkeit, mittels Input_Boolean direkt Automationen zu starten.
+
+Hierzu muss erst ein Helper angelegt werden unter ***Settings --> Devices&Services --> Helpers***, siehe hierzu: https://www.home-assistant.io/integrations/input_boolean/![Toggle1](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/Toggle1.PNG)
+
+Anschliessend wird der erstellte Input_Boolean als Trigger in eine beliebige Automation aufgenommen unter State:![Toggle2](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/Toggle2.PNG)
+
+Im letzten Schritt den Trigger noch einem Button in der Panel Config zuordnen:![Toggle3](./(DE)-HowTo---Alle-wichtigen-Dinge-die-man-wissen-sollte.assets/Toggle3.PNG)
+
+
+
+------
+

docs/de/install.md

@@ -0,0 +1,190 @@
+In diesem Beitrag geht es um die erst Konfiguration. Hier werden alle wichtigen Schritte zur Installation und Einrichtung von ESPHome und dem Blueprint beschrieben. 
+
+⭐ **_Step by Step [Einrichtungs Video](https://www.youtube.com/watch?v=3afPFg6kUdc)_**
+
+ 
+> ### _**ACHTUNG! solltest du vorher bereits auf deinem NSPanel die Version "nspanel-lovelace-ui" von joBr99 eingerichtet haben, ist ein zwischen Schritt nötig - sonst ist es nicht möglich diese oder irgendeine andere Version zu installieren**_ 
+
+   
+   
+
+***
+
+    
+# Inhalt:
+
+1. [Kurz Version der Einrichtung von Esphome und Blueprint](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-Erste-Schritte---Installation-und-Einrichtung#1-kurz-version-der-einrichtung-von-esphome-und-blueprint) 
+
+2. [Version "nspanel-lovelace-ui" von joBr99 wurde vorher installiert](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-Erste-Schritte---Installation-und-Einrichtung#2-version-nspanel-lovelace-ui-von-jobr99-wurde-vorher-installiert)
+
+3. [Advance Modus für ESPHome und HA Profis](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-Erste-Schritte---Installation-und-Einrichtung#3-advanced-configuration-für-alle-esphome-und-home-assistant-profis)
+
+4. [Step by Step Einrichtung und Konfiguration](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-Erste-Schritte---Installation-und-Einrichtung#4-step-by-step-konfiguration-und-einrichtung-von-esphome-und-blueprint) 
+
+   
+
+***
+
+   
+   
+
+## 1. Kurz Version der Einrichtung von Esphome und Blueprint
+> _**(für alle die bereits mit ESPhome und Home Assistant Erfahrung haben)**_
+
+#### 1. Als erstes muss das Blueprint installiert werden. Dazu nutze bitte folgenden Link
+
+[![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2FBlackymas%2FNSPanel_HA_Blueprint%2Fblob%2Fmain%2Fnspanel_blueprint.yaml)
+
+> Es ist auch möglich den Code aus der Datei _**"nspnael_blueprint.yaml"**_ zu kopieren und in HA einzufügen.
+> Hinweise dazu findest du unter [Using Automation Blueprints](https://www.home-assistant.io/docs/automation/using_blueprints/) und [Automation blueprint tutorial](https://www.home-assistant.io/docs/blueprint/tutorial/#create-the-blueprint-file)
+
+#### 2. Nun muss von Github das File **_"nspanel_eu.tft"_** oder **_"nspanel_us.tft"_**heruntergeladen werden 
+
+![Bildschirmfoto 2023-01-23 um 21 31 05](https://user-images.githubusercontent.com/41958506/214161397-ec927f77-be77-433d-84a5-79fbfed33932.png)
+
+
+#### 3. Das File muss nun auf deinen Home Assistant Server in den Ordner **_"www"_** hochgeladen werden. Siehe dazu auch hier [Home Assistant HTTP](https://www.home-assistant.io/integrations/http/#hosting-files) 'Hosting Files' Bereich für weiter Informationen.
+
+![Bildschirmfoto 2023-01-23 um 21 33 20](https://user-images.githubusercontent.com/41958506/214162088-3bd67e46-c389-496f-a937-757ad63e1fe2.png)
+
+#### 4. im nächsten Schritt muss eine neues ESP32 Device in ESPHome erstellt werden
+
+#### 5. wenn das neue ESP32 Device erstellt wurde, klicke als nächstes bei dem soeben angelegten Device auf _**"Edit"**_ um den Web-Editor zu öffnen. Nun muss folgender Code kopiert und eingesetzt werden.
+
+> ❗ _**WICHTIG!**_ Der bereits vorhanden Code in der ESPHome Datei muss _**"KOMPLETT"**_ gelöscht werden und durch den unten stehenden Code _**"ERSETZT"**_ werden.
+
+> ❗ _**WICHTIG!**_ im Block _**"CHANGE ME"**_ müssen alle Werte _**(device_name, wifi_ssid, wifi_password)**_ in den _**" "**_ durch deine eigenen Werte ersetzt werden. Es ist hier auch möglich mit _**"!secret"**_ zu arbeiten
+
+
+> ⚠️ _**ACHTUNG!**_ es dürfen bei _**"device_name"**_ max. 15 Zeichen _**[a-z] und [0-9]**_ verwendet werden und alles müssen _**"Kleinbuchstaben"**_ sein. Weiterhin sind Zeichen wie _**[-],  [SONDERZEICHEN] und [LEERZEICHEN]**_ verboten und führen zu Problemen mit dem Blueprint.
+
+> **Beispiel:** _**nspanel_blackymas**_
+
+ 
+### CODE:
+```
+substitutions:
+
+###### CHANGE ME START ######
+
+  device_name: "YOUR NSPANEL_NAME" 
+  wifi_ssid: "YOUR WIFI SSID"
+  wifi_password: "YOUR WIFI PASSWORD"
+
+  nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel_eu.tft" # URL to local tft File
+#  nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel_eu.tft" # URL to Github
+
+##### CHANGE ME END #####
+
+
+
+##### DO NOT CHANGE ANYTHING! #####
+
+packages:
+  ##### download esphome code from Github
+  remote_package:
+    url: https://github.com/Blackymas/NSPanel_HA_Blueprint
+    ref: main
+    files: [nspanel_esphome.yaml]
+    refresh: 1s
+
+esp32:
+  framework:
+    type: esp-idf
+
+##### DO NOT CHANGE ANYTHING! #####
+```
+
+
+> Im Pfad **_http://HOME-ASSISTANT-IP:8123/local/nspanel_eu.tft_** muss nun die IP Adresse von deinem _**Home Assistant Server**_ eingetragen werden. (_**/local/**_ ist das selbe Verzeichnis wie **_"www"_**
+>
+> 
+
+> Das kann dann wie folgt aussehen **_http://192.168.1.1:8123/local/nspanel_eu.tft_**
+
+> ⚠️ **_ACHTUNG_** Du kannst auch den Pfad zu Github verwenden **_https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel_eu.tft_** und das TFT direkt von Github herunter laden. Aber dabei kann es zu Problemen mit dem Upload zum NSPanel kommen. Das hängt von deinem Internet und WLAN ab. Für mehr Informationen zu diesem Thema schauen auf der **_Issue_** Seite im Github. Das ganze sollte dann so aussehen
+
+```
+#  nextion_update_url: "http://HOME-ASSISTANT-IP:8123/local/nspanel_eu.tft" # URL to local tft File
+  nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel_eu.tft" # URL to Github
+```
+
+> ⚠️ **_ACHTUNG_** soll das US Layout des Panels verwendet werden, dann muss anstelle von "nspanel_eu.tft" in der nextion_update_url "nspanel_us.tft" verwendet werden! 
+
+#### 6. Jetzt kann das NSPanel mit dem neuen ESPHome Code geflasht werden 
+> wie das NSPanel geflasht wird kannst du dir hier ansehen [Anleitung - Flash Sonoff NSPanel mit ESPHome](https://www.youtube.com/watch?v=3afPFg6kUdc)
+
+#### 7. Nachdem das NSPanel fertig geflasht wurde, kannst du unter _**"Einstellungen --> Geräte & Dienste --> Integration hinzufügen"**_ dein neues Gerät hinzufügen und fertig einrichten
+
+#### 8. im letzten Schritt muss nun nur noch das TFT hochgeladen werden. Dazu öffne in der Integration ESPHome dein neues Device und aktiviere unter _**"Konfiguration"**_ den Punkt _**"Update TFT display"**_. Jetzt wird von deinem lokalen Home Assistant Server oder Github das aktuelle TFT File geladen und auf dein NSPanel hochgeladen. _**ACHTUNG!**_ dieser Vorgang kann einen Moment dauern
+
+#### 9. jetzt ist die Einrichtung vom ESPHome und dem NSPanel abgeschlossen.
+
+#### 10. Nun kannst du über das Blueprint dein NSPanel konfigurieren. Dazu gehe auf _**"Einstellungen --> Automatisierungen & Szenen --> Vorlagen --> NSPanel Configuration --> AUTOMATISIERUNG ERSTELLEN"**_ und starte mit der Einrichtung vom NSPanel.
+
+> **HINWEIS!** Trage im Blueprint im Feld _**"ESPHOME Node Name"**_ exakt den selben Namen ein, den du in der _**"ESPHome Datei"**_ vergeben hast.
+
+> **Beispiel:** _**nspanel_blackymas**_
+
+
+
+   
+   
+
+***
+
+   
+   
+##  2. Version "nspanel-lovelace-ui" von joBr99 wurde vorher installiert
+> _**in der Version "nspanel-lovelace-ui" von joBr99 sind ein paar Besonderheiten eingebaut, die es nicht so einfach ermöglichen eine neue Version und TFT auf das NSPanel zu flashen. Da wir dieses Problem aber schon hatten, haben wir natürlich auch schon eine Lösung für euch ;)**_
+
+### _**Es ist notwendig eine "Leeres TFT" Datei hochzuladen, solange "Lovelace ui" noch auf dem NSPanel installiert ist.**_
+
+> WICHTIG! Wenn du bereits das NSPanel mit meiner Version installiert hast, musst du zuerst wieder "Lovelace ui" vollständig installieren.
+
+### Folgende Schritte sind notwendig:
+
+1. lade dir aus dem Ordner _**custom_configuration**_ die Datei _**"nspanel_blank.tft"**_ herunter.
+2. lade nun die TFT Datei _**"nspanel_blank.tft"**_ in den Ordner _**"www"**_ in Home Assistant hoch
+3. gehe jetzt zu dem Punkt _**"Entwicklerwerzeuge --> Dienste"**_ und suche dort nach dem Dienst
+   
+_**"ESPHome: DEVICE_NAME_upload_tft"**_  --> (esphome.device_name_upload_tft)
+4. unter URL musst du jetzt den Pfad zu deiner Datei _**nspanel_blank.tft**_ eingeben. Das könnte zum Beispiel so aussehen _**"http://IP_HOME_ASSISTANT:8123/local/nspanel_blank.tft"**_
+5. nun sollte die TFT Datei auf das NSPanel gespielt werden. Es kann einen Moment dauern, bis es fertig ist
+6. sollte alles funktioniert haben, sollte auf dem NSPanel nur eine weiße Seite zu sehen sein
+7. jetzt kann mit der Einrichtung und Konfiguration meiner Version fortgesetzt werden. Dazu siehe [Kurz Version der Einrichtung von Esphome und Blueprint](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-Erste-Schritte---Installation-und-Einrichtung#1-kurz-version-der-einrichtung-von-esphome-und-blueprint) 
+
+
+
+
+
+   
+   
+
+***
+
+   
+   
+##  3. Advanced configuration für alle ESPHome und Home Assistant Profis
+
+* Blueprint Datei _**"nspnael_blueprint.yaml"**_ kann auch manuell installiert werden
+* ESPHome Datei_**"nspanel_esphome.yaml"**_ kann auch manuell installiert werden. Dadurch können weitere _**"Advanced"**_ Konfigurationen aktiviert oder hinzugefügt werden.
+* Außerdem besteht die Möglichkeit das TFT File _**"nspanel_eu.tft"**_ manuell hochzuladen. Das Ganze kann auch mit einem _**"Folder Watcher"**_ kombiniert werden
+* zusätzlich stellen wir die HMI Datei _**"nspanel_eu.HMI"**_ für den Nextion Editor zur Verfügung, um Grafiken und Programmierung bei bedarf anpassen zu können
+
+> _**ACHTUNG!**_ Wer diesen Modus benutzt, sollte wissen was er tut. Wir geben hier keinen Support!
+
+
+
+
+
+
+   
+   
+
+***
+
+   
+   
+##  4. Step by Step Konfiguration und Einrichtung von ESPHome und Blueprint
+> _**(für alle die neu im Thema ESPhome sind oder noch keine Erfahrungen gesammelt haben)**_

docs/de/tft_upload.md

@@ -0,0 +1,29 @@
+> ### _**ACHTUNG! Wenn bereits die Version "nspanel-lovelace-ui" von joBr99 auf dem NSPanel installiert ist, ist ein Zwischenschritt notwendig - ansonsten ist es nicht möglich, diese oder eine andere Version zu installieren.**_ 
+>Siehe hierzu [Installation und Einrichtung](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-Erste-Schritte---Installation-und-Einrichtung#2-version-nspanel-lovelace-ui-von-jobr99-wurde-vorher-installiert)
+<br>
+
+> ### _**Die frühere Methode, bei der NSPanel das TFT direkt von GitHub heruntergeladen hat, wurde eingestellt, da eine große Anzahl von Benutzern langsame oder fehlgeschlagene Downloads verzeichnete. Daher muss der Upload nun mit einer lokal gehosteten tft-Datei vorgenommen werden**_ 
+
+Es gibt eine Reihe von Problemen, die das Hochladen des TFT-Uploads beeinträchtigen können. Diese Probleme betreffen nicht das NSPanel HA Blueprint-Projekt, sondern scheinen bei Nextion-Displays und ESPhome aufzutreten. Nicht alle der unten genannten Ursachen betreffen alle Benutzer, jedoch haben die folgenden Massnahmen unter jedem Punkt zu einer Lösung geführt.
+
+<br>In order of likelihood:
+
+#### 1. Eine lokale Datenquelle verwenden (Home Assistant) 
+Dies ist die häufigste Ursache für Probleme und der Grund, warum unsere Anleitung nicht mehr auf das Herunterladen des TFT von GitHub verweisen. Durch Ändern der nextion_update_url zum Hosten der TFT-Datei auf dem lokalen HA werden die meisten Probleme gelöst.
+
+Siehe hierzu Punkt 2-4 in den [Installation und Einrichtung](https://github.com/Blackymas/NSPanel_HA_Blueprint/wiki/(DE)-Erste-Schritte---Installation-und-Einrichtung#2-version-nspanel-lovelace-ui-von-jobr99-wurde-vorher-installiert) 
+<br><br>
+
+#### 2. HTTP anstelle von HTTPS
+Während HTTPS für einige Benutzer funktionieren kann, mussten wir feststellen, dass es eine Reihe von Problemen verursachen kann. Eine Möglichkeit ist, das  TFT-Dateihosting und nextion_update_url auf HTTPS umzustellen.
+<br><br>
+
+#### 3. Netzwerkprobleme
+Eine instabile Netzwerkverbindung kann zu Verbindungsabbrüchen führen. Das NSPanel näher an den WiFi Zugangspunkt zu bringen, oder den Router neu zu starten sind zwei Möglichkeiten, dieses Problem zu lösen.
+Wenn die Fehlermeldung _Connection Refused_ oder _Connection Reset_ erscheint, ist dies das häufigste Problem.
+<br><br>
+
+#### 4. DNS
+Ähnlich wie Punkt 2, sollte eine IP Adresse statt die DNS Auflösung verwendet werden: 
+
+also http://192.168.0.100:8123/local/nspanel.tft anstelle von http://homeassistant.local:8123/local/nspanel.tft

docs/de/weather.md

@@ -0,0 +1,36 @@
+## Konfiguration
+
+#### Im Home Assistant NSPanel Blueprint
+Im Blueprint muss als Integration "Accuweather" ausgewählt werden und die Weather Entitiy von AccuWeather (bspw. Home) ausgewählt werden:<br> 
+![Screenshot 2023-01-30 214603](https://user-images.githubusercontent.com/123868814/215602716-60d92287-943f-465b-aac7-8b47795ef608.png)<br>
+<br>
+
+#### AccuWeather Vorhersage aktivieren
+
+Unter Settings - Devices&Services - Accuweather - Configure muss der Haken bei "Weather forecast" gesetzt sein:
+
+![Screenshot 2023-01-30 214638](https://user-images.githubusercontent.com/123868814/215602723-7732578b-3870-4c1a-baec-5ebee98b37ad.png)<br>
+<br>
+
+#### Überprüfen in Developer Tools
+
+#### In developer tools the weather entity should have the attribute 'attribution: Data provided by AccuWeather'<br>
+
+Unter Developer Tools - States kann die AccuWeather integration überprüft werden. Die Weather Entity (hier im Beispiel weather.home) muss das Attribute "attribution: Data provided by Accuweather" haben:
+
+#### ![Screenshot 2023-01-30 214739](https://user-images.githubusercontent.com/123868814/215602730-87093a5d-1a67-460d-9a9c-27a93371ea82.png)<br>
+<br>
+
+<br>
+
+## Wenn das Problem immer noch besteht
+Es kann in Einzelfällen vorkommen, dass mehrere Wetter Integrationen nicht zusammen funktionieren. Um dies zu beheben, empfehlen wir ALLE Wetter Integrations zu löschen und AccuWeather neu hinzuzufügen. Achtung: Dabei werden alle assoziierten Daten sowie Entities gelöscht!!
+
+Das Vorgehen ist wie folgt:
+
+#### 1. Löschen der Standard und AccuWeather Integration
+
+#### 2. Hinzufügen der AccuWeather Integration & Aktivieren der Vorhersage
+
+#### 3. In der Blueprint Automation des NSPanels AccuWeather hinzufügen und die Entität auswählen
+