-
-
Notifications
You must be signed in to change notification settings - Fork 6
Available Entities
HAEdwin edited this page Oct 2, 2025
·
1 revision
This page documents all the entities available in the APsystems ECU Reader integration for Home Assistant.
- Sensors
- ECU Sensors
- CT Sensors (ECU-C only)
- Inverter Sensors
- Binary Sensors
- Switches
- Number Entities
- Button Entities
| 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 |
| 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 |
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 |
| 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 |
| 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 |
| 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 | Description | Compatibility | Notes |
|---|---|---|---|
| ECU Reboot | Reboot the ECU device | ECU-R-Pro & ECU-C models only | Diagnostic entity |
- 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