Product Guides

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

How to Integrate SONOFF OpenEdge Devices with Home Assistant via MQTT


Giriş

SONOFF, yeni nesil akıllı cihazlar için tasarlanmış, yerelliği önceliklendiren bir mimari olan OpenEdge'i kullanıma sunuyor. Bu mimari size cihazlarınızı farklı platformlar ve ekosistemler arasında bağlamak için daha fazla yerel kontrol, daha geniş birlikte çalışabilirlik ve daha esnek yöntemler sağlamayı amaçlıyor.

OpenEdge ile desteklenen 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ı nasıl entegre edeceğiniz konusunda daha fazla seçenek sunar: Yerel kontrolü ve esnek ekosistem entegrasyonunu tercih ettiğinizde cihazlarınızı MQTT üzerinden yerel olarak bağlayabilir, ihtiyaçlarınıza daha uygun olduğunda bulut bağlantısını kullanmaya devam edebilirsiniz.

Bu kılavuzda, SONOFF OpenEdge özellikli cihazları Home Assistant'a MQTT üzerinden entegre etmeyi ayrıntılı, adım adım bir kurulumla öğreneceksiniz.



MQTT Entegrasyonunun Home Assistant ile Çalışma Şekli

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 Broker'ı → Home Assistant

SONOFF cihazı doğrudan Home Assistant'a bağlanmaz. Bunun yerine cihaz ve Home Assistant, aralarında mesaj merkezi görevi gören aynı MQTT broker'ına bağlanır.
  • OpenEdge özellikli SONOFF cihazı — MQTT istemcisi olarak broker'a bağlanır, cihaz durumlarını ve verilerini yayınlar ve kontrol komutlarını alır.
  • MQTT broker'ı — Bağlı istemciler arasındaki MQTT mesajlarını alır ve dağıtır. Home Assistant kurulumlarında Mosquitto yaygın bir tercihtir.
  • Home Assistant — MQTT entegrasyonu üzerinden aynı broker'a bağlanır, cihaz güncellemelerini alır, komut gönderir ve cihazı Home Assistant'ta yönetir.
OpenEdge özellikli SONOFF cihazları, MQTT ile birlikte yerel olarak MQTT Discovery'yi destekler. Cihaz broker'a bağlandığında gerekli keşif bilgilerini yayınlar; böylece Home Assistant, MQTT konularını manuel olarak yapılandırmadan veya YAML yazmadan desteklenen cihazı ve varlıkları otomatik olarak oluşturabilir.



OpenEdge Cihazlarını MQTT Üzerinden Home Assistant ile Kurma

Şimdi MQTT entegrasyonunu kuralım. Bu kılavuzda örnek olarak SONOFF MINI-1GSP kullanılmıştır; aynı temel iş akışı, MQTT desteğine sahip diğer uyumlu OpenEdge cihazları için de kullanılabilir. 

Gerekenler

Başlamadan önce şunlara sahip olduğunuzdan emin olun:
  • MQTT desteğine sahip OpenEdge özellikli bir SONOFF cihazı.
  • Home Assistant yüklenmiş ve çalışıyor.
  • Bir MQTT broker'ı yüklenmiş ve çalışıyor.
  • MQTT entegrasyonu Home Assistant'a eklendi ve broker'a bağlandı. 

MQTT Broker'ı Yükleyin ve Kurun

Henüz bir MQTT broker'ınız yoksa Home Assistant için yaygın bir seçenek, resmi Mosquitto MQTT broker uygulamasıdır.
Home Assistant'a yüklemek için: 
  • Home Assistant'ı açın.
  • Ayarlar → Uygulamalar (önceden eklentiler olarak adlandırılıyordu) → Uygulama yükle bölümüne gidin.
  • Mosquitto brokerı aratın ve KUR'a tıklayın.
  • Kurulduktan sonra Mosquitto broker uygulamasını başlatın.
  • Broker'ın Home Assistant ile otomatik olarak başlatılması ve beklenmedik şekilde durduğunda yeniden başlatılabilmesi için Önyüklemede başlat ve Watchdog seçeneklerinin etkinleştirilmesi önerilir.
  • Gerekirse MQTT cihazları için Ayarlar → Kişiler → Kullanıcılar bölümünden özel bir Home Assistant kullanıcısı oluşturun.

Bir MQTT broker'ı seçme ve yapılandırma hakkında daha fazla bilgi için Home Assistant'ın resmi broker kurulum kılavuzuna bakın. 

Home Assistant'a MQTT Entegrasyonunu Ekleyin

  1. Home Assistant'ta Ayarlar → Cihazlar ve Hizmetler → Entegrasyon Ekle bölümüne gidin.
  2. MQTT'yi aratın ve kurulumu tamamlayın.
  3. Entegrasyonun broker'ınıza bağlı olduğunu doğrulamak için Ayarlar → Cihazlar ve Hizmetler → MQTT bölümüne gidin.

1. Adım: Cihazı Açın

MINI-1GSP, ilk kez açıldığında otomatik olarak eşleştirme moduna girer. LED iki kısa yanıp sönmenin ardından bir uzun yanıp sönme gösterdiğinde, AP erişim noktası kuruluma hazırdır. 

2. Adım: OpenEdge Web Konsolu'na Erişin

Web Konsolu'na erişmenin iki yolu vardır.

Yöntem 1: AP Erişim Noktası Üzerinden Erişim — İlk Kurulum İçin Önerilir

  • Masaüstü, tablet veya mobil cihazınızda Wi-Fi ayarlarını açın.
  • Cihazın erişim noktasına bağlanın: SONOFF_1GSP_xxxx.

  • Bir web tarayıcısı açın ve şu adrese gidin: http://192.168.33.1
  • Web Konsolu giriş sayfası açılır. İlk erişiminizde en az 8 karakter.
    uzunluğunda bir giriş parolası oluşturun. Giriş yaparak OpenEdge Web Konsolu'na erişin.

Web Konsolu'ndan AÇMA/KAPATMA kontrolü, geçmiş enerji verileri, zamanlayıcılar, Matter Eşleştirme, Ağ Ayarları, AP/Wi-Fi yapılandırması, OTA güncellemeleri ve OpenEdge Hakkında gibi yerel işlevleri yönetebilirsiniz.

Bağlantı Ayarları altında Bulut bağlantısını, Home Assistant için MQTT'yi, TLS seçeneklerini ve üçüncü taraf platformlara yönelik giden WebSocket bağlantılarını yapılandırabilirsiniz.  

2. Yöntem: LAN üzerinden erişim

Cihaz yerel ağınıza zaten bağlıysa AP erişim noktasına bağlanmadan Web Konsolu'na doğrudan erişebilirsiniz.  
MINI-1GSP için aynı LAN'a erişebilen bir cihazda tarayıcı açın ve tarayıcıya aşağıdakilerden birini girin:

  • MINI-1GSP.local
  • Cihazın yerel IP adresi.

3. Adım: Cihazı Wi-Fi Ağınıza Bağlayın

Cihazı, hem Home Assistant'a hem de MQTT aracınıza erişebilen bir Wi-Fi ağına bağlayın; böylece yerel ağ üzerinden iletişim kurabilirler.

  • Ağ Ayarları → Wi-Fi Ayarları'na gidin.
  • Home Assistant ve MQTT aracısından erişebileceğiniz Wi-Fi ağını seçin.
  • Wi-Fi parolasını girin.
  • Kaydet'e tıklayın.
  • Cihazın bağlanmasını bekleyin.

Cihaz yerel ağınıza bağlandığında yönlendiriciniz genellikle cihaza DHCP aracılığıyla yerel bir IP adresi atar. Bu adres Wi-Fi ayarlarında gösterilir ve yukarıda açıklanan 2. Yöntem kapsamında Web Konsolu'na daha sonra LAN üzerinden erişmek için kullanılabilir.

Not: AP erişim noktası zaman aşımı

MINI-1GSP, yaklaşık 10 dakika sonra eşleştirme modundan otomatik olarak çıkar. Eşleştirme modu sona erdiğinde, ilk kurulum için kullanılan AP erişim noktası artık kullanılamaz.

Kurulumu tamamlamadan önce AP erişim noktası kaybolursa:

  1. Cihaz yerel ağınıza zaten bağlıysa, kuruluma yukarıda açıklanan LAN erişim yöntemiyle devam edin.
  2. AP erişim noktasını tekrar kullanmanız gerekirse, eşleştirme moduna yeniden girmek için cihaz düğmesini 5 saniye basılı tutun.
  3. SONOFF_1GSP_xxxx ağına yeniden bağlanın, http://192.168.33.1 adresini açın ve kuruluma devam edin.

İpucu: Cihaz düğmesine 10 saniye basılı tutmak fabrika ayarlarına sıfırlama işlemini gerçekleştirir.

4. Adım: MQTT'yi Etkinleştirme ve Parametreleri Yapılandırma

  • Bağlantı Ayarları → MQTT bölümüne gidin.
  • Etkinleştir MQTT.
  • MQTT parametrelerini aşağıda gösterildiği gibi yapılandırın
  • Ayarlar tamamlandığında Kaydet'e tıklayın.

Cihaz Web Konsolu MQTT Yapılandırması Örneği:

Ayar

Girilecek Değer

Sunucu

MQTT aracısının adresi ve bağlantı noktası, örn. 192.168.1.242:1883

Kullanıcı adı

MQTT aracısı kullanıcı adı

Parola

MQTT aracısı parolası

Bağlantı Türü

Aracınıza uygun TLS seçeneğini belirleyin

MQTT üzerinden RPC durum bildirimleri

Gerektiğinde etkinleştirin veya devre dışı bırakın

İpuçları:
  • Sunucu alanı MQTT aracınızı göstermelidir. Mosquitto Broker, Home Assistant ile aynı ana bilgisayarda çalışıyorsa bu genellikle MQTT bağlantı noktası 1883 ile birlikte Home Assistant ana bilgisayarının IP adresidir; örneğin: 192.168.1.242:1883. 
  • Resmî Home Assistant Mosquitto Broker'ını kullanıyor ve ayrı MQTT kimlik bilgileri (kullanıcı adı ve parola) oluşturmadıysanız mevcut bir Home Assistant kullanıcı adı ve parolası kullanabilirsiniz.
  • Mosquitto zaten bir kullanıcı adı ve parolayla yapılandırılmışsa cihazın Web Konsolu MQTT ayarlarında aynı kullanıcı adı ve parolayı girin.

5. Adım: Home Assistant'ta Cihazı Doğrulama ve Denetleme

  • MQTT ayarlarını kaydettikten sonra masaüstü, tablet veya mobil cihazınızı Home Assistant'a ve MQTT aracısına erişebilen yerel ağa yeniden bağlayın.
  • Home Assistant'ı açın, Ayarlar → Cihazlar ve Hizmetler → MQTT bölümüne gidin 

Cihaz, MQTT cihaz listesinde zaten görünmelidir. MQTT destekli OpenEdge özellikli SONOFF cihazları, Home Assistant MQTT Discovery bilgilerini yerel olarak yayımlar. Böylece Home Assistant, manuel MQTT konusu veya YAML yapılandırması gerektirmeden cihazı otomatik olarak ekler ve desteklenen varlıklarını oluşturur.

  • Mevcut denetimleri ve varlıkları görüntülemek için cihaz sayfasını açın. MINI-1GSP örneğinde bunlar aşağıdaki işlevleri içerir:
    • Röle denetimi
    • Akım
    • Gerilim
    • Güç
    • Frekans
    • Enerji verileri

Daha sonra bu varlıkları Home Assistant kontrol panelinize ekleyebilir veya otomasyonlarda ve sahnelerde kullanabilirsiniz.


 

OpenEdge Destekli Cihazlar

Aşağıdaki SONOFF ürünleri şu anda OpenEdge'i desteklemektedir:

MINI-1GS yakında OpenEdge destekli daha fazla cihaz sunulacaktır:

  • MINI-1GS
  • MINI-1GS10
  • ……

OpenEdge, aşağıdakiler de dahil olmak üzere daha fazla SONOFF ürün kategorisini kademeli olarak destekleyecektir:

  • Akıllı anahtarlar — açık arayüzler aracılığıyla daha esnek yerel denetim ve entegrasyon sağlar.
  • Enerji yönetimi ürünleri — yerel veri işleme ve daha şeffaf enerji izleme olanağı sunar.
  • Diğer akıllı cihazlar — OpenEdge'in açık entegrasyon özellikleri sayesinde daha fazla platform ve ekosistemle bağlantı.

👉 Desteklenen en güncel cihazları ve Home Assistant ile entegrasyondan sonra kullanılabilen özellikleri görmek için SONOFF OpenEdge cihazları için Home Assistant Özellik Desteği Listesi.  



Sonuç

SONOFF OpenEdge, Home Assistant entegrasyonunu daha basit, daha yerel ve daha esnek hâle getirir. Dahili Web Konsolu ve OpenEdge'in MQTT üzerinden standartlaştırılmış Yerel API'si sayesinde desteklenen SONOFF cihazları doğrudan bir tarayıcıdan yapılandırılabilir ve Home Assistant ile yerel olarak entegre edilebilir; böylece entegrasyon yolunda buluta ihtiyaç duymadan kolay kurulum, hızlı yerel kontrol ve daha esnek otomasyon sağlanır.


 

 

SSS

S: OpenEdge bulut bağlantısı gerektirir mi?

Şart değil. OpenEdge, yerel öncelikli bir mimari temelinde tasarlanmıştır; böylece desteklenen cihazlar yerel Web Konsolu ve yerel ağ üzerinden standartlaştırılmış Yerel API aracılığıyla yapılandırılabilir, kontrol edilebilir ve entegre edilebilir.

Bu yerel özellikler için bulut bağlantısı gerekli değildir; ancak bulut erişiminden yararlanan özellikler ve hizmetler için isteğe bağlı bir geliştirme olarak kullanılmaya devam eder.

 

S: SONOFF OpenEdge cihazları internet kullanılamadığında Home Assistant ile çalışabilir mi?

Evet. Bu kılavuzda açıklanan Home Assistant MQTT kurulumu için SONOFF cihazı, MQTT aracısı ve Home Assistant'ın yerel ağ üzerinden erişilebilir durumda kalması gerekir.

LAN ve MQTT aracısı kullanılabilir durumda kaldığı sürece cihaz, aktif bir internet bağlantısı olmadan Home Assistant ile yerel olarak iletişim kurmaya devam edebilir.

 

S: Home Assistant ile MQTT kurmak için eWeLink uygulamasına veya eWeLink hesabına ihtiyacım var mı?

Hayır. Bu kılavuzda açıklanan yerel MQTT entegrasyonu için eWeLink uygulamasını veya eWeLink hesabını kullanmadan OpenEdge Web Konsolu'na doğrudan bir tarayıcıdan erişebilirsiniz.

İlk kurulum için Web Konsolu'na cihazın AP erişim noktası üzerinden erişebilirsiniz. Cihaz yerel ağınıza bağlandıktan sonra yerel ana bilgisayar adı veya IP adresiyle LAN üzerinden de erişebilirsiniz.

Web Konsolu üzerinden cihaz ağını ve MQTT bağlantısını doğrudan yapılandırabilirsiniz. Kullanmayı tercih ederseniz eWeLink bulut bağlantısı ayrıca kullanılmaya devam eder.



Sonraki gönderi

home assistant zigbee dongle
SONOFF OpenEdge Devices: Home Assistant Feature Support

Yorum yazın

Tüm yorumlar yayınlanmadan önce incelenir.

Bu site hCaptcha ile korunuyor. Ayrıca bu site için hCaptcha Gizlilik Politikası ve Hizmet Şartları geçerlidir.