Esular · MQTT Veri Yapıları Kılavuzu

Esular MQTT Telemetri Veri Yapısı — Kapsamlı Kılavuz

Bu sayfa, sistemdeki tüm cihaz ve sensörlerin MQTT üzerinden gönderdiği telemetri paketlerini tek bir yerde toplar. Her bölüm; genel açıklama, anotasyonlu paket yapısı, alan-alan referans tablosu ve üzerinde oynayabileceğiniz interaktif örnek JSON içerir.

11 Cihaz Tipi Anotasyonlu Yapı Alan Referans Tabloları İnteraktif JSON

Cihaz Tipleri — Hızlı Referans

Tüm paketler ortak bir devices[ ].sensors[ ] çatısı kullanır; yalnızca iç sensör tipleri ve birimleri cihaza göre değişir. Aşağıdaki tablo, hangi tip numarasının hangi cihaza karşılık geldiğini ve topic önekini özetler.

Tip No	Cihaz / Sensör	Topic Öneki	Paket	Bölüm
`6`	Su Sayacı	WM_	1	Git →
`123`	Vana Ünitesi	Valve_	1	Git →
`124`	Pompa	Pomp_	2	Git →
`134`	Seviye Sensörü	Level_	1	Git →
`175`	Enerji Analizörü	EMT_	1	Git →
`200`	Ortam Nem/Sıcaklık	Temp_	1	Git →
`201`	Toprak Nem/Sıcaklık	Soil_	1	Git →
`202`	Basınç Sensörü	Pre_	1	Git →
`203`	Enerji Durum Sensörü	Power_	1	Git →
`208`	Sulama Grubu	IrrigationGr_	1	Git →
`244`	Bildirim (Notification)	Noti_	1	Git →

Temel

Genel Veri Yapısı

Tüm cihazlar için ortak çatı

MQTT veri yapısında her cihaz için benzersiz bir paket iletilir. Bir paket tek bir cihaz taşıyabileceği gibi çoklu cihaz da barındırabilir. Aşağıdaki genel çerçeve tüm sensörlerde ve bildirimlerde korunur; yalnızca iç yapıdaki type / unit / value içerikleri cihaza göre değişir.

Topic üç parçadan oluşur. İlk iki parça ayarlanabilir, son parça sistem tarafından eklenir ve pakete göre benzersizdir.
İlk parça clientID ile aynıdır (ör. esular); ikinci parça /telemetry/ sabit-ayarlanabilir kısımdır.
Son parça genelde paketteki ilk cihazın name değerinden türetilir (ör. Pomp_44013603).
Paketler kablosuz haberleşme nedeniyle parça parça (chunk) gelebilir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/Pomp_44013603   // 3 parçalı topic. 1: clientID "esular" (ayarlanabilir)
                                         // 2: "/telemetry/" (ayarlanabilir) 3: "Pomp_44013603" (sistem ekler, benzersiz)
{
  "devices": [            // Bir pakette en az 1 cihaz bulunur (cihaz listesi)
    {
      "name": "44013603",   // Benzersiz seri no. Önek=cihaz tipi, sayısal kısım=gerçek seri no
      "type": 124.0,       // Cihaz tipi (124 = pompa). Tip listesini referans tablodan kontrol edin
      "sensors": [          // Bir cihazda birden fazla sensör/ölçüm olabilir
        {
          "type": "Status", // Ölçümün adı
          "unit": "bool",   // Ölçümün birimi/tipi
          "value": 0         // Değer. Genelde float; string içerik de gelebilir
        },
        { "type": "OnTime",  "unit": "dk",  "value": 0 },
        { "type": "OffTime", "unit": "dk",  "value": 6 },
        { "type": "DIO",    "unit": "int", "value": 0 }
      ]
    }
  ]
}

Çatı Alanları

Alan	Açıklama
`devices[ ]`	Paketteki cihaz listesi. En az 1 cihaz içerir.
`name`	Cihazın benzersiz seri numarası. Öneki cihaz tipini, sayısal kısmı gerçek seri numarasını gösterir.
`type`	Cihazın tip numarası (ör. 124 = pompa). Hangi cihaz olduğunu belirler.
`sensors[ ]`	Cihaza ait ölçüm listesi. Her ölçüm `type` / `unit` / `value` üçlüsüdür.

İnteraktif Örnek JSON

Tip 6

Su Sayacı Sensörü

WM_ 1 paket

