Beranda › Panduan Pengguna › Dasbor Home Assistant
Home Assistant · langkah demi langkah

Bangun dasbor proyektor Home Assistant dalam sekitar satu jam

Aplikasi sudah membuatkan dasbor yang berfungsi saat Anda Sync - halaman ini adalah versi mewah yang dibuat manual. Sepuluh langkah, YAML setiap kartu, dan satu tampilan lengkap yang bisa ditempel sekaligus. Petak green glass, tampilan gambar langsung, Skenario Anda, dan grafik jam laser, semuanya dari satu sensor proyektor. Ubah dua string dan ini jadi milik Anda.

Sync membuatkan satu, gratis4 kartu HACS untuk tampilannyaPetak info langsung aktifTombol aktif setelah satu kali tempel
Dasbor Projector Pilot yang sudah jadi di Home Assistant: daya dan sumber, mode warna, menu gambar lengkap, HDR dan sinyal, kalibrasi RGB, lensa dan geometri, perawatan dengan grafik jam laser, dan Skenario, semuanya sebagai petak green glass
Yang akan Anda bangun. Gulir, atau klik untuk memperbesar.
Hanya ingin dasbor yang berfungsi? Anda sudah punya. Ketuk Sync With HA di aplikasi dan aplikasi membuatkan dasbor Projector Pilot siap pakai di bilah samping Home Assistant Anda, dengan setiap kontrol dan sensor langsung - tanpa kartu, tanpa YAML, tanpa tempel. Lihat Sync membuatkan dasbor untuk Anda. Halaman ini untuk membuat versi green-glass yang lebih kaya secara manual, atau menyesuaikan apa yang diberikan Sync.
Terburu-buru ingin tampilan kustom? Lompat ke langkah 10, unduh tampilan lengkapnya, ubah dua string dan tiga id Skenario, lalu tempel. Langkah-langkah di antaranya menjelaskan fungsi tiap bagian agar Anda bisa mengubahnya.

Sebelum Anda mulai

Dua hal mengisi dasbor ini, dan perbedaannya penting di setiap langkah berikut.

Berasal dariMemberi Anda
Sensor proyektor, sensor.YOUR_PROJECTORSetiap pembacaan. Daya, input, mode warna, semua angka gambar, HDR dan sinyal, lensa dan geometri, jam lampu. Langsung aktif begitu Anda masuk dan sinkron, tanpa blok Copy.
Skrip sinkron aplikasi, script.projpilot_YOURSERIAL_...Setiap kontrol. Daya, input, mode warna, memori lensa, dan Skenario Anda. Semua ini baru ada setelah blok Copy ditempel, Home Assistant dimulai ulang, dan Anda mengetuk Sync With HA.
Langkah 1

Pasang empat kartu dari HACS

Keempatnya ada di toko HACS bawaan. Di Home Assistant: HACS › Frontend › Explore & Download Repositories, cari namanya, Download, lalu muat ulang browser Anda.

CariDipakai untukJika dilewati
MushroomSetiap petak info, tombol kontrol, dan petak SkenarioGunakan kartu button biasa. Tetap berfungsi, tampilannya lebih kaku.
button-cardHero, dengan label langsungnyaGunakan kartu entity, atau kartu template Mushroom dengan detail lebih sedikit.
card-modLatar belakang green glass, bingkai, dan gradasiSemuanya tetap berfungsi. Hanya tidak ada efek cahayanya.
mini-graph-cardRiwayat jam laser di bawah PerawatanGunakan kartu history-graph bawaan.
Tidak satu pun wajib agar ini berfungsi. Setiap kontrol di bawah berjalan dari kartu tombol Home Assistant standar yang diarahkan ke skrip yang sama. Kartu kustom hanyalah tampilan green glass, bukan saluran kerjanya.
Langkah 2

Temukan ID entitas dan nomor seri Anda

Setiap cuplikan di halaman ini memakai dua placeholder. Temukan milik Anda satu kali, sisanya tinggal salin dan tempel.

Anda juga bisa menyaring Developer Tools › States dengan projpilot untuk melihat seluruh daftar kontrol yang disinkronkan sekaligus, setelah blok Copy langkah 1 dan Sync selesai.

Belum ada daftar skrip? Itu wajar sebelum Anda menempelkan blok Copy. Sensornya tetap ada dan tetap diperbarui; skrip baru muncul setelah Sync With HA berhasil dijalankan.
Langkah 3

