Skip to content

benbeton/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:

  • Autodetect inverter connection type (i.e. W610 / Direct LAN)
  • Read registers in bulk to improve Home Assistant performance
  • Direct decoding of values (i.e. force charge periods)

Supported models:

  • H1 TCP / USB

Installation

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

Configuration and Options

Select connection type

  • TCP: TCP connection (i.e. W610/LAN)
  • Serial: USB connection

TCP

Serial Inverter Setup

  • Modbus Host: Path to your USB host (default /dev/ttyUSB0)
  • Modbus Slave: Slave ID (default 247)
  • Add another device: Add more than one inverter

TCP

TCP Inverter Setup

  • Modbus Host: IP Adddress of your Modbus (i.e. W610/LAN) host
  • Modbus Port: Port number (default 502)
  • Modbus Slave: Slave ID (default 247)
  • Add another device: Add more than one inverter

TCP

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.

  • Friendly Name: Friendly name of inverter, or blank if not set.
  • Start Address: Start address to write to
  • Values: One or more values to write

Service


About

FoxESS - Modbus

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%