ZHA üzerinden Aqara cihazlarını kullanmak — kısa ve öz
Evet — Aqara'nın çoğu sensörü ve düğmesi ZHA'da çalışır ve temel varlıkları sağlar; radyatör termostatları ise genellikle ek quirks (özel yapılandırmalar), doğru koordinatör veya alternatif entegrasyon gerektirir. Aşağıda tam olarak nelerin çalıştığı ve hızlı, kararlı bir şekilde nasıl bağlanacağı açıklanmıştır.
ZHA'da hangi Aqara cihazları destekleniyor
- Sıcaklık/nem sensörleri ve açılma/hareket sensörleri: Genellikle sensor.temperature, sensor.humidity, binary_sensor.contact, binary_sensor.motion oluşturur. Doğru binding/reporting yapılandırıldığında kararlı çalışırlar.
- Kablosuz düğmeler (WXKG11LM, WXKG12LM ve diğerleri): Dokunmatik anahtarlar olarak gelir ve zha_event / device triggers (tek/çift/basılı tutma) olayları üretir. Otomasyonlar için desteklenirler.
- Su sızıntısı ve titreşim sensörleri: Standart binary_sensor ve sensor; raporlama için güvenilir bir ağa ihtiyaç duyarlar.
- Radyatör termostatları (E1 ve diğerleri): Tanınır ancak vana kontrolü bazen hatalı olabilir — bu durum koordinatöre, ZHA sürümlerine ve özel quirks varlığına bağlıdır.
Doğru şekilde nasıl bağlanır — adım adım
- Eşleştirmeden önce Home Assistant ve zha-device-handlers'ı en son sürümlere güncelleyin.
- Eşleştirme sırasında koordinatörü öngörülen ağın merkezine taşıyın (en azından cihaza daha yakın konumlandırın).
- Cihazı pairing modunda eşleştirin; pilli cihazlar için — koordinatöre yakın tutun ve talimatlara göre "eşleştirme hilesini" (birkaç kez basma) uygulayın.
- Varlıklar oluşturulduktan sonra ZHA arayüzünü açın ve cluster'ları, endpoint'leri ve reporting ayarlarını kontrol edin. Cihazlar düzenli rapor göndermiyorsa binding/reporting yapılandırmasını ayarlayın.
- Termostatlar için: Sıcaklık değişimini test edin ve logları izleyerek vananın fiziksel olarak konum değiştirip değiştirmediğini kontrol edin.
Sıcaklık kontrolünün doğruluğu için ayrı bir oda sensörü kullanın (radyatör üzerindeki değil) ve otomasyonlarda düzeltme (offset) uygulayın.
Tipik sorunlar ve hızlı çözümler
- Cihaz eşleşiyor ancak gerekli sensörler yok: Cihazı silin, zha-device-handlers'ı güncelleyin ve yeniden eşleştirin; Zigbee Device Signature'ı kontrol edin.
- Düğme olay göndermiyor: Koordinatöre yaklaştırın, yeniden eşleştirin ve loglarda zha_event görünümünü kontrol edin.
- Termostat vanayı açmıyor: Adaptörünüzün install-code'u ve gerekli komutları destekleyip desteklemediğini kontrol edin; farklı bir koordinatör veya Zigbee2MQTT deneyin.
Toplu vana değişimi yapmadan önce 1–2 cihazı test edin: Birçok sorun hemen ortaya çıkar ve geri almak daha maliyetli olur.
Sık yapılan hatalar
- zha-device-handlers güncellemelerini görmezden gelmek — birçok hata güncellemeyle çözülür.
- Koordinatörden uzakta eşleştirme yapmak — cihazlar yanlış endpoint'ler alabilir.
- Tüm Aqara özelliklerinin (OTA, üretici sahneleri) quirks olmadan ZHA üzerinden çalışacağını beklemek.
SSS
- Aqara radyatör termostatları ZHA üzerinden çalışır mı? Kısmen: Genellikle sensör okuma evet, vana kontrolü ise bazen quirks/farklı koordinatör gerektirir.
- Install code gerekli mi? Bazı modeller güvenli eşleştirme için install codes kullanır; cihaz isterse kodu girin.
- ZHA yetersiz kalırsa ne yapılmalı? Yedek plan olarak Zigbee2MQTT veya resmi Aqara Hub/Matter'ı deneyin.
Belirli bir model için kontrol listesi hazırlamamı veya ZHA loglarını incelememe yardımcı olmamı isterseniz — modeli belirtin ve log snippet'ini ekleyin.