MQTT sürücüsü

Bir MQTT sunucusuna (broker) MQTT 3.1.1 ya da 5.0 ile bağlanıp konulara abone olarak tag değeri almak, tag yazmayı konuya yayın (publish) olarak göndermek; TLS, istemci sertifikası, kullanıcı / şifre, QoS ve JSON alan adresleri.

Ne zaman kullanılır

MQTT sürücüsü, Live'ı bir MQTT 3.1.1 ya da MQTT 5.0 istemcisi yapar. Live sunucuya (broker) bağlanır, tag'lerin konularına abone olur; konuya gelen son yayın o tag'in değeri olur. Tag'e yazmak, değeri konuya yayınlamaktır. Cihazlar, ağ geçitleri ve IoT sistemleri veriyi genellikle bu yolla paylaşır. Demo Projesi'nde MQTT bağlantısı yoktur.

Sunucu tarafında ön koşullar

• MQTT sunucusu Live bilgisayarından erişilebilir olmalı (varsayılan port 1883, TLS ile genellikle 8883).
• Kimlik doğrulama kullanılıyorsa sunucuda kullanıcı tanımlı olmalı ve kullanıcının okuma / yazma izni bulunmalı. İzin yoksa sunucu aboneliği reddeder.
• Sunucu istemci sertifikası istiyorsa (karşılıklı TLS) Live için bir istemci sertifikası (özel anahtarıyla) hazırlayın.
• Cihazların yayınladığı konu adlarını ve yük (payload) biçimini (düz değer ya da JSON) bilin.

Bağlantı kurma

1. Bağlantı ekleyin

   Bağlantılar bölümünde Ekle, sürücü MQTT; sunucunun adresini yazın, port 1883 gelir. TLS kullanıyorsanız portu 8883 yapın ya da adresi mqtts://sunucu:8883 biçiminde yapıştırın (güvenlik TLS'e geçer).

2. Parametreleri girin

   123456

   1. MQTT sürümü — 3.1.1 ya da 5.0.
   2. Güvenlik — istemci sertifikası yalnızca TLS ile kullanılır.
   3. İstemci sertifikası — Yok, PFX dosyası ya da Windows sertifika deposu.
   4. PFX dosyası — Live bilgisayarındaki tam yol; parolası Live'da girilir.
   5. Sertifika parmak izi — depodaki sertifika için (40 onaltılık karakter).
   6. Hedef — TLS seçiliyse mqtts://.

   MQTT sürümü

   MQTT 3.1.1 (varsayılan) ya da MQTT 5.0 (aşağıda).

   Güvenlik

   Yok (şifrelenmemiş), TLS (sunucu sertifikası doğrulanır) ya da TLS (sertifika doğrulanmaz). TLS 1.2 kullanılır.

   İstemci sertifikası

   Yok (varsayılan), PFX dosyası ya da Windows sertifika deposu. Yalnız TLS ile kullanılır (aşağıda).

   PFX dosyası

   Live bilgisayarındaki tam yol (ör. C:\Sertifikalar\istemci.pfx). Parolası Live'da girilir.

   Sertifika parmak izi

   Windows sertifika deposundaki sertifikanın parmak izi (40 onaltılık karakter; boşluk ve : yazılabilir).

   Kimlik doğrulama

   Anonim ya da Kullanıcı adı ve şifre. İstemci sertifikasıyla birlikte de kullanılabilir.

   Kullanıcı adı

   Şifre proje dosyasına yazılmaz; Live'da girilir (Bağlantı güvenliği).

   İstemci kimliği

   Boşsa fv-<bilgisayar>-<bağlantı> biçiminde otomatik üretilir. Aynı kimlikle bağlanan iki istemciden eskisi sunucu tarafından atılır.

   Abonelik kalitesi (QoS)

   QoS 0 — en çok bir kez (varsayılan) ya da QoS 1 — en az bir kez.

   Yazma kalitesi (QoS)

   QoS 0 — yanıt beklenmez ya da QoS 1 — sunucunun onayı beklenir (varsayılan).

   Yazılanı sunucuda tut (retain)

   Açıksa yazılan mesaj sunucuda saklanır ve sonradan abone olanlara hemen gönderilir. Varsayılan kapalı.

   Bool yazma biçimi

   true / false (varsayılan), 1 / 0 ya da ON / OFF.

   Canlı tutma süresi (sn)

   0 – 3600, varsayılan 30. Sessiz kalan bağlantıda bu aralıkla sunucuya ping gider; 1,5 katı süre hiçbir şey gelmezse bağlantı kopmuş sayılır. 0 = kapalı.

3. Tag ekleyin

   Tag'in adresine konu adını yazın (Tag adresleri).

Konu adresleri

