MQTT Topic Hiyerarşisi
Bootstrap (Claim Öncesi)
| Topic | Yön | QoS | Açıklama |
|---|---|---|---|
/bootstrap/{id}/hello | ESP32→Backend | 0 | Cihaz kendini tanıtır |
/bootstrap/{id}/claim_ready | ESP32→Backend | 0 | Claim'e hazır |
/bootstrap/{id}/srv/rebind | Backend→ESP32 | 1 | Tenant atama |
/bootstrap/{id}/srv/deny | Backend→ESP32 | 1 | Claim reddi |
Tenant-Level Config
| Topic | Yön | QoS | Retain |
|---|---|---|---|
tenant/{tid}/gw/{gid}/desired/config | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/reported/config | GW→Backend | 1 | Hayır |
tenant/{tid}/gw/{gid}/desired/templates/full | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/desired/templates/update | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/desired/templates/add | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/desired/templates/remove | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/desired/devices/full | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/desired/devices/add | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/desired/devices/update | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/desired/devices/remove | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/reported/status | GW→Backend | 1 | Hayır |
Telemetri (Per-Group)
tenant/{tid}/gw/{gid}/data/device/{device_id}/{group_id}
| Group ID | Interval | QoS | İçerik |
|---|---|---|---|
realtime | 5s | 0 | Voltaj, akım, güç, cos(φ) |
power_totals | 5s | 0 | Toplam güç + frekans |
energy_kwh | 60s | 1 | Enerji sayaçları (faturalama) |
energy_per_phase | 60s | 1 | Faz bazlı enerji |
ct_ratio | 24h | 1 | CT/PT konfigürasyon |
bms_identity | 24h | 1 | BMS seri no, SoH |
step_values | 30s | 0 | Kompanzasyon basamakları |
Raw Mode
| Topic | Yön | QoS | Retain |
|---|---|---|---|
tenant/{tid}/gw/{gid}/desired/rawconfig | Backend→GW | 1 | Evet |
tenant/{tid}/gw/{gid}/data/raw/{device_id} | GW→Backend | 0 | Hayır |
tenant/{tid}/gw/{gid}/reported/rawconfig | GW→Backend | 1 | Hayır |
Komutlar
| Topic | Açıklama | QoS | Retain |
|---|---|---|---|
tenant/{tid}/gw/{gid}/cmd/test_read | Test okuma | 1 | Hayır |
tenant/{tid}/gw/{gid}/cmd/reboot | Yeniden başlat | 1 | Hayır |
tenant/{tid}/gw/{gid}/cmd/ota | OTA başlat | 1 | Evet |
tenant/{tid}/gw/{gid}/cmd/read_group | Grup okuma (BMS) | 1 | Hayır |
OTA (Device-Level, MAC Bazlı)
| Topic | Yön | QoS | Retain |
|---|---|---|---|
zeus/devices/{mac}/ota/command | Backend→GW | 1 | Evet |
zeus/devices/{mac}/ota/progress | GW→Backend | 0 | Hayır |
zeus/devices/{mac}/ota/status | GW→Backend | 1 | Evet |
zeus/devices/{mac}/ota/rollback | Backend→GW | 1 | Hayır |
Ownership Sync
| Topic | Yön | QoS | Retain |
|---|---|---|---|
zeus/devices/{mac}/commands/ownership | Backend→GW | 1 | Evet |
zeus/devices/{mac}/events/ownership_ack | GW→Backend | 1 | Hayır |
Broadcast
| Topic | Yön | QoS |
|---|---|---|
zeus/firmware/announcements | Backend→All | 0 |
zeus/firmware/availability | Backend→All | 0 |
QoS Politikası Özeti
| Veri Tipi | QoS | Neden |
|---|---|---|
| Realtime ölçümler | 0 | Sık gönderim, kayıp tolere edilir |
| Enerji sayaçları | 1 | Faturalama verisi, kayıp olmamalı |
| Config / Template | 1 | Cihaz yapılandırması kritik |
| Komutlar | 1 | Tek seferlik, ulaşması garanti |
| Bootstrap | 0 | Best-effort yeterli |