Connects an ESP32 directly to a Solarman/IGEN WiFi data logger dongle over
the local network (TCP port 8899) and reads Modbus registers from the
inverter using the proprietary "Solarman V5" frame format. No Solarman
Cloud, and no Home Assistant required — the dongle's IP address and serial
number can be set at runtime from the ESP's own web_server UI.
external_components:
- source: github://dschierm/solarman@main
components: [solarman]
web_server:
version: 3
solarman:
id: my_logger
port: 8899
modbus_address: 1
update_interval: 15s
text:
- platform: solarman
solarman_id: my_logger
type: ip_address
name: "Logger IP Address"
- platform: solarman
solarman_id: my_logger
type: serial_number
name: "Logger Serial Number"
sensor:
- platform: solarman
solarman_id: my_logger
name: "Battery SOC"
register: 588
function_code: 3
unit_of_measurement: "%"See example.yaml for a fuller example. Works with both framework: type: arduino
and framework: type: esp-idf (uses ESPHome's portable socket API, not
framework-specific networking).
Set the logger's IP and serial number from http://<device-ip>/ after first
boot — no recompile needed, values persist to flash.
Frame format reverse-engineered / documented at https://pysolarmanv5.readthedocs.io/en/stable/solarmanv5_protocol.html. Modbus register maps vary by inverter model/firmware — verify against your own inverter before trusting the example registers.