SONOFF OpenEdge Cihazlarını MQTT Üzerinden Home Assistant ile Entegre Etme Rehberi

Giriş

SONOFF, yeni nesil akıllı cihazlar için tasarlanan ve cihazlarınız üzerinde daha fazla yerel denetim, daha geniş birlikte çalışabilirlik ve farklı platformlar ile ekosistemler arasında cihazlarınızı bağlamak için daha esnek yollar sunmayı amaçlayan yerel öncelikli bir mimari olan OpenEdge'i tanıtıyor.

OpenEdge sayesinde uyumlu SONOFF cihazları HTTP, MQTT ve WebSocket gibi açık arayüzler üzerinden yerel olarak iletişim kurabilir.

Home Assistant kullanıcıları için bu, cihazlarınızı entegre etme konusunda daha fazla seçenek sunar: Yerel denetimi ve esnek ekosistem entegrasyonunu tercih ettiğinizde cihazlarınızı MQTT aracılığıyla yerel olarak bağlayabilir, ihtiyaçlarınıza daha uygun olduğunda bulut bağlantısını kullanmaya devam edebilirsiniz.

Home Assistant ile MQTT Entegrasyonu Nasıl Çalışır?

MQTT'yi yapılandırmaya başlamadan önce bağlantının nasıl çalıştığını anlamak faydalı olacaktır.

Temel mimari şu şekildedir:

OpenEdge özellikli SONOFF cihazı → MQTT Aracısı → Home Assistant

Home Assistant ile MQTT Entegrasyonu Hakkında SSS

 

1. MQTT, SONOFF Cihazlarını Home Assistant'a nasıl bağlar?

SONOFF cihazları doğrudan Home Assistant'a bağlanmaz. Bunun yerine, Home Assistant ile bir MQTT Broker üzerinden iletişim kurarlar.

┌───────────────┐
│ SONOFF Cihazı │
└───────┬───────┘
        │ MQTT
        ▼
┌───────────────┐
│  MQTT Broker  │
└───────┬───────┘
        │ MQTT
        ▼
┌────────────────┐
│ Home Assistant │
└───────┬────────┘
        │ MQTT Discovery
        ▼
┌─────────────────┐
│ Cihaz / Varlık │
└─────────────────┘

Bu nedenle entegrasyon süreci dört aşamaya ayrılabilir:

① SONOFF Cihazı → MQTT Broker

• SONOFF cihazının MQTT Broker'a bağlanabildiğinden emin olun.

② Home Assistant → MQTT Broker

• Home Assistant'ın MQTT Broker'a bağlanabildiğinden emin olun.

③ MQTT Discovery

• Home Assistant'ın MQTT Discovery aracılığıyla SONOFF cihazını keşfedebildiğinden emin olun.

④ Varlık

• Home Assistant'ın varlıkları doğru şekilde oluşturduğundan, cihazı kontrol edebildiğinden ve durumunu okuyabildiğinden emin olun.

Not: Bir SONOFF cihazında "MQTT Bağlandı" görünmesi, yalnızca cihazın MQTT Broker'a başarıyla bağlandığı anlamına gelir. Home Assistant'ın başarıyla bağlandığı veya cihazı keşfettiği anlamına gelmez.

 

2. Aşama 1: SONOFF Cihazını MQTT Broker'a Bağlama

S1: "MQTT Bağlandı", SONOFF cihazımın Home Assistant'a başarıyla bağlandığı anlamına mı gelir?

Hayır. “MQTT Bağlandı” yalnızca SONOFF cihazının MQTT Broker'a başarıyla bağlandığı anlamına gelir.

SONOFF cihazı genellikle Home Assistant'ın çevrimiçi olup olmadığını, Home Assistant'ın Broker'a bağlı olup olmadığını veya cihazın zaten keşfedilip keşfedilmediğini belirleyemez.

İletişim yolunun tamamı şöyledir:

SONOFF cihazı
     ↓
MQTT Broker        ✓
     ↓
Home Assistant     ?
     ↓
MQTT Keşfi     ?
     ↓
Varlık             ?

Cihazda MQTT Bağlandı yazıyor ancak Home Assistant'ta görünmüyorsa 2. ve 3. aşamalarla devam edin.

S2: SONOFF cihazım MQTT Broker'a bağlanamıyorsa neleri kontrol etmeliyim?

Aşağıdaki öğeleri sırayla kontrol edin:

1. MQTT Broker adresi

• SONOFF cihazında yapılandırılan Broker adresinin doğru olduğundan emin olun.
  Örneğin: 192.168.1.100

