İçeriğe geç
Proxus 2.0.0 Proxus 2.0: Proxus tarihinin en büyük sürümü Sürüm notları

Bağlantı kılavuzları · Modbus TCP MQTT

Modbus TCP register’larını okuyup MQTT sunucunuza yayınlayın

Proxus; enerji analizörü, sürücü ve PLC gibi Modbus TCP cihazlarını Edge Gateway’de çalışan kendi sürücüsüyle, Modbus RTU ya da ASCII cihazlarını bir seri cihaz sunucusu üzerinden okur. Register numaralarını cihaz belgesinde yazdığı gibi yapıştırırsınız, Proxus dönüştürür. Bu kılavuzda bir cihazı bağlar ve değerlerini kendi MQTT sunucunuza yayınlarsınız.

Her adım Proxus dokümantasyonundan alınmıştır ve ilgili sayfaya bağlanır.

Gerekenler

  • Oturum açabildiğiniz bir Proxus merkez sunucusu ve cihaz ile veri hedefi oluşturma yetkisi olan bir kullanıcı rolü. Proxus'u Docker ile kurun
  • Makineye ağ üzerinden erişebilen bir Edge Gateway. Merkez sunucuyla aynı ağdaki makineler için merkez sunucunun kendi Edge Gateway’i SYSTEM yeterlidir; çevrim içi bir Edge Gateway Bağlı olarak görünür. Edge Gateway kurun
  • Cihazın IP adresi, gerekiyorsa unit ID değeri ve register listesi: ad, register numarası, veri türü ve birim; örneğin bir Excel tablosunda. Cihaz ekleyin
  • MQTT sunucunuzun (sunucu adresi, port, kullanıcı adı ve parola, konu) bağlantı bilgileri ve hedefe veri gönderecek her Edge Gateway’den bu hedefe ağ erişimi. Veri hedefleri

Adımlar

  1. 01

    Cihaz sihirbazını açın ve Modbus TCP protokolünü seçin

    Bağlantılar > Cihazlar ekranını açın ve Yeni düğmesini seçin. Makineyle aynı ağdaki Edge Gateway’i seçin; bağlantı testi bu Edge Gateway üzerinden yapılır. Protokol arama kutusuna modbus yazın, Modbus TCP kartını seçin (seri cihaz sunucusunun arkasındaki bir cihaz için Modbus RTU Over TCP ya da Modbus ASCII Over TCP) ve İleri: Bağlantı düğmesini seçin.

    Doküman: Cihaz ekleyin

    Sihirbazın ilk adımı: Edge Gateway seçili, protokol arama kutusuna bir arama yazılmış ve bir protokol kartı seçili
  2. 02

    Adresi girin ve bağlantıyı test edin

    IP adresi alanına makinenin adresini, Edge Gateway’in ağdan gördüğü şekliyle girin. Port alanını boş bırakırsanız 502 portu kullanılır. Unit ID ve bayt sırası gibi protokol ayarları adres alanlarının yanında, daha az kullanılanlar Gelişmiş bölümünde yer alır. Daha hızlı ya da daha yavaş okumanız gerekmiyorsa Okuma aralığı için Profil varsayılanı seçeneğini değiştirmeyin ve Bağlantıyı test et düğmesini seçin. Makineye Edge Gateway’in kendisi bağlanmayı dener ve her denetimi ayrı gösterir: adrese ulaşıp ulaşmadığını ve makinenin protokol oturumunu kabul edip etmediğini.

    Doküman: Cihaz ekleyin

    Bağlantı adımı: IP adresi ve port girilmiş, sağda başarılı bir bağlantı testi
  3. 03

    Register’ları yapıştırın

    Yapıştır sekmesinde her satıra bir veri noktası gelecek şekilde ad, adres, veri türü ve birim sütunlarını yapıştırın; sütunlar sekmeyle (Excel’den kopyalandığı gibi), virgülle ya da noktalı virgülle ayrılabilir. Ardından Listeye ekle düğmesini seçin. Cihaz belgesindeki numaralar dönüştürülür: 40001 numarası x=3;0 (holding register 0), 30001 numarası x=4;0 (input register 0), 10001 numarası x=2;0 (discrete input), 1 numarası ise x=1;0 (coil) olur.

    Doküman: Cihaz ekleyin

    Yapıştır sekmesi: ad, register numarası, veri türü ve birim içeren satırlar yapıştırılmış
  4. 04

    Her veri noktasını bir kez okuyun

    Tabloyu kontrol edin ve Hepsini bir kez oku düğmesini seçin: Edge Gateway her veri noktasını bir kez okur ve değeri yanında gösterir, adresi yanlış olan satırda hata görünür. Adres yardımcısı adresi register numarasından oluşturur, böylece adres yanlış yazılmaz. Aynı modeldeki bir sonraki cihaz bu register’ları kullanabilsin diye bir Profil adı girin.

    Doküman: Cihaz ekleyin

    Veri noktası tablosu: ad, adres, veri türü, birim ve her satırın yanında deneme okumasıyla gelen değer
  5. 05

    Cihaza ad verin, yerini belirleyin ve kaydedin

    Yer ve tür adımında benzersiz bir Cihaz adı girin, Yer bölümünü Kuruluş düzeyinden Ekipman modülü düzeyine kadar doldurun (hiçbir düzey zorunlu değildir) ve Cihaz türü seçin; Proxus türü tahmin etmez. Cihazın ortak veri modelindeki (UNS) yerini bu bilgiler belirler. Kaydet ve doğrula düğmesini seçin: Kaydedildi, Gönderildi, Cihaz bağlandı ve İlk değerler aşamaları sırayla yeşile döner, her veri noktasının ilk değeri görünür.

    Doküman: Cihaz ekleyin

  6. 06

    MQTT sunucunuz için veri hedefini oluşturun

    Bağlantılar > Veri hedefleri ekranını açın, filtreyi Tümü olarak değiştirin, MQTT örneğini açın ve Kopyala... düğmesini seçin. Benzersiz bir Profil adı girin, ardından Parametreleri düzenle düğmesiyle MQTT sunucusu adresi ve MQTT sunucusu portu (varsayılan 1883) alanlarını doldurun. Topic değerine yayın yapılacak konuyu yazın; boş bırakılırsa değerler proxus_device_data konusuna gider. Username ve Password yalnızca ikisi birlikte girildiğinde kullanılır. TLS için TLS kullan seçeneğini açın, 8883 portunu kullanın ve MQTT sunucusunun CA sertifikasını Güvenilen sunucu sertifikası olarak seçin. Aktarım stratejisi alanında Doğrudan aktar okunan her değeri, Değiştiğinde yalnızca değişen değerleri gönderir. Kaydet düğmesini seçin.

    Doküman: Veri hedefleri

    MQTT örnek hedefi: hedef türü, aktarım stratejisi ve BrokerHost, BrokerPort gibi parametreler
  7. 07

    Hedefi Edge Gateway’den denetleyin

    Kaydettiğiniz hedefte Denetle düğmesini seçin. Sınamanın çalışacağı yer alanında merkez sunucuyu değil, cihazı okuyan Edge Gateway’i seçin: veriyi hedefe Edge Gateway gönderir ve yalnızca tesis ağından ulaşılabilen bir hedef merkez sunucudan sınandığında başarısız olur. Yapılandırma denetimi, hedefe bağlanmadan hataları ve uyarıları listeler. Bağlantıyı test et ise veri göndermeden hedefe bağlanır; sonuç kimlik doğrulandı, yalnızca erişilebiliyor ya da başarısız olarak, nedeniyle birlikte görünür.

    Doküman: Veri hedefleri

    Bir veri hedefinin Denetle penceresi: sınamanın çalışacağı yer, çalışma durumu ve yapılandırma denetimi
  8. 08

    Cihazın değerlerini hedefe gönderin

    Bağlantılar > Cihazlar ekranında cihazı (ya da birden çok cihazı) seçin, ardından Hedefler > Hedef ekle komutuyla hedefi ekleyin. Tek bir cihaz için cihaz sayfasındaki Gönderim sekmesini de kullanabilirsiniz; yeni bir cihazda hedefi sihirbazdaki Veri nereye gidecek? bölümünde işaretlemeniz yeterlidir. Hedefin Cihazlar sayısı artar, ilk gönderimden sonra Durum yeşile döner.

    Doküman: Veri hedefleri

Veriyi doğrulayın

  • Sihirbazın son adımında aşamalar sırayla tamamlanır ve her veri noktasının ilk değeri görünür. Cihaz ekleyin
  • Cihazı açın. Canlı değerler sekmesinde her veri noktası değeri, küçük bir trend grafiği, Veri kalitesi ve güncellenme zamanıyla görünür. Geçerli, değerin hatasız okunduğunu gösterir. Cihaz sayfası
  • Varlık yapısı > Veri ağacı (UNS) ekranını açın, Ara... kutusuna cihaz adını yazıp Enter tuşuna basın, ardından bir düğüme sağ tıklayıp Tümünü genişlet komutunu seçin. Cihaz verdiğiniz yerde durur; her veri noktası anlık değeri, trendi ve güncellenme zamanıyla görünür. Veri ağacı (UNS)
  • Herhangi bir MQTT istemcisiyle kendi MQTT sunucunuzda hedefin Topic konusuna abone olun: her okuma oraya JSON olarak gelir. Her Edge Gateway aynı değerleri yerleşik MQTT sunucusunda da yayınlar; kullanıcı adı olarak Edge Gateway’in MasterToken değeriyle v1/# konusuna abone olun (1883 portu, TLS ile 8883). MQTT ve UNS konuları
  • Hedefte Durum yeşildir; hedef veri göndermeye devam ettikçe son başarılı gönderim zamanı yaklaşık dakikada bir yenilenir. Veri hedefleri
Veri ağacı (UNS): ağaç kuruluştan bir cihazın veri noktalarına kadar açılmış, panelde bir veri noktası seçili

Sık karşılaşılan sorunlar

Bütün değerler bir register kaymış
Cihaz belgeleri adresleri 1’den, protokol ise 0’dan sayar. Proxus’ta 40001, holding register 0 (x=3;0) anlamına gelir. Cihaz sorunlarını giderme
Sayılar çok büyük ya da çok küçük, örneğin 1.0836943E-38
Veri türü ya da bayt sırası cihazla uyuşmuyor. Veri türünü (Float mı, Int mi) ve profildeki bayt sırası ayarını kontrol edin. Cihaz sorunlarını giderme
Modbus Bool tags should usually use coil/discrete input areas, not holding/input registers.
Proxus sık yapılan Modbus hatalarını tanır ve veri noktasının üzerinde açıkça belirtir. Bir başka örnek: The Modbus address format is invalid. Expected patterns are like x=3;100 for holding registers. Cihaz sorunlarını giderme
Cihaz oturumu reddetti.
Ağ bağlantısı sorunsuz, ancak cihaz protokol oturumunu kabul etmedi. Unit ID değerini kontrol edin; cihaz tek istemciye izin veriyorsa başka bir istemcinin bağlı olmadığından emin olun. Cihaz sorunlarını giderme
Edge Gateway cihaza ulaşamıyor.
TCP bağlantısı kurulamadı: adres ya da port yanlış, cihaz kapalı veya arada bir güvenlik duvarı ya da VLAN var. Test Edge Gateway üzerinde çalışır; erişimi kendi bilgisayarınızdan değil, Edge Gateway’in kurulu olduğu makineden deneyin. Cihaz sorunlarını giderme
MQTT sunucusu bir süre kapalı kalıyor
Veri kaybolmaz. Edge Gateway veriyi önce kendi kalıcı kuyruğuna yazar ve ancak hedef aldıktan sonra kuyruktan siler; hedefe yeniden ulaşıldığında bekleyen veri sırasıyla yazılır. Veri, Edge Gateway’in Ara bellek saklama süresi (saat) boyunca bekler: varsayılan 48 saat, en çok 30 gün. Veri hedefleri

Sonraki adımlar

Bir sonraki adım

Modbus TCP verisini MQTT hedefine kendi ekipmanınızla aktarın.

Proxus’u kurun ve adımları kendi ekipmanınızla izleyin. Bağlanmayan bir şey olursa bir mühendisimiz sizinle birlikte bakar.

  1. 01

    Keşif görüşmesi

    Ekipmanlarınızı, protokollerinizi, tesislerinizi ve verinin ulaşması gereken sistemleri konuşuruz.

  2. 02

    Teknik demo

    Genel bir tanıtım yerine, tesisinize benzeyen bir senaryo üzerinde canlı demo yaparız.

  3. 03

    Pilot planı

    Kurulum ve güvenlik sorularını baştan yanıtlar, ilk hat ya da tesis için kapsamı birlikte belirleriz.

  4. 04

    Yaygınlaştırma

    Aynı şablonlarla yeni hatlar ve tesisler devreye girer.