Tasmota MQTT Komutları Kopya Kâğıdı: cmnd, stat ve tele Topic'leri Açıklaması

Bu Tasmota MQTT komutları kopya kâğıdı, Tasmota cihazlarını herhangi bir MQTT istemcisinden açıp kapatmak, sorgulamak ve ince ayar yapmak için her gün kullanacağınız topic'leri ve komutları bir araya getirir. cmnd, stat ve tele öneklerinin birbiriyle nasıl çalıştığını, her komutun hangi payload'ı beklediğini ve bunları bir terminalden, bir betikten veya ConnectMQ web istemcisinden nasıl göndereceğinizi öğreneceksiniz.

Tasmota MQTT Topic'leri Nasıl Oluşturulur?

Her Tasmota topic'i, varsayılan değeri %prefix%/%topic%/ olan Full Topic şablonunu izler. Komut adı en sona eklenir. Topic değeri plug1 olan bir cihaz için:

İki kural hataların çoğunu önler. Birincisi, komutlar her zaman cmnd önekine gider; stat önekine yayın yapmak hiçbir şey yapmaz. İkincisi, bir komut topic'ine gönderilen boş payload, mevcut değeri değiştirmeden sorgular.

Full Topic'iniz bir önek ekliyorsa, örneğin home/%prefix%/%topic%/, bu sayfadaki her topic o öneki alır: home/cmnd/plug1/POWER. Cihazda MQTT'yi henüz kurmadıysanız Tasmota MQTT kurulum rehberiyle başlayın.

Tasmota MQTT Komutlarını Göndermek

Bu sayfadaki her komutu üç şekilde gönderebilirsiniz.

Terminalden mosquitto istemcileriyle. Ücretsiz herkese açık MQTT broker üzerinde Full Topic'inizde connectmq/demo/k4w9ra/%prefix%/%topic%/ gibi benzersiz bir önek kullanın:

mosquitto_pub -h broker.connectmq.com -p 1883 -i cli-k4w9ra \
  -t 'connectmq/demo/k4w9ra/cmnd/plug1/POWER' -m 'ON'

ConnectMQ web istemcisinden. Portalda tarayıcı içi MQTT istemcisini açın, home/stat/plug1/# topic'ine abone olun, ardından home/cmnd/plug1/POWER topic'ine TOGGLE payload'ı ile yayın yapın. Canlı topic gezgini RESULT yanıtını orijinal durum topic'inin yanında gösterir.

Koddan. Herhangi bir MQTT kütüphanesi işinizi görür; işte paho-mqtt 2.x ile Python:

import paho.mqtt.client as mqtt

PREFIX = "connectmq/demo/k4w9ra"

client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="py-k4w9ra")
client.connect("broker.connectmq.com", 1883, keepalive=30)
client.loop_start()
info = client.publish(f"{PREFIX}/cmnd/plug1/POWER", "TOGGLE", qos=1)
info.wait_for_publish()
client.loop_stop()
client.disconnect()

Güç ve Röle Komutları

PulseTime, "N dakika çalış" anahtarı oluşturmanın güvenli yoludur. Örneğin PulseTime1 400, arada ağ bağlantısı kopsa bile röleyi açıldıktan 300 saniye sonra kapatır.

PowerRetain 1, cihazdan sonra başlayan panolar için kullanışlıdır; çünkü son güç durumu abone olunur olunmaz iletilir. Komut topic'lerini retained yapmayın; retained bir cmnd/.../POWER ON mesajı, her yeniden bağlantıdan sonra röleyi tekrar açar.

Telemetri ve Durum Komutları

Status yanıtları numaraya bağlı olarak stat/<topic>/STATUS, STATUS2 gibi topic'lere gelir. Kısa TelePeriod değerleri test sırasında işe yarar, ancak her 10 saniyede bir rapor veren birkaç yüz cihaz ciddi bir yük oluşturur. Panonuza hâlâ hizmet eden en yavaş aralığı seçin.

Işık ve Dimmer Komutları

Yapılandırma Komutları

