Din projektor, i Home Assistant og Hubitat.

• Den publicerer status. Projektoren dukker op som en Home Assistant-sensor, en Hubitat-enhed eller en JSON-payload på din webhook og bærer de samme aflæsninger, som appen viser dig.
• Den publicerer kontroller. Hver scene, du gemmer, plus strøm, hver kilde, hver farvetilstand og hver objektivhukommelse bliver til noget, en automatisering eller en stemmeassistent kan køre.
• Den kører serverløst. Når scriptsene er sat op, sender Home Assistant kommandoer direkte til projektorens IP-adresse. Din telefon behøver ikke være på netværket, og intet går gennem en cloudkonto.

Tre veje ind, ét knudepunkt

Settings › Home Automation er knudepunktet. Vælg den platform, du kører - Home Assistant, Hubitat eller Webhooks - og sæt den op dér. Du kan sætte mere end én op ad gangen; de er uafhængige.

1. Åbn Settings › Home Automation › Home Assistant.
2. Skriv din Home Assistant-adresse (for eksempel http://homeassistant.local:8123 eller dens IP), og tryk derefter på Sign in. Det er et browserlogin mod din egen instans - der er intet token at indsætte. Brug dit almindelige Home Assistant-login, tofaktor og det hele.
3. Appen publicerer projektoren som en sensor med en entity som sensor.projector_pilot_epson_qb1000b_qb1000w, der bærer strøm, kilde, farvetilstand, billedtallene og lampetimer.
4. Slå Send projektorens status til, så disse aflæsninger opdateres i Home Assistant, hver gang de ændrer sig, mens appen er åben, og slå Sync Advanced Controls til for at publicere scripts til billedtilstande, kilder, objektivhukommelser og strøm.
5. Indsæt den ene shell_command-blok (nedenfor) i din configuration.yaml, genstart Home Assistant, og tryk derefter på Sync With HA.

shell_command-blokken

Det er hele det serverløse trick. Appen skriver én kommando, som Home Assistant kører for at tale med projektorens Web Control, og hvert script, den synkroniserer, kalder den kommando med et andet verbum. Tryk på Copy block i appen, og indsæt den i configuration.yaml. Eksemplet nedenfor er illustrativt - appen udfylder din projektors egen adresse og kommandonavn:

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

Kun et eksempel. Appen genererer din med projektorens rigtige IP og et navn afledt af dens serienummer.

Test forbindelse, Sync og oprydning

• Test forbindelse tjekker, at appen kan nå din Home Assistant, og at den indsatte shell_command faktisk er der, så du finder en tastefejl, før du bygger noget oven på den.
• Sync With HA skriver eller opdaterer scriptsene til dine scener og kontroller og bygger et færdigt Projector Pilot-dashboard direkte i Home Assistant. Kør den igen, når du tilføjer en scene eller ændrer en kontrol - den opdaterer på stedet i stedet for at hobe dubletter op.
• Fjern forældreløse scripts finder scripts, appen har skrevet, som ikke længere har en tilsvarende scene eller kontrol - for eksempel efter du har slettet en scene - viser præcis, hvilke den vil fjerne, og spørger først. Intet slettes, før du bekræfter. Den rører kun scripts, som Projector Pilot har oprettet; intet andet i din Home Assistant forstyrres, og hvis Home Assistant ikke vil udlevere sin scriptliste, fjernes intet.

• Forbundet til Home Assistant - logget ind og svarer. Hvis Home Assistant ikke svarer, siger rækken, at du skal tjekke adressen, og at din telefon er på det samme netværk.
• Projektor føjet til Home Assistant - om Home Assistant allerede har denne projektor. Hvis ikke, sender rækken dig videre til at tilføje PJLink-integrationen, og trinnet for tilføjelse af integration viser den PJLink-vært og port, Home Assistant spørger efter.
• Aflæsningssensor registreret - sensoren, der bærer din projektors aflæsninger. Den registreres første gang, appen læser projektoren, og rækken tilbyder Registrer nu eller Slå til, når noget forhindrer det.
• Hvad din Home Assistant har - HACS (fællesskabsbutikken), Epson Projector Link-integrationen, PJLink-integrationen og Projector Pilot-kommandoerne i configuration.yaml. Hver viser Fundet, Ikke installeret eller Kunne ikke afgøres, med knapperne Sådan installerer du og Åbn i HACS, hvor de hjælper.

• Indbyggede kort først. Hvis du ikke har nogen fællesskabskort, bygger Sync dit dashboard med Home Assistants indbyggede kort og siger det, når det er færdigt. Det virker lige ud af kassen.
• Opgraderet, når HACS-kort er installeret. Appen tjekker, hvilke af fællesskabskortene (Mushroom, button-card, card-mod, apexcharts-card) der er installeret, og opgraderer hvert kort til det rigere, hvor du har det. Guiden til det håndbyggede dashboard går længere, hvis du vil have det fulde grønne glasudseende.
• Scener og kontroller kræver den ene indsættelse. Hvis Home Assistant endnu ikke har en kommando til at sende til projektoren, bliver dashboardet stadig bygget med live aflæsninger, og et Afslut opsætning-kort fører dig igennem det: tryk på Copy block, indsæt den i configuration.yaml, genstart Home Assistant, og tryk derefter på Sync igen.
• Intet installeret? Indsæt i hånden. Hvis intet er installeret i Home Assistant, kan du stadig kopiere det hele fra appen og indsætte det selv.
• En adgangskode bliver fremhævet. Kommandoblokken, du indsætter, siger til, når den bærer en projektoradgangskode, så du ved det, før du deler eller gemmer den.

• Det er endnu en valgfri blok: indsæt den til sidst i configuration.yaml (eller tilføj kun dens linjer under en eksisterende template:-sektion), og genstart Home Assistant. Appen har en Tjek, at den er der-knap, der fortæller dig, om Home Assistant har den.
• En slukning når nu Home Assistant som off, så dashboardet og dine automatiseringer ser projektoren som slukket, når den er det.

• Automatiseringer kan køre dem. „Ved solnedgang, hvis TV'et tænder, kør Movie Night“ er en helt almindelig Home Assistant-automatisering, når scenen først er et script.
• Stemmeassistenter kan køre dem. Gør et script tilgængeligt for din assistent, og „tænd Movie Night“ sætter kilden, billedtilstanden og objektivhukommelsen i ét hug.
• Kun dine rigtige kontroller dukker op. Appen skriver et script for hver kilde, farvetilstand og objektivhukommelse, projektoren oplyser - ikke en generisk liste, den har gættet sig til.
• At fjerne synkronisering fjerner kun det, appen har skrevet. Slå synkroniseringen fra, eller brug Fjern forældreløse scripts (som viser dem og spørger først), og Projector Pilot sletter de scripts, den har oprettet, og intet andet.

Dashboardet

Sync bygger dashboardet for dig

Du behøver ikke bygge en Lovelace-visning i hånden, og du behøver heller ikke længere indsætte en. Når du trykker på Sync With HA, bygger appen et komplet Projector Pilot-dashboard direkte i Home Assistant via dens eget API: projektorens live status og en knap til hver scene og kontrol, den har synkroniseret. Det dukker op i din Home Assistant-sidebjælke som Projector Pilot - åbn det, så er det klaret.

1. Log ind på Home Assistant i appen.
2. Indsæt appens Copy block i configuration.yaml én gang, og genstart Home Assistant (det ene manuelle trin - Home Assistant lader ikke apps tilføje den kommando eksternt).
3. Tryk på Sync With HA. Dashboardet bliver bygget til dig og dukker op i sidebjælken som Projector Pilot.

Uanset om det bliver bygget til dig, eller du indsætter det, er dashboardet det samme - et statuskort plus en knap til hver kontrol (illustrativt uddrag):

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

Kun et eksempel. Dit dashboard bærer din projektors rigtige entity og dine egne scener.

1. Aktivér Maker API-appen i Hubitat, notér dens adgangs-URL og token, og vælg, hvilke enheder den udstiller.
2. Åbn Settings › Home Automation › Hubitat i Projector Pilot, og indtast din hubs Maker API-oplysninger.
3. Vælg den enhed, der står for projektoren. Appen foreslår den mest sandsynlige; vælg den, eller vælg din egen.
4. Appen spejler strøm, mute og kilde over på den enhed og sender kun de kommandoer, enheden accepterer.
5. Byg Rule Machine-regler mod den enhed, som du ville gøre med enhver anden - projektorens status driver dem.

1. Åbn Settings › Home Automation › Webhooks.
2. Indtast den URL, der skal sendes til. En Home Assistant-webhook ser ud som http://homeassistant.local:8123/api/webhook/your-id.
3. Vælg, hvilke hændelser der udløser webhooken: tænd, sluk, kildeskift, scenekald - og filtrér eventuelt til en bestemt kilde eller scene.
4. Angiv eventuelt en brugerdefineret payload, hvis den modtagende tjeneste vil have en bestemt form; ellers sender appen sin standard-JSON.
5. Gem. Appen sender derefter ved hver matchende hændelse.

Standardpayloaden er almindelig JSON - en hændelse, projektoren og den værdi, der ændrede sig:

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

Eksempel på payload. En hændelse om kildeskift eller strøm bærer de felter, der er relevante for den.