CarloGavazzi_EM580

Carlo Gavazzi EM580 powermeter

Handwritten Documentation

Module implementing the Carlo Gavazzi EM580 power meter driver adapter via Modbus RTU (through SerialCommHub). This module also supports models without OCMF/Eichrecht support (e.g. EM300 series).

Description

The module consists of a single main implementation that serves the powermeter interface. Modbus access is done via the required serial_communication_hub interface.

Features

  • Live meter reads and powermeter publishing (interval configurable)

  • Resilient Modbus transport with retries and protocol-compliant write chunking

If supported by meter: - OCMF/Eichrecht transaction start/stop logic - Public key reading and publishing (hex)

Module Configuration

The module configuration parameters are defined in manifest.yaml. A complete example configuration can be found at config/bringup/config-bringup-CGEM580.yaml.

Transaction flow (OCMF)

Start transaction

At transaction start the module:

  1. Ensures OCMF state is NOT_READY

  2. Writes OCMF identification data, EVSE ID and tariff text (TT) (0-terminated, used bytes only)

  3. Writes session modality

  4. Sends the start command ('B')

Stop transaction

At transaction stop the module:

  1. Sends the end command ('E') for the tracked transaction

  2. Waits for OCMF state READY

  3. Reads the OCMF file (size + content)

  4. Confirms the file read by setting state back to NOT_READY

Notes / Limitations

  • Modbus Write Multiple Registers requests are chunked to max 123 registers per request.

  • TT is a CHAR[252] field (126 words); overlong strings are warned and truncated.

Device identification code (register 300012 / 000Bh)

At startup the driver reads the Carlo Gavazzi Controls identification code from Modbus register 300012 (000Bh) to decide whether OCMF transactions are exposed.

The following identification codes are explicitly supported as EM300/ET300 series (live metering only; start_transaction / stop_transaction return NOT_SUPPORTED): 331, 332, 335, 336, 340, 341, 345, 346, 355.

Any other identification code is treated as an OCMF-capable device (e.g. EM580 class): the full transaction flow applies. If a new meter without OCMF uses a code not listed above, the driver should be updated to recognise it; otherwise it may incorrectly attempt the OCMF path.

Auto-Generated Reference

Provides

main: powermeter
Implementation of the driver functionality
config:
powermeter_device_id: integer <optional>
default: 1
The powermeter’s address on the serial bus
communication_retry_count: integer <optional>
default: 3
Number of retries for communication operations before giving up.
communication_retry_delay_ms: integer <optional>
default: 500
Delay in milliseconds between retry attempts.
communication_error_pause_delay_s: integer <optional>
default: 10
Delay in seconds before retrying communication in the live measurement thread after a failure. Default 10 seconds. Applies to initial communication too.
initial_connection_retry_count: integer <optional>
default: 10
Number of retries for initial connection/signature config read during module initialization. 0 means infinite retries.
initial_connection_retry_delay_ms: integer <optional>
default: 2000
Delay in milliseconds between retry attempts during initialization.
timezone_offset_minutes: integer <optional>
default: 0
Timezone offset from UTC in minutes (e.g., 60 for UTC+1, -300 for UTC-5). Range -1440 to +1440 minutes. Default is 0 (UTC).
live_measurement_interval_ms: integer <optional>
default: 1000
Interval in milliseconds between live powermeter reads and publishes. Default 1000 ms (once per second). Allowed range 500-60000 ms (twice per second to once per minute).
device_state_read_interval_ms: integer <optional>
default: 10000
Interval in milliseconds between reading the device state bitfield (used for VendorError reporting). Default 10000 ms (once per 10 seconds). Allowed range 500-60000 ms.
public_key_format: string <optional>
default: “binary”
The key format to use for the public key.
enum:
- binary
- der

Requirements

modbus: serial_communication_hub 1

Metadata

Authors

florin.mihut@pionix.com

License

https://opensource.org/licenses/Apache-2.0