Din projektor, i Home Assistant och Hubitat.

• Den publicerar status. Projektorn dyker upp som en sensor i Home Assistant, en enhet i Hubitat eller en JSON-nyttolast på din webhook, med samma avläsningar som appen visar dig.
• Den publicerar kontroller. Varje scen du sparar, plus ström, varje ingång, varje färgläge och varje objektivminne, blir något som en automation eller en röstassistent kan köra.
• Den körs serverlöst. När skripten är inställda skickar Home Assistant kommandon direkt till projektorns IP-adress. Din telefon behöver inte vara på nätverket, och ingenting går via ett molnkonto.

Tre vägar in, ett nav

Inställningar › Hemautomation är navet. Välj den plattform du kör - Home Assistant, Hubitat eller Webhooks - och ställ in den där. Du kan koppla upp fler än en samtidigt; de är oberoende av varandra.

1. Öppna Inställningar › Hemautomation › Home Assistant.
2. Skriv din Home Assistant-adress (till exempel http://homeassistant.local:8123 eller dess IP) och tryck sedan på Logga in. Det är en inloggning i webbläsaren mot din egen instans - det finns ingen token att klistra in. Använd din vanliga Home Assistant-inloggning, tvåfaktor och allt.
3. Appen publicerar projektorn som en sensor, med en entity som sensor.projector_pilot_epson_qb1000b_qb1000w, med ström, ingång, färgläge, bildvärden och lamptimmar.
4. Slå på Skicka projektorns status så att dessa avläsningar uppdateras i Home Assistant när de ändras medan appen är öppen, och slå på Synka avancerade kontroller för att publicera skript för bildlägen, ingångar, objektivminnen och ström.
5. Klistra in det enda shell_command-blocket (nedan) i din configuration.yaml, starta om Home Assistant och tryck sedan på Synka med HA.

Blocket shell_command

Det här är hela det serverlösa tricket. Appen skriver ett enda kommando som Home Assistant kör för att prata med projektorns Web Control, och varje skript den synkar anropar det kommandot med ett annat verb. Tryck på Kopiera block i appen och klistra in det i configuration.yaml. Exemplet nedan är bara ett exempel - appen fyller i din projektors egen adress och ditt kommandonamn:

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

Endast exempel. Appen genererar ditt med projektorns riktiga IP och ett namn som härleds från dess serienummer.

Testa anslutning, synka och städning

• Testa anslutning kontrollerar att appen når din Home Assistant och att det inklistrade shell_command faktiskt finns där, så att du hittar ett skrivfel innan du bygger något ovanpå det.
• Synka med HA skriver eller uppdaterar skripten för dina scener och kontroller, och bygger en färdig Projector Pilot-panel direkt i Home Assistant. Kör den igen när du lägger till en scen eller ändrar en kontroll - den uppdaterar på plats i stället för att skapa dubbletter.
• Ta bort föräldralösa skript hittar skript som appen skrivit och som inte längre har någon matchande scen eller kontroll - till exempel efter att du tagit bort en scen - listar exakt vilka den tar bort och frågar först. Ingenting raderas förrän du bekräftar. Den rör bara skript som Projector Pilot har skapat; inget annat i din Home Assistant störs, och om Home Assistant inte vill lista sina skript tas ingenting bort.

• Ansluten till Home Assistant - inloggad och svarar. Om Home Assistant inte svarar ber raden dig kontrollera adressen och att telefonen är på samma nätverk.
• Projektor tillagd i Home Assistant - om Home Assistant redan har den här projektorn. Om den inte har det skickar raden dig till att lägga till PJLink-integrationen, och steget för att lägga till integrationen visar den PJLink-värd och port som Home Assistant frågar efter.
• Avläsningssensor registrerad - sensorn som bär din projektors avläsningar. Den registreras första gången appen läser projektorn, och raden erbjuder Registrera nu eller Slå på när något hindrar det.
• Vad din Home Assistant har - HACS (communitybutiken), integrationen Epson Projector Link, PJLink-integrationen och Projector Pilot-kommandona i configuration.yaml. Var och en visar Hittad, Inte installerad eller Kunde inte avgöra, med knapparna Så installerar du och Öppna i HACS där de hjälper.

• Inbyggda kort först. Om du inte har några communitykort bygger Synka din panel med Home Assistants inbyggda kort och säger det när den är klar. Det fungerar direkt.
• Uppgraderas när HACS-kort är installerade. Appen kontrollerar vilka av communitykorten (Mushroom, button-card, card-mod, apexcharts-card) som är installerade och uppgraderar varje kort till det rikare där du har det. Guiden för den handbyggda panelen går längre om du vill ha hela det gröna glasutseendet.
• Scener och kontroller kräver den enda inklistringen. Om Home Assistant ännu inte har något kommando för att skicka till projektorn byggs panelen ändå med live-avläsningar, och ett kort Slutför installationen går igenom det: tryck på Kopiera block, klistra in det i configuration.yaml, starta om Home Assistant och tryck sedan på Synka igen.
• Inget installerat? Klistra in för hand. Om inget är installerat i Home Assistant kan du ändå kopiera allt från appen och klistra in det själv.
• Ett lösenord lyfts fram. Kommandoblocket du klistrar in talar om när det innehåller ett projektorlösenord, så att du vet det innan du delar eller sparar det.

• Det är ett valfritt block till: klistra in det i slutet av configuration.yaml (eller lägg bara till dess rader under ett befintligt template:-avsnitt) och starta om Home Assistant. Appen har en knapp Kontrollera att den finns som talar om för dig om Home Assistant har den.
• En avstängning når nu Home Assistant som off, så att panelen och dina automationer ser projektorn som avstängd när den är det.

• Automationer kan köra dem. ”Vid solnedgången, om TV:n slås på, kör Filmkväll” är en vanlig Home Assistant-automation så fort scenen är ett skript.
• Röstassistenter kan köra dem. Exponera ett skript för din assistent och ”slå på Filmkväll” ställer in ingången, bildläget och objektivminnet på en gång.
• Bara dina riktiga kontroller visas. Appen skriver ett skript för varje ingång, färgläge och objektivminne som projektorn rapporterar - inte en generisk lista som den gissat sig till.
• Att ta bort synken tar bara bort det appen skrev. Stäng av synken, eller använd Ta bort föräldralösa skript (som listar dem och frågar först), så raderar Projector Pilot de skript den skapade och ingenting annat.

Instrumentpanelen

Synka bygger panelen åt dig

Du behöver inte bygga en Lovelace-vy för hand, och du behöver inte längre klistra in en heller. När du trycker på Synka med HA bygger appen en komplett Projector Pilot-panel direkt i Home Assistant via dess eget API: projektorns live-status och en knapp för varje scen och kontroll som den synkat. Den dyker upp i sidofältet i Home Assistant som Projector Pilot - öppna den så är det klart.

1. Logga in på Home Assistant i appen.
2. Klistra in appens Kopiera-block i configuration.yaml en gång och starta om Home Assistant (det enda manuella steget - Home Assistant låter inte appar lägga till det kommandot på distans).
3. Tryck på Synka med HA. Panelen byggs åt dig och dyker upp i sidofältet som Projector Pilot.

Oavsett om den byggs åt dig eller du klistrar in den är panelen densamma - ett statuskort plus en knapp för varje kontroll (förenklat utdrag):

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

Endast exempel. Din panel har din projektors riktiga entity och dina egna scener.

1. Aktivera appen Maker API i Hubitat och notera dess åtkomst-URL och token, och välj vilka enheter den exponerar.
2. Öppna Inställningar › Hemautomation › Hubitat i Projector Pilot och ange uppgifterna för din hubbs Maker API.
3. Välj den enhet som representerar projektorn. Appen föreslår den troliga; välj den eller markera din egen.
4. Appen speglar ström, tystning och ingång på den enheten och skickar bara de kommandon som enheten accepterar.
5. Bygg Rule Machine-regler mot den enheten på samma sätt som för vilken annan som helst - projektorns status styr dem.

1. Öppna Inställningar › Hemautomation › Webhooks.
2. Ange URL:en att posta till. En Home Assistant-webhook ser ut som http://homeassistant.local:8123/api/webhook/your-id.
3. Välj vilka händelser som utlöser webhooken: påslagning, avstängning, ingångsbyte, scenåterkallning - och filtrera eventuellt till en viss ingång eller scen.
4. Ange vid behov en anpassad nyttolast om den mottagande tjänsten vill ha en särskild form; annars skickar appen sin standard-JSON.
5. Spara. Appen postar vid varje matchande händelse från och med nu.

Standardnyttolasten är vanlig JSON - en händelse, projektorn och det värde som ändrades:

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

Exempel på nyttolast. En ingångsändring eller en strömhändelse bär de fält som är relevanta för den.