Fronius Symo / Primo GEN24 Plus

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

A curated ModDef profile for the Fronius Symo / Primo GEN24 Plus. Import it as fronius.gen24 or load the .moddef.yaml directly.

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("fronius-gen24.moddef.yaml")
dev, _ := client.New(doc, "fronius-gen24", transport) // your modbus.Transport
v, _ := dev.ReadPoint(ctx, "ac_current_total")
fmt.Println(v)

TypeScript

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

const doc = await loadDocument('fronius-gen24.moddef.yaml');
const dev = Device.create(doc, 'fronius-gen24', transport);
console.log(await dev.readPoint('ac_current_total'));

Rust

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

Python

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

doc = load("fronius-gen24.moddef.yaml")
transport = await PymodbusTransport.tcp("192.168.1.50", options=Options())
dev = Device.create(doc, "fronius-gen24", transport)
print(await dev.read_point("ac_current_total"))

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("fronius-gen24"), &transport);

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

C++

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

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

Measurands

The 22 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
current	Current	A	RMS current; qualify with phase_ref / direction
voltage	Voltage	V	RMS voltage; qualify with phase_ref (L1_N, L1_L2, ...)
active_power	Active Power	W	Instantaneous real power
apparent_power	Apparent Power	VA	Instantaneous apparent power
reactive_power	Reactive Power	var	Instantaneous reactive power
power_factor	Power Factor	1 (ratio)	Ratio of real to apparent power (dimensionless)
frequency	Frequency	Hz	Grid frequency
energy_active	Active Energy	Wh	Cumulative active energy register
energy_apparent	Apparent Energy	VAh	Cumulative apparent energy register
energy_reactive	Reactive Energy	varh	Cumulative reactive energy register
pv_current	PV Current	A	PV array / string current
pv_voltage	PV Voltage	V	PV array / string voltage
pv_power	PV Power	W	PV array / string power
battery_voltage	Battery Voltage	V	Battery terminal voltage
state_of_charge	State of Charge	%	Battery charge level
charge_limit	Charge Limit	W	Maximum allowed charge power
discharge_limit	Discharge Limit	W	Maximum allowed discharge power
inverter_temperature	Inverter Temperature	degC	Inverter internal temperature
temperature	Temperature	degC	Temperature; qualify with location (INTERNAL, EXTERNAL, ...)
inverter_status	Inverter Status	undefined	Inverter operating state (enum)
device_status	Device Status	undefined	Overall device operating status (enum)
alarm_status	Alarm Status	undefined	Alarm state (enum or flag set)

Source

• Profile: solar-inverter/fronius-gen24/fronius-gen24.moddef.yaml
• Register map: vendor documentation