Panduan Home Assistant & Hubitat untuk Proyektor

Ikhtisar

Apa yang dilakukan Otomasi Rumah

Otomasi Rumah mengubah Projector Pilot dari remote di tangan Anda menjadi perangkat yang bisa dilihat seluruh rumah. Ia menampilkan apa yang dilakukan proyektor - daya, input, mode warna, angka gambar, jam lampu - dan memberi rumah pintar Anda kontrol atas semua yang bisa diubah aplikasi.

Ia menerbitkan status. Proyektor muncul sebagai sensor Home Assistant, perangkat Hubitat, atau payload JSON di webhook Anda, membawa pembacaan yang sama dengan yang ditampilkan aplikasi.
Ia menerbitkan kontrol. Setiap Skenario yang Anda simpan, plus daya, setiap input, setiap mode warna, dan setiap memori lensa, menjadi sesuatu yang bisa dijalankan oleh otomasi atau asisten suara.
Ia berjalan tanpa server. Setelah skrip disiapkan, Home Assistant mengirim perintah langsung ke alamat IP proyektor. Ponsel Anda tidak perlu berada di jaringan, dan tidak ada yang melewati akun cloud.

Otomasi Rumah adalah add-on berbayar. Pembeliannya sekali saja, terpisah dari Projector Pilot Pro, dan paket bundel membeli keduanya sekaligus dengan harga lebih hemat. Tanpa langganan, tanpa akun, tanpa cloud. Lihat harga.

Tiga jalur masuk, satu hub

Pengaturan › Otomasi Rumah adalah hubnya. Pilih platform yang Anda gunakan - Home Assistant, Hubitat, atau Webhook - dan atur di sana. Anda bisa menghubungkan lebih dari satu sekaligus; semuanya independen.

Home Assistant

Siapkan Home Assistant

Masuk dari aplikasi, terbitkan proyektor sebagai sensor, tempel satu blok ke konfigurasi Anda, lalu sinkron. Sejak itu Home Assistant menjalankan proyektor sendiri.

