Įdomybės

Kaip prijungti ESP32 prie Home Assistant be debesijos

ESP32 yra pigus mikrovaldiklis su integruotu Wi-Fi ir Bluetooth, todėl jis puikiai tinka savo rankomis kuriamiems jutikliams ir valdikliams. Home Assistant yra atvirojo kodo išmaniųjų namų sistema, veikianti jūsų tinkle. Kartu jie sudaro valdymo sistemą, kuri nepriklauso nuo gamintojų serverių, veikia net dingus internetui ir nesiunčia duomenų į išorę. Žemiau paaiškinsime, kaip tai padaryti.

Ko reikės

  • ESP32 plokštės su USB laidu (tinka dauguma DevKit modelių).
  • Veikiančio Home Assistant. Diegimo variantus rasite oficialiame diegimo vadove.
  • Namų Wi-Fi tinklo, 2,4 GHz juostoje, nes ESP32 5 GHz nepalaiko.
  • Kompiuterio su Chrome ar Edge naršykle pirmajam programavimui.

Du keliai: ESPHome ir MQTT

Yra du pagrindiniai būdai sujungti ESP32 su Home Assistant be debesies.

ESPHome yra rekomenduojamas pasirinkimas. Prietaisą aprašote paprastu YAML failu, o ESPHome sugeneruoja programinę įrangą. Home Assistant įrenginį randa automatiškai per vietinį API, todėl nereikia jokio tarpinio serverio. Daugiau apie sistemą rasite ESPHome svetainėje.

MQTT tinka, jei jau naudojate šį protokolą arba turite daug skirtingų įrenginių. Reikia atskiro tarpininko (angl. broker), pavyzdžiui, Mosquitto, ir integracijos Home Assistant pusėje. Aprašymas pateiktas MQTT integracijos dokumentacijoje. Pradedantiesiems ESPHome paprastesnis.

Žingsnis 1: įdiekite ESPHome

Jei naudojate Home Assistant OS, ESPHome įdiegiama kaip papildinys (add-on) iš papildinių parduotuvės. Žingsniai aprašyti ESPHome pradžios vadove. Kitas variantas yra ESPHome paleisti Docker konteineryje arba per Python komandinę eilutę.

Žingsnis 2: sukurkite pirmąjį įrenginį

ESPHome skydelyje paspauskite „New Device”, įveskite pavadinimą ir pasirinkite ESP32. Programa sugeneruos YAML failą. Jame nurodykite Wi-Fi duomenis, geriausia per secrets.yaml failą, kad slaptažodžiai nepatektų į kodą. Paprasčiausias pavyzdys:

yaml
esphome:  name: svetaines-jutiklis
esp32:  board: esp32dev
wifi:  ssid: !secret wifi_ssid  password: !secret wifi_password
api:  encryption:    key: !secret api_key
ota:  platform: esphome  password: !secret ota_password
logger:

Blokas api yra svarbiausias, nes būtent per jį Home Assistant bendrauja su prietaisu vietiniame tinkle. Parametrai aprašyti API komponento dokumentacijoje. Visi Wi-Fi nustatymai paaiškinti Wi-Fi komponento puslapyje.

Žingsnis 3: įkelkite programinę įrangą

Pirmą kartą ESP32 junkite USB laidu prie kompiuterio. ESPHome leidžia įrašyti programą tiesiai iš naršyklės per ESPHome Web. Vėliau atnaujinimai vyksta per orą (OTA), todėl laido nebereikės.

Žingsnis 4: pridėkite į Home Assistant

Kai ESP32 prisijungia prie tinklo, Home Assistant paprastai parodo pranešimą apie rastą įrenginį. Spauskite „Configure” ir įveskite šifravimo raktą. Jei pranešimo nėra, eikite į Nustatymai → Įrenginiai ir paslaugos → Pridėti integraciją ir pasirinkite ESPHome, tada įveskite prietaiso IP adresą. Integracijos aprašymas pateiktas Home Assistant dokumentacijoje.

Žingsnis 5: pridėkite jutiklį ar jungiklį

Tikroji ESPHome galia atsiskleidžia pridedant komponentus. Pavyzdžiui, temperatūros ir drėgmės jutiklis DHT22 aprašomas kelių eilučių konfigūracija pagal DHT komponento vadovą. Po įkėlimo naujos esybės (entities) Home Assistant pasirodo savaime, ir jas galite naudoti skydeliuose bei automatizacijose.

Kaip užtikrinti, kad tikrai veikia be debesies

  • Naudokite statinį IP adresą arba rezervaciją maršrutizatoriuje, kad įrenginys visada turėtų tą patį adresą.
  • Nenaudokite nuotolinės prieigos per trečiųjų šalių paslaugas. Jei reikia prieigos iš išorės, nustatykite VPN.
  • Palikite įjungtą API šifravimą ir OTA slaptažodį.
  • Patikrinkite, kad prietaisas veikia, kai atjungiate internetą nuo maršrutizatoriaus. Jei taip, sistema tikrai vietinė.

Dažniausios klaidos

Dažniausia problema yra 5 GHz tinklas, prie kurio ESP32 negali prisijungti. Antra klaida yra neteisingas šifravimo raktas, dėl kurio Home Assistant atsisako ryšio. Trečia klaida yra silpnas maitinimo šaltinis: prastas USB laidas ar įkroviklis sukelia nuolatinius perkrovimus. Jei prietaisas neatsiranda, pirmiausia pažiūrėkite ESPHome žurnalus, nes juose paprastai aiškiai parašyta priežastis.

Prijungti ESP32 prie Home Assistant be debesies galima per vieną vakarą. Įdiekite ESPHome, aprašykite prietaisą YAML failu, įkelkite programą ir pridėkite įrenginį į Home Assistant. Rezultatas yra greita, privati ir nuo išorinių paslaugų nepriklausoma sistema, kurią galite plėsti pagal poreikius.