Modbus Polling

Standard Mode (Template-Based)

Template, register group'larını tanımlar:

{
  "groupId": "realtime",
  "intervalMs": 5000,
  "blocks": [
    {"startAddress": 4354, "count": 60, "functionCode": 3}
  ]
}

Her polling döngüsünde:

1. UART mutex alınır
2. Modbus RTU isteği gönderilir (FC 3 veya 4)
3. Yanıt template'e göre parse edilir
4. Per-group JSON oluşturulur
5. TelemetryQueue'ya eklenir
6. UART mutex serbest bırakılır

Raw Mode (Hex Output)

Template parsing ESP32'de yapılmaz, ham register değerleri hex olarak gönderilir:

{
  "slaveId": 1,
  "addr": 4354,
  "count": 60,
  "data": "43E6800043E5999A..."
}

Backend tarafında template ile parse edilir. Legacy ve özel cihazlar için kullanışlıdır.

Backpressure Sistemi

TelemetryQueue doluluk oranına göre 3 kademeli koruma:

Kademe	Eşik	Aksiyon
Normal	< %33 (5 item)	Tam hızda polling
Throttle	≥ %66 (10 item)	500ms gecikme
Critical	≥ %86 (13 item)	En eski veri düşürülür, polling duraklar

Hysteresis ile kademe geçişlerinde salınım önlenir.

Polling Aralıkları

Grup	Aralık	İçerik
realtime	5s	Voltaj, akım, güç, cos(φ)
power_totals	5s	Toplam güç, frekans
energy_kwh	60s	Enerji sayaçları
step_values	30s	Kompanzasyon basamakları
ct_ratio	24h	CT/PT konfigürasyon
bms_identity	24h	BMS seri no, SoH

---

Desteklenen Cihaz Modelleri

Aşağıdaki tabloda Zeus 2.0 ile test edilmiş ve template'i hazır olan cihaz modelleri listelenmiştir.

Marka	Model	Tip	Protokol	Baud Rate
Entes	RG3-12CS	Enerji Analizörü	Modbus RTU	9600
Entes	RG20C	Enerji Analizörü	Modbus RTU	9600
Entes	RGSR-24S	Reaktif Kompanzasyon	Modbus RTU	9600
Kael	Energymeter-02	Enerji Analizörü	Modbus RTU	9600
Kael	Multiser-01	Multi Analizör	Modbus RTU	9600
Varkombi	12-PC-TFT	Reaktif Kompanzasyon	Modbus RTU	9600
Varkombi	18-PC-TFT	Reaktif Kompanzasyon	Modbus RTU	9600
Sofar	HYD 3-6K	Hibrit İnvertör	Modbus RTU	9600
Sofar	KTLX-G3	String İnvertör	Modbus RTU	9600
Matismart	MTM5M	MCCB (Devre Kesici)	Modbus RTU	9600
Electronova	PD194Z-9H	Enerji Analizörü	Modbus RTU	9600

Not: Tüm cihazlar Modbus RTU protokolü ve 9600 baud rate ile iletişim kurar. Yeni cihaz desteği eklemek için ilgili marka/model için JSON template dosyası oluşturulmalıdır.

---

Register Map Yapısı

Template dosyaları JSON formatında register haritası tanımlar. Her template, cihazın Modbus register'larını gruplar halinde organize eder.

Template Yapısı

{
  "templateId": "entes-rg3-12cs",
  "manufacturer": "Entes",
  "model": "RG3-12CS",
  "groups": [
    {
      "groupId": "realtime",
      "intervalMs": 5000,
      "blocks": [
        {
          "startAddress": 4354,
          "count": 60,
          "functionCode": 3
        }
      ],
      "fields": [
        {
          "name": "voltage_l1",
          "offset": 0,
          "dataType": "float32",
          "scaleFactor": 1.0,
          "unit": "V"
        },
        {
          "name": "current_l1",
          "offset": 2,
          "dataType": "float32",
          "scaleFactor": 1.0,
          "unit": "A"
        }
      ]
    }
  ]
}

Field Tanımı

Her field aşağıdaki özellikleri içerir:

Alan	Tip	Açıklama
name	string	Metrik adı (MQTT payload'da kullanılır)
offset	int	Block başlangıcından register offset'i
dataType	string	Veri tipi: uint16, int16, uint32, int32, float32
scaleFactor	float	Ölçek çarpanı (ör: 0.1 = değer/10)
unit	string	Birim: V, A, W, kW, kWh, Hz, %, vb.

Function Code'lar

Kod	Ad	Kullanım
3	Read Holding Registers	Yapılandırma ve durum register'ları
4	Read Input Registers	Salt okunur ölçüm register'ları

---

Polling Interval Önerileri

Aşağıdaki aralıklar, veri güncellik ihtiyacı ve Modbus bus yükü dengesine göre belirlenmiştir.

Grup	Interval	Açıklama	Gerekçe
realtime	5s	Voltaj, akım, güç, güç faktörü (cosφ)	Anlık izleme ve alarm tespiti için yüksek çözünürlük
power_totals	5s	Toplam güç ve frekans	Dashboard'da gerçek zamanlı gösterim
energy_kwh	60s	Enerji sayaçları (kWh, kVArh)	Sayaç değerleri yavaş değişir, sık okuma gereksiz
step_values	30s	Kompanzasyon kademe değerleri	Kademe değişimleri orta hızda, aşırı yük oluşturmaz
ct_ratio	24h	CT/PT dönüşüm oranları	Sabit yapılandırma değerleri, nadiren değişir
bms_identity	24h	BMS kimlik bilgileri (seri no, SoH)	Cihaz tanımlama, günde bir kez yeterli

Önemli: Aynı RS-485 bus üzerinde çok sayıda cihaz varsa, toplam polling döngü süresi hesaplanmalıdır. Her Modbus isteği ortalama 50-100ms sürer. 10 cihaz x 6 grup = 60 istek, bu da ~3-6 saniye demektir. Realtime grubunun 5s aralığına sığması için bus üzerindeki toplam cihaz sayısı dikkate alınmalıdır.