About
AlphaESS Modbus TCP is a local integration that reads and controls AlphaESS solar inverters over Modbus TCP. It talks directly to the inverter on the local network, so no cloud account is needed. Besides sensors for power flows, battery state and daily energy totals, it adds switches and number settings for forced charging, discharging, export and import, each with power, duration and cutoff charge level. Hold switches keep a forced mode running past its duration, and an excess export mode stores solar power that the inverter output limit would otherwise clip. Selects cover dispatch mode, charge and discharge time periods and the inverter AC limit, and buttons sync the inverter clock or restart its controllers. Setup in the UI asks for the inverter address, port and slave ID, and options cover polling speed and the inverter model variant.
Automatic summary of the README and code of senalse/ha-alphaess-modbus. 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.
Provides
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
AlphaESS Modbus TCP
- Inverter IP Address
- Modbus Port
- Slave ID
After setup
- Poll ModeSlow (3x longer), Normal (default), or Fast. In Fast mode the loop runs at the poll interval value directly, so 0.1 gives a 100 ms loop and 10 polls per second for 1 s sensors.
- Slow Mode Interval MultiplierMultiplier applied to all scan intervals in Slow mode (default 3.0, range 0.25-10.0).
- Fast Mode Poll Interval (s)Sets the coordinator loop interval in seconds and scales all sensor poll intervals by the same factor. At 0.1, the loop runs every 100 ms and 1 s sensors poll 10 times per second. Values below 0.25 are only recommended for direct Modbus TCP connections - RS485 adapters are unlikely to keep up and may cause timeouts.
- Inverter Model VariantSelect Standard for most inverters. Select SMILE-B3 / SMILE-B3-PLUS if your inverter is a SMILE-B3 or SMILE-B3-PLUS - these models use different scale factors for voltage and inverter power registers.
Texts from the code of senalse/ha-alphaess-modbus.
Entities
- Binary sensorsExcess Export Pause, Force Import Pause
- ButtonsDispatch Reset, Synchronise Date & Time, Sync Dispatch State, Restart PCS, Restart EMS, Reset Energy Totals
- NumbersCharging Cutoff SoC, Discharging Cutoff SoC, Max Feed to Grid, Force Charging Power, Force Charging Stop at SoC, Force Charging Duration, Force Discharging Power, Force Discharging Stop at SoC, Force Discharging Duration, Force Export Power, Force Export Stop at SoC, Force Export Duration, and 6 more
- SelectsCharging / Discharging Settings, Dispatch Mode, Inverter AC Limit
- SensorsDispatch Time Remaining, Force Charging Countdown, Force Discharging Countdown, Force Export Countdown, Force Import Countdown, Today's Energy Feed to Grid, Today's Energy from Grid, Today's PV Generation, Today's Battery Charged, Today's Battery Discharged, Today's Battery Charged from Grid
- SwitchesForce Charging, Force Charging Hold, Force Discharging, Force Discharging Hold, Force Export, Force Export Hold, Dispatch, Excess Export, Force Import, Force Import Hold, Dispatch PV Enabled
From the README
Local Home Assistant integration for AlphaESS solar inverters (SMILE-M5, SMILE5, SMILE-G3, SMILE-Hi, SMILE-B3 series) via Modbus TCP.
No cloud account required. All communication is direct to the inverter on your local network.
- 103 sensor entities enabled by default (172 total) - real-time power flows, battery SoC/SoH, cell voltages, temperatures, voltages, energy totals, daily energy summaries, dispatch diagnostics, grid…
- Force Charging - charge battery from grid at configurable power (kW), duration, and cutoff SoC
- Force Charging Hold - keeps Force Charging running indefinitely after the duration expires; turn on before starting Force Charging for continuous charging without a time limit
- Force Discharging - discharge battery at configurable power, duration, and cutoff SoC; automatically stops 1% above the cutoff and resets dispatch so the inverter returns to self-consumption without…
- Force Discharging Hold - keeps Force Discharging running for the full configured duration instead of stopping early when the SoC target is reached
- Force Export - export to grid at a target feed-in rate (kW); battery discharge is dynamically adjusted for live house load and PV so the grid sees the configured power; stops automatically when the…
- Force Export Hold - keeps Force Export running indefinitely after the duration expires; turn on before starting Force Export for continuous export without a time limit
Shows in Vulpo
Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center.Information
- Installs
- 178 sharing analytics
- GitHub stars
- 26
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v1.14.0,
- Category
- Energy, Solar and batteries
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
alphaess_modbus- Issues
- Report an issue
