FoxESS and Home Assistant integration via Modbus RS485
A community maintained Home Assistant integration using local native polling of Modbus data using RS485 to enable near realtime data access, with no reliance on the FoxESS cloud portal
Hybrid Series
✅ H1-3.0-E
✅ H1-3.7-E
✅ H1-4.6-E
✅ H1-5.0-E
✅ H1-6.0-E
AC Series
✅ AC-3.0-E
✅ AC-3.7-E
✅ AC-4.6-E
✅ AC-5.0-E
✅ AC-6.0-E
We strongly suspect that this plugin will also work with the FoxESS AIO series and 3PH series but have not yet tested. Please let us know if you have an AIO or 3PH system and if the plugin works.
The aim of this project is to enable the full use of the Energy dashboard in Home Assistant and is a fully functional replacement of the FoxESS App for reporting needs.
- Hardware configuration instructions can be found on the wiki
- Create a full backup of your HA instance including the configuration.yaml file
- Copy the contents of the configuration.yaml file to your config file
- Create a new file called modbus.yaml and place alongside your configuration.yaml file
- Check your config is valid, then Restart HA
- Map energy dashboard as per below example and enjoy configuring dashboards using near realtime data.
Step by step walkthrough of the setup
Electricity Grid
- grid_daily
- feedin_daily
Solar Panels
- pv1_daily
- pv2_daily
Home Batteries
- bat_charge_daily
- bat_discharge_daily
Registers
The wiki has references for the registers.
Please read and understand before using this plugin:
This plugin has been developed as a personal project, with no connection to the official brand of FoxESS, use of this plugin is intended for use by the community without fee but has no warrenty or liability should any damage, harm or undesired results happen as a result of using this plugin. We strongly recommend that only competently trained individuals attempt to wire the additional connections required for this plugin to function. There is a risk of personal or device damage/harm. You have been warned!