ESPHome Build-Umgebung

Diese Build-Umgebung nutzt Docker für Builds (ESPHome 2025.10.3) und native Tools für Flash/Logs auf macOS.

Voraussetzungen

• Docker installiert und laufend
• Python 3 mit venv
• USB-Verbindung zum ESP32 (Port: /dev/cu.usbmodem1101)

Schnellstart

1. Python venv einrichten (einmalig)

python3 -m venv venv
source venv/bin/activate
pip install esptool pyserial

2. Projekt kompilieren

./build.sh basic_setup.yaml

oder für die volle Konfiguration:

./build.sh full_setup.yaml

3. Auf ESP32 flashen

./flash-native.sh basic_setup.yaml

Mit anderem Port:

./flash-native.sh basic_setup.yaml /dev/cu.usbserial-14320

4. Logs anzeigen

./logs-native.sh

Mit anderem Port:

./logs-native.sh /dev/cu.usbserial-14320

Beenden mit Ctrl+]

5. Build-Cache löschen (bei Problemen)

./clean.sh basic_setup.yaml

Vollständiger Workflow

# 1. Build
./build.sh basic_setup.yaml

# 2. Flash
./flash-native.sh basic_setup.yaml

# 3. Logs anzeigen
./logs-native.sh

Troubleshooting

Port nicht gefunden

Liste verfügbare Ports:

ls -l /dev/cu.*

esptool nicht gefunden

Installiere im venv:

source venv/bin/activate
pip install esptool

Build-Fehler

Lösche den Cache und versuche erneut:

./clean.sh basic_setup.yaml
./build.sh basic_setup.yaml

Docker Volume zurücksetzen

docker volume rm esphome-cache

Manuelle Commands

Build:

docker run --rm -v "${PWD}":/config -v esphome-cache:/config/.esphome \
  ghcr.io/esphome/esphome:2025.10.3 compile basic_setup.yaml

Clean:

docker run --rm -v "${PWD}":/config -v esphome-cache:/config/.esphome \
  ghcr.io/esphome/esphome:2025.10.3 clean basic_setup.yaml

Flash (manuell):

source venv/bin/activate
esptool.py --port /dev/cu.usbmodem1101 --chip esp32s3 write_flash \
  0x0 bootloader.bin 0x8000 partitions.bin 0x10000 firmware.bin

Logs (manuell):

source venv/bin/activate
python3 -m serial.tools.miniterm /dev/cu.usbmodem1101 115200