Data Bridge (IoT gateway)

REST sunucu, REST istemci ve MQTT istemci ajanları; payload biçimleri; Kepware uyumlu uçlar.

Data Bridge (eski adıyla IoT Gateway) veriyi MergenHub'dan dışarı — bulutlara, broker'lara ve üçüncü parti sistemlere — taşır ve basit HTTP istemcilerinin OPC UA olmadan tag okuyup yazmasını sağlar. Kendi Windows servisi olarak çalışır (MergenHubDataBridge); yavaş bir bulut ucu taramayı hiçbir zaman etkilemez.

Eklentiler › Data Bridge — ajan listesi ve ajan editörü

Ajanlar

Ajan	Yön	Ne yapar
REST sunucu	gelen	Kepware uyumlu HTTP uçları (`/iotgateway/read`, `/iotgateway/write`, `/iotgateway/browse`); Kepware IoT Gateway ile aynı JSON biçimleri, mevcut entegrasyonlar değişmeden çalışır
REST istemci	giden	Seçili tag'leri değişimde ya da zamanlı bir URL'ye iter (POST/PUT); JSON/XML/CSV/anahtar-değer; özel başlık ve kimlik
MQTT istemci	giden	Seçili tag'leri broker'a yayınlar (QoS, retain, TLS, kullanıcı/parola ya da sertifika); JSON payload, tag başına konu ya da gruplu; isteğe bağlı Sparkplug tarzı şablonlar

Her ajanın kendi tag listesi, yayın hızı, değişimde / deadband filtreleri ve sayaçlarla son hatayı gösteren durum sayfası vardır.

REST sunucu hızlı başlangıç

REST sunucu ajanı ekleyin, tag'leri seçin, gerekiyorsa yazmaya izin verin.
Giriş yapın (oturum çerezi ya da API token) ve okuyun:

curl -b c.txt "http://localhost:8090/iotgateway/read?ids=Tesis.PLC1.Debi&ids=Tesis.PLC1.Basinc"

{"readResults":[{"id":"Tesis.PLC1.Debi","s":true,"r":"","v":412.6,"t":1757067641008}, …]}

Yazma (yazmaya izin açıkken):

curl -b c.txt -X POST http://localhost:8090/iotgateway/write -H "Content-Type: application/json" \
     -d '[{"id":"Tesis.PLC1.Setpoint","v":55}]'

MQTT istemci hızlı başlangıç

Broker mqtt://broker.example.com:1883 (ya da TLS ile mqtts://), istemci id, kimlik.
tesis/{channel}/{device}/{tag} gibi konu şablonu ya da JSON dizisiyle tek konu.
Yayın modu: değişimde (deadband'li) ya da her N ms.
Payload örneği:

{"id":"Tesis.PLC1.Debi","v":412.6,"q":"Good","t":"2026-09-05T10:20:41.008Z"}

Dayanıklılık

Hedef düşükken ajanlar tamponlar, dönünce boşaltır (sınırlı kuyruklu bellek içi store-and-forward).
Ajan durumu bağlı / yeniden deniyor ve son hata metnini gösterir; hatalar Olay günlüğünde de vardır.
Köprü ayrı süreç olduğundan yeniden başlatmak (Ayarlar › Servisler) OPC UA'yı ve taramayı kesmez.

Güvenlik notları

REST sunucu ana API ile aynı kullanıcı, token ve kaynak ACL'sini kullanır; yalnız kullanıcının okuyabildiği tag'ler döner.
Dış sistemler için HTTPS ve API token tercih edin; web portunu TLS'siz asla dışarı açmayın.
MQTT: TLS ve broker'da cihaz başına kimlik; test için kapatmadıkça MergenHub broker sertifikasını doğrular.