Twój projektor, w Home Assistant i Hubitat.

• Publikuje stan. Projektor pojawia się jako czujnik Home Assistant, urządzenie Hubitat albo ładunek JSON w Twoim webhooku, niosący te same odczyty, które pokazuje aplikacja.
• Publikuje sterowanie. Każda zapisana scena, a także zasilanie, każde wejście, każdy tryb koloru i każda pamięć obiektywu, staje się czymś, co może uruchomić automatyzacja lub asystent głosowy.
• Działa bez serwera. Po skonfigurowaniu skryptów Home Assistant wysyła polecenia prosto na adres IP projektora. Telefon nie musi być w sieci i nic nie przechodzi przez konto w chmurze.

Trzy drogi, jeden hub

Ustawienia › Automatyka domowa to hub. Wybierz platformę, której używasz - Home Assistant, Hubitat lub Webhooki - i skonfiguruj ją tam. Możesz połączyć kilka naraz; są niezależne.

1. Otwórz Ustawienia › Automatyka domowa › Home Assistant.
2. Wpisz swój adres Home Assistant (na przykład http://homeassistant.local:8123 lub jego IP), a potem dotknij Zaloguj się. To logowanie w przeglądarce do Twojej własnej instancji - nie ma tokenu do wklejania. Użyj zwykłego loginu Home Assistant, razem z uwierzytelnianiem dwuskładnikowym.
3. Aplikacja publikuje projektor jako czujnik z encją w rodzaju sensor.projector_pilot_epson_qb1000b_qb1000w, niosący zasilanie, wejście, tryb koloru, wartości obrazu i godziny pracy lampy.
4. Włącz Wysyłaj stan projektora, aby te odczyty aktualizowały się w Home Assistant przy każdej zmianie, gdy aplikacja jest otwarta, oraz włącz Synchronizuj zaawansowane sterowanie, by opublikować skrypty dla trybów obrazu, wejść, pamięci obiektywu i zasilania.
5. Wklej jeden blok shell_command (poniżej) do swojego configuration.yaml, uruchom ponownie Home Assistant, a potem dotknij Synchronizuj z HA.

Blok shell_command

To cała sztuczka bez serwera. Aplikacja zapisuje jedno polecenie, które Home Assistant uruchamia, by rozmawiać z Web Control projektora, a każdy synchronizowany skrypt wywołuje to polecenie z innym czasownikiem. Dotknij w aplikacji Kopiuj blok i wklej go do configuration.yaml. Poniższy przykład jest poglądowy - aplikacja wstawia własny adres projektora i nazwę polecenia:

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

Tylko przykład. Aplikacja generuje Twój z prawdziwym IP projektora i nazwą utworzoną z jego numeru seryjnego.

Testuj połączenie, synchronizacja i porządki

• Testuj połączenie sprawdza, czy aplikacja dociera do Twojego Home Assistant i czy wklejony shell_command faktycznie tam jest, więc literówkę znajdziesz, zanim zbudujesz na tym cokolwiek.
• Synchronizuj z HA zapisuje lub aktualizuje skrypty dla Twoich scen i elementów sterowania oraz buduje gotowy panel Projector Pilot prosto w Home Assistant. Uruchom go ponownie, gdy dodasz scenę albo zmienisz sterowanie - aktualizuje na miejscu, zamiast mnożyć duplikaty.
• Usuń osierocone skrypty znajduje skrypty zapisane przez aplikację, które nie mają już odpowiadającej sceny lub sterowania - na przykład po usunięciu sceny - wymienia dokładnie, które usunie, i najpierw pyta. Nic nie jest usuwane, dopóki nie potwierdzisz. Dotyka tylko skryptów utworzonych przez Projector Pilot; nic innego w Twoim Home Assistant nie jest naruszane, a jeśli Home Assistant nie wyświetli listy skryptów, nic nie jest usuwane.

• Połączono z Home Assistant - zalogowano i odpowiada. Jeśli Home Assistant nie odpowiada, wiersz każe sprawdzić adres i to, czy telefon jest w tej samej sieci.
• Projektor dodany do Home Assistant - czy Home Assistant ma już ten projektor. Jeśli nie, wiersz odsyła do dodania integracji PJLink, a krok dodawania integracji pokazuje host i port PJLink, o które pyta Home Assistant.
• Czujnik odczytów zarejestrowany - czujnik niosący odczyty Twojego projektora. Rejestruje się przy pierwszym odczycie projektora przez aplikację, a wiersz oferuje Zarejestruj teraz lub Włącz, gdy coś go blokuje.
• Co ma Twój Home Assistant - HACS (sklep społeczności), integracja Epson Projector Link, integracja PJLink i polecenia Projector Pilot w configuration.yaml. Każdy pokazuje Znaleziono, Nie zainstalowano lub Nie udało się ustalić, z przyciskami Jak zainstalować i Otwórz w HACS tam, gdzie pomagają.

• Najpierw wbudowane karty. Jeśli nie masz kart społeczności, Synchronizacja buduje panel z wbudowanych kart Home Assistant i mówi o tym na koniec. Działa od razu po instalacji.
• Ulepszane, gdy zainstalowane są karty HACS. Aplikacja sprawdza, które z kart społeczności (Mushroom, button-card, card-mod, apexcharts-card) są zainstalowane, i zamienia każdą kartę na bogatszą tam, gdzie ją masz. Przewodnik po ręcznie budowanym panelu idzie dalej, jeśli chcesz pełnego wyglądu zielonego szkła.
• Sceny i sterowanie wymagają jednego wklejenia. Jeśli Home Assistant nie ma jeszcze polecenia wysyłania do projektora, panel i tak jest budowany z odczytami na żywo, a karta Dokończ konfigurację prowadzi Cię przez to: dotknij Kopiuj blok, wklej go do configuration.yaml, uruchom ponownie Home Assistant, a potem dotknij Synchronizuj ponownie.
• Nic nie zainstalowano? Wklej ręcznie. Jeśli w Home Assistant nic nie jest zainstalowane, nadal możesz skopiować wszystko z aplikacji i wkleić samodzielnie.
• Hasło jest sygnalizowane. Wklejany blok poleceń informuje, gdy zawiera hasło projektora, więc wiesz o tym, zanim go udostępnisz lub zapiszesz.

• To kolejny opcjonalny blok: wklej go na końcu configuration.yaml (albo dodaj tylko jego wiersze pod istniejącą sekcją template:) i uruchom ponownie Home Assistant. Aplikacja ma przycisk Sprawdź, czy jest, który mówi, czy Home Assistant go ma.
• Wyłączenie zasilania dociera teraz do Home Assistant jako wyłączony, więc panel i Twoje automatyzacje widzą projektor jako wyłączony, gdy taki jest.

• Automatyzacje mogą je uruchamiać. „O zachodzie słońca, jeśli TV się włączy, uruchom Wieczór filmowy” to zwykła automatyzacja Home Assistant, gdy scena jest skryptem.
• Asystenci głosowi mogą je uruchamiać. Udostępnij skrypt asystentowi, a „włącz Wieczór filmowy” ustawi razem wejście, tryb obrazu i pamięć obiektywu.
• Pojawiają się tylko Twoje prawdziwe elementy sterowania. Aplikacja zapisuje skrypt dla każdego wejścia, trybu koloru i pamięci obiektywu zgłaszanych przez projektor - nie ogólną listę, którą się domyśliła.
• Wyłączenie synchronizacji usuwa tylko to, co zapisała aplikacja. Wyłącz synchronizację albo użyj Usuń osierocone skrypty (które je wymienia i najpierw pyta), a Projector Pilot usunie skrypty, które utworzył, i nic więcej.

Kokpit

Synchronizacja buduje panel za Ciebie

Nie musisz ręcznie budować widoku Lovelace i nie musisz go już wklejać. Gdy dotkniesz Synchronizuj z HA, aplikacja buduje kompletny panel Projector Pilot bezpośrednio w Home Assistant przez jego własne API: stan projektora na żywo i przycisk dla każdej zsynchronizowanej sceny i elementu sterowania. Pojawia się w panelu bocznym Home Assistant jako Projector Pilot - otwierasz i gotowe.

1. Zaloguj się do Home Assistant w aplikacji.
2. Wklej blok do skopiowania z aplikacji do configuration.yaml raz i uruchom ponownie Home Assistant (jedyny ręczny krok - Home Assistant nie pozwala aplikacjom dodawać tego polecenia zdalnie).
3. Dotknij Synchronizuj z HA. Panel zostaje zbudowany i pojawia się w panelu bocznym jako Projector Pilot.

Niezależnie od tego, czy zbudowano go za Ciebie, czy wkleiłeś sam, panel jest taki sam - karta stanu i przycisk dla każdego sterowania (fragment poglądowy):

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

Tylko przykład. Twój panel niesie prawdziwą encję Twojego projektora i Twoje własne sceny.

1. W Hubitat włącz aplikację Maker API, zanotuj jej URL dostępu i token oraz wybierz, które urządzenia udostępnia.
2. W Projector Pilot otwórz Ustawienia › Automatyka domowa › Hubitat i wpisz dane Maker API swojego hubu.
3. Wybierz urządzenie reprezentujące projektor. Aplikacja podpowiada prawdopodobne; wybierz je albo wskaż własne.
4. Aplikacja odzwierciedla zasilanie, wyciszenie i wejście na tym urządzeniu, wysyłając tylko polecenia, które urządzenie akceptuje.
5. Buduj reguły Rule Machine względem tego urządzenia tak jak dla każdego innego - stan projektora je napędza.

1. Otwórz Ustawienia › Automatyka domowa › Webhooki.
2. Wpisz adres URL, na który ma trafiać żądanie. Webhook Home Assistant wygląda jak http://homeassistant.local:8123/api/webhook/your-id.
3. Wybierz, które zdarzenia uruchamiają webhook: włączenie, wyłączenie, zmiana wejścia, przywołanie sceny - a opcjonalnie filtruj do konkretnego wejścia lub sceny.
4. Opcjonalnie ustaw własny ładunek, jeśli usługa odbierająca oczekuje określonego kształtu; w przeciwnym razie aplikacja wysyła domyślny JSON.
5. Zapisz. Od tej pory aplikacja wysyła żądanie przy każdym pasującym zdarzeniu.

Domyślny ładunek to zwykły JSON - zdarzenie, projektor i wartość, która się zmieniła:

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

Przykładowy ładunek. Zdarzenie zmiany wejścia lub zasilania niesie pola, które go dotyczą.