Sigenergy SigenStor / Sigen Hybrid (hybrid ESS)

Status: Vendor Confirmed · Register points: 144 · Transports: Modbus TCP, Modbus RTU

A curated ModDef profile for the Sigenergy SigenStor / Sigen Hybrid (hybrid ESS). Import it as sigenergy.sigenstor or load the .moddef.yaml directly.

Connect to one over Web Serial and watch its values live in the device dashboard.

Usage

Load the profile, bind a transport, and read a point by name. The runtime applies the offset, scaling, byte order, and sentinels from the definition.

Go

doc, _ := moddef.Load("sigenergy-sigenstor.moddef.yaml")
dev, _ := client.New(doc, "sigenergy-sigenstor", transport) // your modbus.Transport
v, _ := dev.ReadPoint(ctx, "grid_active_power")
fmt.Println(v)

TypeScript

import {Device} from '@moddef/core';
import {loadDocument} from '@moddef/core/node';

const doc = await loadDocument('sigenergy-sigenstor.moddef.yaml');
const dev = Device.create(doc, 'sigenergy-sigenstor', transport);
console.log(await dev.readPoint('grid_active_power'));

Rust

let doc = moddef_core::load("sigenergy-sigenstor.moddef.yaml")?;
let mut dev = Device::new(&doc, Some("sigenergy-sigenstor"), transport)?;
let v = dev.read_point("grid_active_power").await?;

Python

from moddef import Device, load
from moddef.pymodbus import Options, PymodbusTransport

doc = load("sigenergy-sigenstor.moddef.yaml")
transport = await PymodbusTransport.tcp("192.168.1.50", options=Options())
dev = Device.create(doc, "sigenergy-sigenstor", transport)
print(await dev.read_point("grid_active_power"))

C

md_doc_t doc;
md_doc_init(&doc, flash_ptr, flash_len);        /* zero-copy view */

md_dev_t dev;
md_dev_init(&dev, &doc, MD_STR("sigenergy-sigenstor"), &transport);

md_value_t v;
md_dev_read(&dev, MD_STR("grid_active_power"), &v);

C++

auto doc = moddef::Document::view(flash_bytes).value();   // zero-copy over flash
auto dev = moddef::Device::open(doc, "sigenergy-sigenstor", transport).value();

if (auto v = dev->read("grid_active_power"); v)
    std::cout << v->to_string() << '\n';

Measurands

The 20 semantic quantities this device reports, each linked to the measurand catalog. Query a device by measurand instead of a raw point when you want portable code.

Base quantity	Name	Unit	Description
active_power	Active Power	W	Instantaneous real power
reactive_power	Reactive Power	var	Instantaneous reactive power
pv_power	PV Power	W	PV array / string power
pv_voltage	PV Voltage	V	PV array / string voltage
pv_current	PV Current	A	PV array / string current
battery_power	Battery Power	W	Battery power (sign per direction)
battery_voltage	Battery Voltage	V	Battery terminal voltage
voltage	Voltage	V	RMS voltage; qualify with phase_ref (L1_N, L1_L2, ...)
current	Current	A	RMS current; qualify with phase_ref / direction
frequency	Frequency	Hz	Grid frequency
state_of_charge	State of Charge	%	Battery charge level
state_of_health	State of Health	%	Battery health
charge_limit	Charge Limit	W	Maximum allowed charge power
discharge_limit	Discharge Limit	W	Maximum allowed discharge power
energy_active	Active Energy	Wh	Cumulative active energy register
power_factor	Power Factor	1 (ratio)	Ratio of real to apparent power (dimensionless)
temperature	Temperature	degC	Temperature; qualify with location (INTERNAL, EXTERNAL, ...)
inverter_temperature	Inverter Temperature	degC	Inverter internal temperature
device_status	Device Status	undefined	Overall device operating status (enum)
alarm_status	Alarm Status	undefined	Alarm state (enum or flag set)

Source

• Profile: battery-storage/sigenergy-sigenstor/sigenergy-sigenstor.moddef.yaml
• Register map: vendor documentation