How lavron/docker-voltronic-mqtt works
Project type and purpose
• This is a containerized IoT gateway application written in Python.
• It reads data from Voltronic solar inverters over a serial/USB interface, decodes inverter-specific protocols (PI30 and PI41), and publishes sensor readings to an MQTT broker.
• It’s intended to run as a Docker container (or via docker-compose) and integrate directly with Home Assistant (through the provided ha-sensors.yaml).
File structure
• Top-level:
• Dockerfile / docker-compose.yml – packaging and runtime orchestration
• requirements.txt – Python dependencies
• ha-sensors.yaml – Home Assistant configuration snippet
• src/ – Python source code
• src/ breakdown:
• main.py – application entrypoint
• serial_port.py – low-level adapter for /dev/ttyUSB* interface
• voltronic.py – protocol handler (PI30 & PI41 parsing, CRC, frame decode)
• mqtt.py – MQTT client wrapper (connect, publish)
• sensors.json – sensor metadata (IDs, names, units)
• No database or web server—just a pipeline: serial → parsing → MQTT.
README for additional insights
• Environment variables (MQTT_SERVER, MQTT_USER/PASSWORD, SERIAL_PORT) configure connections
• Image is “lavron/voltronic-mqtt:latest” on Docker Hub
• Supports dynamic discovery in Home Assistant via the YAML snippet
Elements
• “SerialPort Adapter”
• “Voltronic Protocol Handler”
• “MQTT Publisher”
• “MQTT Broker”
• “Home Assistant”
• “Solar Inverter”
• Data from inverter to adapter to handler to publisher to broker to HA
Detail & coverage
• Docker Compose linking container to host-device mapping (/dev:/dev)