FoxESS and Home Assistant integration 🏡 ☀
Use hacs.io to manage the installation and update process. Right now this integration is part of HACS by default - no more neeed to add it by custom repositories 🥳
Copy content of custom_components folder into your HA /config/custom_components folder
Edit your home-assistan /configuration.yaml and add:
sensor:
- platform: foxess
username: foxesscloud_username
password: foxesscloud_password
deviceID: foxesscloud_inverter_idfoxesscloud_inverter_idin UUID that can be found on the foxesscloud in the url path on theInverter Detailspage.⚠️ Please make sure that this is exact value from inverter details page address between = and & character:
- Multi-inverter support - if you have more than one FoxESS device in your installation, you can leverage the optional
namefield in you config, if you want see an example check out here
| HA Entity | Measurement |
|---|---|
| Inverter | on/off |
| Generation Power | kW |
| Grid Consumption Power | kW |
| FeedIn Power | kW |
| Bat Discharge Power | kW |
| Bat Charge Power | kW |
| Solar Power | kW |
| Load Power | kW |
| PV1 Power | kW |
| PV2 Power | kW |
| PV3 Power | kW |
| PV4 Power | kW |
| Energy Generated | kWh |
| Grid Consumption | kWh |
| FeedIn | kWh |
| Solar | kWh |
| Load | kWh |
| Bat Charge | kWh |
| Bat Discharge | kWh |
| Bat SoC | % |
| Bat Temp | °C |
💡 If you want to understand energy generation per string check out this wiki article
API Error summary:
{"errno":41930,"result":null}⟶ incorrect inverter id{"errno":40261,"result":null}⟶ incorrect inverter id{"errno":41807,"result":null}⟶ wrong user name or password
Increase log level in your /configuration.yaml by adding:
logger:
default: warning
logs:
custom_components.foxess: debug