Buat tampilan

  1. Pengaturan › Dasbor › Tambah Dasbor › Dasbor baru dari awal. Beri nama Projector Pilot.
  2. Buka dasbor itu, lalu ikon pensil di kanan atas untuk mengedit.
  3. Tambahkan tampilan. Tata letak apa pun bisa, tetapi dasbor asli memakai tumpukan kartu bawaan, satu di bawah yang lain, yang paling mudah untuk ditempel.
  4. Untuk menempel YAML, gunakan menu tiga titik pada kartu dan pilih Edit in YAML, atau menu tiga titik pada dasbor untuk Raw configuration editor agar bisa menempel seluruh tampilan sekaligus.

Pengaturan tampilan itu sendiri, jika Anda lebih suka mengetiknya:

title: Projector Pilot
views:
- title: Projector Pilot
  path: projector-pilot
  icon: mdi:projector
  cards: []
Langkah 4

Tambahkan petak info langsung

Mulailah dengan sesuatu yang hanya membaca, agar Anda tahu ID entitas Anda sudah benar sebelum menyentuh apa pun yang mengirim perintah. Petak ini aktif begitu sensor proyektor Anda ada, tanpa blok Copy, tanpa sinkron. Tambahkan kartu, Edit in YAML, tempel:

type: custom:mushroom-template-card
primary: Brightness
secondary: '{{ state_attr(''sensor.YOUR_PROJECTOR'',''brightness'') }}'
icon: mdi:brightness-6
icon_color: green
layout: vertical
fill_container: true
card_mod:
  style: 'ha-card { background: rgba(18,26,20,0.60); border: 1px solid rgba(61,220,107,0.20);
    border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32); backdrop-filter: blur(8px);
    min-height: 104px; }'

Bentuk yang sama bisa membaca atribut mana pun dari sekitar 80 atribut yang dibawa sensor: ganti brightness dengan contrast, gamma, color_temp, hdr_pq, lamp_hours, apa pun yang Anda inginkan di petak.

Simpan. Jika angka atau kata yang nyata muncul, ID entitas Anda benar dan semua di bawah akan berfungsi. Jika kosong, kembali ke langkah 2.

Langkah 5

Tambahkan header seksi hijau

Judul polos hanyalah ruang kosong. Ini adalah kartu markdown dengan latar gradasi dari card-mod, dan inilah yang mengubah tumpukan petak menjadi seksi bernama. Setiap seksi di dasbor dibuka dengan salah satunya, hanya label dan emoji-nya yang berbeda.

type: markdown
content: '🔌    **POWER & SOURCE**'
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.30), rgba(16,120,60,0.30));
    border: 1px solid rgba(61,220,107,0.45); border-radius: 14px; box-shadow: 0 6px 20px rgba(0,0,0,0.3); }
    ha-markdown { padding: 12px 20px !important; } ha-markdown p { margin: 0 !important;
    letter-spacing: 3px; color: #eafff0; font-size: 14px; font-weight: 700; }'

Ubah kode emoji dan teks label; blok card-mod identik di setiap seksi.

Langkah 6

Tambahkan tombol kontrol

Tombol ini mengirim perintah, bukan hanya membaca nilai, sehingga skripnya harus sudah ada lebih dulu. Ia memanggil script.projpilot_YOURSERIAL_power_on, yang ditulis aplikasi hanya setelah Anda menempelkan blok Copy ke configuration.yaml, memulai ulang Home Assistant, dan mengetuk Sync With HA.

type: custom:mushroom-template-card
primary: Power On
icon: mdi:power
icon_color: green
layout: vertical
fill_container: true
tap_action:
  action: call-service
  service: script.projpilot_YOURSERIAL_power_on
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.16), rgba(16,90,46,0.20));
    border: 1px solid rgba(61,220,107,0.34); border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32);
    min-height: 92px; }'

Kartu yang sama untuk Matikan Daya, Layar Kosong, HDMI 1, HDMI 2, A/V Mute, mode warna, atau memori lensa: hanya label, ikon, dan service yang berubah.

Jika tampilannya benar tetapi tidak ada yang terjadi saat diketuk, blok Copy belum ditempel atau Home Assistant belum dimulai ulang sejak itu. Jalankan Test Connection di aplikasi, yang memeriksa persis hal itu, sebelum menganggap dasbornya salah.
Langkah 7

Tambahkan hero

Hero di bagian atas dasbor adalah button-card: status daya besar, ringkasan satu baris yang dibuat dari beberapa atribut sekaligus, dan tampilan green glass pada seluruh kartu, bukan hanya bingkainya.

type: custom:button-card
entity: sensor.YOUR_PROJECTOR
name: Epson QB1000
show_state: true
show_label: true
size: 48px
state_display: '[[[ return entity.state==''on'' ? ''Powered on'' : ''Standby''; ]]]'
label: '[[[ var a=entity.attributes; return (a.input||''-'')+''  •  ''+(a.color_mode||''-'')+
  ''  •  ''+(a.video_range||''-'')+''  •  ''+(a.lamp_hours||0)+''  h''; ]]]'