2. MQTT bağlantı noktası

• Yaygın MQTT bağlantı noktaları şunlardır: 

• SONOFF cihazında yapılandırılan bağlantı noktasının, MQTT Broker'ın gerçekten dinlediği bağlantı noktasıyla eşleştiğinden emin olun.

3. MQTT kullanıcı adı ve şifresi

Broker'da kimlik doğrulama etkinse şunları kontrol edin:

• Kullanıcı adı
• Şifre
• Hesabın devre dışı bırakılıp bırakılmadığı
• Herhangi bir ACL izninin hesabı kısıtlayıp kısıtlamadığı

Kullanıcı adı veya şifre yanlışsa SONOFF cihazı MQTT bağlantısı kuramayabilir.

4. Ağ bağlantısı

• SONOFF cihazının MQTT Broker'a erişebildiğinden emin olun. Örneğin:

SONOFF cihazı
192.168.1.50
     ↓
MQTT Broker
192.168.1.100:1883

Yapılandırma ayarlarını değiştirirseniz yeniden kontrol etmeden önce Home Assistant'ı yeniden başlatın veya MQTT entegrasyonunu yeniden yükleyin.

3. Aşama 2: Home Assistant'ı MQTT Broker'a bağlama

S3: SONOFF cihazımda “MQTT Bağlandı” yazıyor, ancak Home Assistant'ta görünmüyor. Neleri kontrol etmeliyim?

Öncelikle, Home Assistant'ın kendisinin MQTT Broker'a başarıyla bağlanıp bağlanmadığını kontrol edin.

SONOFF cihazı ve Home Assistant birbirinden bağımsız MQTT istemcileridir:

              MQTT Broker
             /           \
            /             \
   SONOFF cihazı           HA
        |                   |
    Bağlandı           Bağlandı mı?

SONOFF cihazının başarıyla bağlanmış olması, Home Assistant'ın da MQTT Broker'a bağlı olduğu anlamına gelmez.

S4: Home Assistant'ın MQTT Broker'a bağlı olup olmadığını nasıl kontrol edebilirim?

Home Assistant'ta şu yolu izleyin: Ayarlar → Cihazlar ve hizmetler → MQTT → Yeniden yapılandır

Aşağıdakiler de dahil olmak üzere MQTT Broker yapılandırmasının doğru olduğunu kontrol edin:

• Broker IP adresi
• Kullanıcı adı
• Şifre

Home Assistant web arayüzü genellikle 8123 bağlantı noktasını kullanır. Bu, MQTT bağlantı noktasından farklıdır. Yaygın olarak kullanılan MQTT bağlantı noktalarından biri 1883 numaralı bağlantı noktasıdır.

S5: SONOFF OpenEdge cihazı ve Home Assistant farklı MQTT Broker'ları kullanabilir mi?

Normalde, farklı MQTT Broker'ları kullanıyorlarsa otomatik keşif düzgün çalışmaz. Örneğin:

SONOFF cihazı
     ↓
Broker A

Home Assistant
     ↓
Broker B

İki sistem farklı Broker'lara bağlı olduğundan Home Assistant, SONOFF cihazının yayımladığı MQTT iletilerini alamaz.

Normal kurulum şöyledir:

SONOFF cihazı ─┐
         ↓
       Broker
         ↑
         │
Home Assistant

 

4. Aşama 3: MQTT Discovery

S6: OpenEdge cihazı ve Home Assistant MQTT Broker'a bağlı, ancak cihaz hâlâ Home Assistant'ta görünmüyor. Ne yapmalıyım?

Bu aşamada MQTT Discovery ayarını kontrol edin.

Cihazın, MQTT Discovery aracılığıyla Home Assistant'a cihaz ve varlık bilgilerini sağlaması gerekir.

• Home Assistant'ta şu konuma gidin: Ayarlar → Cihazlar ve hizmetler → MQTT → Yapılandır → MQTT seçeneklerini yapılandır
• Keşfi etkinleştir seçeneğinin etkin olup olmadığını kontrol edin.
• Ayrıca Discovery Önekinin varsayılan değere ayarlı olup olmadığını kontrol edin: homeassistant

Discovery devre dışı bırakılmışsa, etkinleştirip ayarları kaydetmek Home Assistant'ın zaten bağlı olan MQTT cihazlarını hemen yeniden taramasını sağlamaz.

Home Assistant'ın Discovery Topic'ine yeniden abone olup cihazları tanımlayabilmesi için lütfen Home Assistant'ı yeniden başlatın veya MQTT entegrasyonunda “Yeniden yükle”ye tıklayın.

 

