Skip to content
dschiermPublic

About

solarman

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

solarman (ESPHome external component)

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.

Usage

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.

Protocol notes

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.

About

solarman

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages