Energy
FoxESS Control
nicois/foxess-control · vv1.0.21
HACSCloud polling
Allow Home Assistant to modify FoxESS inverter charge/discharge modes
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) |
How it connects
Cloud polling
Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.
Details
| Installs (analytics) | 122 (0.02%) |
|---|---|
| GitHub stars | 21 |
| Latest version | v1.0.21 (2026-09-04) |
| Set up in the UI | Yes |
| Maintainers | @nicois |
| License | MIT |
Limitations from the README
- Minimum SoC behaviour is unintuitive: When the battery reaches the minimum SoC during force discharge or feed-in, the inverter's behaviour may not match expectations. Smart actions work around this by setting fdSoc to an extreme value (100% for charge, 11% for discharge) so the inverter never triggers its own …
- Schedule race condition (cloud mode only): Force charge/discharge actions read the current schedule, modify it, then write it back. If the schedule is changed between the read and write (e.g. via the FoxESS app), those changes will be overwritten. Enable debug logging for foxesscontrol` to see before/after state if …
- FoxESS Cloud API latency (cloud mode only): All commands go through the FoxESS Cloud API, which throttles requests to one every 5 seconds. Actions are not instantaneous. For faster local control, enable entity mode with foxess_modbus.
- FoxESS mode scheduler bugs (cloud mode only): The FoxESS Cloud API has known issues with schedule validation (e.g. rejecting its own saved schedules due to overlap detection on disabled groups). This integration works around known issues, but the API may introduce new ones.
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/nicois/foxess-control
- Source code: https://github.com/nicois/foxess-control
- Issues: https://github.com/nicois/foxess-control/issues
- HACS: https://hacs.xyz
