Energy

Must Inverter

mukaschultze/ha-must-inverter · vv0.2.5

HACSLocal polling

Must Inverter plugin for HomeAssistant

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.

Entity	Shows up as	Note
`switch`	Switch or outlet
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)
`button`	Button (as a switch)
`select`	Mode picker (as switches)

What people report

Must inverters work over local Modbus; the official WiFi dongle only talks to the cloud so it can't be read locally.

Works2
Partly works1
Requested1

Device	In Home Assistant	What they said	Source
Must PH1100 series inverter	Works Local	Support added with PH1100 EU 5-12KW unit Saved copy This pull request adds support for the PH1100 series. Developed using a PH1100 EU Series (AC:380V 5-12KW) inverter. # Changes - Added support for the PH1100 series - Added the `TIME` platform sensor - Changed device info retrieval to support inverters with missing `InverterMachineType`, `InverterHardwareVersion` or `InverterSoftwareVersion` values # Notes - Auto Detect doesn't work for this model as I haven't found a register containing the model name. Maybe UI should be updated to reflect that? - Most of the input sensors have not been implemented as I don't know the valid ranges for them. … Excerpt saved from GitHub on 2026-10-23.	PR #113 · 2026-02
Must PV1900 series inverter	Works Local	Support added including extra registers Saved copy inverter model selection, added support for PV19 - additional parameters / registers for PV19 - entity names based on model name - includes code of register_monitor tool if you decide to check additional ranges on your device Excerpt saved from GitHub on 2026-10-23.	PR #58 · 2025-01
Must PV18-3224 VPM II inverter	Partly works Local	Grid charger current range capped for older PV1800; fix open Saved copy `GridMaxChargerCurrentSet` is capped at `Range(20, 30, 10)`. That is the AC charge current spec of the older PV1800 VPM series (12V: 10A or 20A, 24V: 20A or 30A, 48V: 60A). PV18-3224 VPM II is rated 60A AC charge on the nameplate and accepts more than 30A: setting 34A from the LCD menu (item 13) writes 340 to register 20125. With the current range the HA number entity reports the value correctly but clamps it back to 30A as soon as the slider is touched. Changed to `data["RatedCurrent"] * 0.1`, the same source `MaxChargerCurrent` already uses, so the cap follows the model. Step 10 -> 1, since … Excerpt saved from GitHub on 2026-10-23.	PR #118 · 2026-09
Must official WiFi USB dongle	Requested Cloud	Dongle talks only to shinemonitor cloud; no open local port found Saved copy HI everyone The wifi dongle of the inverters must only communicate with the cloud service www.shinemonitor.com it is not possible to intercept modbus messages locally. The option for those of us who have this dongle and the inverter far from the home assistant equipment is to read the information that the WiFi dongle sends every 5 minutes to the cloud service Here is an option that works well, changing some parameters, it would be very good to add the "online" option I am not very good at programming but I have found how to make it work so that it extracts the data from the web page To do … Excerpt saved from GitHub on 2026-10-23.	Issue #20 · 2024-03

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 polling

Talks to the device on your network, asking it for updates every so often.

Details

Installs (analytics)	129 (0.02%)
GitHub stars	69
Latest version	v0.2.5 (2026-04-11)
Set up in the UI	Yes
Maintainers	@mukaschultze
License	MIT

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.

Fork	Stars	Last push	Description
fkrutko/ha-must-inverter Newer code	★ 0	2026-08-17	Must Inverter plugin for HomeAssistant with beta support for Hiden Control ep3300
grengojbo/ha-must-inverter Newer code	★ 0	2026-09-20	Must Inverter plugin for HomeAssistant
jmason-git/ha-must-inverter Newer code	★ 0	2026-10-01	Must Inverter plugin for HomeAssistant

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.

Sources

Documentation: https://github.com/mukaschultze/ha-must-inverter
Source code: https://github.com/mukaschultze/ha-must-inverter
Issues: https://github.com/mukaschultze/ha-must-inverter/issues
HACS: https://hacs.xyz