A projektor, Home Assistant-ban és Hubitat-ban.

• Állapotot tesz közzé. A projektor Home Assistant szenzorként, Hubitat eszközként vagy a webhookon küldött JSON-adatcsomagként jelenik meg, ugyanazokkal az értékekkel, amelyeket az alkalmazás is mutat.
• Vezérlőket tesz közzé. Minden elmentett Jelenet, valamint a bekapcsolás, minden bemenet, minden színmód és minden lencsememória olyasmivé válik, amit egy automatizálás vagy egy hangasszisztens futtatni tud.
• Szerver nélkül fut. Amint a szkriptek be vannak állítva, a Home Assistant közvetlenül a projektor IP-címére küldi a parancsokat. A telefonnak nem kell a hálózaton lennie, és semmi sem megy át felhőfiókon.

Három út, egy központ

A Beállítások › Otthon-automatizálás a központ. Válassza ki a használt platformot - Home Assistant, Hubitat vagy Webhookok - és ott állítsa be. Egyszerre többet is bekötheti; egymástól függetlenek.

1. Nyissa meg a Beállítások › Otthon-automatizálás › Home Assistant oldalt.
2. Írja be a Home Assistant címét (például http://homeassistant.local:8123 vagy az IP-címét), majd koppintson a Bejelentkezés gombra. Ez böngészős bejelentkezés a saját példányába - nincs beillesztendő token. Használja a szokásos Home Assistant belépését, kétfaktoros azonosítással együtt.
3. Az alkalmazás szenzorként teszi közzé a projektort, például sensor.projector_pilot_epson_qb1000b_qb1000w entitással, amely hordozza a bekapcsolási állapotot, a bemenetet, a színmódot, a képadatokat és a lámpaórákat.
4. Kapcsolja be a A projektor állapotának küldése funkciót, hogy ezek az értékek frissüljenek a Home Assistant-ban, valahányszor változnak, amíg az alkalmazás nyitva van, és kapcsolja be a Speciális vezérlők szinkronizálása funkciót, hogy szkriptek készüljenek a képmódokhoz, bemenetekhez, lencsememóriákhoz és a bekapcsoláshoz.
5. Illessze be az egyetlen shell_command blokkot (lent) a(z) configuration.yaml fájlba, indítsa újra a Home Assistant-ot, majd koppintson a Szinkronizálás HA-val gombra.

A shell_command blokk

Ez a teljes szerver nélküli trükk. Az alkalmazás egyetlen parancsot ír, amelyet a Home Assistant futtat a projektor Web Control felületével való beszélgetéshez, és minden szinkronizált szkript ezt a parancsot hívja más-más igével. Koppintson az alkalmazásban a Blokk másolása gombra, és illessze be ide: configuration.yaml. Az alábbi példa csak illusztráció - az alkalmazás beírja a projektor saját címét és parancsnevét:

shell_command:
  projector_pilot_epson: >-
    curl -s --max-time 5 --digest -u 'EPSONWEB:'
    -H "X-Requested-With: XMLHttpRequest"
    -H "Referer: http://192.168.1.50/cgi-bin/webconf"
    "http://192.168.1.50/cgi-bin/directsend?{{ verb }}={{ value | urlencode }}"

Csak példa. Az alkalmazás a sajátját a projektor valódi IP-címével és a sorozatszámból képzett névvel állítja elő.

Kapcsolat tesztelése, szinkronizálás és takarítás

• A Kapcsolat tesztelése ellenőrzi, hogy az alkalmazás eléri-e a Home Assistant-ot, és hogy a beillesztett shell_command valóban ott van-e, így még azelőtt kiderül egy elírás, hogy bármit ráépítene.
• A Szinkronizálás HA-val megírja vagy frissíti a Jelenetek és vezérlők szkriptjeit, és közvetlenül a Home Assistant-ba felépít egy kész Projector Pilot vezérlőpultot. Futtassa újra bármikor, ha új Jelenetet ad hozzá vagy módosít egy vezérlőt - helyben frissít, nem halmoz fel másolatokat.
• Az Árva szkriptek eltávolítása megkeresi azokat a szkripteket, amelyeket az alkalmazás írt, de már nincs hozzájuk Jelenet vagy vezérlő - például egy Jelenet törlése után -, felsorolja, pontosan melyeket távolítja el, és előbb rákérdez. Semmi sem törlődik, amíg meg nem erősíti. Csak a Projector Pilot által létrehozott szkriptekhez nyúl; a Home Assistant semmi más része nem sérül, és ha a Home Assistant nem listázza a szkriptjeit, semmi sem kerül eltávolításra.

• Csatlakozva a Home Assistant-hoz - bejelentkezve és válaszol. Ha a Home Assistant nem válaszol, a sor azt javasolja, hogy ellenőrizze a címet, és hogy a telefon ugyanazon a hálózaton van-e.
• Projektor hozzáadva a Home Assistant-hoz - hogy a Home Assistant már ismeri-e ezt a projektort. Ha nem, a sor a PJLink integráció hozzáadásához irányítja, és az integráció-hozzáadási lépés megmutatja a PJLink gazdát és portot, amelyet a Home Assistant kér.
• Értékszenzor regisztrálva - a szenzor, amely a projektor értékeit hordozza. Akkor regisztrálódik, amikor az alkalmazás először olvassa be a projektort, és a sor Regisztrálás most vagy Bekapcsolás lehetőséget kínál, ha valami megakadályozza.
• Mi van a Home Assistant-ban - HACS (a közösségi bolt), az Epson Projector Link integráció, a PJLink integráció, és a Projector Pilot parancsai itt: configuration.yaml. Mindegyik Megtalálva, Nincs telepítve vagy Nem állapítható meg állapotot mutat, Telepítés menete és Megnyitás a HACS-ben gombokkal, ahol azok segítenek.

• Előbb a beépített kártyák. Ha nincsenek közösségi kártyák, a szinkronizálás a Home Assistant beépített kártyáival építi fel a vezérlőpultot, és a végén ezt jelzi. Dobozból kivéve működik.
• Frissítés, ha HACS-kártyák vannak telepítve. Az alkalmazás ellenőrzi, melyik közösségi kártya (Mushroom, button-card, card-mod, apexcharts-card) van telepítve, és ahol megvan, a gazdagabbra cseréli az adott kártyát. A kézzel épített vezérlőpult útmutatója tovább megy, ha a teljes zöld üveges megjelenést szeretné.
• A Jelenetekhez és vezérlőkhöz kell az az egy beillesztés. Ha a Home Assistant-ban még nincs projektornak küldő parancs, a vezérlőpult élő értékekkel így is elkészül, és egy Beállítás befejezése kártya végigvezeti: koppintson a Blokk másolása gombra, illessze be ide: configuration.yaml, indítsa újra a Home Assistant-ot, majd koppintson újra a Szinkronizálásra.
• Nincs semmi telepítve? Illessze be kézzel. Ha a Home Assistant-ban nincs telepítve semmi, mindent kimásolhat az alkalmazásból, és maga beillesztheti.
• A jelszót jelzi. A beillesztett parancsblokk megmondja, ha projektorjelszót hordoz, így megosztás vagy tárolás előtt tudja.

• Ez még egy opcionális blokk: illessze be a(z) configuration.yaml végére (vagy csak a soraiban lévő részt egy meglévő template: szakasz alá), és indítsa újra a Home Assistant-ot. Az alkalmazásban van egy Ellenőrzés, hogy ott van-e gomb, amely megmondja, hogy a Home Assistant rendelkezik-e vele.
• A kikapcsolás mostantól off állapotként érkezik a Home Assistant-ba, így a vezérlőpult és az automatizálások kikapcsoltnak látják a projektort, amikor az valóban az.

• Az automatizálások futtathatják őket. „Naplementekor, ha a TV bekapcsol, futtasd a Filmes estet” egy hétköznapi Home Assistant automatizálás, amint a Jelenet szkript.
• A hangasszisztensek futtathatják őket. Tegyen elérhetővé egy szkriptet az asszisztensének, és a „kapcsold be a Filmes estet” együtt állítja be a bemenetet, a képmódot és a lencsememóriát.
• Csak a valódi vezérlők jelennek meg. Az alkalmazás minden olyan bemenethez, színmódhoz és lencsememóriához ír szkriptet, amelyet a projektor jelent - nem egy találgatott, általános listához.
• A szinkronizálás eltávolítása csak azt távolítja el, amit az alkalmazás írt. Kapcsolja ki a szinkronizálást, vagy használja az Árva szkriptek eltávolítása funkciót (amely felsorolja őket, és előbb rákérdez), és a Projector Pilot törli az általa létrehozott szkripteket, és semmi mást.

A vezérlőpult

A szinkronizálás elkészíti a vezérlőpultot

Nem kell kézzel építenie egy Lovelace nézetet, és beillesztenie sem kell többé. Amikor a Szinkronizálás HA-val gombra koppint, az alkalmazás a saját API-ján keresztül közvetlenül a Home Assistant-ban felépít egy teljes Projector Pilot vezérlőpultot: a projektor élő állapotát és egy gombot minden szinkronizált Jelenethez és vezérlőhöz. Az oldalsávban Projector Pilot néven jelenik meg - nyissa meg, és kész.

1. Jelentkezzen be az alkalmazásban a Home Assistant-ba.
2. Illessze be az alkalmazás Másolás blokkját egyszer ide: configuration.yaml, és indítsa újra a Home Assistant-ot (az egyetlen kézi lépés - a Home Assistant nem engedi, hogy alkalmazások távolról adják hozzá ezt a parancsot).
3. Koppintson a Szinkronizálás HA-val gombra. A vezérlőpult elkészül, és Projector Pilot néven megjelenik az oldalsávban.

Akár elkészül Önnek, akár maga illeszti be, a vezérlőpult ugyanaz - egy állapotkártya és egy gomb minden vezérlőhöz (illusztratív részlet):

views:
  - title: Projector
    cards:
      - type: entity
        entity: sensor.projector_pilot_epson_qb1000b_qb1000w
        name: Projector
      - type: button
        name: Power On
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_power_on
      - type: button
        name: Movie Night
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_scene_movie_night

Csak példa. A vezérlőpultja a projektora valódi entitását és a saját Jelenetei hordozza.

1. A Hubitat-ban engedélyezze a Maker API alkalmazást, jegyezze fel a hozzáférési URL-jét és tokenjét, és válassza ki, mely eszközöket tegye elérhetővé.
2. A Projector Pilot-ban nyissa meg a Beállítások › Otthon-automatizálás › Hubitat oldalt, és adja meg a központ Maker API adatait.
3. Válassza ki a projektort képviselő eszközt. Az alkalmazás javasolja a valószínűt; fogadja el, vagy válasszon sajátot.
4. Az alkalmazás tükrözi a bekapcsolást, némítást és bemenetet arra az eszközre, és csak az eszköz által elfogadott parancsokat küldi.
5. Építsen Rule Machine szabályokat arra az eszközre úgy, ahogy bármely másikra - a projektor állapota vezérli őket.

1. Nyissa meg a Beállítások › Otthon-automatizálás › Webhookok oldalt.
2. Adja meg az URL-t, amelyre küldeni kell. Egy Home Assistant webhook így néz ki: http://homeassistant.local:8123/api/webhook/your-id.
3. Válassza ki, mely események váltják ki a webhookot: bekapcsolás, kikapcsolás, bemenetváltás, Jelenet előhívása - és szükség esetén szűrjön egy adott bemenetre vagy Jelenetre.
4. Szükség esetén állítson be egyéni adattartalmat, ha a fogadó szolgáltatás bizonyos formát vár; különben az alkalmazás az alapértelmezett JSON-t küldi.
5. Mentse el. Az alkalmazás ezután minden egyező eseménynél küld.

Az alapértelmezett adattartalom sima JSON - egy esemény, a projektor és az érték, amely megváltozott:

{
  "event": "scene_recalled",
  "projector": "Epson QB1000B/QB1000W",
  "scene": "Movie Night",
  "power": "on",
  "input": "HDMI1",
  "color_mode": "Cinema",
  "timestamp": "2026-09-23T20:14:07Z"
}

Példa adattartalom. A bemenetváltás vagy bekapcsolás eseménye a rá vonatkozó mezőket hordozza.