Huawei Solar for Home Assistant (Marketplace integration)

Installs: 6.5k sharing analytics
GitHub stars: 939
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 2.1.5, October 10, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Brand: Huawei
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: huawei_solar
Source: github.com/wlcrs/huawei_solar
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Huawei Solar is an integration that reads and controls Huawei Solar inverters over Modbus, working locally. It connects either through a serial link to the inverter's RS485 pins or over the network, and setup runs in the UI. It adds sensors for energy, yield, line voltages, phase currents, active power and frequency, plus switches, numbers and selects for inverter and battery settings. Optional elevated permissions give access to optimizer data and let settings be changed from Home Assistant. Actions cover forcible battery charge and discharge by time or to a state of charge level, and limiting power fed to the grid by wattage or percentage. Time of use and fixed charge periods can also be set, and the inverter is polled every 30 seconds by default.

Automatic summary of the README and code of wlcrs/huawei_solar. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Select connection type

Connection type

Network login

Password
Username

Setup network

Advanced: elevate permissions
Host
Port
Slave IDs: AUTO for auto-discovery, otherwise a comma separated list

Device

Select device
Baud rateDefault is 9600
Slave IDs: AUTO for auto-discovery, otherwise a comma separated list

Texts from the code of wlcrs/huawei_solar.

Entities

ButtonsStop forcible charge
NumbersPower derating, Power derating (by percentage), Maximum feed grid power (%), Maximum feed grid power, Maximum power for charging batteries from grid, TOU periods, MPPT-Scan Interval, Backup power SOC, Peak Shaving SOC, End-of-charge SOC, End-of-discharge SOC, Grid charge cutoff SOC, and 3 more
SelectsESS Control Mode, Excess PV energy use in TOU, Capacity Control Mode, Working Mode
SensorsTotal energy, Total yield, A-B line voltage, Phase A current, Phase A active power, B-C line voltage, Phase B current, Phase B active power, C-A line voltage, Phase C current, Phase C active power, Frequency, and 216 more
SwitchesMPPT-Scan, Inverter ON/OFF, Charge from grid

Actions

Forcible ChargeForcible Charge of the battery for a certain timeFields: Battery, Duration, Power
Forcible Charge to a SoC levelForcible Charge of the battery to a certain State of Charge levelFields: Battery, Power, Target SoC
Forcible DischargeForcible Discharge of the battery for a certain timeFields: Battery, Duration, Power
Forcible Discharge to a SoC levelForcible Discharge of the battery to a certain State of Charge levelFields: Battery, Power, Target SoC
Set Active Power Control to Maximum Feed Grid PowerSet Active Power Control to the default Unlimited modeFields: Device
Set Capacity Control PeriodsSet Capacity Control PeriodsFields: Battery, Periods
Set Active Power Control to 'DI active scheduling'Set Active Power Control to 'DI active scheduling'Fields: Inverter
Set Fixed Charge PeriodsSets Fixed Charge and Discharge PeriodsFields: Battery, Periods
Limit the power fed to the gridSets Active Power Control to 'Power-limited grid connection' with the given wattageFields: Device, Power
Limit the power fed to the grid to percentageSets Active Power Control to 'Power-limited grid connection (%)' with the given percentageFields: Device, Power Percentage
Set TOU PeriodsSets Time Of Use PeriodsFields: Device, Periods
Set Active Power Control to 'Zero power grid connection'Set Active Power Control to 'Zero power grid connection'Fields: Device
Stop the forcible charge or dischargeCancel the running forcible charge commandFields: Battery