(DE) Erste Schritte Installation und Einrichtung
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
(für alle die bereits mit ESPhome und Home Assistant Erfahrung haben)
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 und Automation blueprint tutorial
3. Das File muss nun auf deinen Home Assistant Server in den Ordner "www" hochgeladen werden. Siehe dazu auch hier Home Assistant HTTP 'Hosting Files' Bereich für weiter Informationen.
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
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!
wie das NSPanel geflasht wird kannst du dir hier ansehen Anleitung - Flash Sonoff NSPanel mit ESPHome
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
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
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.
- lade dir aus dem Ordner custom_configuration die Datei "nspanel_blank.tft" herunter.
- lade nun die TFT Datei "nspanel_blank.tft" in den Ordner "www" in Home Assistant hoch
- gehe jetzt zu dem Punkt "Entwicklerwerzeuge --> Dienste" und suche dort nach dem Dienst
"ESPHome: DEVICE_NAME_upload_tft" --> (esphome.device_name_upload_tft) - 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"
- nun sollte die TFT Datei auf das NSPanel gespielt werden. Es kann einen Moment dauern, bis es fertig ist
- sollte alles funktioniert haben, sollte auf dem NSPanel nur eine weiße Seite zu sehen sein
- jetzt kann mit der Einrichtung und Konfiguration meiner Version fortgesetzt werden. Dazu siehe Kurz Version der Einrichtung von Esphome und Blueprint
- 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!
(für alle die neu im Thema ESPhome sind oder noch keine Erfahrungen gesammelt haben)