Skip to content

iancg/foxess_modbus

 
 

Repository files navigation

FoxESS - Modbus

GitHub Release GitHub Activity License

pre-commit Black

hacs Project Maintenance BuyMeCoffee

Discord Community Forum

** This project is not endorsed by, directly affiliated with, maintained, authorized, or sponsored by FoxESS **

Introduction

A Home Assistant custom component designed to ease integrating modbus data from Fox H1 inverters.

Features include:

  • Read registers in bulk to improve Home Assistant performance
  • Direct decoding of values (i.e. force charge periods)
  • Set charge periods, work mode, min/max SoC (when connected over RS485 only)

Supported models:

  • H1 (including AC1 and AIO)
  • H3

See the wiki for how-to articles and FAQs

Installation

Migrating from StealthChesnut's HA-FoxESS-Modbus? Read this.

Recommend installation through HACS

  1. Navigate to HACS integrations
  2. Hit the menu button (top right) and select 'Custom repositories'
  3. Paste this GitHub link and select 'Integration'
  4. Install as usual through HACS
    • 'Explore & Download Repositories'
    • Search for 'FoxESS - Modbus'
    • Download
  5. Restart Home Assistant
  6. Go to Settings > Devices and Services > Add Integration
  7. Search for and select 'FoxESS - Modbus' (If the integration is not found, empty your browser cache and reload the page)
  8. Proceed with the configuration

Usage

Modbus Service

  1. Navigate to Settings -> Devices & Services to find...

Usage

  1. Select '1 service' to find all Modbus readings...

Example

Write Service

A service to write any modbus address is available, similar to the native Home Assistant service.

Service

Update Charge Periods

Updates one of the two charge periods (if supported by your inverter).

Service

Update All Charge Periods

Sets all charge periods in one service call. The service "Update Charge Period" is easier for end-users to use.

Service


About

FoxESS - Modbus

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%