ESPHome builder

Laitteet ja niiden YAML-asetustiedostot luetaan/kirjoitetaan suoraan ESPHome-yhteensopivasta asetushakemistosta - ei tietokantataulua, joten mikä tahansa siellä jo käsin hallittu pysyy käsin hallittavana. Tämä on ESPHomen asetus-/käännöspuoli (nimeltään "ESPHome Dashboard" itse taustapalvelussa, mutta täällä otsikoitu "ESPHome builder", jotta se ei lue kaksoiskappaleena vieressä olevasta natiivi-laitteiden "ESPHome"-ruudusta - katso Laitteet ja palvelut); laitteiden löytämiseen ja live-yhdistämiseen niiden omalla API:lla, katso sen sijaan ESPHome.

Kuten jokainen muu integraatio kohdassa Laitteet ja palvelut, tämä ruutu on piilossa kunnes se on oikeasti asetettu - sivun otsikkorivin oma kolmen pisteen valikon "Asetukset"-kohta asettaa Dashboard-osoitteen ja valinnaiset tunnistetiedot (tämä oli ennen kortti System-asetussivulla; se siirtyi tänne kun ESPHome builderista tuli valinnainen integraatio aina päällä olevan sivupalkkikohteen sijaan).

Laitteet-välilehti

Korttinäkymä (oletus) tai luettelonäkymä, vaihdettavissa oikeasta yläkulmasta, ja heti sen vieressä suodatinkuvakkeen valikko Online/Offline-suodattimille (kumpikaan ei ole valittuna oletuksena, jolloin kaikki laitteet näkyvät; jommankumman tai molempien valinta rajaa vain niihin tiloihin). Hakukenttä niiden vasemmalla puolella täsmää nimeä/näyttönimeä/alustaa/ piirilevyä yhdessä kirjoittaessa. Kortti näyttää yläreunassa näyttönimen ja tiedostonimen, Tila-merkin, sitten Muokkaa ja Logs, ja kolmen pisteen valikon (avautuu painikkeen oikealle puolelle, tai vasemmalle näytön reunan lähellä) kaikelle muulle.

• Tila (Status) - ESPHome-hallintapaneelin oma tavoitettavuustarkistus, kysyttynä 15 sekunnin välein, näytettynä vihreänä/punaisena/himmeänä merkkinä. "Tuntematon" (ei asetettua hallintapaneelia, tai ei koskaan tavoitettu) näyttää saman punaisen "Poissa verkosta" -merkin kuin vahvistetusti offline-tilassa oleva laite.
• Validoi / Käännä (Validate / Compile) - suoratoistavat live-tulostetta ESPHome-hallintapaneelin taustapalvelusta modaalissa. Vaatii asetetun Dashboard-osoitteen (katso "Asetukset" yllä); ilman sitä laitteen YAML-muokkaus ja Tiedostot-välilehti alla toimivat silti.
• Asenna (Install) - avaa modaalin, jossa valitaan USB tai verkko (katso "Laiteohjelmiston kirjoittaminen" alla, mitä kumpikin tekee).
• Näytä API-avain - näyttää laitteen oman api: encryption: key: -arvon (jos asetettu) kopiointipainikkeen kera.
• Lataa YAML - tallentaa laitteen raa'an asetustiedoston sellaisenaan.
• Muokkaa näyttönimeä / Nimeä konenimi uudelleen - nopeat yhden kentän muokkaukset kohteille esphome: friendly_name: / esphome: name: ilman koko YAML-muokkaimen avaamista. Konenimen uudelleennimeäminen muuttaa vain tämän sisäisen kentän (laitteen todellisen verkko-/mDNS-nimen), ei tämän listan omaa tiedosto-/URL-identiteettiä - se on erillinen uudelleennimeäminen laitteen omalla Muokkaa-sivulla.
• Monista (Duplicate) - kopioi laitteen kokoonpanon tavu tavulta uuteen tiedostoon valitsemallasi nimellä; sen sisäiset esphome:-nimi-/friendly_name-kentät jätetään koskemattomiksi, joten muokkaa niitä (Nimeä konenimi uudelleen / Muokkaa näyttönimeä yllä) ennen kuin käännät kopion - kaksi laitetta joilla on sama ESPHome-nimi törmäävät heti kun molemmat ovat verkossa.
• Lataa (Download) - lataa viimeksi käännetyn laiteohjelmistotiedoston.
• Arkistoi / Poista (Archive / Delete) - Arkistoi siirtää kokoonpanon hallintapaneelin omaan archive/-alikansioon (palauta se siirtämällä tiedosto takaisin Tiedostot-välilehdeltä); Poista poistaa sen kokonaan.

