Cihaz Entegrasyonu

Zeus 2.0, gunes enerjisi santralleri ve enerji yonetim sistemlerindeki sahadaki cihazlari Modbus RTU protokolu uzerinden okur. ESP32 tabanli gateway'ler, RS-485 bus uzerinden cihazlara baglanir, JSON tabanli template dosyalarina gore register'lari parse eder ve verileri MQTT uzerinden backend'e iletir.

Veri Akisi

Saha Cihazi (Invertor, Analizor, MCCB)
    |
    | RS-485 (Modbus RTU, 9600 baud)
    v
ESP32 Gateway
    |
    | Template Parse (JSON register haritasi)
    | JSON serialize
    v
MQTT Broker (EMQX)
    |
    | zeus/{tenant_id}/{gateway_id}/{device_id}/{group_id}
    v
FastAPI Backend
    |
    | TimescaleDB + PostgreSQL
    v
Dashboard / Alarm / Rapor

Ozet: Cihaz, RS-485 uzerinden elektriksel sinyalleri ESP32 gateway'e gonderir. Gateway, template dosyasina gore ham register degerlerini anlamli metriklere donusturur (voltaj, akim, guc, enerji vb.). Daha sonra bu veriler MQTT uzerinden backend'e iletilir ve veritabanina kaydedilir.

Desteklenen Cihazlar

Asagidaki tabloda Zeus 2.0 ile test edilmis ve template'i hazir olan cihaz modelleri listelenmistir.

Marka	Model	Tip	Protokol	Baud Rate	Aciklama
Entes	RG3-12CS	Enerji Analizoru	Modbus RTU	9600	3 fazli enerji analizoru, harmonik olcumu
Entes	RG20C	Enerji Analizoru	Modbus RTU	9600	Kompakt enerji analizoru
Entes	RGSR-24S	Reaktif Kompanzasyon	Modbus RTU	9600	Reaktif guc kompanzasyon kontrol rolesi
Kael	Energymeter-02	Enerji Analizoru	Modbus RTU	9600	Enerji olcum cihazi
Kael	Multiser-01	Multi Analizor	Modbus RTU	9600	Coklu parametre analizoru
Varkombi	12-PC-TFT	Reaktif Kompanzasyon	Modbus RTU	9600	12 kademeli kompanzasyon panosu
Varkombi	18-PC-TFT	Reaktif Kompanzasyon	Modbus RTU	9600	18 kademeli kompanzasyon panosu
Sofar	HYD 3-6K	Hibrit Invertor	Modbus RTU	9600	PV + batarya + grid yonetimi
Sofar	KTLX-G3	String Invertor	Modbus RTU	9600	PV uretim invertorleri
Matismart	MTM5M	MCCB (Devre Kesici)	Modbus RTU	9600	Akilli devre kesici, uzaktan kontrol
Electronova	PD194Z-9H	Enerji Analizoru	Modbus RTU	9600	Cok fonksiyonlu guc analizoru

Template Sistemi

Zeus 2.0, cihaz register haritalarini JSON template dosyalari ile tanimlar. Bu yaklasim, yeni cihaz destegi eklemek icin firmware degisikligi gerektirmeden sadece yeni bir template dosyasi olusturmayi yeterli kilar.

Template Yapisi

Her template asagidaki bilesenlerden olusur:

• Cihaz bilgileri: Uretici, model, template ID
• Polling gruplari: Farkli olcum kategorileri (realtime, energy_kwh, step_values vb.)
• Bloklar: Her grup icinde okunacak register aralik(lar)i (start address, count, function code)
• Field tanimlari: Her register icin ad, offset, veri tipi, olcek carpani ve birim

Polling Gruplari

Grup	Aralik	Icerik
realtime	5s	Voltaj, akim, guc, guc faktoru (cos phi)
power_totals	5s	Toplam guc, frekans
energy_kwh	60s	Enerji sayaclari (kWh, kVArh)
step_values	30s	Kompanzasyon kademe degerleri
ct_ratio	24h	CT/PT donusum oranlari
bms_identity	24h	BMS seri no, SoH (invertor icin)

Veri Tipleri

Tip	Boyut	Aciklama
uint16	1 register	Isaretsiz 16-bit tamsayi
int16	1 register	Isaretli 16-bit tamsayi
uint32	2 register	Isaretsiz 32-bit tamsayi
int32	2 register	Isaretli 32-bit tamsayi
float32	2 register	IEEE 754 kayan nokta

Function Code'lar

Kod	Ad	Kullanim
3	Read Holding Registers	Yapilandirma ve durum register'lari
4	Read Input Registers	Salt okunur olcum register'lari

Sonraki Adimlar

• Belirli bir cihaz ailesi hakkinda detay icin sol menudeki ilgili sayfaya gidin
• Yeni bir cihaz entegre etmek icin Yeni Cihaz Ekleme Rehberi sayfasina bakin