| title |
description |
ha_iot_class |
ha_config_flow |
ha_release |
ha_category |
ha_domain |
ha_platforms |
ha_integration_type |
ha_codeowners |
| APsystems |
Control and monitor your APsystems EZ1 microinverters locally without the cloud |
Local Polling |
true |
2024.6 |
|
apsystems |
| binary_sensor |
| number |
| sensor |
| switch |
|
device |
| @mawoka-myblock |
| @SonnenladenGmbH |
|
The APsystems {% term integration %} allows you to read the data from your APsystems EZ1 microinverter. It also allows you to set the output limit to anything above 30 watts.
Sensors
Numerical sensors
| Sensor ID |
Unit |
Description |
| total_power |
W |
Total current output of the inverter |
| lifetime_production_p1 |
kWh |
Lifetime production of first input |
| lifetime_production_p2 |
kWh |
Lifetime production of second input |
| lifetime_production |
kWh |
Lifetime production of both inputs combined |
| total_power_p1 |
W |
Current input on first input |
| total_power_p2 |
W |
Current input on second input |
| today_production |
kWh |
Today's production of both inputs combined |
| today_production_p1 |
kWh |
Today's production of first input |
| today_production_p2 |
kWh |
Today's production of second input |
Binary sensors
| Sensor ID |
Description |
| off_grid_status |
On when the inverter is not connected to the power grid |
| dc_1_short_circuit_error_status |
Short circuit detected on first input |
| dc_2_short_circuit_error_status |
Short circuit detected on second input |
| output_fault_status |
Output because of any error deactivated |
Settings
| Setting ID |
Type |
Description |
| inverter_status |
switch |
Enables or disables the inverter's output |
| output_limit |
number |
Sets the max output of the inverter |
Flash Endurance
There has been a discussion about the inverter's lifetime being shortened when using the output_limit setting excessively. APsystems officially confirmed this to me while also acknowledging that newer hardware versions don't have this issue, while older ones should be updated at most every 300 seconds. Newer inverters have a serial number starting with Ex701 and thus aren't at risk of flash wear when setting the output_limit more frequently than every 300 seconds.
Prerequisites
Make sure the local API is activated and set to Continuously. For that, connect to the inverter via Bluetooth using the app and go to Settings > Local Mode, set the switch Enable Local Mode to on and make sure to set this to Continuously.
{% include integrations/config_flow.md %}