Laiteohjelmiston kirjoittaminen

Kaksi tapaa saada käännetty laiteohjelmisto laitteelle - valitse jompikumpi kortin omasta "Asenna"-valikkokohdasta, tai laitteen omalta sivulta.

OTA (verkon kautta)

Välittää ESPHome-hallintapaneelin oman "run"-toiminnon - saman mekanismin jota Käännä/Validoi käyttävät - kohdistuen oletuksena laitteen mDNS-isäntänimeen. Vaatii asetetun Dashboard-osoitteen (katso "Asetukset" yllä) ja laitteen jo tavoitettavissa verkossa.

Selaimen USB (WebSerial)

Täysin uudelle sirulle, jolla ei ole vielä mitään - kirjoitus tapahtuu kokonaan selainpuolella ESP Web Toolsin kautta (sama kirjasto, jota oikea ESPHome-hallintapaneeli käyttää), ilman Docker/isäntäkoneen USB-läpivientiä tarvitsematta. Kytke laite tietokoneeseen, jossa selaimesi on käynnissä, ei Athena- palvelimeen. "Liitä tähän tietokoneeseen" -valinta Asenna-modaalissa kääntää ensin automaattisesti (käännös voi kestää hetken, ja selain sallii oman USB-porttivalitsimensa avaamisen vain parin sekunnin sisällä oikeasta klikkauksesta, joten sitä ei voida käynnistää automaattisesti heti käännöksen valmistuttua) - kun se onnistuu, yksi lisäklikkaus samassa modaalissa näkyvästä painikkeesta avaa porttivalitsimen ja kirjoittaa.

Kummankin tavan jälkeen laitteen pitäisi ilmestyä uudelleen yllä olevaan Tila-tarkistukseen noin 15 sekunnissa, ja ESPHome-tunnistukseen pian sen jälkeen, kun se on taas verkossa.

Lokit

Laitteen omalla sivulla on myös "Logs"-painike, saman rivin oikeassa reunassa kuin Tallenna/ Validoi/Käännä/Vilkuta - suoratoistaa kyseisen laitteen omaa live-lokitulostetta suoraan ESPHome-hallintapaneelin taustapalvelusta, sama näkymä jonka hallintapaneelin oma "Logs"-toiminto näyttää, kohdistuen laitteen mDNS-isäntänimeen samalla tavalla kuin Vilkuta.

Tiedostot-välilehti

Yleiskäyttöinen tiedostonhallinta koko asetushakemiston yli, paketeille, rajapinnoille tai mille tahansa muulle, johon viitataan käsin laitteen YAML:sta !include/ packages:-avulla.

Jaettu käyttöönotto

Jos ESPHomen omat käännökset ovat enemmän kuin Athena-koneesi haluaa kantaa, aja hallintapaneelia sen sijaan erillisellä, tehokkaammalla koneella (docker-compose-esphome.yml) ja osoita tämän integraation oma "Asetukset" Dashboard-osoite sinne - katso Asennus. ESPHOME_DASHBOARD_URL tiedostossa .env toimii silti myös, alkuarvona jonka tuore asennus lukee ennen kuin kukaan on tallentanut mitään Asetuksista.