Skip to content
Home Assistant TestFlight
Energy

FoxESS - Modbus

nathanmarlor/foxess_modbus · vv1.15.0

HACSLocal push

FoxESS inverter integration. Connect directly to your FoxESS inverter (no cloud!) for real-time status and control.

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

EntityShows up asNote
binary_sensorSensor (motion, contact, leak, smoke…)
sensorSensor (temperature, humidity, air quality…)
selectMode picker (as switches)

What people report

Local Modbus control of FoxESS H1, H3, KH and rebrands. Firmware updates repeatedly change model strings or registers, and new rebrands are added via PRs.

  • Works4
  • Partly works1
  • Not working2
  • Requested4
  • Won’t be supported1
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
1Komma5 1K5-1P-HI-5Works LocalReported unsupported, then solved per linked discussion
Saved copy
EDIT: Solved in: https://github.com/nathanmarlor/foxess_modbus/discussions/1003 Hi all Recently installed Home Assistant and run a 1Komma5 branded FoxESS Error connecting to your inverter. Details: Inverter model not supported: '1K5-1P-HI-5' Is this model completely not supported or is there a way around it? Thank you

Excerpt saved from GitHub on 2026-10-23.

Discussion #1032 · 2026-02
Ebyte NA111 RS485 adapterWorks LocalAdded as supported network adapter
Saved copy
Adds the Ebyte NA111 family of RS485-to-Ethernet serial servers to the network adapter dropdown in the config flow. The NA111, NA111-A, NA111-E and NA111-M share the same firmware and protocol stack, they differ only in power input (DC 8–28 V, AC 85–265 V, or PoE) and mounting form factor. All four support Modbus TCP and UDP out of the box, so a single entry covers the whole series. Configured with `max_read=100`, matching other capable RS485-to-Ethernet adapters (Elfin EW11, Waveshare RS485-to-ETH, USR-TCP232-410s). Tested on a FoxESS KH10 with the NA111-E over Modbus TCP. Pre-commit hooks …

Excerpt saved from GitHub on 2026-10-23.

PR #1132 · 2026-05
FoxESS H3 ProWorks LocalSplit from H3 for newer firmware; export power limit PR open
Saved copy
Summary Add H3 Pro support for the Export Power Limit entity ## Testing Verified on FoxESS H3 Pro 20.0: - Master Firmware: 1.74 - Slave Firmware: 1.06 - Manager Firmware: 1.44 - Software Version: 2.07

Excerpt saved from GitHub on 2026-10-23.

PR #1238 · 2026-08
FoxESS H3-12.0-E (firmware 2.23)Works LocalModel detection fixed for -E suffix
Saved copy
Firmware 2.23 for H3 inverters started reporting model strings like "H3-12.0-E". The existing regex ^H3-([\d\.]+) does not match this format, causing model detection to fail and the integration to fall back to the serial number string. This patch extends the regex to accept the optional "-E" suffix: ^H3-([\d\.]+)(?:-E)? This change is backward‑compatible and does not affect older firmware versions.

Excerpt saved from GitHub on 2026-10-23.

PR #1116 · 2026-04
FoxESS H1 Gen2Partly works LocalNewer firmware ignores local force charge/discharge writes; cloud API workaround
Saved copy
FoxESS H1 Gen2, Force Charge/Discharge via Cloud API in Home Assistant If your FoxESS H1 Gen2 inverter firmware update has broken force charge/discharge over local Modbus, this guide replaces those dead writes with the official FoxESS Cloud API, the same path the FoxESS app uses. Works reliably regardless of firmware version. Tested on: FoxESS H1 Gen2 · Home Assistant OS · TonyM1958/HA-FoxESS-Modbus v1.6.6 No extra dependencies, pure Python stdlib, no pip installs required. Why this is needed FoxESS changed the Modbus register layout in newer H1 Gen2 firmware. The time-period based force …

Excerpt saved from GitHub on 2026-10-23.

Issue #1128 · 2026-05
FoxESS H3-12.0-SMART (LAN)Not working LocalRegister read timeout at 31000 after manager 1.28 firmware
Saved copy
Is there an existing issue for this? - [x] I have searched the existing issues ### FoxESS - Modbus version 1.16.2-beta ### Inverter model H3-12.0-SMART ### Inverter manager version 1.28 ### Describe the bug Environment: - Home Assistant: latest stable - foxess_modbus: 1.16.2-beta - Connection: Direct LAN Connection - Inverter: FoxESS H3-12.0-SMART - LAN - Battery: FoxESS EP12 - Modbus TCP: Enabled - Port: 502 - Slave ID: 247 Firmware: - Master: 1.46 - Slave: 1.00 - Manager: 1.28 - AFCI: 0.35 Problem: The integration successfully detects the inverter and creates all entities. The Modbus TCP …

Excerpt saved from GitHub on 2026-10-23.

