Integrace

Acer Projector

Integrace Acer Projector ovládá vybrané projektory Acer připojené sériovou linkou RS232. V RichPear Home se projektor chová jako spínač: zapnutí a vypnutí posílá příkazy do projektoru a při obnově stavu načítá stav lampy, počet hodin lampy, vstup a ECO režim.

Přejít na nastavení Zpět na audit

Doména: acer_projector
Kategorie: Multimédia
Komunikace: local-polling
Nastavení: configuration.yaml

Připravte projektor a sériový port

Projektor musí být připojený k systému RichPear Home přes RS232 nebo přes USB-RS232 převodník. Integrace nepoužívá síťové API ani cloudový účet, komunikuje přímo přes zařízení typu /dev/ttyUSB0.

Před úpravou konfigurace ověřte, že hostitel RichPear Home sériový adaptér vidí a že cesta k zařízení zůstává stabilní i po restartu.

Kontrola před nastavením

Projektor Acer podporuje sériové ovládání kompatibilní s příkazy Acer Projector.
RS232 kabel nebo USB-RS232 převodník je připojený k hostiteli RichPear Home.
Znáte cestu k sériovému zařízení, například /dev/ttyUSB0 nebo stabilní cestu v /dev/serial/by-id/.
Instalace RichPear Home má k zařízení přístup. U kontejnerové instalace musí být sériové zařízení předané do kontejneru.

Ověřte průvodce v RichPear Home

V českém RichPear Home otevřete Nastavení → Zařízení a služby → Přidat integraci a vyhledejte Acer Projector. Integrace je v seznamu dostupná, ale je označená jako integrace bez nastavitelného UI průvodce.

Vyhledání integrace Acer Projector v českém RichPear Home — Acer Projector se v dialogu Přidat integraci najde, ale u položky je ikona ruční konfigurace.

Použijte ruční konfiguraci

Po výběru integrace RichPear Home zobrazí upozornění, že ji nelze přidat přes uživatelské rozhraní. Reálný postup je proto úprava configuration.yaml a následný restart RichPear Home.

Upozornění, že Acer Projector nelze přidat přes uživatelské rozhraní — RichPear Home potvrzuje, že Acer Projector se přidává přes `configuration.yaml`.

Přidejte položku do configuration.yaml

Do konfigurace přidejte platformu acer_projector pod sekci switch. Povinná je pouze položka filename, tedy cesta k sériovému portu. Název a timeouty upravte podle instalace.

Po uložení konfigurace proveďte kontrolu konfigurace a restartujte RichPear Home. Potom otevřete Nastavení → Zařízení a služby a zkontrolujte vytvořenou entitu.

Příklad konfigurace

switch:
  - platform: acer_projector
    filename: /dev/ttyUSB0
    name: Projektor v obýváku
    timeout: 1
    write_timeout: 1

Zkontrolujte entitu a atributy

Integrace vytvoří jednu entitu typu spínač. Její zapnutý stav vychází z odpovědi projektoru na dotaz na lampu. Pokud projektor odpoví stavem Lamp 1, entita je zapnutá. Pokud odpoví Lamp 0, entita je vypnutá.

Při obnově stavu integrace načítá také atributy Lamp Hours, Input Source a ECO Mode. Tyto údaje použijte pro dashboard nebo servisní kontrolu lampy.

Co u entity ověřit

Entita se zobrazí jako spínač s ikonou projektoru.
Zapnutí a vypnutí odpovídá skutečnému chování projektoru.
Atribut Lamp Hours se po obnově stavu mění podle projektoru.
Při odpojeném nebo nereagujícím projektoru se entita může stát nedostupnou.

Použijte akce spínače

Acer Projector nepřidává vlastní doménové akce. Ovládání probíhá přes standardní akce spínače v RichPear Home: switch.turn_on, switch.turn_off, případně switch.toggle.

V automatizacích počítejte s tím, že projektor může na zapnutí nebo vypnutí reagovat pomaleji než běžné relé. Po zapnutí nechte projektoru čas na start lampy a další povely posílejte až po ustálení stavu.

Příklad automatizace

automation:
  - alias: Zapnout projektor pro filmový režim
    trigger:
      - platform: state
        entity_id: input_boolean.filmovy_rezim
        to: "on"
    action:
      - action: switch.turn_on
        target:
          entity_id: switch.projektor_v_obyvaku

Řešení problémů

Nejčastější problém není v samotné entitě, ale v sériovém spojení. Pokud RichPear Home hlásí problém komunikace, ověřte cestu k portu, oprávnění, fyzické zapojení RS232 a nastavení předání zařízení do systému, ve kterém RichPear Home běží.

Pokud projektor jednou odpovídá a podruhé ne, zvyšte timeout nebo write_timeout a ověřte kvalitu převodníku. Levné USB-RS232 adaptéry mohou po uspání hostitele změnit zařízení z /dev/ttyUSB0 na jiné číslo.

Rychlá diagnostika

Po restartu ověřte, že cesta v filename stále existuje.
U kontejneru zkontrolujte, že je sériové zařízení předané do kontejneru a není blokované oprávněními.
Vyzkoušejte stabilní cestu /dev/serial/by-id/... místo proměnlivého /dev/ttyUSB0.
Ujistěte se, že kabel je RS232 a ne pouze servisní USB kabel bez sériového rozhraní.
Po změně YAML konfigurace vždy proveďte kontrolu konfigurace a restart RichPear Home.

URL

Lokální adresa systému

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.