Skip to main content

ESPHome-Device über eine lokale Python Umgebung in Windows installieren

Stand 02.206 funktioniert die Installation von esphome nur auf Python 3.13.
Bei Python 3.14 gibt es einen Fehler bei der Installation von ruamel.yaml.clib.

Vorbereitung

Alles in der Eingabeaufforderung als Administrator ausführen!

Für die Installation wird Git benötigt
winget install --id Git.Git -e --source winget
Eine neue virtuele Umgebung für Python erstellen
python -m venv "C:\Program Files\Python314\esphome"
Die virtuele Umgebung aktivieren
"C:\Program Files\Python314\esphome\Scripts\activate.bat"

Die virtuelle Umgebung wird nun durch ein vorangestelltes (esphome) angezeigt. 
Alle weiteren Befehle erfolgen in der virtuellen Umgebung.

PIP auf die neueste Version bringen
python.exe -m pip install --upgrade pip
ESPHome in der virtuellen Umgebung installieren
pip install esphome
Die yaml-Dateien des Projekts in den Ordner kopieren

ESPHome WasserMeter Sensor (Beispieldateien)

cp c:\Users\User\Desktop\WaterMeter.yaml c:\Program Files\Python314\esphome\Scripts
cp c:\Users\User\Desktop\secret.yaml c:\Program Files\Python314\esphome\Scripts

Hier sind es zwei Dateien da die Informationen für das WLAN extra in der Datei secret.yaml stehen.

Die Verbindungseinstellungen anzeigen

Bei gedrückter Boot-Taste den Espressif-Microcontroller an den USB-Port anstecken. Der Befehl mode zeigt dann den Gerätestatus mit den Verbindungseinstellungen.

mode

Falls keine Verbindungseinstellungen angezeigt werden, ist das USB-Kabel ein reines Ladekabel.

Die Programmierung durchführen

(esphome) c:\Program Files\Python314\esphome\Scripts>esphome run WaterMeter.yaml --device COM3