styles:
  card:
  - height: 176px
  - background: linear-gradient(135deg, rgba(61,220,107,0.32), rgba(11,64,34,0.6))
  - border: 1px solid rgba(61,220,107,0.5)
  - border-radius: 22px
  - box-shadow: 0 12px 36px rgba(0,0,0,0.42)
  - padding: 20px
  state:
  - color: '[[[ return entity.state==''on'' ? ''#3ddc6b'' : ''#8a9'' ]]]'

Dipangkas ke bagian yang berubah per instalasi. Kartu lengkap juga mengatur posisi grid ikon, nama, dan label; lihat unduhan di langkah 10 untuk selengkapnya.

Lebih suka strip yang lebih ramping? mushroom-chips-card melakukan tugas yang sama dalam satu baris chip kecil: status daya, input, mode warna, rentang video, dan jam lampu, masing-masing template yang membaca state_attr('sensor.YOUR_PROJECTOR', ...). Gunakan salah satu, jangan keduanya, di bagian atas dasbor.

Langkah 8

Tambahkan Skenario Anda

Setiap Skenario yang Anda simpan di aplikasi menjadi skrip bernama script.projpilot_YOURSERIAL_scene_<id> setelah Anda sinkron, dan petak untuk satu Skenario adalah kartu tombol kontrol yang sama dari langkah 6 dengan nama dan ikon Skenario.

type: custom:mushroom-template-card
primary: Movie Night
icon: mdi:movie-open
icon_color: green
layout: vertical
fill_container: true
tap_action:
  action: call-service
  service: script.projpilot_YOURSERIAL_scene_YOURSCENE1
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.16), rgba(16,90,46,0.20));
    border: 1px solid rgba(61,220,107,0.34); border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32);
    min-height: 92px; }'

Ganti YOURSCENE1 dengan id yang ditampilkan untuk Skenario itu di daftar kontrol sinkron aplikasi. Satu petak per Skenario, dalam horizontal-stack.

Langkah 9

Tambahkan riwayat jam laser

Sensor proyektor direkam oleh Home Assistant seperti sensor lainnya, sehingga lamp_hours mendapat riwayat secara gratis. Tanpa sensor tambahan, tanpa helper, tanpa konfigurasi apa pun lebih dulu, di bawah seksi Perawatan.

type: custom:mini-graph-card
entities:
- entity: sensor.YOUR_PROJECTOR
  attribute: lamp_hours
  name: Laser hours
name: Laser hours
icon: mdi:lightbulb-on-outline
line_color: '#3ddc6b'
line_width: 4
hours_to_show: 336
points_per_hour: 0.5
height: 96
animate: true
card_mod:
  style: 'ha-card { background: rgba(18,26,20,0.60); border: 1px solid rgba(61,220,107,0.20);
    border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32); backdrop-filter: blur(8px); }'

336 jam adalah dua minggu. Jam laser dan lampu naik stabil dan tidak melonjak-lonjak, jadi jendela dua minggu biasanya cukup untuk melihat tren tanpa membuat grafik tampak datar.

Langkah 10

Atau ambil semuanya

Tampilan lengkap, setiap seksi dan setiap kartu dari tangkapan layar di bagian atas halaman ini, dengan placeholder sebagai pengganti ID entitas.

  1. Unduh YAML tampilan.
  2. Buka di editor teks apa pun dan ganti, di mana pun muncul: YOUR_PROJECTOR dengan ID entitas sensor proyektor Anda dari langkah 2, dan YOURSERIAL dengan ID turunan nomor seri Anda dari langkah 2.
  3. Di seksi Skenario di dekat bagian bawah, ganti YOURSCENE1, YOURSCENE2, dan YOURSCENE3 dengan tiga id Skenario Anda sendiri, atau tambah dan hapus petak sesuai jumlah Skenario yang Anda punya.
  4. Di Home Assistant, buka dasbor Anda, ikon pensil, menu tiga titik, Raw configuration editor, lalu tempel sebagai tampilan.
Nama dan jumlah Skenario Anda tidak akan sama. File ini berisi tiga contoh Skenario: Movie Night, Gaming, Sports Day. Ganti nama petaknya, arahkan ke id Skenario Anda sendiri, lalu tambah atau hapus petak sampai seksinya sesuai jumlah Skenario yang benar-benar Anda simpan.
Petak info langsung berfungsi setelah Anda menempel. Petak ini hanya butuh sensornya ada. Tombol kontrol dan Skenario tetap tidak berfungsi sampai blok Copy ditempel ke configuration.yaml, Home Assistant dimulai ulang, dan Anda mengetuk Sync With HA.

