Ketika saya menulis panduan pertama untuk menghubungkan alarm Ajax ke Home Assistant, saya harus bermain-main antara SIA, Jeedom, MQTT, topik yang banyak… Hasilnya berfungsi dengan sempurna, tetapi harus menyukai sistem yang rumit. Hari ini, perubahan total terjadi: beberapa pengembang telah mengembangkan integrasi asli Ajax Home Assistant, yang dapat dipasang melalui HACS, yang terhubung langsung dengan API Cloud resmi Ajax. Arming, disarming, notifikasi, sensor, relay… semuanya terintegrasi ke dalam Home Assistant, dalam waktu (hampir) nyata!
Terpasang di rumah saya sejak beberapa hari yang lalu, saya tawarkan untuk mengetahui lebih banyak detail tentang plugin yang sangat dinantikan ini…
Pengingat singkat tentang metode lama
Sampai saat ini, untuk membahas Ajax Home Assistant, ada dua pendekatan.
Pendekatan pertama melalui integrasi SIA Alarm Systems di Home Assistant. Alarm Ajax dikonfigurasi seolah-olah Home Assistant adalah pusat pemantauan. Kami mendapatkan status sistem, beberapa informasi kebakaran / banjir, dan itu saja. Tidak mungkin mengendalikan alarm, tidak ada rincian tentang setiap sensor. Ini terutama berguna untuk memicu beberapa skenario berdasarkan status keseluruhan alarm, seperti mengalihkan pemanas ke mode eco saat mengaktifkan alarm saat meninggalkan rumah.
Pendekatan kedua, yang dijelaskan dalam panduan saya sebelumnya, adalah menggunakan plugin Ajax di Jeedom, lalu menerbitkan semua informasi ke Home Assistant melalui MQTT. Jauh lebih lengkap, dengan hampir semua sensor Ajax terintegrasi, tetapi dengan biaya tambahan server domotik kedua, broker MQTT, pemetaan puluhan topik… Singkatnya, sangat kuat, tetapi jelas tidak untuk semua orang.
Plugin baru mengubah permainan sepenuhnya: Ajax Home Assistant menjadi pasangan yang jauh lebih mudah untuk diatur.
Apa yang diperbolehkan oleh plugin baru Ajax Home Assistant
Integrasi ajax-hass adalah komponen kustom Home Assistant yang terhubung langsung ke Cloud Ajax melalui API resmi dan aliran gRPC, persis seperti aplikasi seluler Ajax. Secara konkret, Hub Ajax Anda menjadi “warga kelas satu” di Home Assistant, dengan panel alarm nyata dan entitas untuk sensor, sirene, relay, soket, dll.
Anda memperoleh kontrol penuh atas keamanan. Panel alarm Home Assistant memungkinkan pengaktifan penuh, pembongkaran, mode malam, pengaktifan sebagian per grup, dan bahkan pengaktifan paksa saat beberapa sensor tetap terbuka. Sebuah layanan khusus mengelola tombol panik, yang dapat diletakkan di dashboard atau di remote virtual.
Dari sisi pengambilan informasi, plugin ini mengekspos peristiwa pengaktifan / pembongkaran dengan nama pengguna Ajax, notifikasi alarm, deteksi gerakan, pembukaan pintu dan jendela, alarm kebakaran atau banjir, serta sensor “teknis” seperti level baterai, kualitas sinyal, suhu atau status koneksi. Ini sangat komprehensif.
Integrasi ini mendukung beberapa hub Ajax di Home Assistant yang sama jika perlu, dan antarmuka sudah diterjemahkan ke dalam bahasa Prancis. Dalam hal peralatan, pengembang mengutamakan pengujian Hub 2 Plus dan MotionCam, tetapi desainnya didasarkan pada API resmi Ajax dan komunitas telah mengonfirmasi sejumlah besar keyboard, sirene, kontak pembuka, detektor kebakaran, dll.
Kami memiliki tandem nyata Ajax Home Assistant, yang mampu mengendalikan dan mengamati sistem alarm dengan baik, tanpa perlu melalui jalur yang berbelit-belit.
Mempersiapkan instalasi Ajax dan Home Assistant
Sebelum memulai, lebih baik memeriksa beberapa prasyarat.
Sistem Ajax Anda harus berfungsi, dengan Hub yang dikonfigurasi di aplikasi resmi, semua detektor sudah ditambahkan dan dinamai dengan benar, dan jika memungkinkan, grup sudah ditentukan (lantai dasar, lantai, garasi, dll.). Semakin bersih konfigurasi Ajax, semakin menyenangkan bagian Home Assistant untuk digunakan.
Dari sisi domotik, Anda memerlukan Home Assistant yang diperbarui, dengan HACS sudah terpasang dan berfungsi, karena plugin Ajax Home Assistant didistribusikan sebagai integrasi kustom. Pastikan juga bahwa instance Home Assistant Anda memiliki akses internet keluar ke server Ajax, karena komunikasi berjalan melalui Cloud menggunakan HTTPS dan gRPC.
Akhirnya, pastikan bahwa instalasi Home Assistant Anda aman: kata sandi yang kuat, akses jarak jauh yang aman (reverse proxy, autentikasi, sertifikat TLS), dan cadangan berkala. Mengintegrasikan sistem alarm Anda ke dalam domotik sangat praktis, tetapi ini juga membutuhkan ketelitian lebih terhadap keamanan keseluruhan infrastruktur.
Menginstal integrasi Ajax melalui HACS
Mari kita beranjak ke hal yang lebih konkret. Apakah HACS sudah ada di Home Assistant Anda? Bagus, kita bisa mulai menginstal plugin Ajax Home Assistant.
Langkah pertama adalah mendeklarasikan repositori GitHub plugin dalam HACS. Di antarmuka Home Assistant, buka HACS, lalu bagian yang dikhususkan untuk integrasi. Di sudut kanan atas, ada tombol dengan tiga titik untuk mengakses menu lanjutan. Dengan memilih entri “Repositori kustom”, Anda dapat menambahkan repositori baru.
Di kolom URL, masukkan alamat repositori https://github.com/foXaCe/ajax-hass, dan pilih “Integrasi” sebagai kategori. Validasi, lalu tutup jendela. Saat Anda mencari integrasi berikutnya di HACS, “Ajax Security System” akan muncul dalam daftar.
Masih di HACS, lakukan pencarian untuk “Ajax Security System”, buka kartu yang sesuai, lalu instal.
HACS akan mengunduh komponen ajax-hass dan menempatkannya di folder custom_components/ajax dari instalasi Home Assistant Anda.
Setelah instalasi selesai, restart Home Assistant diperlukan untuk memuat integrasi baru.
Menambahkan integrasi Ajax Home Assistant di Home Assistant
Setelah Home Assistant di-restart, kita dapat melanjutkan ke konfigurasi. Semua dilakukan dari antarmuka, tanpa perlu YAML, yang menyenangkan!
Buka menu “Pengaturan”, lalu “Perangkat dan layanan”. Di bagian bawah halaman, gunakan tombol “Tambah integrasi”. Di kotak pencarian, ketik “Ajax”. Anda seharusnya melihat “Ajax Security System” dengan ikon yang sesuai. Pilih untuk memulai asisten konfigurasi.
Integrasi akan meminta Anda untuk memasukkan kredensial akun Ajax Anda, yaitu alamat email dan kata sandi yang digunakan dalam aplikasi resmi. Plugin tidak memerlukan alamat IP lokal dari hub, atau port eksotik, semuanya melewati Cloud Ajax.
Selanjutnya, ada pengaturan yang sangat berguna: filter notifikasi. Anda dapat memilih untuk tidak mengirimkan notifikasi ke Home Assistant, hanya notifikasi alarm masuk, peristiwa keamanan (pengaktifan / pembongkaran, pemberitahuan teknis), atau semua, termasuk peristiwa sensor secara bersamaan. Jika Anda berencana untuk membuat banyak otomatisasi Ajax Home Assistant, seringkali menarik untuk mulai setidaknya dengan peristiwa keamanan, lalu menyesuaikan.
Validasi, tunggu beberapa detik: integrasi menghubungi Cloud Ajax, dan mengambil daftar hub Anda. Di sini saya memiliki 3 sistem Ajax yang berbeda: saya bisa menambahkan semua atau hanya memilih yang saya inginkan, seperti di sini “Rumah” saja.
Kita validasi. Sistem kemudian mengambil grup dan semua perangkat dari hub yang dipilih, lalu membuat entitas yang sesuai di Home Assistant. Kita kemudian dapat memberi mereka ruang jika diinginkan:
Apa yang ada di Home Assistant setelah integrasi
Setelah integrasi Ajax Home Assistant terpasang, sedikit melihat di “Perangkat dan layanan” memungkinkan kita untuk melihat hasilnya. Setiap Hub Ajax muncul sebagai perangkat, dengan panel alarm utama dan seperangkat sensor dan aktuator.
Panel alarm, yang diekspos sebagai entitas alarm_control_panel, memungkinkan untuk mengaktifkan seluruh rumah, beralih ke mode malam, membongkar, dan menggunakan pengaktifan sebagian per grup jika Anda sudah mengaturnya di aplikasi Ajax. Entitas ini menjadi titik pusat dari skenario keamanan Anda.
Detektor gerakan diungkapkan sebagai binary_sensor klasik, yang beralih ke status “on” saat terdeteksi dan kembali ke “off” setelah masa istirahat. Kontak pintu dan jendela juga terdaftar sebagai sensor biner, sangat bagus untuk memicu skenario pemotongan pemanas jika jendela tetap terbuka terlalu lama.
Detektor asap, karbon monoksida, atau banjir juga menjadi entitas yang dapat digunakan secara langsung.
Colokan dan relay Ajax muncul sebagai saklar atau aktuator, dengan kemampuan untuk mengendalikannya dari Home Assistant. Misalnya, kita dapat mengontrol relay Ajax untuk memutuskan sumber daya peralatan jika terjadi insiden.
Bagi yang lebih teliti, serangkaian sensor “teknis” juga muncul: level baterai, kekuatan sinyal radio, suhu, status koneksi, dll. Ini adalah dasar yang bagus untuk membuat dasbor “kesehatan sistem Ajax” di Home Assistant.
Contoh skenario Ajax Home Assistant dalam situasi
Setelah semua terintegrasi ke dalam Home Assistant, bagian yang paling menarik dimulai: otomatisasi. Kekuatan integrasi Ajax Home Assistant ini adalah responsif terhadap pengambilan peristiwa dan kemampuan mengendalikan alarm.
Sebuah skenario pertama yang sangat berguna adalah mengaktifkan alarm secara otomatis saat semua orang meninggalkan rumah. Kita menggunakan keberadaan orang-orang via aplikasi seluler Home Assistant atau sistem keberadaan lainnya, dan meluncurkan pengaktifan penuh segera setelah orang terakhir berstatus “not_home”.
Contoh minimalis dalam YAML bisa terlihat seperti ini:
automation:
- alias: "Arma Ajax saat semua orang pergi"
trigger:
- platform: state
entity_id: group.famille
to: "not_home"
action:
- service: alarm_control_panel.alarm_arm_away
target:
entity_id: alarm_control_panel.ajax_alarm_home
Kita bisa membayangkan sebaliknya saat kembali: pembongkaran otomatis saat orang pertama tiba, disertai dengan pencahayaan lembut beberapa lampu dan menonaktifkan beberapa skenario keberadaan yang disimulasikan.
Kasus penggunaan lain yang sering terjadi berkaitan dengan pemanas. Sensor pembukaan Ajax yang terintegrasi di Home Assistant memungkinkan untuk mematikan pemanas listrik atau pendingin udara saat sebuah jendela tetap terbuka lebih dari lima menit, kemudian mengaktifkan kembali sistem saat jendela ditutup. Tidak perlu menggunakan banyak sensor Zigbee atau Z-Wave untuk bekerja dengan cara yang baik pada pembukaan.
Detektor gerakan Ajax juga dapat ikut serta dalam pengelolaan pencahayaan. Kita dapat memutuskan bahwa, hanya di malam hari, melewati depan detektor di lorong mengaktifkan lampu malam atau strip LED di bawah tempat tidur, dengan intensitas rendah, selama beberapa menit. Alarm tidak diaktifkan, tetapi kita menggunakan infrastruktur untuk kenyamanan. Ini adalah salah satu kesenangan dari domotik yang terintegrasi dengan baik.
Akhirnya, tombol panik Ajax yang terungkap sebagai entitas “button” dapat ditempatkan di dasbor yang ditujukan untuk orang dewasa, atau bahkan disembunyikan di balik kartu yang dilindungi oleh kata sandi, dan digunakan untuk memicu peringatan umum: sirene, penerangan luar ruangan di 100%, pengiriman notifikasi ke smartphone, bahkan panggilan otomatis ke kerabat melalui layanan pihak ketiga. Dalam jenis skenario ini, lebih baik tentu saja untuk menguji dalam kondisi nyata tetapi memberi tahu semua orang terlebih dahulu…
Keamanan dan praktik terbaik dengan Ajax Home Assistant
Mengintegrasikan Ajax ke Home Assistant melalui plugin ini berarti bahwa Home Assistant menjadi bagian dari rantai keamanan. Pengembang memperhatikan bagian privasi: kredensial disimpan dalam sistem terenkripsi Home Assistant, kata sandi di-hash sebelum dikirim ke server Ajax, komunikasi melewati TLS, dan tidak ada data yang dikirim ke layanan pihak ketiga. Integrasi ini bersifat open source dan dapat diaudit, yang memberikan rasa aman untuk sistem keamanan.
Namun, ada baiknya untuk mempertahankan beberapa kebiasaan. Home Assistant yang dibuka di internet tanpa batas menjadi pintu masuk ke sistem alarm Anda. Oleh karena itu, penting untuk mengunci akses luar, menjaga Home Assistant serta integrasi Ajax agar tetap terkini, dan menghindari banyak akun admin. Pengaktifan paksa, khususnya, harus digunakan dengan hati-hati, karena memungkinkan untuk mengaktifkan sistem bahkan saat ada sensor yang terbuka atau dalam keadaan gagal.
Titik terakhir: plugin ini bergantung pada Cloud Ajax. Jika koneksi internet Anda terputus atau jika server Ajax tidak dapat dijangkau, hub akan terus melindungi rumah, tetapi koneksi waktu nyata dengan Home Assistant akan terputus.
Dalam praktiknya, mengapa mengadopsi plugin Ajax Home Assistant ini
Secara ringkas, kita beralih dari integrasi “yang dibangun-bangun”, bergantung pada sistem domotik kedua, ke plugin Ajax Home Assistant yang didedikasikan, dikelola, dan sangat mendalam dalam pengelolaan peralatan. Instalasi dilakukan melalui HACS, konfigurasi hanya dilakukan dari antarmuka, dan kita mendapatkan kontrol penuh atas alarm, dengan pengambilan peristiwa yang hampir instan.
Dalam kehidupan sehari-hari, ini berarti skenario yang lebih cerdas, konsistensi nyata antara keamanan dan kenyamanan, dan lebih sedikit duplikasi sensor di seluruh rumah. Bagi para pemasang, ini juga menjadi argumen kuat untuk disampaikan kepada klien yang sudah dilengkapi dengan Ajax, yang bermimpi tentang pengendalian global rumah mereka dengan Home Assistant.
Dan hal yang paling menyenangkan dari semua ini adalah bahwa untuk sekali ini, “lebih lengkap” tidak berarti “lebih rumit”.
