williamjeccles/ha-foxess-modbus

Home Assistant Modbus Integration setup for Fox ESS H1 Inverter

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

---

Connecting to your inverter can be acheived in two ways:

• Using the inverters LAN port connected to your router/switch (no additional hardware required)

• Connecting to the COM port using a RS485 to USB adapter or WIFI/LAN RS485 converter

⚠️ Additional hardware requires basic electronics competencies to connect the two additional wires for the RS485 interface to the inverters com connector.⚠️

---

Supported Hardware

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
AIO Series
✅ AIO-H1-3.0
✅ AIO-H1-3.7
✅ AIO-H1-4.6
✅ AIO-H1-5.0
✅ AIO-H1-6.0

---

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.

HACS Specific Installation

• Add this repository to your HACS custom integrations
• Install from HACS

Manual Specific installation

• Hardware configuration instructions can be found on the wiki
• Copy the Required modbus file (USB or LAN) file to /config/custom_components/HA-FoxESS-Modbus/modbusLAN.yaml

Then, Common Installation Steps

• Create a full backup of your HA instance including the configuration.yaml file
• Copy the Required modbus line (USB or LAN) and following contents of the configuration.yaml file to your config file
• For LAN, create your Secrets file entry
• 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

Engergy Dashboard Configuration

Energy Dashboard Values

⚠️Some values won't appear or will show an error until a small amount of data has passed through that value. You may need to wait 24hrs before you can setup the energy dashboard.

Electricity Grid

• grid_daily
• feedin_daily

Solar Panels

• pv1_daily
• pv2_daily

Home Batteries

• bat_charge_daily
• bat_discharge_daily

Provided Entities

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!

---

If you find this useful and are thinking of joining Octopus Energy, use my referral code! We both get £50 credit on our bills! https://share.octopus.energy/showy-pup-300