Buka Pengaturan › Otomasi Rumah › Home Assistant.
Ketik alamat Home Assistant Anda (misalnya http://homeassistant.local:8123 atau IP-nya), lalu ketuk Masuk. Ini adalah login lewat browser ke instans Anda sendiri - tidak ada token untuk ditempel. Gunakan login Home Assistant biasa Anda, lengkap dengan autentikasi dua faktor.
Aplikasi menerbitkan proyektor sebagai sensor, dengan entitas seperti sensor.projector_pilot_epson_qb1000b_qb1000w, yang membawa daya, input, mode warna, angka gambar, dan jam lampu.
Aktifkan Kirim status proyektor agar pembacaan itu diperbarui di Home Assistant setiap kali berubah selama aplikasi terbuka, dan aktifkan Sync Advanced Controls untuk menerbitkan skrip untuk mode gambar, input, memori lensa, dan daya.
Tempel satu blok shell_command (di bawah) ke configuration.yaml Anda, mulai ulang Home Assistant, lalu ketuk Sync With HA.

Blok shell_command

Inilah seluruh trik tanpa server. Aplikasi menulis satu perintah yang dijalankan Home Assistant untuk berbicara dengan Web Control proyektor, dan setiap skrip yang disinkronkan memanggil perintah itu dengan kata kerja berbeda. Ketuk Copy block di aplikasi dan tempel ke configuration.yaml. Contoh di bawah hanya ilustrasi - aplikasi mengisi alamat dan nama perintah proyektor Anda sendiri:

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

Hanya contoh. Aplikasi membuat milik Anda dengan IP asli proyektor dan nama yang diturunkan dari nomor serinya.

Mengapa tanpa server. curl itu berjalan di perangkat Home Assistant, bukan ponsel Anda. Home Assistant menjangkau IP proyektor langsung lewat Web Control, sehingga otomasi berjalan entah aplikasi terbuka atau tidak dan entah ponsel Anda di rumah atau tidak. Pengguna digest EPSONWEB adalah login Web Control; aplikasi memakai kata sandi Web Control yang sudah tersimpan untuk proyektor.

Test Connection, Sync, dan pembersihan

Test Connection memeriksa bahwa aplikasi bisa menjangkau Home Assistant Anda dan bahwa shell_command yang ditempel benar-benar ada, sehingga Anda menemukan salah ketik sebelum membangun apa pun di atasnya.
Sync With HA menulis atau memperbarui skrip untuk Skenario dan kontrol Anda, dan membuat dasbor Projector Pilot siap pakai langsung di Home Assistant. Jalankan lagi kapan saja saat Anda menambah Skenario atau mengubah kontrol - ia memperbarui di tempat, tidak menumpuk duplikat.
Remove orphaned scripts menemukan skrip yang ditulis aplikasi yang tidak lagi punya Skenario atau kontrol yang cocok - misalnya setelah Anda menghapus Skenario - menampilkan daftar persis mana yang akan dihapus, dan bertanya dulu. Tidak ada yang dihapus sampai Anda konfirmasi. Ia hanya menyentuh skrip yang dibuat Projector Pilot; tidak ada hal lain di Home Assistant Anda yang terganggu, dan jika Home Assistant tidak mau menampilkan daftar skripnya, tidak ada yang dihapus.

Daftar periksa penyiapan

Aplikasi memberi tahu apa yang sudah selesai dan apa yang kurang

Layar Home Assistant memiliki Daftar periksa penyiapan dan panel Apa yang dimiliki Home Assistant Anda, sehingga Anda tidak perlu menebak langkah mana yang tersisa. Setiap baris menyatakan apakah sudah selesai, kurang, atau tidak bisa dipastikan, dan menjelaskan apa yang harus dilakukan selanjutnya.

Terhubung ke Home Assistant - sudah masuk dan menjawab. Jika Home Assistant tidak menjawab, baris ini meminta Anda memeriksa alamat dan memastikan ponsel Anda di jaringan yang sama.
Proyektor ditambahkan ke Home Assistant - apakah Home Assistant sudah memiliki proyektor ini. Jika belum, baris ini mengarahkan Anda menambahkan integrasi PJLink, dan langkah tambah integrasi menampilkan host dan port PJLink yang diminta Home Assistant.
Sensor pembacaan terdaftar - sensor yang membawa pembacaan proyektor Anda. Sensor ini terdaftar saat pertama kali aplikasi membaca proyektor, dan baris ini menawarkan Daftarkan sekarang atau Aktifkan saat ada yang menghalanginya.
Apa yang dimiliki Home Assistant Anda - HACS (toko komunitas), integrasi Epson Projector Link, integrasi PJLink, dan perintah Projector Pilot di configuration.yaml. Masing-masing menampilkan Ditemukan, Tidak terpasang, atau Tidak bisa dipastikan, dengan tombol Cara memasang dan Buka di HACS jika berguna.

Periksa lagi memberi tahu apa yang ditemukan. Ketuk Periksa lagi setelah Anda memperbaiki sesuatu dan aplikasi membaca ulang Home Assistant Anda lalu melaporkan hasilnya, bukan membiarkan Anda bertanya-tanya apakah berhasil. Baris yang tidak bisa diperiksa menyatakan Tidak bisa dipastikan, tidak pernah ya atau tidak yang ditebak.

Bekerja dengan apa yang sudah Anda punya

Dukungan integrasi PJLink inti, dan kartu yang lebih kaya jika Anda memilikinya

Projector Pilot mencari tahu apa yang terpasang di Home Assistant Anda dan membangun di sekitarnya. Ia bekerja dengan integrasi PJLink inti yang sudah disertakan Home Assistant, sehingga proyektor PJLink yang sudah Anda tambahkan di sana diperlakukan sebagai warga kelas satu.

Kartu bawaan lebih dulu. Jika Anda tidak punya kartu komunitas, Sync membangun dasbor Anda dengan kartu bawaan Home Assistant dan menyatakannya saat selesai. Langsung berfungsi tanpa penyiapan tambahan.
Ditingkatkan saat kartu HACS terpasang. Aplikasi memeriksa kartu komunitas mana (Mushroom, button-card, card-mod, apexcharts-card) yang terpasang dan meningkatkan setiap kartu ke yang lebih kaya jika Anda memilikinya. Panduan dasbor buatan manual melangkah lebih jauh jika Anda ingin tampilan green-glass penuh.
Skenario dan kontrol butuh satu kali tempel. Jika Home Assistant belum punya perintah untuk mengirim ke proyektor, dasbor tetap dibuat dengan pembacaan langsung, dan kartu Selesaikan penyiapan memandu Anda: ketuk Copy block, tempel ke configuration.yaml, mulai ulang Home Assistant, lalu ketuk Sync lagi.
Tidak ada yang terpasang? Tempel manual. Jika tidak ada yang terpasang di Home Assistant, Anda tetap bisa menyalin semuanya dari aplikasi dan menempelkannya sendiri.
Kata sandi diberi tanda. Blok perintah yang Anda tempel menyatakan saat ia membawa kata sandi proyektor, sehingga Anda tahu sebelum membagikan atau menyimpannya.

Saat proyektor mati

Pembacaan yang tetap bertahan

Proyektor dalam standby melaporkan sangat sedikit, sehingga dasbor biasanya menjadi kosong. Sensor terakhir diketahui opsional menyimpan pembacaan terakhir proyektor Anda - input, jam lampu atau laser - di Home Assistant selama proyektor mati.

Ini satu blok opsional lagi: tempel di akhir configuration.yaml (atau tambahkan hanya barisnya di bawah seksi template: yang sudah ada) dan mulai ulang Home Assistant. Aplikasi punya tombol Periksa apakah sudah ada yang memberi tahu apakah Home Assistant memilikinya.
Daya yang dimatikan kini sampai ke Home Assistant sebagai off, sehingga dasbor dan otomasi Anda melihat proyektor sebagai mati saat memang mati.

Skenario sebagai skrip

Setiap Skenario menjadi skrip Home Assistant

Setelah sinkron, Skenario Anda tidak terkunci di dalam aplikasi. Masing-masing, plus daya, setiap input, setiap mode warna, dan setiap memori lensa yang benar-benar dimiliki proyektor Anda, ditulis sebagai skrip Home Assistant.

Otomasi bisa menjalankannya. "Saat matahari terbenam, jika TV menyala, jalankan Movie Night" adalah otomasi Home Assistant biasa begitu Skenario menjadi skrip.
Asisten suara bisa menjalankannya. Ekspos skrip ke asisten Anda dan "nyalakan Movie Night" mengatur input, mode gambar, dan memori lensa sekaligus.
Hanya kontrol nyata Anda yang muncul. Aplikasi menulis skrip untuk setiap input, mode warna, dan memori lensa yang dilaporkan proyektor - bukan daftar umum hasil tebakan.
Menghapus sinkron hanya menghapus yang ditulis aplikasi. Matikan sinkron, atau gunakan Remove orphaned scripts (yang menampilkan daftarnya dan bertanya dulu), dan Projector Pilot menghapus skrip yang dibuatnya dan tidak ada yang lain.

Skrip dinamai agar penggantian nama memperbarui skrip yang sama. Nama skrip diturunkan dari proyektor dan kontrolnya, sehingga sinkron ulang setelah Anda mengganti nama Skenario memperbarui skrip yang ada, bukan membuat salinan kedua.

Dasbor

Sync membuatkan dasbor untuk Anda

Anda tidak perlu membuat tampilan Lovelace secara manual, dan tidak perlu lagi menempelkannya. Saat Anda mengetuk Sync With HA, aplikasi membangun dasbor Projector Pilot lengkap langsung di Home Assistant lewat API-nya sendiri: status langsung proyektor dan tombol untuk setiap Skenario dan kontrol yang disinkronkan. Dasbor itu muncul di bilah samping Home Assistant Anda sebagai Projector Pilot - buka dan selesai.

Dasbor Projector Pilot di Home Assistant: daya dan sumber, mode warna, menu gambar lengkap, HDR dan sinyal, kalibrasi RGB, lensa dan geometri, grafik jam laser, perawatan, dan Skenario - semuanya sebagai petak green glass — Versi dasbor yang lebih kaya dan dibuat manual. Dasbor yang dibuat Sync membawa status langsung dan tombol yang sama dalam kartu Home Assistant standar; tampilan green glass di bawah adalah versi kustom opsional. Gulir, atau klik untuk memperbesar.

Masuk ke Home Assistant di aplikasi.
Tempel blok Copy aplikasi ke configuration.yaml sekali saja dan mulai ulang Home Assistant (satu-satunya langkah manual - Home Assistant tidak mengizinkan aplikasi menambahkan perintah itu dari jarak jauh).
Ketuk Sync With HA. Dasbor dibuat untuk Anda dan muncul di bilah samping sebagai Projector Pilot.

Lebih suka menempelnya sendiri? Salin dasbor masih ada di layar Home Assistant. Ketuk, lalu di Home Assistant buka Pengaturan › Dasbor › Tambah Dasbor, buat dasbor kosong, buka menu tiga titiknya › Edit dashboard › menu tiga titik › Raw configuration editor, dan tempel YAML yang disalin.

Entah dibuatkan untuk Anda atau Anda tempel sendiri, dasbornya sama - kartu status plus tombol untuk setiap kontrol (cuplikan ilustrasi):

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

Hanya contoh. Dasbor Anda membawa entitas asli proyektor Anda dan Skenario Anda sendiri.

Tidak terikat model. Dasbor dibuat dari kemampuan proyektor Anda sendiri - entitas, angka gambar, input, mode warna, memori lensa, dan Skenario yang benar-benar dilaporkannya. Tangkapan layar di sini adalah QB1000; model Anda mungkin menampilkan input, kontrol, dan pembacaan yang berbeda. Untuk dasbor green-glass penuh seperti yang tampak, ikuti panduan dasbor langkah demi langkah atau unduh tampilan lengkapnya dan ubah dua string.

Ingin dinding yang lebih kaya? Skrip yang sama menggerakkan kartu apa pun yang Anda suka. Jika Anda pernah memakai AVR Maestro, pendekatannya identik - buat petak sumber dan mode yang menyala, header langsung, dan riwayat dari satu sensor dan skrip yang disinkronkan.

Hubitat

Siapkan Hubitat

Di Hubitat, Projector Pilot mencerminkan proyektor ke sebuah perangkat di hub Anda lewat Maker API, sehingga Rule Machine bisa membaca dan bertindak atas daya, mute, dan input.

Di Hubitat, aktifkan aplikasi Maker API dan catat URL akses serta tokennya, lalu pilih perangkat mana yang diekspos.
Di Projector Pilot, buka Pengaturan › Otomasi Rumah › Hubitat dan masukkan detail Maker API hub Anda.
Pilih perangkat yang mewakili proyektor. Aplikasi menyarankan yang paling mungkin; pilih itu atau pilih milik Anda sendiri.
Aplikasi mencerminkan daya, mute, dan input ke perangkat itu, hanya mengirim perintah yang diterima perangkat.
Buat aturan Rule Machine terhadap perangkat itu seperti perangkat lainnya - status proyektor yang menggerakkannya.

Hanya yang diterima perangkat. Aplikasi mengirim nilai proyektor ke Hubitat hanya jika perangkat yang dipilih mendukung perintah itu, sehingga tidak pernah mendorong sesuatu yang akan ditolak perangkat.

Webhook

Siapkan Webhook

Webhook adalah penampung segala keperluan. Aplikasi mengirim ke URL milik Anda saat proyektor menyala, mati, berganti input, atau memanggil Skenario - webhook Home Assistant, Node-RED, IFTTT, atau apa pun yang menerima JSON.

Buka Pengaturan › Otomasi Rumah › Webhook.
Masukkan URL tujuan pengiriman. Webhook Home Assistant terlihat seperti http://homeassistant.local:8123/api/webhook/your-id.
Pilih peristiwa mana yang memicu webhook: daya menyala, daya mati, perubahan input, pemanggilan Skenario - dan secara opsional saring ke input atau Skenario tertentu.
Secara opsional atur payload kustom jika layanan penerima menginginkan bentuk tertentu; jika tidak, aplikasi mengirim JSON default-nya.
Simpan. Sejak itu aplikasi mengirim pada setiap peristiwa yang cocok.

Payload default adalah JSON biasa - sebuah peristiwa, proyektor, dan nilai yang berubah:

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

Contoh payload. Peristiwa perubahan input atau daya membawa kolom yang relevan dengannya.

Menautkan ulang memperbaiki semuanya. Jika Anda menautkan ulang Home Assistant ke alamat baru, aplikasi memperbarui semua webhook yang mengarah ke sana sekaligus, sehingga instans yang pindah tidak berarti mengedit satu per satu secara manual.

Pemecahan masalah

Pastikan alamat yang Anda masukkan adalah alamat yang benar-benar Anda gunakan untuk menjangkau Home Assistant, termasuk port (biasanya :8123). Login ini adalah login browser sungguhan ke instans Anda, jadi nama pengguna, kata sandi, dan kode dua faktor Anda semuanya berlaku. Di ponsel, login selesai entah browser dalam aplikasi menyerahkan hasilnya atau callback lokal kembali lebih dulu; jika masih macet, tutup lembar itu dan ketuk Masuk lagi.

Sensor proyektor tidak muncul di Home Assistant

Sensor diterbitkan saat aplikasi terbuka dan Kirim status proyektor aktif, jadi buka aplikasi dan pastikan tombol itu. Lalu periksa Developer Tools › States di Home Assistant dan saring dengan projector_pilot. Proyektor dalam standby menerbitkan sangat sedikit; bangunkan dan pembacaannya akan terisi.

Skrip yang disinkronkan tidak ada

Skrip ditulis oleh Sync With HA, yang membutuhkan blok shell_command sudah ditempel ke configuration.yaml dan Home Assistant sudah dimulai ulang sekali. Jalankan Test Connection lebih dulu - ia memberi tahu apakah blok itu ada. Lalu Sync lagi. Jika skrip lama yang sudah mati memenuhi daftar, gunakan Remove orphaned scripts.

Skrip berjalan di aplikasi tetapi tidak dari Home Assistant saat ponsel saya tidak ada

Itulah tujuan blok shell_command - ia yang memungkinkan Home Assistant menjangkau IP proyektor sendiri. Jika hanya berfungsi saat aplikasi terbuka, kemungkinan blok belum ditempel atau Home Assistant belum dimulai ulang setelah menempel. Pastikan dengan Test Connection, mulai ulang Home Assistant, dan Sync.

FAQ

Jawaban singkat

Apakah ponsel saya harus tetap berada di jaringan agar otomasi Home Assistant berjalan?

Tidak. Setelah Anda menempelkan satu blok shell_command ke Home Assistant dan sinkron, Home Assistant mengirim perintah langsung ke alamat IP proyektor. Projector Pilot hanyalah alat penyiapan; setelah itu, Home Assistant berbicara dengan proyektor sendiri, entah ponsel Anda di rumah atau tidak.

Bagaimana proyektor muncul di Home Assistant?

Sebagai sensor, misalnya sensor.projector_pilot_epson_qb1000b_qb1000w, yang membawa daya, input, mode warna, angka gambar, dan jam lampu, diperbarui setiap kali berubah selama aplikasi terbuka. Aktifkan Sync Advanced Controls dan aplikasi juga menulis skrip Home Assistant untuk setiap Skenario, plus daya, setiap input, setiap mode warna, dan setiap memori lensa yang dimiliki proyektor Anda.

Apakah Otomasi Rumah gratis?

Otomasi Rumah adalah add-on berbayar, pembelian sekali, terpisah dari Projector Pilot Pro. Paket bundel membeli keduanya sekaligus dengan harga lebih hemat. Lihat halaman harga.

Proyektor Anda, di Home Assistant dan Hubitat.