-
-
Notifications
You must be signed in to change notification settings - Fork 10
Troubleshooting connection issues
HAEdwin edited this page Feb 20, 2026
·
2 revisions
This guide summarizes common troubleshooting tips and solutions for users experiencing connection issues with their APsystems ECU and the Home Assistant integration. These tips are based on real-world issues and solutions discussed in closed issues.
- First of all, follow the connection method if you use this integration.
- Ensure the ECU is powered on and connected to your local network (Ethernet or WiFi).
- Verify the ECU’s IP address is correct and reachable (try pinging it from another device).
- For WiFi: Make sure the signal is strong and the ECU is not too far from the router.
- For Ethernet: Confirm the cable is properly connected and the port is active.
- The integration typically communicates on port 8899. Use a tool like
nc(netcat) to check if this port is open:nc -v <ECU_IP> 8899
- Ensure your firewall or router is not blocking this port.
- Assign a static IP to your ECU in your router’s DHCP settings to prevent IP changes after reboots.
- Try accessing the ECU’s web interface via its IP address in a browser to confirm it is online (for ECU-R 2162 or ECU-C users only)
- If the ECU is visible and updating in the EMA app/portal but not in Home Assistant, the issue is likely with the integrations settings or local network.
- Double-check the IP address and settings entered in the Home Assistant integration.
- Restart the ECU, your router, reload the integration or finally restart Home Assistant to clear temporary network issues.
- Make sure you are not in a reboot loop when using a smart plug or build-in reboot on ECU-R-Pro (2162) or ECU-C models. Wait 10 minutes before querying the ECU again.
- Ensure your ECU firmware and the integration are up to date.
- Some issues are specific to certain Home Assistant or integration versions—try upgrading to the latest version.
- Enable debug logging in Home Assistant for the integration and check for errors in the logs.
- Look for messages like “failed to claim socket after 5 attempts” or “No ECU found at this IP-address.”
- If the ECU only updates at certain times (e.g., at night), check for power-saving settings or network dropouts.
- If you see “No ECU found at this IP-address or ECU is recovering from restart,” wait 10 minutes and try again.
- If the ECU is connected but no data is received, try reloading the integration or rebooting Home Assistant.
If these steps do not resolve your issue, consult the integration’s documentation or open a new issue with detailed logs and your setup information.