README.md

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 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

🤔 Troubleshooting

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)