ESPHome: kom i gang med dit smart home

ESPHome bygger firmware ud fra en YAML-konfiguration og er især praktisk til sensorer og enheder i Home Assistant. YAML beskriver opsætningen; det er ikke selve transportprotokollen mellem enheden og Home Assistant.

Vælg den rigtige vej ind

Bruger du Home Assistant OS, kan du installere ESPHome Device Builder gennem Home Assistants understøttede app-/tilføjelsesoversigt. Alternativt kan du bruge ESPHomes dokumenterede container- eller kommandolinjeopsætning. Følg den officielle installationsguide; menunavne og skærmbilleder ændrer sig over tid.

Tilslut boardet med et USB-datakabel. En browserbaseret installation kræver en understøttet browser og adgang til den korrekte serielle port. Installer kun en USB-driver, der passer til boardets faktiske USB-interface; CP210x, CH34x og native USB er ikke det samme.

Board, framework og version

Vælg den præcise ESP32-variant. ESP32, ESP32-S3, ESP32-C3 og ESP8266 kan ikke uden videre dele boarddefinitioner, pinvalg eller Bluetooth-funktioner. Se ESP32-platformens dokumentation. Lad den aktuelle Device Builder generere grundkonfigurationen, og gem den sammen med versionsoplysninger.

API og trådløse opdateringer

Brug API-kryptering til Home Assistant-forbindelsen. Den gamle api.password-indstilling blev fjernet i ESPHome 2026.1. OTA-konfigurationen er også platformsbaseret; kopier ikke ukritisk gamle eksempler med kun ota: og en adgangskode.

Følg API-dokumentationen og OTA-dokumentationen for din installerede version. Hold Wi-Fi-oplysninger og enhedens nøgler i secrets.yaml, og del aldrig filen i et offentligt kodearkiv.

Byg den første måling

1. Start med én enhed og en enkel sensor. Kontrollér forsyningsspænding, signalniveau og pinout i databladet.
2. Tilføj den relevante ESPHome-komponent. Kontrollér dens præcise modelnavn og opsætningsfelter.
3. Valider konfigurationen, byg firmwaren og installer den. Fejl i YAML og fejl i en elektrisk forbindelse løses forskellige steder.
4. Læs loggen, og kontrollér at Home Assistant modtager en stabil måling. Sammenlign med en kendt reference.
5. Tag en kopi af den fungerende opsætning, før du tilføjer flere funktioner.

Hvis det ikke virker

Ingen seriel port peger først på kabel, USB-interface eller tilladelser. En enhed, der starter igen og igen, kan have forkert boardkonfiguration, kode eller en ustabil forsyning. En forkert sensorværdi kræver kontrol af både ledningsføring, adresse, enheder og kalibrering.

Software giver ikke et ubeskyttet relæmodul sikker elektrisk isolation. Begynd med lavspændingsprojekter på USB eller batteri; arbejde med netspænding kræver en egnet, lukket installation og relevant faglig kompetence.

Find udviklingsboards og sensorer i butikken, og vælg efter den konkrete opgave frem for blot produktets familienavn.