Grup topic'leri toplu kontrolü kolaylaştırır: GroupTopic1 kitchen ayarlı her cihaz cmnd/kitchen/POWER OFF mesajına tepki verir. Yerleşik varsayılan grup topic'i tasmotas'tır. Cihazlarınız bir broker'ı başkalarıyla paylaşıyorsa bunu benzersiz bir değerle değiştirin; aksi takdirde başıboş bir cmnd/tasmotas/... mesajı cihazlarınıza ulaşabilir.

Şifreli bağlantıların kendine özgü gereksinimleri vardır; bunlar Tasmota MQTT TLS rehberinde ele alınır.

Bakım Komutları

Backlog ile Birden Fazla Komut Çalıştırmak

Backlog, noktalı virgülle ayrılmış bir komut listesini çalıştırır; bunu MQTT üzerinden de gönderebilirsiniz:

mosquitto_pub -h broker.connectmq.com -p 1883 -i cli-k4w9ra \
  -t 'connectmq/demo/k4w9ra/cmnd/plug1/Backlog' \
  -m 'Power ON; Delay 50; Power OFF'

Delay 0,1 saniyelik birimler kullanır; dolayısıyla Delay 50 beş saniye bekler. Backlog, her cihazın web arayüzünü tek tek ziyaret etmeden tüm bir yapılandırmayı cihaz filosuna göndermenin en temiz yoludur.

Kurallar: Cihazda Tetiklenen Komutlar

Kurallar (rules), bir cihazın herhangi bir sunucu olmadan tepki vermesini sağlar. Klasik bir örnek, röle değiştiğinde özel bir mesaj yayınlar:

Rule1 ON Power1#State DO Publish home/events/plug1 {"power":"%value%"} ENDON
Rule1 1

Bir kuraldan çalışan Publish, istediğiniz herhangi bir topic'e gönderim yapar; bu, başka bir sistem belirli bir format beklediğinde işe yarar.

Hızlı Başvuru Kontrol Listesi

1. Komutları cmnd/<topic>/<Command> adresine gönderin; yanıtları stat/<topic>/RESULT üzerinden okuyun.
2. Boş payload "kapat" değil, "sorgula" anlamına gelir.
3. Erişilebilirlik için tele/<topic>/LWT topic'ini izleyin.
4. Panolar ihtiyaç duyuyorsa durum topic'lerini retained yapın; komutları asla retained yapmayın.
5. Paylaşılan broker'larda benzersiz client ID, topic ve grup topic'leri kullanın.

Tasmota Cihazlarınızı ConnectMQ Üzerinde Çalıştırın

Herkese açık broker'da test yapmak sorun değildir, ancak özel bir broker yabancıları rölelerinizden uzak tutar. ConnectMQ'nun barındırılan MQTT broker hizmeti her cihaza kendi kimlik bilgilerini, yanıtları kontrol etmek için canlı bir topic gezginini ve ESP32 derlemeleri için 8883 portunda TLS sunar. app.connectmq.com adresinde kredi kartı gerekmeden ücretsiz bir Serverless broker oluşturun ve proje fikirleri için IoT otomasyon rehberine göz atın.

Sık Sorulan Sorular

Tasmota'da cmnd, stat ve tele arasındaki fark nedir?

cmnd komut gönderdiğiniz yerdir, stat yanıtları ve durum değişikliklerini taşır, tele ise periyodik telemetriyi ve Online/Offline erişilebilirlik mesajını taşır.

Bir Tasmota cihazının durumunu değiştirmeden nasıl kontrol ederim?

Komut topic'ine, örneğin cmnd/plug1/POWER adresine boş bir payload yayınlayın. Cihaz stat/plug1/RESULT üzerinden yanıt verir.

Birden fazla Tasmota komutunu tek bir MQTT mesajıyla nasıl gönderirim?

Komutları noktalı virgülle ayırarak cmnd/<topic>/Backlog adresine yayınlayın; örneğin Power ON; Delay 50; Power OFF.

Tasmota komutlarım neden yok sayılıyor?

Genellikle topic yanlıştır: komutlar cmnd önekini kullanmalı ve ek önekler ile büyük/küçük harf dahil cihazın Full Topic'iyle birebir eşleşmelidir.