Screenshots From the README of guoxiatech/hanchu-ess-ha.
About
Hanchuess is an integration for monitoring and controlling Hanchu ESS energy storage devices through the vendor's cloud. It adds sensors for device status, battery charge level, and power readings for battery, solar, grid, load, and generator, plus daily energy totals. Number entities set charge power limit, discharge power limit, and minimum battery charge, and a switch controls the inverter. A bundled custom dashboard card handles remote settings such as work modes, charge and discharge time periods, and a timed fast charge or discharge with a stop option. Several devices under one account can be added, and the interface is available in English and Simplified Chinese. Setup is done in the UI with account credentials, and a repair prompt asks for them again if the cloud token expires.
Automatic summary of the README and code of guoxiatech/hanchu-ess-ha. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Login to Hanchuess
- Account
- Password
Also asked when signing in again.
Select Devices
- Devices
Texts from the code of guoxiatech/hanchu-ess-ha.
Entities
- NumbersCharge Power Limit, Discharge Power Limit, SOC Minimum
- SensorsDevice Status, Battery SOC, Battery Power, PV Power, Grid Power, Load Power, Generator Power, Daily Load Energy, Daily PV Energy, Daily Charge Energy, Daily Discharge Energy, Daily Grid Import, and 2 more
- SwitchesInverter
From the README
A custom Home Assistant integration for monitoring and controlling Hanchuess ESS (Energy Storage System) devices.
- Real-time Monitoring — Battery SOC, PV power, grid power, load power, battery power, generator power (if available)
- Daily Energy Statistics — PV generation, battery charge/discharge, grid import/export, load consumption, generator energy (if available)
- Remote Settings Card — Custom Lovelace card for configuring work modes, charge/discharge time periods, and related parameters
- Fast Charge/Discharge — Quick charge or discharge with configurable duration and one-click stop
- Multi-device Support — Manage multiple devices under one account
- Internationalization — English and Simplified Chinese UI
Shows in Vulpo
Quick Toggle card, Select card, Chart card, Apple Watch, Control Center.Information
- Installs
- 53 sharing analytics
- GitHub stars
- 6
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v1.0.27,
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
hanchuess- Issues
- Report an issue













