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.

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("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