Skip to content

Releases: remcom/sunspec-esphome

v0.0.1

07 Apr 18:13
e252587

Choose a tag to compare

v0.0.1 — Initial Release

First public release of sunspec-esphome, an ESPHome external component that exposes SunSpec Modbus TCP on an ESP32, enabling energy managers (Victron, SolarEdge, Fronius, etc.) to read live solar inverter data.

Features

  • SunSpec Modbus TCP server on port 502 with the following models:
    • Model 1 — Common block (manufacturer, model, serial, version)
    • Model 101 — Single-phase inverter (power, voltage, current, frequency, temperature, energy, state)
    • Model 120 — Nameplate (rated power)
    • Model 123 — Controls (WMaxLimPct power limiting)
  • Sensor bridging — reads live data from existing ESPHome sensors and maps them to SunSpec registers
  • Power limit write-back — accepts WMaxLimPct commands from energy managers and relays to inverter via:
    • Number entity (recommended)
    • Direct Modbus register write (legacy)
  • Optional AC current sensor — derives current from power/voltage when no current sensor is available
  • FC03 (read holding registers), FC06 (write single register), FC16 (write multiple registers) support

Requirements

  • ESP32 with ESP-IDF or Arduino framework (POSIX socket APIs required)
  • ESPHome 2026.1+

Configuration

See README for full YAML examples.