5. Discovery Öneki Sorunları

S8: Discovery Öneki nedir?

Discovery Öneki, Home Assistant MQTT Discovery tarafından kullanılan Topic önekidir.

Home Assistant varsayılan olarak şu değeri kullanır: homeassistant

S9: Home Assistant Discovery Önekini değiştirmek OpenEdge cihaz entegrasyonunu etkiler mi?

Evet. Örneğin cihaz varsayılan öneki kullanıyorsa: homeassistant

Ancak Home Assistant Discovery Öneki şu şekilde değiştirilmişse: myhome

Home Assistant şu konumda Discovery Topic'lerini dinler: myhome/...

İletişim yolu şöyle görünür:

Cihaz
homeassistant/...
       ↓
    Broker
       ↓
Home Assistant
myhome/... adresini dinler

İki önek eşleşmediğinden Home Assistant cihazı doğru şekilde keşfedemez.

Öneri

• Home Assistant Discovery Önekini şu değere ayarlayın: homeassistant
• Değiştirmeyin.
• Önek daha önce değiştirilmiş ve bu nedenle cihaz kullanılamaz hâle gelmişse, varsayılan değere geri döndürmek eski varlıkları otomatik olarak kaldırmaz veya cihazın yeniden keşfedilmesini sağlamaz.
• Bu durumda, Home Assistant'ı yeniden başlatın veya MQTT entegrasyonunu yeniden yükleyin. Daha önce keşfedilen varlıklar hâlâ “Kullanılamıyor” olarak görünüyorsa eski varlıkları silip cihazı yeniden keşfetmeniz gerekebilir.

 

6. Özel ağ ortamlarındaki sorunlar

S11: Yerel ağımda MQTT çalışıyor, ancak harici bir ağa geçtiğimde neden çalışmayı durduruyor?

MQTT aracısı yalnızca evinizin yerel ağına dağıtılmışsa:

SONOFF cihazı
     ↓
192.168.1.100:1883
     ↓
Ev yerel ağı

Cihaz başka bir LAN'dayken bu ağdan ayrılırsa:

SONOFF cihazı
    x
192.168.1.100

Artık aracıya LAN IP adresi üzerinden erişemez.

Ağlar arası erişim için şunları değerlendirin:

• Herkese açık IP adresli MQTT aracısı

Güvenlik notu: Şifrelenmemiş 1883 MQTT bağlantı noktasını doğrudan herkese açık internete açmanız önerilmez.

 

7. Docker ortamlarında sık karşılaşılan sorunlar

S12: Home Assistant Docker'da çalışıyor. localhost:1883 kullandığımda neden MQTT aracısına bağlanamıyor?

Home Assistant ve MQTT aracısı farklı Docker kapsayıcılarında çalışıyorsa localhost genellikle MQTT aracısının çalıştığı kapsayıcıyı değil, Home Assistant kapsayıcısını ifade eder.

Örneğin:

┌─────────────────────┐
│ Docker ana makinesi         │
│                     │
│ ┌───────────────┐   │
│ │ Home Assistant│   │
│ │ localhost     │   │
│ └───────────────┘   │
│                     │
│ ┌───────────────┐   │
│ │ Mosquitto     │   │
│ │ Bağlantı noktası 1883     │   │
│ └───────────────┘   │
│                     │
└─────────────────────┘

Bu nedenle, Home Assistant'ta localhost:1883 girmek Mosquitto'ya bağlanmayı garanti etmez.

Önerilen yapılandırma

Docker ağ yapılandırmasına aşina değilseniz MQTT aracısının çalıştığı ana makinenin yerel ağ IP adresini girmeniz önerilir. Örneğin:

MQTT aracısı:
192.168.1.100

Bağlantı noktası:
1883

192.168.1.100 yerine MQTT aracısının çalıştığı ana makinenin gerçek IP adresini yazın.

Home Assistant ve Mosquitto aynı Docker ağına bağlıysa Mosquitto kapsayıcı adını da kullanabilirsiniz. Örneğin: mosquitto:1883

Not: mosquitto gibi bir kapsayıcı adı yalnızca ilgili Docker ağında kullanılabilir. SONOFF cihazları genellikle Docker kapsayıcı adını değil, MQTT aracısının çalıştığı ana makinenin IP adresini veya alan adını kullanmalıdır.

Değişiklikleri yaptıktan sonra, yeni yapılandırmayı uygulamak için Home Assistant kapsayıcısını yeniden başlatın veya MQTT entegrasyonunu yeniden yükleyin.