OFFICIAL TECHNICAL SPECIFICATION

GENVOLT DOCS

Engineering specifications, MQTT telemetry topics, Modbus register mappings, and Real Edge device onboarding for the GenVolt SCADA Platform.

01 // SYSTEM TOPOLOGY & DATA PIPELINE PRODUCTION SPEC

High-Performance Cloud SCADA Topology

GenVolt connects physical generators via Edge Gateways to cloud ingest engines with sub-second latency and persistent hypertable telemetry:

Real Edge PC (On-Site)
      │
      │ MQTT over TLS :8883 (mTLS / CA validated)
      ▼
EMQX Community 5.x Broker (VPS: 43.129.56.157)
      │
      ├── Fastify Node.js Backend (:8000 / api.genvolt.cloud)
      │     │
      │     ├── TimescaleDB / PostgreSQL 16 (Hypertable Storage)
      │     └── Server-Sent Events (SSE /v1/stream)
      │
      └── Next.js 15 Standalone Frontend Portals
            ├── Web Monitor (monitor.genvolt.cloud)
            └── Web Admin (admin.genvolt.cloud)

02 // MQTT PROTOCOL & TOPIC HIERARCHY QOS SPECIFICATION

Standardized MQTT Topics

Direction	Topic Format	QoS	Description
Edge → Cloud	`v1/{company}/{site}/{device}/telemetry`	QoS 0	High-frequency generator telemetry (cadence 0.5s)
Cloud → Edge	`v1/{company}/{site}/{device}/command/down`	QoS 1	Control commands (START, STOP, RESET_ALARM, AUTO, MANUAL)
Edge → Cloud	`v1/{company}/{site}/{device}/command/up`	QoS 1	Command acknowledgment and execution status receipt
Edge → Cloud	`v1/{company}/{site}/edge/{edge_id}/heartbeat`	QoS 1	Periodic edge daemon health and status (15s cadence)

03 // MODBUS REGISTER SPECIFICATION DSE 8610 MKII

Active Register Subsets

Edge collector interrogates controller holding & input registers via Function Code 03 / 04:

Register	Signal Name	Multiplier	Unit	Category
1024	Engine Speed (RPM)	1.0	RPM	Engine
1025	Oil Pressure	1.0	kPa	Engine
1026	Coolant Temp	1.0	°C	Engine
1027	Fuel Level	1.0	%	Engine
1028	Battery Voltage	0.1	V	Electrical
1032	Generator Frequency	0.1	Hz	Electrical
1033	Voltage L1-N	1.0	V	Electrical
1040	Current L1	1.0	A	Electrical
1044	Total Active Power	1.0	kW	Power

04 // REAL EDGE PC ONBOARDING GUIDE TLS PORT 8883

Edge Collector Configuration

To connect a physical Edge PC running the GenVolt Edge Collector to the cloud:

{
  "edge_id": "EDGE-PLANT-01",
  "company_id": "PT-ENERGY-NUSANTARA",
  "site_id": "SITE-JAKARTA-01",
  "mqtt": {
    "host": "emqx.genvolt.cloud",
    "port": 8883,
    "username": "genvolt_edge",
    "password": "",
    "tls": true
  },
  "devices": [
    {
      "device_id": "GENSET-DSE-8610-A",
      "modbus_ip": "192.168.1.50",
      "modbus_port": 502,
      "modbus_unit_id": 10,
      "polling_interval": 0.5
    }
  ]
}