How xx-nichtlachen-xx/opendtu works
OpenDTU is an ESP32-based telemetry gateway intended to replace a Hoymiles DTU, receiving inverter data and exposing it through a web interface and MQTT integrations. The runtime entry point initializes configuration, networking, MQTT handlers, the Web API, and display services before running the scheduler. The source excerpts establish these startup calls and Home Assistant publication behavior; several protocol, API, and frontend details are unsampled, so those relationships are shown only where documented or left unconnected.
Main entry points: main.cpp Runtime startup · Hoymiles.cpp Hoymiles protocol · WebApi.cpp Web API · MqttHandleHass.cpp Home Assistant discovery
Components 26
Device runtime
- Runtime startup
src/main.cpp - Task scheduler
include/Scheduler.h
Inverter communications
- Hoymiles protocol
lib/Hoymiles/src/Hoymiles.cpp - CMT radio
lib/Hoymiles/src/HoymilesRadio_CMT.cpp - NRF radio
lib/Hoymiles/src/HoymilesRadio_NRF.cpp - Command queue
lib/Hoymiles/src/queue/CommandQueue.cpp - Alarm parser
lib/Hoymiles/src/parser/AlarmLogParser.cpp - Grid profile parser
lib/Hoymiles/src/parser/GridProfileParser.cpp
Device services
- Configuration
src/Configuration.cpp - Telemetry state
src/Datastore.cpp - Network settings
src/NetworkSettings.cpp - Web API
src/WebApi.cpp - Inverter endpoints
src/WebApi_inverter.cpp - MQTT endpoints
src/WebApi_mqtt.cpp - Display output
src/Display_Graphic.cpp
External integrations
- MQTT connection
src/MqttSettings.cpp - Inverter MQTT
src/MqttHandleInverter.cpp - Home Assistant discovery
src/MqttHandleHass.cpp - DTU MQTT
src/MqttHandleDtu.cpp - Total MQTT
src/MqttHandleInverterTotal.cpp
Web interface
- Web application
webapp/src/main.ts - App shell
webapp/src/App.vue - Live dashboard
webapp/src/views/HomeView.vue - Inverter administration
webapp/src/views/InverterAdminView.vue
Other components
- Device user
- MQTT broker
Connections 25
- Device user → Web application: uses
- Runtime startup → Configuration: initializes
src/main.cpp - Runtime startup → Network settings: initializes
src/main.cpp - Runtime startup → Web API: initializes
src/main.cpp - Runtime startup → Display output: initializes
src/main.cpp - Runtime startup → MQTT connection: initializes
src/main.cpp - Runtime startup → Inverter MQTT: initializes
src/main.cpp - Runtime startup → Home Assistant discovery: initializes
src/main.cpp - Runtime startup → DTU MQTT: initializes
src/main.cpp - Runtime startup → Total MQTT: initializes
src/main.cpp - Runtime startup → Task scheduler: executes
src/main.cpp - Home Assistant discovery → MQTT connection: publishes through
src/MqttHandleHass.cpp - Home Assistant discovery → Network settings: reads local IP
src/MqttHandleHass.cpp - MQTT connection → MQTT broker: connects to
- Hoymiles protocol → CMT radio: uses radio
- Hoymiles protocol → NRF radio: uses radio
- Hoymiles protocol → Command queue: dispatches commands
- Alarm parser → Hoymiles protocol: parses responses
- Grid profile parser → Hoymiles protocol: parses responses
- Web API → Inverter endpoints: routes to
- Web API → MQTT endpoints: routes to
- Web application → App shell: mounts
webapp/src/main.ts - App shell → Live dashboard: renders route
- App shell → Inverter administration: renders route
- Web application → Web API: requests data