pdw-mb / foxess-ha

Home Assistant & FoxESS integration. Monitor you photovoltaic installation directly from HA ☀️ ⚡️

FoxESS and Home Assistant integration 🏡 ☀

⚙️ Installation & ♻️ Update

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 🥳

⌨️ Manual installation

Copy content of custom_components folder into your HA /config/custom_components folder

💾 Configuration

Edit your home-assistan /configuration.yaml and add:

sensor:
  - platform: foxess
    username: foxesscloud_username
    password: foxesscloud_password
    deviceID: foxesscloud_inverter_id

Auxiliary notes:

• foxesscloud_inverter_id in UUID that can be found on the foxesscloud in the url path on the Inverter Details page. ⚠️ 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 name field in you config, if you want see an example check out here

📊 Provided entities

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 Current	A
PV1 Power	kW
PV1 Volt	V
PV2 Current	A
PV2 Power	kW
PV2 Volt	V
PV3 Current	A
PV3 Power	kW
PV3 Volt	V
PV4 Current	A
PV4 Power	kW
PV4 Volt	V
PV Power	kW
R Current	A
R Freq	Hz
R Power	kW
R Volt	V
S Current	A
S Freq	Hz
S Power	kW
S Volt	V
T Current	A
T Freq	Hz
T Power	kW
T Volt	V
Reactive Power	kVar
Energy Generated	kWh
Grid Consumption	kWh
FeedIn	kWh
Solar	kWh
Load	kWh
Bat Charge	kWh
Bat Discharge	kWh
Bat SoC	%
Bat Temp	°C
Ambient Temp	°C
Boost Temp	°C
Inv Temp	°C

💡 If you want to understand energy generation per string check out this wiki article

🤔 Troubleshooting

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
• {"errno":41808,"result":null} ⟶ token expierd
• {"errno":41809,"result":null} ⟶ invalid token

Increase log level in your /configuration.yaml by adding:

logger:
  default: warning
  logs:
    custom_components.foxess: debug

📚 Usefull wiki articles

• Understand PV string power generation using foxess ha
• Sample sensors for better solar monitoring
• How to fix Energy Dashboard data (statistic data)