(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)
- Als erstes muss das Blueprint installiert werden. Dazu nutze bitte folgenden Link
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
-
im nächsten Schritt muss eine neues ESP32 Device in ESPHome erstellt werden
-
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 ######
device_name: "YOUR NSPANEL_NAME"
wifi_ssid: "YOUR WIFI SSID"
wifi_password: "YOUR WIFI PASSWORD"
##### CHANGE ME #####
##### DO NOT CHANGE ANYTHING! #####
nextion_update_url: "https://raw.githubusercontent.com/Blackymas/NSPanel_HA_Blueprint/main/nspanel.tft"
packages:
##### download esphome code from Github
remote_package:
url: https://github.com/Blackymas/NSPanel_HA_Blueprint
ref: main
files: [nspanel_esphome.yaml]
refresh: 300s
##### DO NOT CHANGE ANYTHING! #####
- Jetzt kann das NSPanel mit dem neuen ESPHome Code geflasht werden
wie das NSPanel geflasht wird kannst du dir hier ansehen HOW TO - Flash Sonoff NSPanel with ESPHome
-
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
-
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 aus Github das aktuelle TFT File geladen und auf dein NSPanel hochgeladen. ACHTUNG! dieser Vorgang kann einen Moment dauern
-
jetzt ist die Einrichtung vom ESPHome und dem NSPanel abgeschlossen.
-
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.tft" manuell hochzuladen. Das Ganze kann auch mit einem "Folder Watcher" kombiniert werden
- zusätzlich stellen wir die HMI Datei "nspanel.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)