info.md

💽 Version

{% if version_installed == version_available %} 👍 You already have the latest released version installed. {% endif %}

{% if installed and version_installed != selected_tag %} 🤓 Changes from version {{ version_installed }} {% endif %}

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:
• if you have more than one FoxESS device in your installation you can leverage optional name field in you config, if you want se some 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

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

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