ESPHome mit Web Installer flashen

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:

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:

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

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:

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

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:

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:

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

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

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:

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

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:

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:

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:

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.