Home Assistant
Disertakan dengan Macro DeckNyalakan lampu, jalankan adegan dan skrip, dan tampilkan status langsung dari Home Assistant di deck Anda.
Dialog Hubungkan Home Assistant dengan kolom Alamat dan Token akses berumur panjang
- Nyalakan, matikan, atau alihkan entitas, dengan tombol yang menampilkan statusnya
- Atur lampu, penutup, termostat, dan pemutar media
- Jalankan adegan, skrip, dan otomasi, atau panggil layanan apa pun
- Variabel langsung untuk status atau atribut entitas apa pun
- Pemicu saat status berubah dan untuk peristiwa dari event bus
Integrasi Home Assistant menghubungkan Macro Deck ke Home Assistant melalui WebSocket API-nya. Macro Deck menjaga satu koneksi tetap terbuka, sehingga status tiba saat itu juga ketika berubah di Home Assistant, dan aksi langsung berjalan. Home Assistant dapat berjalan di mana saja selama dapat dijangkau Macro Deck: di komputer yang sama, Raspberry Pi atau server di jaringan Anda, atau alamat jarak jauh.
Yang dapat dilakukan
- Nyalakan atau matikan satu atau beberapa entitas, atau alihkan statusnya. Tombol dengan Alihkan menyala selama entitas aktif.
- Atur status, kecerahan, warna, suhu warna, dan transisi lampu dengan Atur Lampu.
- Buka, tutup, hentikan, atau atur posisi penutup, atur suhu, mode, mode kipas, dan preset termostat, serta kendalikan pemutaran dan volume pemutar media.
- Aktifkan adegan, jalankan skrip dengan variabel, serta picu, aktifkan, atau nonaktifkan otomasi.
- Panggil layanan apa pun dengan Panggil Layanan, dengan entitas, perangkat, atau area sebagai target dan data sebagai JSON.
- Baca status atau atribut entitas ke dalam variabel Macro Deck dengan Dapatkan Status Entitas.
Beberapa contoh penggunaan:
- Tombol dengan Alihkan untuk lampu meja yang menampilkan apakah lampu sedang menyala.
- Tombol Film yang mengaktifkan adegan menonton dan menjeda musik di pemutar media.
- Slider yang terikat pada kecerahan lampu, sehingga Anda dapat meredupkannya dari deck dan melihat perubahan yang dibuat di Home Assistant.
- Tombol yang labelnya menampilkan suhu dari sebuah sensor, dan alur pada Status Entitas Berubah yang menampilkan notifikasi saat pintu depan terbuka.
Variabel dan pembaruan langsung
Home Assistant menawarkan jauh lebih banyak nilai daripada yang dicantumkan Macro Deck sejak awal. Setiap entitas dapat ditemukan di grup Variabel tidak terikat yang terlipat di antara variabel integrasi, di halaman Variabel dan di setiap pemilih variabel. Buka sebuah entitas untuk melihat status dan atributnya, lalu pilih Ikat pada yang dibutuhkan: nilai itu menjadi variabel biasa yang diperbarui secara langsung. Dengan cara ini, slider dapat mengendalikan kecerahan lampu, kecepatan kipas, posisi penutup, volume pemutar media, atau suhu termostat.
Saat koneksi terputus, Macro Deck terhubung kembali dengan sendirinya, dengan menunggu sedikit lebih lama setelah setiap percobaan yang gagal, hingga satu menit. Pemicu Terhubung dan Terputus berjalan saat hal itu terjadi, dan aksi gagal dengan pesan selama Home Assistant tidak terhubung. Anda dapat menghubungkan satu Home Assistant.
Yang Anda butuhkan
- Home Assistant yang berjalan dan dapat dijangkau Macro Deck, misalnya
http://homeassistant.local:8123. - Akun pengguna Home Assistant untuk membuat token akses berumur panjang.
- Untuk alamat
https://: sertifikat yang dipercaya komputer Anda.
Cara menyiapkan
Langkah 1: Buat token akses berumur panjang
Di Home Assistant, buka profil Anda dan masuk ke tab Security. Gulir ke Long-lived access tokens, buat token, beri nama
Macro Deck, lalu salin. Home Assistant hanya menampilkannya sekali.Langkah 2: Buka integrasi Home Assistant
Di Macro Deck, klik Integrasi di bilah samping, lalu klik Home Assistant. Di tab Ringkasan, klik Siapkan di bagian Konfigurasi. Mengaktifkan sakelar di kanan atas membuka dialog yang sama, dan integrasi menjadi aktif setelah penyiapan selesai.
Langkah 3: Masukkan alamat dan token
Di dialog Hubungkan Home Assistant, masukkan:
- Alamat: alamat yang digunakan untuk membuka Home Assistant, termasuk port, misalnya
http://homeassistant.local:8123. - Token akses berumur panjang: token yang baru saja disalin.
Saat Anda mengklik Lanjutkan, Macro Deck menguji koneksi dan menyimpannya sebagai Home Assistant dengan nama rumah Anda di dalam tanda kurung.
- Alamat: alamat yang digunakan untuk membuka Home Assistant, termasuk port, misalnya
Langkah 4: Tambahkan aksi ke tombol
Di halaman Deck, klik sebuah tombol. Deck harus dalam keadaan tidak terkunci: jika tombol Kunci tampil di kanan atas, deck tidak terkunci. Editor terbuka dengan Ketuk Singkat terpilih. Klik + Tambah aksi, pilih Home Assistant di sisi kiri dialog Tambah aksi, pilih Alihkan, lalu pilih satu atau beberapa Entitas, misalnya sebuah lampu.
Langkah 5: Tekan tombolnya
Tekan tombol di deck Anda. Lampu berganti status di Home Assistant, dan tombol menampilkan apakah lampu menyala.
Langkah 6: Ikat nilai untuk ditampilkan di tombol
Untuk menampilkan sebuah nilai, buka tab Variabel di halaman Home Assistant dan buka grup Variabel tidak terikat. Buka sebuah entitas, lalu klik Ikat pada status atau salah satu atributnya. Gunakan variabel baru tersebut di label, misalnya
{{ vars.ha_sensor_living_room_temperature }}.
Aksi12
Pasang aksi ini di tombol atau jalankan dari alur.
- Panggil Layanan
- Memanggil layanan Home Assistant apa pun dengan entitas, perangkat, area, dan data JSON opsional.
- Nyalakan
- Menyalakan satu atau beberapa entitas.
- Matikan
- Mematikan satu atau beberapa entitas.
- Alihkan
- Mengalihkan status satu atau beberapa entitas, dan menampilkan di tombol apakah entitas tersebut menyala.
- Atur Lampu
- Menyalakan atau mematikan lampu dan mengatur kecerahan, warna, suhu warna, dan transisinya.
- Kontrol Penutup
- Membuka, menutup, atau menghentikan penutup, atau mengatur posisi atau posisi kemiringannya.
- Kontrol Pemutar Media
- Memutar, menjeda, menghentikan, melewati, membisukan, atau mengatur volume pemutar media.
- Atur Termostat
- Mengatur suhu target, mode, mode kipas, dan preset termostat.
- Aktifkan Adegan
- Mengaktifkan adegan, dengan transisi opsional.
- Jalankan Skrip
- Menjalankan skrip, secara opsional dengan variabel sebagai objek JSON.
- Kontrol Otomasi
- Memicu, mengaktifkan, menonaktifkan, atau mengalihkan otomasi, secara opsional dengan mengabaikan kondisinya.
- Dapatkan Status Entitas
- Membaca status entitas atau salah satu atributnya ke dalam variabel Macro Deck.
Pemicu4
Tombol atau alur dapat bereaksi terhadap peristiwa ini.
- Terhubung
- Macro Deck terhubung ke Home Assistant.
- Terputus
- Koneksi ke Home Assistant terputus.
- Status Entitas Berubah
- Sebuah entitas berubah status, secara opsional hanya untuk satu domain, satu entitas, atau perubahan dari atau ke status tertentu.
- Peristiwa Home Assistant
- Apa pun di bus peristiwa Home Assistant, seperti otomasi, skrip, penekanan tombol ZHA dan deCONZ, atau peristiwa khusus, secara opsional hanya satu jenis peristiwa.
Variabel5
Tampilkan nilai ini di tombol dan widget, atau gunakan dalam kondisi.
homeassistant_is_connected- Apakah Macro Deck terhubung ke Home Assistant.
homeassistant_version- Versi Home Assistant Anda.
homeassistant_location_name- Nama rumah Anda.
homeassistant_entity_count- Berapa banyak entitas yang dimiliki Home Assistant Anda.
ha_<entity>,ha_<entity>_<attribute>- Status atau atribut apa pun dari sebuah entitas, setelah Anda mengikatnya dari Variabel tidak terikat. Namanya disarankan dari ID entitas, misalnya
ha_light_office_lampatauha_light_office_lamp_brightness_pct. Banyak di antaranya juga dapat diatur, misalnyabrightness_pctsebuah lampu.
Pertanyaan yang sering diajukan
Apakah Home Assistant harus berjalan di komputer yang sama?
Tidak. Macro Deck terhubung melalui jaringan, sehingga Home Assistant dapat berjalan di Raspberry Pi, server, atau alamat jarak jauh, selama Macro Deck dapat menjangkaunya.
Bisakah lebih dari satu Home Assistant dihubungkan?
Tidak. Integrasi ini mendukung satu Home Assistant. Menjalankan penyiapan lagi akan mengganti koneksi, dan tombol Anda tetap berfungsi.
Penyiapan menyatakan sertifikat tidak dapat divalidasi. Apa yang bisa dilakukan?
Komputer Anda tidak memercayai sertifikat alamat https:// Anda. Percayai sertifikat itu di penyimpanan sertifikat sistem operasi, atau hubungkan melalui http:// di jaringan lokal.
Home Assistant di balik reverse proxy tidak mau terhubung. Mengapa?
Beberapa proxy memblokir permintaan yang dianggap sebagai lalu lintas otomatis. Buka Pengaturan > Lanjutan > HTTP dan masukkan nilai yang diterima proxy di HTTP User-Agent.
Apa yang terjadi saat koneksi terputus?
Macro Deck terhubung kembali dengan sendirinya dan menjalankan pemicu Terputus dan Terhubung. Jika Home Assistant tidak dapat dijangkau selama beberapa waktu, integrasi menampilkan Home Assistant tidak dapat dijangkau dan terus mencoba di latar belakang.
Di mana token akses disimpan?
Token disimpan terenkripsi di komputer Anda dan tidak pernah keluar dari komputer kecuali untuk berkomunikasi dengan Home Assistant Anda. Jika Home Assistant menolaknya, integrasi menampilkan masalah: buat token baru dan jalankan penyiapan lagi.
Lainnya di Rumah pintar dan web
AdGuard Home
Disertakan dengan Macro DeckAktifkan, nonaktifkan, atau jeda perlindungan AdGuard Home, dan tampilkan statistiknya di deck Anda.
Feed RSS
Disertakan dengan Macro DeckIkuti feed RSS dan Atom, tampilkan artikel terbarunya di widget, dan tanggapi saat artikel baru masuk.
HTTP
Disertakan dengan Macro DeckKirim permintaan HTTP dari tombol dan simpan nilai dari respons ke dalam variabel.
Cuaca
Disertakan dengan Macro DeckTampilkan cuaca saat ini dan prakiraan untuk lokasi Anda di deck, tanpa kunci API.