Electrical Energy Channel
Channel Category: electrical_energy
Measures cumulative energy consumption over time in kilowatt-hours (kWh). The consumption property is a running total; use measurement_kind and reset_behavior metadata to determine how to compute deltas for billing or aggregation.
Required Properties
| Property | Data Type | Range/Values | Unit | Permissions |
|---|---|---|---|---|
consumption | Float | 0–∞ | kWh | RO (Read-Only) |
Property Details
consumption
Cumulative total energy consumed since last counter reset, in kWh. Monotonically increasing under normal operation. Use reset_behavior to handle counter resets or rollovers.
Optional Properties
| Property | Data Type | Range/Values | Unit | Permissions |
|---|---|---|---|---|
average_power | Float | 0–100000 | W | RO (Read-Only) |
grid_import | Float | 0–∞ | kWh | RO (Read-Only) |
grid_export | Float | 0–∞ | kWh | RO (Read-Only) |
active | Bool | - | - | RO (Read-Only) |
fault | Uchar | 0–255 | - | RO (Read-Only) |
Property Details
average_power
Average power draw over the last reporting interval, in watts. Computed by the device as energy delta divided by interval duration. Not an instantaneous reading.
grid_import
Cumulative total energy imported from the public grid into the home since last counter reset, in kWh. Monotonically increasing under normal operation. Only present on devices with a main grid meter. Use reset_behavior to handle counter resets or rollovers.
grid_export
Cumulative total energy exported from the home into the public grid since last counter reset, in kWh. Monotonically increasing under normal operation. Represents excess generation (e.g. PV) fed back to the grid. Use reset_behavior to handle counter resets or rollovers.
active
Indicates if the channel/sensor is currently active and functioning
fault
Fault code or diagnostic indicator (0 = no fault)