ESPHome bygger firmware från en YAML-konfiguration och är särskilt praktiskt för sensorer och enheter i Home Assistant. YAML beskriver konfigurationen; det är inte själva transportprotokollet mellan enheten och Home Assistant.
Välj rätt väg in
Om du använder Home Assistant OS kan du installera ESPHome Device Builder genom Home Assistants katalog över stödda appar/tillägg. Du kan också använda ESPHomes dokumenterade container- eller kommandoradsinstallation. Följ den officiella installationsguiden; menynamn och skärmbilder ändras med tiden.
Anslut kortet med en USB-datakabel. Installation i webbläsaren kräver en webbläsare som stöds och åtkomst till rätt serieport. Installera endast en USB-drivrutin som passar kortets faktiska USB-gränssnitt; CP210x, CH34x och inbyggd USB är inte samma sak.
Kort, ramverk och version
Välj exakt ESP32-variant. ESP32, ESP32-S3, ESP32-C3 och ESP8266 kan inte utan vidare dela kortdefinitioner, pinval eller Bluetooth-funktioner. Se ESP32-plattformens dokumentation. Låt aktuell Device Builder skapa grundkonfigurationen och spara den tillsammans med versionsuppgifterna.
API och trådlösa uppdateringar
Använd API-kryptering för anslutningen till Home Assistant. Den gamla api.password-inställningen togs bort i ESPHome 2026.1. OTA-konfigurationen är också plattformsbaserad; kopiera inte okritiskt gamla exempel med endast ota: och ett lösenord.
Följ API-dokumentationen och OTA-dokumentationen för din installerade version. Förvara Wi-Fi-uppgifter och enhetens nycklar i secrets.yaml, och dela aldrig filen i ett offentligt kodarkiv.
Bygg den första mätningen
- Börja med en enhet och en enkel sensor. Kontrollera matningsspänning, signalnivåer och pinout i databladet.
- Lägg till rätt ESPHome-komponent. Kontrollera exakt modellnamn och konfigurationsfält.
- Validera konfigurationen, bygg firmware och installera den. YAML-fel och fel i en elektrisk anslutning åtgärdas på olika ställen.
- Läs loggen och kontrollera att Home Assistant tar emot en stabil mätning. Jämför med en känd referens.
- Säkerhetskopiera den fungerande konfigurationen innan du lägger till fler funktioner.
Om det inte fungerar
Om serieporten saknas, kontrollera först kabel, USB-gränssnitt och behörigheter. En enhet som startar om upprepade gånger kan ha fel kortkonfiguration, kod eller instabil matning. Ett felaktigt sensorvärde kräver kontroll av ledningsdragning, adress, enheter och kalibrering.
Programvara ger inte en oskyddad relämodul säker elektrisk isolation. Börja med lågspänningsprojekt på USB eller batteri; arbete med nätspänning kräver en lämplig sluten installation och relevant yrkeskompetens.
Hitta utvecklingskort och sensorer i butiken och välj efter den konkreta uppgiften, inte bara produktens familjenamn.
