Carlo Gavazzi EM340 (three-phase, direct connection)

Status: Vendor Confirmed · Register points: 53 · Transports: Modbus RTU

A curated ModDef profile for the Carlo Gavazzi EM340 (three-phase, direct connection). Import it as carlogavazzi.em340 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("carlo-gavazzi-em340.moddef.yaml")
dev, _ := client.New(doc, "carlo-gavazzi-em340", transport) // your modbus.Transport
v, _ := dev.ReadPoint(ctx, "voltage_l1_n")
fmt.Println(v)

TypeScript

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

const doc = await loadDocument('carlo-gavazzi-em340.moddef.yaml');
const dev = Device.create(doc, 'carlo-gavazzi-em340', transport);
console.log(await dev.readPoint('voltage_l1_n'));

Rust

let doc = moddef_core::load("carlo-gavazzi-em340.moddef.yaml")?;
let mut dev = Device::new(&doc, Some("carlo-gavazzi-em340"), transport)?;
let v = dev.read_point("voltage_l1_n").await?;

Python

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

doc = load("carlo-gavazzi-em340.moddef.yaml")
transport = await PymodbusTransport.tcp("192.168.1.50", options=Options())
dev = Device.create(doc, "carlo-gavazzi-em340", transport)
print(await dev.read_point("voltage_l1_n"))

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("carlo-gavazzi-em340"), &transport);

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

C++

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

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

Measurands

The 9 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
voltage	Voltage	V	RMS voltage; qualify with phase_ref (L1_N, L1_L2, ...)
current	Current	A	RMS current; qualify with phase_ref / direction
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_reactive	Reactive Energy	varh	Cumulative reactive energy register

Source

• Profile: energy-meter/carlo-gavazzi-em340/carlo-gavazzi-em340.moddef.yaml
• Register map: vendor documentation