Over 950 active installations and growing!
If this integration has been helpful, please consider leaving a ⭐ star—it really helps support the project. Want to support ongoing improvements? You can also buy me a coffee ☕. Thank you!
APsystems ECU Reader is a custom Home Assistant integration project for communicating with APsystems ECU hubs.
Important
for solar installations only (not the APsystems APstorage systems like the ELS or ELT series)
Tip
For EZ1 microinverters use the integration at: https://www.home-assistant.io/integrations/apsystems/.
The APsystems ECU Reader is an extended and improved version of ksheumaker's "homeassistant-apsystems_ecur" integration.
Key features include:
- Robust data integrity checks
- Enhanced communication control with the ECU
- Individual inverter on/off switching (ECU-R-Pro series starting with 2162 and ECU-C only)
- Improved error handling and query efficiency
- Support for L2 and L3 voltages (three-phase inverters)
- Multiple ECU hub support
- Individual inverter online sensors for automations
- Near zero Export capability (ECU-R-Pro series starting with 2162 and ECU-C only). See Wiki for script.
- Per-panel maximum power limiting (ECU-R-Pro, ECU-C, ECU-3)
- Zigbee signal strength in dBm
Note: For in-dept information about sensors etc. please read the Wiki on this project page. This integration is not compatible with any ECU-C mounted in the APsystems storage solutions.
- Supported ECU models: ECU-B, ECU-R, ECU-C (with YC600, YC1000/QT2, DS3, QS1 series inverters).
- ECU must be connected to your LAN with a fixed IP address.
- Home Assistant must have network access to the ECU.
- HACS must be installed in Home Assistant.
- Home Assistant log should not show repetitive errors that could cause resource exhaustion.
| Connection Required | ECU Model | Automated Restart* |
|---|---|---|
| Wireless | ECU-R (2160 series), ECU-B | No |
| Wireless/Wired | ECU-R (2162 series) | Yes |
| Wireless/Wired | ECU-C | Yes |
ECU-3 owners: See ha-apc-ecu-3
- Install EMA Manager: Download from your app store.
- Access Point Mode: Press and hold the ECU-R button until Wi-Fi starts.
- Connect to ECU-R Wi-Fi: Default password is
88888888. - Launch EMA Manager: Choose "Local" connection.
- Configure Network: Connect ECU-R to the same Wi-Fi as Home Assistant.
Find your ECU on the network (look for "Espressif Inc." or "ESP").
Test with ping or Netcat:
nc -v <ECU_IP> 8899
APS1100160001END
APS11009400012160000xxxxxxxz%10012ECU_R_1.2.22009Etc/GMT-8
Assign a fixed IP address to your ECU.
| Domain | Ports | Protocol |
|---|---|---|
| ecu.apsystemsema.com | 8995, 8996, 8997, 8998, 9227, 9228, 9001-9004 | TCP |
| ecu2.apsema.com | 9220, 9222 | TCP |
| ecu2.apsema.com | 9219, 21 | FTP |
| ecuna.apsema.com | 9220, 9222 | TCP |
| ecuna.apsema.com | 9219, 21 | FTP |
| ecueu.apsema.com | 9220, 9222 | TCP |
| ecueu.apsema.com | 9219, 21 | FTP |
- Download via HACS:
When HACS is installed, you should be able to find this integration by default in the HA Community Store.
- Search for "APsystems ECU Reader".
- Click on the integration and choose [Download]-button in the lower right corner.
- After downloading a message appears reminding you to restart HA - Restart HA.
- After restart go to [Devices & Services] and choose the [+ Add integration]- button on the lower right corner.
- In "Search for a brand name" enter "APsystems ECU Reader" and select the integration.
- Now follow the Configuration Options guide below.
Note:
If you are not able to connect to the ECU, read this manual and prerequisites. For more guidance use the wiki.
- ECU-IP address: Enter your assigned ECU IP.
- Query interval: Recommended: 300 seconds.
- Retries: Number of connection attempts before using cache.
- Cache count before auto reboot: For ECU-R-Pro & ECU-C.
- Update graphs when inverters offline: On/Off.
- SSID and Password: For forced ECU reboot (ECU-R-Pro & ECU-C).
| Type | Entity | ECU-B | ECU-R | ECU-R-Pro | ECU-C |
|---|---|---|---|---|---|
| switch | ecu_{ECU-ID}_zero_export | No | No | No | Yes |
| switch | inverter_{Inverter-ID}_on_off | No | No | Yes | Yes |
| button | ecu_{ECU-ID}_reboot | No | No | Yes | Yes |
| number | inverter_{Inverter-ID}_maxpwr | No | No | Yes | Yes |
| number | ecu_{ECU-ID}_power_limit | No | No | No | Yes |
- If frequent cache usage or crashes occur, check [Settings] > [System] > [Logs] for errors.
- Disable integrations that are causing connection/communication errors.
- Choose the best location for your ECU where it has the best reception for both Zigbee and WiFi.
- Make sure that nothing is blocking the reception of the signals.
- Check if the firmware has been changed.
- The integration cannot connect to the ECU
- Received data is incomplete
- A timeout occurs
- Another error occurs
However, this does not prevent the integration from continuing to function normally. If you really can't figure it out, create an issue and remember that the more time you spend specifying the problem, the faster and more precise the answer can be.
If inverter temperature returns zero when offline, use a template to convert non-numeric values:
template:
- sensor:
- name: "Temperature non numeric 4080xxxxxxxx"
state: "{{ states('sensor.inverter_4080xxxxxxxx_temperature')|float(0) }}"
unit_of_measurement: "°C"
- name: "Temperature non numeric 8060xxxxxxxx"
state: "{{ states('sensor.inverter_8060xxxxxxxx_temperature')|float(0) }}"
unit_of_measurement: "°C"- For in-depth information on available sensors, read the Wiki
- German Guide
- Dutch Guide
Why is my inverter offline during the day?
- Possible Zigbee signal loss or poor reception.
- Overvoltage due to wiring or grid conditions.
Why do ECU values differ from EMA values?
- Sampling frequency and CT location differences.
Why can't the integration find my ECU?
- Network configuration issues or ECU not running long enough.
Developed in collaboration with checking12, ksheumaker, HAEdwin, and the Home Assistant community.
Special thanks to 12christiaan, ViperRNMC, and all sponsors for their support!