Pemecahan masalah

Petak menampilkan Unknown

Periksa nama atribut dengan apa yang sebenarnya dibawa sensor: Developer Tools › States, entitas sensor.YOUR_PROJECTOR Anda, lalu baca daftar atributnya. Beberapa pembacaan, seperti HDR PQ atau HDR HLG, hanya terisi saat proyektor aktif menerima jenis sinyal itu, jadi Unknown pada keduanya bisa benar, bukan rusak. Jika seluruh sensor tampak sepi, bangunkan proyektor: unit dalam standby menerbitkan sangat sedikit.

Tombol tidak melakukan apa-apa

Anda belum menempelkan blok Copy, atau Home Assistant belum dimulai ulang sejak itu. Tombol kontrol dan Skenario memanggil skrip yang ditulis aplikasi, dan skrip itu tidak ada sampai Pengaturan › Otomasi Rumah › Home Assistant di aplikasi memiliki blok Copy yang ditempel ke configuration.yaml, Home Assistant dimulai ulang sekali, dan Sync With HA diketuk. Jalankan Test Connection di aplikasi lebih dulu - ia memberi tahu apakah blok itu ada sebelum Anda mencari kesalahan di dasbor.

Skrip yang saya harapkan tidak ada di Developer Tools › States

Saring dengan projpilot daripada nomor seri lengkap - lebih mudah melihat seluruh daftar. Jika kontrol atau Skenario yang baru Anda tambahkan tidak ada, ketuk Sync With HA lagi; ia memperbarui di tempat, tanpa perlu penyiapan baru. Jika skrip lama yang sudah mati memenuhi daftar setelah Anda menghapus Skenario, gunakan Remove orphaned scripts di aplikasi.

ID entitas saya tidak seperti yang ada di panduan ini

Polanya tetap, bagian tengahnya tidak. Sensor Anda dinamai sesuai model proyektor Anda sendiri, dan setiap skrip membawa nomor seri proyektor Anda sendiri, bukan placeholder di halaman ini. Ambil keduanya dari Developer Tools › States dan layar Home Assistant aplikasi, seperti di langkah 2, dan gunakan itu sebagai ganti mengetik teks contoh.

Seluruh proyektor Anda, di satu dinding

Otomasi Rumah adalah add-on sekali beli. Tanpa langganan, tanpa akun, tanpa cloud. Satu pembelian membukanya di setiap platform yang Anda miliki.

Google Play - tersedia sekarang App Store - menunggu persetujuan Microsoft Store - menunggu persetujuan Mac App Store - menunggu persetujuan

Kembali ke Otomasi Rumah → · Panduan Pengguna Lengkap →

FAQ

Jawaban singkat

Apakah saya harus membuat dasbor ini secara manual?

Tidak. Saat Anda mengetuk Sync With HA di aplikasi, aplikasi membuatkan dasbor Projector Pilot siap pakai langsung di Home Assistant - sensor proyektor langsung plus tombol untuk setiap kontrol dan Skenario - dan dasbor itu muncul di bilah samping Anda sebagai Projector Pilot. Halaman ini untuk membuat versi green-glass yang lebih kaya secara manual, atau menyesuaikan apa yang dibuat Sync.

Apakah saya perlu kartu kustom dari HACS untuk membangun ini?

Untuk menyamai tampilan di tangkapan layar, ya: Mushroom, button-card, card-mod, dan mini-graph-card. Tidak satu pun wajib agar kontrol dasarnya berfungsi - setiap tombol adalah panggilan skrip biasa, dan kartu kustom hanyalah tampilan di atasnya.

Mengapa petak info menampilkan nilai tetapi tombolnya tidak melakukan apa-apa?

Sensor proyektor menerbitkan pembacaannya segera setelah Anda masuk dan menyinkronkan di aplikasi, sehingga petak info langsung aktif. Tombol kontrol dan Skenario memanggil skrip yang baru ada di Home Assistant setelah Anda menempelkan blok Copy dari aplikasi ke configuration.yaml, memulai ulang Home Assistant, dan mengetuk Sync With HA sekali.

Apakah entity ID saya akan sama dengan yang ada di panduan ini?

Polanya sama, karakter persisnya tidak. Sensor proyektor Anda dinamai sesuai model proyektor Anda, dan setiap skrip dinamai sesuai nomor seri proyektor Anda. Di mana pun halaman ini menulis YOUR_PROJECTOR, isi dengan ID entitas sensor Anda sendiri; di mana pun tertulis YOURSERIAL, isi dengan ID turunan nomor seri yang ditampilkan di layar Home Assistant aplikasi.