Projektorisi Home Assistantissa ja Hubitatissa.

• Se julkaisee tilan. Projektori näkyy Home Assistantin anturina, Hubitatin laitteena tai JSON-sisältönä webhookissasi, ja se sisältää samat lukemat, jotka sovellus näyttää sinulle.
• Se julkaisee säätimet. Jokaisesta tallentamastasi kohtauksesta sekä virrasta, jokaisesta tulosta, jokaisesta väritilasta ja jokaisesta linssimuistista tulee jotakin, minkä automaatio tai ääniavustaja voi suorittaa.
• Se toimii palvelimettomasti. Kun skriptit on asennettu, Home Assistant lähettää komennot suoraan projektorin IP-osoitteeseen. Puhelimesi ei tarvitse olla verkossa, eikä mikään kulje pilvitilin kautta.

Kolme tapaa sisään, yksi keskus

Asetukset › Kodin automaatio on keskus. Valitse käyttämäsi alusta - Home Assistant, Hubitat tai Webhooks - ja määritä se siellä. Voit ottaa käyttöön useamman kuin yhden samanaikaisesti; ne ovat toisistaan riippumattomia.

1. Avaa Asetukset › Kodin automaatio › Home Assistant.
2. Kirjoita Home Assistantin osoite (esimerkiksi http://homeassistant.local:8123 tai sen IP-osoite) ja napauta Kirjaudu sisään. Kirjautuminen tapahtuu selaimessa omaa instanssiasi vasten - tunnusta ei tarvitse liittää. Käytä tavallista Home Assistant -kirjautumistasi, kaksivaiheinen tunnistautuminen mukaan lukien.
3. Sovellus julkaisee projektorin anturina, jonka entiteetti on esimerkiksi sensor.projector_pilot_epson_qb1000b_qb1000w ja joka sisältää virran, tulon, väritilan, kuvan arvot ja lampun käyttötunnit.
4. Ota käyttöön Lähetä projektorin tila, jotta nämä lukemat päivittyvät Home Assistantissa aina muuttuessaan sovelluksen ollessa auki, ja ota käyttöön Sync Advanced Controls julkaistaksesi skriptit kuvatiloille, tuloille, linssimuisteille ja virralle.
5. Liitä yksi shell_command-lohko (alla) tiedostoosi configuration.yaml, käynnistä Home Assistant uudelleen ja napauta sitten Sync With HA.

shell_command-lohko

Tämä on koko palvelimettoman toiminnan temppu. Sovellus kirjoittaa yhden komennon, jonka Home Assistant ajaa keskustellakseen projektorin Web Controlin kanssa, ja jokainen synkronoitu skripti kutsuu tätä komentoa eri verbillä. Napauta sovelluksessa Copy block ja liitä se tiedostoon configuration.yaml. Alla oleva esimerkki on havainnollistava - sovellus täyttää projektorisi oman osoitteen ja komennon nimen:

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 }}"

Vain esimerkki. Sovellus luo omasi projektorin todellisella IP-osoitteella ja sarjanumerosta johdetulla nimellä.

Test Connection, Sync ja siivous

• Test Connection tarkistaa, että sovellus tavoittaa Home Assistantisi ja että liitetty shell_command on todella siellä, jotta löydät kirjoitusvirheen ennen kuin rakennat mitään sen päälle.
• Sync With HA kirjoittaa tai päivittää kohtaustesi ja säädintesi skriptit ja rakentaa valmiin Projector Pilot -kojelaudan suoraan Home Assistantiin. Suorita se uudelleen aina, kun lisäät kohtauksen tai muutat säädintä - se päivittää paikallaan eikä kasaa kaksoiskappaleita.
• Remove orphaned scripts löytää skriptit, jotka sovellus on kirjoittanut ja joilla ei enää ole vastaavaa kohtausta tai säädintä - esimerkiksi kohtauksen poistamisen jälkeen - luettelee tarkasti, mitkä se poistaa, ja kysyy ensin. Mitään ei poisteta ennen kuin vahvistat. Se koskee vain Projector Pilotin luomia skriptejä; mikään muu Home Assistantissasi ei häiriinny, ja jos Home Assistant ei luettele skriptejään, mitään ei poisteta.

• Yhdistetty Home Assistantiin - kirjautunut sisään ja vastaa. Jos Home Assistant ei vastaa, rivi kehottaa tarkistamaan osoitteen ja sen, että puhelimesi on samassa verkossa.
• Projektori lisätty Home Assistantiin - onko tämä projektori jo Home Assistantissa. Jos ei, rivi ohjaa sinut lisäämään PJLink-integraation, ja integraation lisäysvaihe näyttää PJLink-isännän ja portin, joita Home Assistant kysyy.
• Lukemien anturi rekisteröity - anturi, joka sisältää projektorisi lukemat. Se rekisteröityy ensimmäisellä kerralla, kun sovellus lukee projektoria, ja rivi tarjoaa toimintoja Rekisteröi nyt tai Ota käyttöön, kun jokin estää sen.
• Mitä Home Assistantissasi on - HACS (yhteisön kauppa), Epson Projector Link -integraatio, PJLink-integraatio ja Projector Pilotin komennot tiedostossa configuration.yaml. Kukin näyttää tilan Löytyi, Ei asennettu tai Ei voitu selvittää, ja mukana ovat tarvittaessa Asennusohje- ja Avaa HACSissa -painikkeet.

