Ana içeriğe geç

MQTT Payload Şemaları

Bootstrap Hello​

{
  "device_id": "esp32-gateway-001",
  "device_type": "esp32_gateway",
  "manufacturer": "About Energy",
  "firmware_version": "2.0.0",
  "ssid": "MyNetwork",
  "rssi": -45,
  "ip_address": "192.168.1.100",
  "uptime_sec": 3600,
  "free_heap": 180000
}

Per-Group Telemetri (Realtime)​

{
  "deviceId": "varkombi-001",
  "templateId": "VARKOMBI-18-PC-TFT",
  "groupId": "realtime",
  "timestamp": "2026-01-27T12:00:00.000Z",
  "data": {
    "voltage_l1n": 230.5,
    "voltage_l2n": 229.8,
    "voltage_l3n": 231.2,
    "current_l1": 45.2,
    "current_l2": 44.8,
    "current_l3": 46.1,
    "power_active_l1": 9500,
    "power_active_l2": 9200,
    "power_active_l3": 9800,
    "cos_phi_total": 0.976
  }
}

Raw Mode Data​

{
  "$schema": "zeus/mqtt/rawdata/v1",
  "templateId": "VARKOMBI-18-PC-TFT",
  "slaveId": 1,
  "addr": 4354,
  "count": 60,
  "ts": 1706360000,
  "data": "43E6800043E5999A43E733..."
}

RawConfig (Backend → Gateway)​

{
  "$schema": "zeus/mqtt/rawconfig/v1",
  "version": 1704067200,
  "devices": [
    {
      "id": "device-uuid",
      "templateId": "VARKOMBI-18-PC-TFT",
      "slaveId": 1,
      "enabled": true,
      "blocks": [
        {"addr": 4354, "count": 60, "fc": 3, "interval": 5000},
        {"addr": 8706, "count": 16, "fc": 3, "interval": 60000}
      ]
    }
  ]
}

Ownership Command​

{
  "$schema": "zeus/mqtt/ownership-command/v1",
  "action": "unclaim",
  "timestamp": "2025-12-04T10:30:00.000Z",
  "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
  "issued_by": "backend",
  "reason": "user_initiated",
  "metadata": {
    "user_id": "user-uuid",
    "organization_id": "org-uuid"
  }
}

Ownership ACK​

{
  "$schema": "zeus/mqtt/ownership-ack/v1",
  "command": "unclaim",
  "status": "success",
  "correlation_id": "550e8400-e29b-41d4-a716-446655440000",
  "mac_address": "44:91:2E:86:AB:CD",
  "firmware_version": "2.0.0",
  "previous_state": {
    "tenant_id": "e7dcb56a-...",
    "gateway_id": "235b492f-..."
  }
}

OTA Command​

{
  "$schema": "zeus/mqtt/ota-command/v1",
  "action": "update",
  "correlation_id": "550e8400-...",
  "ota_id": "ota-history-uuid",
  "firmware": {
    "version": "2.0.0",
    "url": "https://minio.zeus.local/zeus-firmwares/global/v2.0.0.bin",
    "size_bytes": 1048576,
    "checksum": {"algorithm": "sha256", "value": "abc123..."},
    "min_required_version": "1.5.0"
  },
  "options": {
    "force": false,
    "allow_downgrade": false,
    "reboot_delay_seconds": 3
  }
}