--- title: "AlphaESS Modbus TCP" description: "AlphaESS Modbus TCP is a Marketplace integration for Home Assistant. It has 178 installs sharing analytics, works locally and was last updated June 14, 2026." canonical: "https://vulpo.app/integrations/marketplace/senalse-ha-alphaess-modbus" url: "https://vulpo.app/integrations/marketplace/senalse-ha-alphaess-modbus.md" last-updated: "2026-10-22" version: "1.4" --- # AlphaESS Modbus TCP > AlphaESS Modbus TCP is a Marketplace integration for Home Assistant. It has 178 installs sharing analytics, works locally and was last updated June 14, 2026. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=senalse&repository=ha-alphaess-modbus&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=senalse&repository=ha-alphaess-modbus&category=integration) ## 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. ### AlphaESS Modbus TCP - **Inverter IP Address** - **Modbus Port** - **Slave ID** ### After setup - **Poll Mode**: Slow (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 Multiplier**: Multiplier 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 Variant**: Select 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](https://github.com/senalse/ha-alphaess-modbus). ## Entities - **Binary sensors**: Excess Export Pause, Force Import Pause - **Buttons**: Dispatch Reset, Synchronise Date & Time, Sync Dispatch State, Restart PCS, Restart EMS, Reset Energy Totals - **Numbers**: Charging 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 - **Selects**: Charging / Discharging Settings, Dispatch Mode, Inverter AC Limit - **Sensors**: Dispatch 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 - **Switches**: Force 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 From the README of [senalse/ha-alphaess-modbus](https://github.com/senalse/ha-alphaess-modbus#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Number: 178 installs sharing analytics; 26 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.14.0, last updated June 14, 2026 - Domain: `alphaess_modbus` - Source: - Issues: In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/senalse-ha-alphaess-modbus --- - HTML version of this page: https://vulpo.app/integrations/marketplace/senalse-ha-alphaess-modbus - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml