IoT Cihazları

Modül Nedir?

IoT Cihazları modülü (/iot-devices), Retgate donanımı kullanmadan, yalnızca API veya MQTT entegrasyonu ile veri toplanan cihazların yönetildiği modüldür. Üçüncü parti sensörler, bulut tabanlı cihazlar veya kendi API'si olan endüstriyel ekipmanlar bu modül aracılığıyla Retmes MES'e entegre edilir.

Retgate cihazı fiziksel olarak sahada PLC ve sensörlere bağlanırken, IoT Cihazları modülü yazılımsal bir entegrasyon katmanı sunar. Cihazlar, kendilerine verilen bağlantı token'ı veya MQTT broker bilgisi ile MES'e veri gönderir.

Bu modül özellikle şu durumlarda kullanılır:

• Retgate donanımı temin edilemediğinde veya gereksiz olduğunda
• Üçüncü parti IoT sensörleri veya gateway'lerin entegrasyonunda
• Bulut tabanlı cihazlardan (cloud-to-cloud) veri çekilmesinde
• MQTT broker üzerinden veri yayını yapan cihazların bağlanmasında

Yetenekler

• API tabanlı cihaz tanımlama ve yönetme
• MQTT tabanlı cihaz tanımlama ve yönetme
• Bağlantı token'ı oluşturma ve yönetimi
• Node oluşturma (API'den gelen değerler için manuel tanımlama)
• Cihaz durumu izleme (aktif/pasif)
• Node'ları Tag kaynağı olarak kullanma

Erişim & Roller

Bilgi	Değer
Route	/iot-devices
Gerekli Yetki	navigateIotDevices
Roller	Admin, Mühendis

Ekran Açıklaması

Ekran Görüntüsü

Ekran görüntüsü yakında eklenecektir.

Cihaz Listesi

Alan	Açıklama
Cihaz Adı	Cihazın okunabilir adı
Cihaz Türü	API veya MQTT
Bağlantı Token'ı	Cihazın MES'e veri gönderirken kullandığı kimlik doğrulama token'ı
Durum	Aktif / Pasif
Node Sayısı	Cihaz altındaki veri noktası adedi
İşlemler	Düzenle, Sil, Node'lara Git

Cihaz Oluşturma / Düzenleme Formu

Alan	Tip	Zorunlu	Açıklama
Cihaz Adı (Name)	Text	✅	Cihazın benzersiz adı
Cihaz Türü (Type)	Select	✅	API — REST API ile veri gönderir, MQTT — MQTT broker üzerinden veri yayını yapar
Açıklama (Description)	TextArea	❌	Cihaz hakkında açıklama

Bağlantı Token'ı

Cihaz oluşturulduktan sonra sistem tarafından otomatik bir bağlantı token'ı üretilir. Bu token, cihazın MES'e veri gönderirken kimlik doğrulaması için kullanılır.

Alan	Açıklama
Token	Otomatik üretilen benzersiz kimlik anahtarı
Token Yenile	Mevcut token'ı iptal edip yeni token üretir
Kopyala	Token'ı panoya kopyalar

Node Listesi (Cihaz Detayı)

Bir cihaz seçildiğinde altındaki node'lar (veri noktaları) listelenir:

Alan	Açıklama
Node ID	Veri noktasının benzersiz kimliği
Node Adı	Veri noktasının açıklayıcı adı
Değer	Son okunan değer
Zaman Damgası	Son veri alınma zamanı
İşlemler	Düzenle, Sil

Node Oluşturma Formu

Alan	Tip	Zorunlu	Açıklama
Node Adı (Name)	Text	✅	Veri noktasının adı
Node ID	Text	✅	API veya MQTT mesajlarında kullanılacak benzersiz tanımlayıcı
Açıklama	TextArea	❌	Node hakkında açıklama

Adım Adım Kullanım

API Cihazı Ekleme

1. Sol menüden Retgate & IoT → IoT Cihazları sayfasına gidin
2. Yeni Cihaz Ekle butonuna tıklayın
3. Cihaz Adı girin (örn: "Ortam Sensörü API")
4. Cihaz Türü olarak API seçin
5. Kaydet butonuna tıklayın
6. Oluşturulan cihazın Bağlantı Token'ını kopyalayın
7. Token'ı cihaz tarafındaki yazılıma yapıştırarak entegrasyonu tamamlayın

MQTT Cihazı Ekleme

1. Yeni Cihaz Ekle butonuna tıklayın
2. Cihaz Adı girin (örn: "Sıcaklık Sensör Ağı")
3. Cihaz Türü olarak MQTT seçin
4. Kaydet butonuna tıklayın
5. MQTT broker bağlantı bilgilerini ve topic yapısını yapılandırın

Node Oluşturma

1. Cihaz listesinde ilgili cihaza tıklayarak node listesine geçin
2. Yeni Node Ekle butonuna tıklayın
3. Node Adı girin (örn: "Ortam_Sıcaklık")
4. Node ID girin (API/MQTT mesajlarındaki alan adı ile eşleşmeli)
5. Kaydet butonuna tıklayın
6. Oluşturulan node'u Taglar modülünde bir tag kaynağı olarak atayın

Use Case Senaryoları

Senaryo 1 — Üçüncü Parti Sensör Entegrasyonu

Bir gıda fabrikasında LoRaWAN tabanlı kablosuz sıcaklık/nem sensörleri kullanılıyor. Sensörlerin kendi bulut platformu REST API sunuyor:

1. IoT Cihazları modülünde yeni bir API tipi cihaz oluşturulur: "LoRa_Depo_Sensörleri"
2. Bağlantı token'ı kopyalanır
3. Sensör platformunun webhook ayarlarına Retmes API adresi ve token girilir
4. Her sensör noktası için Node oluşturulur: "Depo1_Sıcaklık", "Depo1_Nem", "Depo2_Sıcaklık"
5. Node'lar Taglar modülünde etiketlerle eşleştirilir
6. Retgate donanımı olmadan depo sıcaklıkları MES'te izlenir

Senaryo 2 — Bulut Tabanlı Enerji İzleme

Bir işletme, enerji analizörlerini bulut tabanlı bir IoT platformu üzerinden izliyor ve bu verileri MES'e aktarmak istiyor:

1. IoT Cihazları modülünde API tipi cihaz oluşturulur: "Enerji_Bulut_Gateway"
2. Enerji platformunun entegrasyon ayarlarına Retmes endpoint ve token bilgisi girilir
3. Her ölçüm noktası için Node tanımlanır: "Ana_Pano_kWh", "Kompresör_kW"
4. Node'lar tag'larla eşleştirilerek enerji dashboard'unda görüntülenir

Senaryo 3 — MQTT Ortam İzleme

Bir ilaç üretim tesisinde temiz oda sensörleri MQTT üzerinden veri yayını yapıyor:

1. IoT Cihazları modülünde MQTT tipi cihaz oluşturulur: "CleanRoom_Sensors"
2. MQTT broker bilgileri ve topic yapısı yapılandırılır
3. Her sensör için Node oluşturulur: "CR1_Partikül", "CR1_Nem", "CR1_Basınç"
4. Node'lar tag'larla eşleştirilerek GMP uyumlu izleme sağlanır

Modüller Arası Bağlantılar

İlişki	Modül	Açıklama
Alternatif	Retgate Cihazlar	Retgate tabanlı donanımsal veri toplama alternatifi
Veri akışı	Taglar	IoT node'ları tag kaynağı olarak kullanılır
İzleme	Node İzleme	IoT cihaz node değerleri canlı izlenebilir
Kavramsal	Retgate Nedir?	Genel IoT mimarisi ve karşılaştırma
Politika	Bağlantı Politikaları	IoT cihaz bağlantı kuralları yönetilir