Su sayacında şu anda 1 adet MQTT paket yapısı vardır. Toplam tüketim ve anlık akış bilgisini iletir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/WM_44017700
{
  "devices": [
    {
      "name": "WM_44017700",
      "type": 6.0,            // 6 = su sayacı
      "sensors": [
        { "type": "Volume", "unit": "m3",   "value": 23.3  // Tüketilen toplam su (m3) },
        { "type": "Flow",   "unit": "m3/h", "value": 12.45 // Anlık akış (m3/h) }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Volume`	m3	Tüketilen toplam su miktarı (kümülatif endeks).
`Flow`	m3/h	Anlık akış değeri.

İnteraktif Örnek JSON

Tip 123

Vana Ünitesi

Valve_ 1 paket

Vana durumunu ve vana ile ilgili süre bilgilerini iletir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/Valve_44017706
{
  "devices": [
    {
      "name": "44017706",
      "type": 123.0,         // 123 = vana
      "sensors": [
        { "type": "Status",  "unit": "bool", "value": 0  // 0:Kapalı, 1:Açık, -1:Belirsiz },
        { "type": "OnTime",  "unit": "dk",   "value": 0  // Açık kalma süresi (dakika) },
        { "type": "OffTime", "unit": "dk",   "value": 58 // Kapalı kalma süresi (dakika) },
        { "type": "DIO",     "unit": "int",  "value": 0  // Dijital giriş/çıkış (kullanılmıyor) }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Status`	bool	Vana durumu — 0: Kapalı, 1: Açık, -1: Belirsiz.
`OnTime`	dk	Açık kalma süresi (dakika).
`OffTime`	dk	Kapalı kalma süresi (dakika).
`DIO`	int	Dijital giriş/çıkış durumu. Şu an kullanılmıyor.

İnteraktif Örnek JSON

Tip 124

Pompa

Pomp_ 2 paket

Pompada 2 farklı MQTT paketi bulunur: Paket-1 normal pompa durumunu, Paket-2 ise enerji/güç tüketim verilerini iletir. Paket-2 genelde invertörlü sistemlerde invertör verilerini takip için kullanılır ve cihaz adının sonuna _2 eki gelir.

Paket-1 · Durum

Topic: /esular/telemetry/Pomp_44013603
{
  "devices": [
    {
      "name": "44013602",
      "type": 124.0,         // 124 = pompa
      "sensors": [
        { "type": "Status",  "unit": "bool", "value": 0 // 0:Kapalı, 1:Açık, -1:Belirsiz },
        { "type": "OnTime",  "unit": "dk",   "value": 0 // Açık kalınan süre },
        { "type": "OffTime", "unit": "dk",   "value": 6 // Kapalı kalınan süre },
        { "type": "DIO",     "unit": "int",  "value": 0 }
      ]
    }
  ]
}

Paket-2 · Güç / Enerji

Topic: /esular/telemetry/Pomp_44013600_2   // Sondaki _2 paket numarasını ifade eder
{
  "devices": [
    {
      "name": "Pomp_44013600_2",
      "sensors": [
        { "type": "Status",   "unit": "bool", "value": 0 },
        { "type": "PowerKW",  "unit": "kw",   "value": 0 // Anlık çekilen enerji },
        { "type": "PowerHP",  "unit": "hp",   "value": 0 // Hidrolik güç },
        { "type": "Current",  "unit": "A",    "value": 0 // Toplam akım },
        { "type": "Voltage",  "unit": "V",    "value": 0 // RMS voltaj }
      ]
    }
  ]
}

Sensör Alanları

Paket	Alan	Birim	Açıklama
1	`Status`	bool	Pompa çalışıyor mu — 0:Kapalı, 1:Açık, -1:Belirsiz.
1	`OnTime`	dk	Pompanın açık kaldığı süre.
1	`OffTime`	dk	Pompanın kapalı kaldığı süre.
1	`DIO`	int	Dijital giriş/çıkış. Kullanılmıyor.
2	`PowerKW`	kw	Pompanın çektiği anlık enerji.
2	`PowerHP`	hp	Pompanın hidrolik gücü.
2	`Current`	A	Tüm fazlardan çekilen toplam akım.
2	`Voltage`	V	RMS voltaj değeri.

İnteraktif Örnek — Paket-1

İnteraktif Örnek — Paket-2

Tip 134

Seviye Sensörü

Level_ 1 paket

Su seviyesi durumunu ve seviye ile ilgili ölçümleri iletir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/Level_44017701
{
  "devices": [
    {
      "name": "44017701",
      "type": 134.0,         // 134 = su seviye sensörü
      "sensors": [
        { "type": "Status", "unit": "bool", "value": 0   // 0:Kapalı, 1:Açık, -1:Belirsiz },
        { "type": "Value",  "unit": "%",    "value": 100 // Havuz seviyesi (% — doğrudan seviye) },
        { "type": "Length", "unit": "cm",   "value": 0   // Suyun sensöre uzaklığı (cm) },
        { "type": "Type",   "unit": "int",  "value": 0   // Sensör tipi (ultrasonik/şamandıra/2-prob… aktif kullanılmıyor) }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Status`	bool	Seviye durumu — 0:Kapalı, 1:Açık, -1:Belirsiz.
`Value`	%	Yüzde cinsinden havuz/depo seviyesi. Doğrudan seviyeyi gösterir.
`Length`	cm	Suyun sensöre uzaklığı (cm).
`Type`	int	Sensör tipi (ultrasonik, şamandıra, 2-prob vb.). Şu an aktif kullanılmıyor.

İnteraktif Örnek JSON

Tip 175

Enerji Analizörü

EMT_ 1 paket · ~60 alan

Enerji analizörü, üç fazlı şebekeye dair voltaj, akım, anlık güç, güç faktörü, enerji sayaçları (kWh/kvarh/kVAh) ve harmonik bozulma değerlerini tek pakette iletir. Alan sayısı çok olduğundan aşağıda gruplanmış referans tablosu ile birlikte verilmiştir. unit: "f" ifadesi cihazdan gelen ham float değeri belirtir.

Paket Yapısı (özet)

Topic: /esular/telemetry/EMT_44017700
{
  "devices": [
    {
      "name": "44017700_17",
      "type": 175.0,     // 175 = enerji analizörü
      "sensors": [
        { "type": "Status", "unit": "bool", "value": 0 // 0:Okuma yok, 1:Okuma yapıldı, -1:Belirsiz },
        { "type": "F",    "unit": "hz", "value": 0 // Frekans },
        { "type": "kWa",  "unit": "kw", "value": 0 // A fazı anlık güç },
        { "type": "kWb",  "unit": "kw", "value": 0 },
        { "type": "kWc",  "unit": "kw", "value": 0 },
        // … Uan/Ubn/Ucn, Uab/Ubc/Uca, UAvg (voltajlar)
        // … Ia/Ib/Ic, IAvg (akımlar)
        // … kvar*, kVA*, PF* (reaktif/görünür güç, güç faktörü)
        // … kWh*/kvarh*/kVAh* (enerji sayaçları)  ·  THaD/THbD/THcD (harmonik)
      ]
    }
  ]
}

Gruplanmış Alan Referansı

Grup	Alanlar	Birim	Açıklama
Durum	`Status`	bool	Okuma durumu — 0:Okuma yok, 1:Okuma yapıldı, -1:Belirsiz.
Frekans	`F`	hz	Şebeke frekansı.
Anlık Güç	`kWa` `kWb` `kWc` `kWT`	kw / f	Faz A/B/C ve toplam (T) anlık aktif güç.
Faz-Nötr Voltaj	`Uan` `Ubn` `Ucn`	V	Faz-nötr gerilimleri.
Faz-Faz Voltaj	`Uab` `Ubc` `Uca` `UAvg`	V	Faz-faz gerilimleri ve ortalama.
Akım	`Ia` `Ib` `Ic` `IAvg`	A	Faz akımları ve ortalama.
Reaktif Güç	`kvara` `kvarb` `kvarc` `kvarT`	f	Faz ve toplam reaktif güç.
Görünür Güç	`kVAa` `kVAb` `kVAc` `kVAT`	f	Faz ve toplam görünür güç.
Güç Faktörü	`PFa` `PFb` `PFc` `PFT`	f	Faz ve toplam güç faktörü.
Açılar	`UAng` `IaAn` `IbAn` `IcAn`	f	Gerilim ve akım faz açıları.
Aktif Enerji	`kWhI` `kWhE` `kWhN` `kWhT`	f	İçe/Dışa/Net/Toplam aktif enerji sayacı.
Reaktif Enerji	`kvarhI` `kvarhE` `kvarhN` `kvarhT`	f	İçe/Dışa/Net/Toplam reaktif enerji.
Görünür Enerji	`kVAhI` `kVAhE` `kVAhN` `kVAhT`	f	İçe/Dışa/Net/Toplam görünür enerji.
Endüktif Reaktif	`kvarhEndI/E/N/T`	f	Endüktif reaktif enerji sayaçları.
Kapasitif Reaktif	`kvarhCapI/E/N/T`	f	Kapasitif reaktif enerji sayaçları.
Harmonik	`THaD` `THbD` `THcD`	f	Faz bazlı toplam harmonik bozulma (THD).

Not: Bu pakette alanların büyük çoğunluğu cihaz tarafından ham float (unit: "f") olarak gönderilir; ölçeklendirme ve birim yorumu uygulama tarafında yapılır.

İnteraktif Örnek JSON

Tip 200

Ortam Nem/Sıcaklık Sensörü

Temp_ 1 paket

Ortam (hava) sıcaklığı ve nem değerini iletir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/Temp_10004100
{
  "devices": [
    {
      "name": "10004100",
      "type": 200.0,         // 200 = ortam nem/sıcaklık sensörü
      "sensors": [
        { "type": "Temp", "unit": "C", "value": 17.98 // Sıcaklık (°C) },
        { "type": "Hum",  "unit": "%", "value": 0     // Nem (%) }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Temp`	C	Ortam sıcaklığı (°C).
`Hum`	%	Ortam nem değeri (%).

İnteraktif Örnek JSON

Tip 201

Toprak Nem/Sıcaklık Sensörü

Soil_ 1 paket

Toprak sıcaklığı ve nem değerini iletir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/Soil_44017700
{
  "devices": [
    {
      "name": "44017700",
      "type": 201.0,         // 201 = toprak nem/sıcaklık sensörü
      "sensors": [
        { "type": "Temp", "unit": "C", "value": 17.98 // Toprak sıcaklığı (°C) },
        { "type": "Hum",  "unit": "%", "value": 65    // Toprak nemi (%) }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Temp`	C	Toprak sıcaklığı (°C).
`Hum`	%	Toprak nem değeri (%).

İnteraktif Örnek JSON

Tip 202

Basınç Sensörü

Pre_ 1 paket

Anlık basınç değerini, sensör tipini ve ölçülen min/max basınçları iletir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/Pre_44017701
{
  "devices": [
    {
      "name": "44017701",
      "type": 202.0,         // 202 = basınç sensörü
      "sensors": [
        { "type": "Status",   "unit": "bool", "value": 0    // 0:Normal, 1:Hatalı basınç, -1:Belirsiz },
        { "type": "Value",    "unit": "bar",  "value": 1.23 // Anlık basınç },
        { "type": "Type",     "unit": " ",    "value": 2    // 0:None, 1:Limit, 2:4-20mA, 3:0-10V },
        { "type": "MaxValue", "unit": "bar",  "value": 0    // Maksimum ölçülen basınç },
        { "type": "MinValue", "unit": "bar",  "value": 0    // Minimum ölçülen basınç }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Status`	bool	0:Normal basınç, 1:Hatalı basınç, -1:Belirsiz.
`Value`	bar	Anlık basınç verisi.
`Type`	int	Sensör tipi — 0:None, 1:Limit, 2:4-20mA, 3:0-10V.
`MaxValue`	bar	Maksimum ölçülen basınç.
`MinValue`	bar	Minimum ölçülen basınç.

İnteraktif Örnek JSON

Tip 203

Enerji Durum Sensörü

Power_ 1 paket

Cihazın besleme/enerji durumunu, pil seviyesini ve enerji/pil tiplerini iletir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/Power_44013600
{
  "devices": [
    {
      "name": "44013600",
      "type": 203.0,             // 203 = enerji durum cihazı
      "sensors": [
        { "type": "Status",       "unit": "bool", "value": 1    // 1:Besleme var },
        { "type": "BatteryLevel", "unit": "%",    "value": 98.5 // Pil seviyesi (%) },
        { "type": "PowerType",    "unit": "int",  "value": 1    // 0:None, 1:ExternalDC, 2:ExternalAC },
        { "type": "BatteryType",  "unit": "int",  "value": 3    // 0:None,1:9V,2:3V6,3:Şarjlı-Li,4:External }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Status`	bool	Enerji durumu — 0:Kapalı, 1:Açık (besleme var), -1:Belirsiz.
`BatteryLevel`	%	Yüzde cinsinden pil seviyesi (float).
`PowerType`	int	Enerji tipi — 0:None, 1:ExternalDC, 2:ExternalAC.
`BatteryType`	int	Pil tipi — 0:None, 1:Tek kullanım 9V, 2:Tek kullanım 3V6, 3:Şarjlı Lityum, 4:External.

İnteraktif Örnek JSON

Tip 208

Sulama Grubu

IrrigationGr_ 1 paket

Bir sulama grubunun çalışma durumunu, ilerleme yüzdesini ve süre bilgilerini iletir.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/IrrigationGr_44017733
{
  "devices": [
    {
      "name": "44017733",
      "type": 208.0,           // 208 = sulama grubu
      "sensors": [
        { "type": "Status",      "unit": "bool", "value": 0  // 1:Running,2:WillStop,3:Stop,4:Error,5:Calibre },
        { "type": "IsActive",    "unit": "bool", "value": 0  // Grup aktif mi },
        { "type": "Percent",     "unit": "%",    "value": 75 // Sulama yüzdesi },
        { "type": "WorkingTime", "unit": "dk",   "value": 10 // Maksimum çalışma süresi },
        { "type": "OnTime",      "unit": "dk",   "value": 7  // Geçen sulama süresi }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Status`	bool	Grup durumu — 1:Running (çalışıyor), 2:WillStop, 3:Stop, 4:Error, 5:Calibre.
`IsActive`	bool	Grup aktif mi.
`Percent`	%	Sulamanın hangi oranda yapıldığını gösteren yüzde.
`WorkingTime`	dk	Maksimum çalışma süresi (dakika).
`OnTime`	dk	Sulama açıkken geçen süre (dakika).

İnteraktif Örnek JSON

Tip 244

Bildirim (Notification)

Noti_ 1 paket

type: 244 paketin bir bildirim olduğunu gösterir. name alanı, bildirimin ilgili olduğu cihazın seri numarasını taşır; içerideki sensör alanları bildirimin türünü ve detayını ifade eder.

Anotasyonlu Paket Yapısı

Topic: /esular/telemetry/Noti_44017701
{
  "devices": [
    {
      "name": "44017701",        // Bildirimin ilgili olduğu cihazın seri no'su
      "type": 244.0,           // 244 = bildirim paketi
      "sensors": [
        { "type": "Type",       "unit": "int", "value": 1 // 0:None,1:Alert,2:Danger,3:Info,4:Warning,5:Success },
        { "type": "DeviceType", "unit": "int", "value": 0 // İlgili cihazın tipi },
        { "type": "InType",     "unit": "int", "value": 0 // Detaylı bildirim kodu (aşağıdaki tabloya bakın) }
      ]
    }
  ]
}

Sensör Alanları

Alan	Birim	Açıklama
`Type`	int	Bildirim tipi — 0:None, 1:Alert, 2:Danger, 3:Info, 4:Warning, 5:Success.
`DeviceType`	int	Bildirimin ilgili olduğu cihazın tipi.
`InType`	int	Detaylı (iç) bildirim kodu — aşağıdaki tabloya bakın.

InType — Detaylı Bildirim Kodları

Kod	Sabit	Anlamı
`0`	Noti_Inner_None	Detay yok.
`1`	Noti_Inner_RefreshTimeout	Yenileme zaman aşımı.
`2`	Noti_Inner_ValueNotChanged	Değer değişmedi.
`3`	Noti_Inner_MaxError	Maksimum sınır hatası.
`4`	Noti_Inner_MinError	Minimum sınır hatası.
`5`	Noti_Inner_Gone	Cihaz iletişimi kayboldu.
`6`	Noti_Inner_Come	Cihaz iletişimi geri geldi.
`7`	Noti_Inner_WorkingError	Çalışma hatası.
`8`	Noti_Inner_TWorkingError	Zamanlı çalışma hatası.
`9`	Noti_Inner_TimeOutError	Zaman aşımı hatası.
`10`	Noti_Inner_Success	Başarılı.

İnteraktif Örnek JSON

…

Yakında Eklenecek Yapılar

Hazırlanıyor

Aşağıdaki cihaz tiplerinin MQTT veri yapısı henüz yayınlanmamıştır; tanımlandıkça bu sayfaya eklenecektir.

Arazi veri yapısı — Arazilerin gönderdiği MQTT verinin yapısı.
İklim istasyonu sensörü — İklim istasyonu telemetri paketi.

İhtiyaç duyduğunuz ek bir cihaz/paket tipi varsa, mevcut devices[ ].sensors[ ] çatısı korunarak kolayca eklenebilir.