Smarthome-BlogESPHome mit Web Installer flashen

ESPHome mit Web Installer flashen

Für ESP8266 oder ESP32

Lesezeit: 7 min

Veröffentlicht: 2024.04.26

Letztes Update: 2024.04.26

ES8266 mit ESPHome

In dieser Anleitung zeige ich euch den, meiner Meinung nach, einfachsten Weg euren ESP8266 oder ESP32 mit ESPHome zu flashen und in Homeassistant einzubinden. Wir werden dafür den offiziellen ESPHome Web-Installer verwenden.

Voraussetzungen

  • Ein ESP8266 oder ESP32 mit Micro-USB oder USB-C Anschluss.
  • Ein passendes USB-Kabel. Achtung: Nicht alle USB-Kabel haben eine Datenleitung (Diese dienen dann nur zum Aufladen von Geräten). Ihr braucht jedoch ein solches. Solltet ihr also nicht weiter kommen, testet verschiedene Kabel. (Und legt euch das Funktionierende für zukünftige Projekte am besten gleich zur Seite)
  • Einen Computer auf dem Windows läuft und auf dem der Chrome Webbrowser installiert ist. Ich benutze bevorzugt Linux, habe es damit aber nicht zum Laufen bekommen. Mit MacOS habe ich leider keine Erfahrungen.

ESPHome flashen

Den Web-Installer findet ihr unter folgendem Link:
https://web.esphome.io/

Ihr werdet mit folgendem Interface begrüßt:

ESPHome Webinstaller Welcome Screen

Jetzt verbindet ihr eure ESP Platine über das USB-Kabel mit eurem Computer und klickt auf CONNECT.
Im darauf folgenden Menü wählt ihr euren USB-Anschluss aus. Im Normalfall wird hier nicht mehr als 1 Eintrag zur Auswahl stehen.
Falls ihr nichts sehen könnt, versucht es mit einem anderen USB-Kabel.

Wurde die Verbindung erfolgreich hergestellt, seht ihr folgenden Dialog:

ESPHome Web Installer Prepare for first use

Nun klickt ihr auf PREPARE FOR FIRST USE, es folgt:

ESPHome Webinstaller Install

Ihr klickt auf INSTALL.
Anschließend die Installation abwarten, es kann ein paar Minuten dauern.
Danach erhaltet ihr eine Meldung, welche die erfolgreiche Installation bestätigt:

ESP Home Web Installer Configuration Installed

Im nun folgenden Fenster könnt ihr euren ESP direkt mit eurem WLAN verbinden:

ESPHome Webinstaller Connect to WIFI

Ihr wählt CONNECT TO WI-FI.
Anschließend könnt ihr euer WLAN auswählen und euer Passwort eingeben.
Nach einer erneuten kurzen Wartezeit solltet ihr die Bestätigung erhalten, dass die Installation jetzt erfolgreich abgeschlossen ist:

ESPHome Webinstaller Installation abgeschlossen
Falls ihr bei der Einrichtung des WLANs eine Fehlermeldung bekommt, könnt ihr euch stattdessen direkt mit dem WLAN des ESP verbinden, welches nach der erfolgreichen Installation aktiv sein sollte. Dort könnt ihr dann im Web-Interface ebenfalls die Zugangsdaten für euer WLAN eingeben und der ESP wird sich entsprechend verbinden.

Einrichtung in Homeassistant

In Homeassistant wechselt ihr in die ESPHome Integration. Dort sollte euer neuer ESP nach kurzer Zeit von selbst auftauchen. Nun müsst ihr ADOPT anklicken:

Homeassistant ESPHome Integration

Im nun folgenden Fenster könnt ihr eurem ESP einen Namen geben:

Homeassistant ESPHome Integration Benennen und Adopt

Nun klickt ihr wieder auf ADOPT. Dadurch wird eure initiale Konfiguration für den ESP erstellt. Zur Bestätigung seht ihr folgenden Dialog:

ESP Home Web Installer Configuration Created

Den Encryption Key könnt ihr, wenn ihr wollt, vorläufig in ein Textdokument kopieren. Das ist aber nicht unbedingt notwendig, weil dieser sowieso in der Konfigurationsdatei enthalten ist, wie wir gleich sehen werden.
Ihr klickt erneut auf INSTALL.
Jetzt wird eure Konfiguration auf den ESP übertragen. Es werden eine Menge Log-Einträge angezeigt. Abschließend solltet ihr jedoch OTA Successfully sehen:

ESP Home Webinstaller OTA Successful

Mit Klick auf EDIT kommt ihr zum Konfigurations-Code für euren ESP.
Direkt nach der Installation sollte dieser ca. so aussehen:

YAML

esphome:
  name: esphome-web-739a1d
  friendly_name: Rollo Büro

esp8266:
  board: esp01_1m

# Enable logging
logger:

# Enable Home Assistant API
api:
  encryption:
    key: (Euer Encryption Key)

ota:


wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: "Esphome-Web-739A1D"
    password: (Fallback Hotspot Passwort)

captive_portal:

Ihr seht, dass die SSID und das Passwort für euer WLAN per !secret eingefügt wird. Ich empfehle euch, euren Encryption Key und das Passwort für den Fallback-Hotspot auf dieselbe Weise einzubinden.
Um Secret-Werte festzulegen, geht zurück in das Hauptmenü der ESPHome Integration und klickt rechts oben auf SECRETS.
Dort könnt ihr eure Werte eingeben und anschließend auf SAVE klicken.

Des weiteren Empfehle ich euch, name nach eurem Bedarf anzupassen und bei board den Wert zu setzen, welcher für euer Board passt. In meinem Fall ist es ein d1_mini.

Nun sollte eure Konfiguration so ähnlich aussehen:

YAML

esphome:
  name: rollo_buero
  friendly_name: Rollo Büro

esp8266:
  board: d1_mini

# Enable logging
logger:

# Enable Home Assistant API
api:
  encryption:
    key: !secret esp_rollo_buero_api_key

ota:


wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: "Esphome-Web-739A1D"
    password: !secret esp_rollo_buero_fallback_hotspot

captive_portal:

Mit Klick auf SAVE und anschließend INSTALL wird eure Konfiguration wieder auf den ESP übertragen. Es gibt verschiedene Möglichkeiten der Übertragung. Wenn ihr so weit gekommen seit, könnt ihr aber einfach Wirelessly auswählen und die Daten werden direkt über euer WLAN übertragen.

Als letzten Schritt müsst ihr euren neuen ESP noch für Homeassistant selbst konfigurieren. Geht dazu unter Settings in das Menü Devices & Services. Oben wird euer neuer ESP unter Discovered angezeigt:

Homeassistant neues Gerät Discovered

Ihr klickt auf Configure und anschließend auf Submit. Abschließend erscheint eine Erfolgsmeldung, in der ihr den ESP noch einem Raum zuweisen könnt:

Homeassistant Installation Erfolgreich

Von hier an stehen euch alle Türen offen, mit eurem ESP coole Projekte umzusetzen. Solltet Ihr Fragen oder Verbesserungsvorschläge haben, kontaktiert mich gerne.

Keinen Beitrag mehr verpassen:

Feedback Me: