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 yerelliği önceliklendiren, cihazlarınızı farklı platformlar ve ekosistemler arasında bağlamanız için daha fazla yerel denetim, daha geniş birlikte çalışabilirlik ve daha esnek yöntemler sunmak üzere tasarlanan OpenEdge mimarisini kullanıma sunuyor.

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ı entegre etme konusunda daha fazla seçenek anlamına gelir: yerel denetimi 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ını, ayrıntılı ve adım adım bir kurulumla MQTT üzerinden Home Assistant'a nasıl entegre edeceğinizi öğreneceksiniz.




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ı olur.

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ındaki 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 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ırmaya veya YAML yazmaya gerek kalmadan 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ılı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 destekli, OpenEdge özellikli bir SONOFF cihazı.
  • Home Assistant yüklü ve çalışır durumdadır.
  • Bir MQTT broker'ı yüklü ve çalışır durumdadır.
  • Home Assistant'a MQTT entegrasyonu eklendi ve broker'a bağlandı. 

Bir 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.
  • Kurulum tamamlandıktan sonra Mosquitto broker uygulamasını başlatın.
  • Broker'ın Home Assistant ile otomatik olarak başlaması ve beklenmedik şekilde durduğunda yeniden başlatılabilmesi için Başlangıçta başlat ve Watchdog özelliklerini etkinleştirmeniz ö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.

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. Broker'ınıza entegrasyonun bağlı olduğunu doğrulamak için Ayarlar → Cihazlar ve Hizmetler → MQTT bölümüne gidin.

Adım 1: Cihazı Açın

MINI-1GSP için cihaz, ilk açılışta 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. 

Adım 2: OpenEdge Web Konsoluna Erişin

Web Konsoluna 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çılacaktır. İlk kez eriştiğinizde, en az 8 karakterden oluşan bir giriş şifresi oluşturun.
    OpenEdge Web Konsolu'na girmek için oturum açın.

Web Konsolu’ndan AÇMA/KAPATMA denetimi, 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 dahil olmak üzere yerel işlevleri yönetebilirsiniz.

Bağlantı Ayarları bölümünde 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ıyı açın ve aşağıdakilerden birini tarayıcıya girin:

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

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

Cihazı, hem Home Assistant’a hem de MQTT broker’ınıza ulaşabilen bir Wi-Fi ağına bağlayın; böylece yerel ağ üzerinden iletişim kurabilirler.

  • Ağ Ayarları → Wi-Fi Ayarları bölümüne gidin.
  • Home Assistant ve MQTT broker’dan erişebildiğiniz Wi-Fi ağını seçin.
  • Wi-Fi parolasını girin.
  • Kaydet düğmesine 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 2. Yöntem bölümünde açıklandığı gibi 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 yukarıda açıklanan LAN üzerinden erişim yöntemini kullanarak kuruluma devam edin.
  2. AP erişim noktasını tekrar kullanmanız gerekirse cihaz düğmesine 5 saniye basılı tutarak eşleştirme moduna yeniden girin.
  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ı tutulması 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 düğmesine tıklayın.

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

Ayar

Girilecek Değer

Sunucu

MQTT broker adresi ve bağlantı noktası, ör. 192.168.1.242:1883

Kullanıcı adı

MQTT broker kullanıcı adı

Parola

MQTT broker parolası

Bağlantı Türü

Broker’ı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 broker'ınızı göstermelidir. Mosquitto Broker, Home Assistant ile aynı ana bilgisayarda çalışıyorsa bu genellikle MQTT 1883 bağlantı noktası ile birlikte Home Assistant ana bilgisayarının IP adresidir; örneğin: 192.168.1.242:1883. 
  • Resmî Home Assistant Mosquitto Broker'ını kullanıyorsanız 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.

Adım 5: Cihazı Home Assistant'ta Doğrulama ve Kontrol Etme

  • MQTT ayarlarını kaydettikten sonra masaüstü, tablet veya mobil cihazınızı Home Assistant'a ve MQTT broker'ı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 desteğine sahip OpenEdge özellikli SONOFF cihazları, Home Assistant MQTT Discovery bilgilerini yerel olarak yayımlar. Böylece Home Assistant cihazı otomatik olarak ekler ve manuel MQTT konusu veya YAML yapılandırması gerektirmeden desteklenen varlıkları oluşturur.

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

Ardından bu varlıkları Home Assistant kontrol panelinize ekleyebilir veya otomasyonlarda ve sahnelerde kullanabilirsiniz.



OpenEdge Destekli Cihazlar

MINI-1GSP, OpenEdge'i destekleyen ilk SONOFF ürünüdür.
MINI-1GP|Çok yakında MINI-1GSP de dâhil olmak üzere OpenEdge destekli daha fazla cihaz kullanıma sunulacak:

  • MINI-1GP
  • MINI-1GS
  • MINI-1GS10

OpenEdge, aşağıdakiler de dâhil olmak üzere daha fazla SONOFF ürün kategorisini kademeli olarak destekleyecek:

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

Desteklenen en yeni cihazları ve Home Assistant ile entegrasyon sonrasında kullanılabilen özellikleri görmek için [SONOFF OpenEdge cihazları için Home Assistant Özellik Desteği Listesi] sayfasına bakın.  



Sonuç

SONOFF OpenEdge, Home Assistant entegrasyonunu daha basit, daha yerel ve daha esnek hâle getirir. Yerleşik 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'a yerel olarak entegre edilebilir. Böylece entegrasyon yolunda buluta bağlı kalmadan kolay kurulum, hızlı yerel kontrol ve daha esnek otomasyon elde edilir.



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.