• Konu joker karakter (+, #) içermez; tag tek bir konunun değeridir. Konu ve JSON yolu büyük / küçük harfe duyarlıdır. Yazma konusu $ ile başlayamaz.
• JSON yolu nokta ile ayrılmış alan adları ve dizi sıralarıdır (motor.hiz, dizi[0].alan); başındaki $. isteğe bağlıdır; en çok 16 adım.

Okuma ve yazma davranışı

• Okuma: sürücü her konuya bir kez abone olur. Sunucu tutulan (retained) mesajı aboneliğe hemen gönderir. Henüz hiç yayın gelmemiş konunun tag'i hata vermez; değer gelene kadar bekler (kalitesiz görünür).
• Değer çevirme: Bool için true / false / 1 / 0 / on / off / yes / no okunur. Tag tipine sığmayan değer kırpılmaz, tag hata alır. DateTime için ISO 8601 ya da unix saniye / milisaniye kabul edilir. Yük UTF-8 metindir; 1 MB'tan büyük yük okunmaz.
• Yazma: değer, tag'in yazma konusuna yayınlanır. Okuma konusuyla aynıysa değer, sunucudan dönmesi beklenmeden tag'e de işlenir. Bağlantı kopmuşsa yazma reddedilir.
• JSON alanı yazma: konuya son gelen belgenin yalnızca ilgili alanı değiştirilir, diğer alanlar korunur. Konuda henüz belge yoksa ya da yazma konusu ayrıysa ve önceki belge bilinmiyorsa yalnızca o alanı içeren yeni bir belge yayınlanır.

MQTT 5.0

MQTT sürümü MQTT 5.0 seçilince konu adresleri, QoS ve yazma davranışı aynı kalır. Farklar:

• Anlaşılır red iletileri. Sunucunun bağlantı, abonelik ve yayın reddindeki neden kodu Türkçe bir iletiye çevrilir (ör. MQTT sunucusu bu konuya aboneliği reddetti (yetki yok): hat1/durum). Sunucu bir açıklama metni de gönderirse iletinin sonuna Sunucu iletisi: "…" olarak eklenir. Tanınmayan kod onaltılık olarak yazılır (0xA5 gibi).
• Sunucunun sınırları uygulanır. Sunucu kendi canlı tutma süresini bildirirse o kullanılır; en yüksek QoS'u 0 ise yazmalar QoS 0 ile gider. Sunucu tutulan mesajı desteklemiyorsa Yazılanı sunucuda tut açık bağlantının yazmaları reddedilir; sunucunun paket sınırını aşan yayın gönderilmez.
• Yönlendirme izlenmez. Sunucu bağlantıyı başka bir sunucuya yönlendirirse ileti yeni adresi söyler; bağlantının adresini siz değiştirirsiniz.
• Sunucu MQTT 5.0'ı desteklemiyorsa bağlantı MQTT sunucusu MQTT 5.0'ı desteklemiyor. Bağlantı parametrelerinde MQTT sürümü olarak 3.1.1 seçin. iletisiyle kurulmaz.

İstemci sertifikası (karşılıklı TLS)

Bazı sunucular bağlanan istemciden bir sertifika ister. Sertifika TLS bağlantısında verilir; MQTT 3.1.1 ve 5.0 ile kullanılabilir. Güvenlik Yok iken seçilen sertifika kullanılmaz ve Studio Sorunlar'da uyarır.

Yedekli sunucu çiftinde PFX dosyası iki bilgisayarda aynı yolda bulunmalı ve parola ikisinde de girilmelidir.

Sürücü başvurusu

MQTT

MQTT 3.1.1 / 5.0 istemcisi: Live sunucuya (broker) bağlanır, tag'lerin konularına abone olur ve gelen son yayını tag değeri yapar; yazma konuya yayın (publish) olarak gider. Adres bir konudur (ör. fabrika/hat1/sicaklik); yük JSON ise "konu#yol" ile içindeki alan seçilir; okuma ve yazma konuları ayrıysa "okuma|yazma" yazılır.

Sürücü kimliği

mqtt (proje dosyasındaki ad)

Bağlantı

IP adresi / bilgisayar adı ve port gerekir (varsayılan port 1883)

Veri tipleri

Bool Byte SInt Int UInt DInt UDInt Real LReal String DateTime

Aynı adres

Aynı adrese birden çok bağlantı tanımlanabilir.

Bağlantı parametreleri

Bağlantı seçiliyken Denetçi penceresinde görünür.

Adres biçimleri

Örnek adresler

Sık hatalar

Her satırın başındaki işaret, iletinin Live'da nerede görüneceğini söyler: [bağlantı] sistem menüsünün Bağlantılar bölümünde; [yazma] yazmayı yapan operatöre bildirim penceresinde; [Studio] Studio'daki adres hücresinde ya da Sorunlar listesinde görünür. [tag] okuma sırasındaki tag hatasıdır: tag kalitesiz kalır, iletinin metni bu sürümde Live'da gösterilmez (Tag hataları); metni nedeni anlamak için okuyun.

Sınırlar