• Sisäänrakennetut kortit ensin. Jos sinulla ei ole yhteisökortteja, Sync rakentaa kojelaudan Home Assistantin sisäänrakennetuilla korteilla ja kertoo siitä valmistuttuaan. Se toimii heti valmiina.
• Päivittyy, kun HACS-kortit on asennettu. Sovellus tarkistaa, mitkä yhteisökorteista (Mushroom, button-card, card-mod, apexcharts-card) on asennettu, ja päivittää kunkin kortin rikkaampaan, jos se sinulla on. Käsin rakennettavan kojelaudan opas menee pidemmälle, jos haluat täyden vihreälasisen ulkoasun.
• Kohtaukset ja säätimet tarvitsevat yhden liittämisen. Jos Home Assistantissa ei vielä ole komentoa projektorille lähettämiseen, kojelauta rakennetaan silti reaaliaikaisilla lukemilla, ja Viimeistele asennus -kortti opastaa läpi: napauta Copy block, liitä se tiedostoon configuration.yaml, käynnistä Home Assistant uudelleen ja napauta Sync uudelleen.
• Mitään ei asennettu? Liitä käsin. Jos Home Assistantiin ei ole asennettu mitään, voit silti kopioida kaiken sovelluksesta ja liittää sen itse.
• Salasana mainitaan erikseen. Liittämäsi komentolohko kertoo, kun se sisältää projektorin salasanan, jotta tiedät sen ennen jakamista tai tallentamista.

• Se on yksi lisälohko: liitä se tiedoston configuration.yaml loppuun (tai lisää vain sen rivit olemassa olevan template:-osion alle) ja käynnistä Home Assistant uudelleen. Sovelluksessa on Tarkista, että se on siellä -painike, joka kertoo, onko se Home Assistantissa.
• Virran katkaisu välittyy nyt Home Assistantiin tilana off, joten kojelauta ja automaatiosi näkevät projektorin pois päältä silloin, kun se on.

• Automaatiot voivat ajaa ne. ”Auringonlaskussa, jos televisio menee päälle, aja Elokuvailta” on tavallinen Home Assistant -automaatio, kun kohtaus on skripti.
• Ääniavustajat voivat ajaa ne. Julkaise skripti avustajallesi, niin ”käynnistä Elokuvailta” asettaa tulon, kuvatilan ja linssimuistin yhdessä.
• Vain todelliset säätimesi näkyvät. Sovellus kirjoittaa skriptin jokaiselle tulolle, väritilalle ja linssimuistille, jonka projektori ilmoittaa - ei arvattua yleisluetteloa.
• Synkronoinnin poisto poistaa vain sovelluksen kirjoittaman. Kytke synkronointi pois tai käytä toimintoa Remove orphaned scripts (joka luettelee ne ja kysyy ensin), ja Projector Pilot poistaa luomansa skriptit eikä mitään muuta.

Kojelauta

Sync rakentaa kojelaudan puolestasi

Sinun ei tarvitse rakentaa Lovelace-näkymää käsin, eikä sinun enää tarvitse edes liittää sellaista. Kun napautat Sync With HA, sovellus rakentaa täydellisen Projector Pilot -kojelaudan suoraan Home Assistantiin sen omalla rajapinnalla: projektorin reaaliaikainen tila ja painike jokaiselle synkronoidulle kohtaukselle ja säätimelle. Se ilmestyy Home Assistantin sivupalkkiin nimellä Projector Pilot - avaa se, ja se on valmis.

1. Kirjaudu sovelluksessa Home Assistantiin.
2. Liitä sovelluksen Copy block kerran tiedostoon configuration.yaml ja käynnistä Home Assistant uudelleen (ainoa manuaalinen vaihe - Home Assistant ei salli sovellusten lisätä tuota komentoa etänä).
3. Napauta Sync With HA. Kojelauta rakennetaan puolestasi ja ilmestyy sivupalkkiin nimellä Projector Pilot.

Rakennettiinpa se puolestasi tai liitit sen itse, kojelauta on sama - tilakortti sekä painike jokaiselle säätimelle (havainnollistava pätkä):

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

Vain esimerkki. Kojelaudassasi on projektorisi todellinen entiteetti ja omat kohtauksesi.

1. Ota Hubitatissa käyttöön Maker API -sovellus, merkitse muistiin sen käyttö-URL ja tunnus ja valitse, mitkä laitteet se julkaisee.
2. Avaa Projector Pilotissa Asetukset › Kodin automaatio › Hubitat ja anna keskuksesi Maker API -tiedot.
3. Valitse laite, joka edustaa projektoria. Sovellus ehdottaa todennäköisintä; valitse se tai valitse oma.
4. Sovellus peilaa virran, mykistyksen ja tulon kyseiselle laitteelle ja lähettää vain komennot, jotka laite hyväksyy.
5. Rakenna Rule Machine -säännöt kyseisen laitteen pohjalta kuten minkä tahansa muun - projektorin tila ohjaa niitä.

1. Avaa Asetukset › Kodin automaatio › Webhooks.
2. Anna URL, johon lähetetään. Home Assistant -webhook näyttää tältä: http://homeassistant.local:8123/api/webhook/your-id.
3. Valitse, mitkä tapahtumat laukaisevat webhookin: virta päälle, virta pois, tulon vaihto, kohtauksen palautus - ja halutessasi rajaa tiettyyn tuloon tai kohtaukseen.
4. Aseta tarvittaessa oma hyötykuorma, jos vastaanottava palvelu haluaa tietyn muodon; muuten sovellus lähettää oletus-JSONinsa.
5. Tallenna. Sovellus lähettää sen jälkeen jokaisesta vastaavasta tapahtumasta.

Oletushyötykuorma on pelkkää JSONia - tapahtuma, projektori ja muuttunut arvo:

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

Esimerkkihyötykuorma. Tulon vaihto- tai virtatapahtuma sisältää siihen liittyvät kentät.