Issue #1201 · 2026-07
FoxESS KH8Not working LocalForce discharge fails after manager 1.58; firmware cause, not integration
Saved copy
Is there an existing issue for this? - [x] I have searched the existing issues ### FoxESS - Modbus version 1.13.6 ### Inverter model KH8 ### Inverter manager version 1.58 (master 1.60) ### Describe the bug Force discharge stopped working on my KH8 after an automatic firmware update to master 1.60 / manager 1.58. Setting work mode to "Force Discharge" via the integration leaves invbatpower drifting around 10–400W; force discharge power is set to 6500W, battery SoC 98%. I probed the inverter directly with raw modbus to see where it breaks down. The integration is writing the right things: - …

Excerpt saved from GitHub on 2026-10-23.

Issue #1113 · 2026-04
a-Tronix AX PlusRequested LocalH3 Smart rebrand; PR open
Saved copy
Besides the AX models from a-Tronix there are the AX Plus models which are H3 Smart rebrands. I added the support for my AX Plus locally, but I think it is a good idea to integrate it in every version. What this adds Native support for the a-Tronix AX Plus hybridinverter, which is identical to the FoxESS H3 Smart. Until now it had to be added by hand-editing the integration files, which gets overwritten on every HACS update. Details a-tronix reports a model string of AX Plus kW-3ph (e.g. AX Plus 10kW-3ph) This PR: - adds ATRONIX_AX_PLUS = "ATRONIX_AX_PLUS" to the InverterModel enum, and - …

Excerpt saved from GitHub on 2026-10-23.

PR #1182 · 2026-06
FoxESS P3-ProRequested LocalOEM variant of H3-Pro; PR closed
Saved copy
Summary The FoxESS P3-Pro is an OEM/installer-channel variant of the H3-Pro. The naming reflects the sales channel only (H = Home, P = Pro/installer), hardware, Modbus registers, firmware versions, and connection type are identical. This change broadens the `H3_PRO` regex from `^H3-Pro-` to `^[HP]3-Pro-` so both `H3-Pro-*` and `P3-Pro-*` model strings are matched by a single profile entry. This keeps the `INVERTER_PROFILES` dict length assertion intact (no duplicate model keys). ## Changes - `inverter_profiles.py`: regex `^H3-Pro-([\d\.]+)` → `^[HP]3-Pro-([\d\.]+)` ## Test Tested on a …

Excerpt saved from GitHub on 2026-10-23.

PR #1160 · 2026-06
Solarwatt VisionRequested LocalRebadged H3 Smart; PR open
Saved copy
What this adds Native support for the Solarwatt Vision inverter, which is electrically identical to the FoxESS H3 Smart. Until now it had to be added by hand-editing the integration files (see discussion #956), which gets overwritten on every HACS update. ## Details The Solarwatt Vision reports a model string of `VSN THREE KW` (e.g. `VSN THREE 12KW`). This PR: - adds `SOLARWATT_VISION = "VSN"` to the `InverterModel` enum, and - adds an `InverterModelProfile` that maps `^VSN THREE ([\d\.]+)KW$` to the existing H3 Smart register set via AUX / holding registers (mirroring the built-in H3 Smart …

Excerpt saved from GitHub on 2026-10-23.

PR #1178 · 2026-06
WEG SIW200H US (FoxESS H1-US)Requested LocalRead-only support PR open
Saved copy
Add read-only support for WEG SIW200H US (FoxESS H1-US, split-phase) ### Background The WEG SIW200H "S" series (e.g. SIW200H S114 W20, 11.4 kW, split-phase 2L+N 120/240 V, sold in Brazil) is an OEM FoxESS H1-US: - INMETRO registration 015970/2024 lists Foxess Co., Ltd as the manufacturer - the SunSpec common block reports manufacturer `FOX` - FoxESS Cloud reports `productType: "US"` Today autodetect fails with `Inverter model not supported: ''`, because these units leave holding registers 30000+ unpopulated (all `0xFFFF`). The model is available elsewhere: in the SunSpec common block (`SunS` …

Excerpt saved from GitHub on 2026-10-23.

PR #1284 · 2026-10
FoxESS EP11 batteryWon’t be supported LocalRejects 0% min SoC / 100% DOD in app and Modbus
Saved copy
I agree that this must be clarified. I have 4x EP11 batteries with latest firmware 1.012 and they do not support 100% DOD. Two batteries are older and two batteries are from the newer revision. I also found two identical EP11 datasheets: EN-EP11-Datasheet-V1.1-12.05 (1).pdf EN-EP11-Datasheet-AU-V1.1-20250915.pdf first datasheet has 90% DOD, but second has 100% DOD. Anyway: 1. Inverter ( I have Foxess H3 12.0E ) doesn't allow to set DOD to 100% via screen. 2. It is not possible to set 100% DOD via Foxess

Excerpt saved from GitHub on 2026-10-23.

Issue #926 · 2025-10

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Details

Installs (analytics)1,329 (0.19%)
GitHub stars340
Latest versionv1.15.0 (2026-09-21)
Set up in the UIYes
Maintainers@nathanmarlor
LicenseMIT

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

ForkStarsLast pushDescription
AdamNewberry/foxess_modbus_EVO★ 72026-03-22FoxESS inverter integration with Fox EVO support. Connect directly to your FoxESS inverter (no cloud!) for real-time status and control.

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.