Available Entities - HAEdwin/homeassistant-apsystems_ecu_reader GitHub Wiki
This page documents all the entities available in the APsystems ECU Reader integration for Home Assistant.
Table of Contents
- Sensors
- ECU Sensors
- CT Sensors (ECU-C only)
- Inverter Sensors
- Binary Sensors
- Switches
- Number Entities
- Button Entities
Sensors
ECU Sensors
| Sensor |
Description |
Unit |
Device Class |
State Class |
Notes |
| Current Power |
Total current power produced by all inverters |
W |
power |
measurement |
|
| Today Energy |
Total energy produced today |
kWh |
energy |
total_increasing |
|
| Lifetime Energy |
Total energy produced during device lifetime |
kWh |
energy |
total_increasing |
|
| Lifetime Maximum Power |
Maximum power ever recorded |
W |
power |
measurement |
|
| Inverters |
Total number of configured inverters |
- |
- |
- |
Diagnostic entity |
| Inverters Online |
Number of currently online inverters |
- |
- |
- |
Diagnostic entity |
| Using Cache Counter |
Number of consecutive failed communications with ECU |
- |
- |
- |
Diagnostic entity |
| Firmware Version |
Current firmware version of the ECU |
- |
- |
- |
Diagnostic entity |
CT Sensors (ECU-C only)
| Sensor |
Description |
Unit |
Device Class |
State Class |
Notes |
| Production CT A/B/C |
Power production per phase |
W |
power |
measurement |
|
| Grid CT A/B/C |
Grid power flow per phase |
W |
power |
measurement |
Positive values = import from grid |
| Consumed A/B/C |
Power consumption per phase |
W |
power |
measurement |
|
Inverter Sensors
Each inverter has the following sensors:
| Sensor |
Description |
Unit |
Device Class |
State Class |
Notes |
| Power Ch X |
Power output per inverter channel |
W |
power |
measurement |
Number of channels depends on inverter model |
| Temperature |
Internal inverter temperature |
°C |
temperature |
measurement |
Diagnostic entity |
| Frequency |
Grid frequency |
Hz |
frequency |
measurement |
Diagnostic entity |
| Signal |
Signal strength between inverter and ECU |
dBm |
signal_strength |
measurement |
Diagnostic entity |
| Voltage |
Grid voltage (per phase for 3-phase models) |
V |
voltage |
measurement |
Diagnostic entity |
Binary Sensors
| Sensor |
Description |
Notes |
| Using Cached Data |
Indicates if data is from cache due to failed communication |
Diagnostic entity |
| Inverter X Online |
Status of each inverter (online/offline) |
One per inverter, diagnostic entity |
Switches
| Switch |
Description |
Compatibility |
Notes |
| ECU Query |
Enable/disable data polling from the ECU |
All ECU models |
Diagnostic entity |
| Inverter X On/Off |
Control the power state of each inverter |
ECU-R-Pro & ECU-C models only |
Configuration entity |
| Zero Export |
Enable/disable zero export function |
ECU-C models only |
Configuration entity |
Number Entities
| Entity |
Description |
Range |
Default |
Compatibility |
Notes |
| Inverter X Maxpwr |
Maximum power setting per inverter |
20-500 W |
500 W |
ECU-R-Pro & ECU-C models only |
Configuration entity |
Button Entities
| Button |
Description |
Compatibility |
Notes |
| ECU Reboot |
Reboot the ECU device |
ECU-R-Pro & ECU-C models only |
Diagnostic entity |
Additional Notes
- ECU-R-Pro models have ECU IDs starting with "2162"
- ECU-C models have ECU IDs starting with "215"
- Some features require specific ECU models as indicated in the compatibility column
- Diagnostic entities are categorized as such in Home Assistant and are hidden by default in the UI
- Configuration entities are used to change settings on the ECU or inverters