LuxPower Inverter (Modbus) for Home Assistant (Marketplace integration)

Installs: 399 sharing analytics
GitHub stars: 79
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v1.1.1, October 14, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: lxp_modbus
Source: github.com/ant0nkr/luxpower-ha-integration
Issues: Report an issue

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

About

LuxPower Inverter (Modbus) monitors and controls LuxPower inverters through the Wi-Fi dongle over Modbus TCP. Communication stays on the local network without the cloud, and only Wi-Fi dongles are supported. It adds sensors for PV power, battery charge state, grid import and export, and load, plus a text sensor describing what the inverter is doing and a calculated load percentage. Numbers, switches, selects and time entities change charge and discharge currents, toggle features such as grid feed-in, set output priority and schedule charging periods. Read-only mode swaps these controls for sensors, and entities can be grouped into sub-devices for PV, Grid, EPS, Generator and Battery. Setup runs in the UI and asks for the dongle address, its serial number and the inverter serial number.

Automatic summary of the README and code of ant0nkr/luxpower-ha-integration. 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.

Luxpower Inverter Setup

IP AddressThe IP address of your inverter's WiFi dongle.
PortThe communication port, usually 8000.
WiFi Dongle Serial Number (BAXXXXXXXX)The 10-character serial number of your WiFi dongle.
Inverter Serial Number (XXXXXXXXX)The 10-character serial number of your inverter.
Polling Interval (seconds)How often to poll the inverter for data. A lower value means faster updates but more network traffic.
Entity Prefix (Optional)A custom prefix for all entity names (e.g., 'LXP'). Leave blank for no prefix.
Inverter Rated Power (Watts)The rated power of your inverter in Watts (e.g., 5000 for a 5kW model). Used for calculations.
Read-Only ModeIf enabled, all interactive controls (switches, numbers, selects, etc.) will be replaced with read-only sensors. This allows you to monitor all settings without being able to change them.
Register Block SizeBlock size for register reads. Use 125 (default) for most inverters. Use 40 for older firmware that doesn't support larger reads.
Connection Retry AttemptsNumber of connection retry attempts before giving up (default is 3).
Enable Device GroupingGroup entities into sub-devices (PV, Grid, EPS, Generator, Battery) for better organization.
Battery EntitiesSet to 'none' to disable, 'auto' to auto-discover batteries, or enter comma-separated battery serial numbers.
Battery Voltage (V)The nominal voltage of your battery bank: 12, 24 or 48 V. Voltage limits are written for 48 V systems and are scaled to match your battery.

After setup

IP AddressThe IP address of your inverter's WiFi dongle.
PortThe communication port, usually 8000.
WiFi Dongle Serial NumberThe 10-character serial number of your WiFi dongle.
Inverter Serial NumberThe 10-character serial number of your inverter.
Polling Interval (seconds)How often to poll the inverter for data. A lower value means faster updates but more network traffic.
Entity Prefix (Optional)A custom prefix for all entity names (e.g., 'LXP'). Leave blank for no prefix.
Inverter Rated Power (Watts)The rated power of your inverter in Watts (e.g., 5000 for a 5kW model). Used for calculations.
Read-Only ModeIf enabled, all interactive controls (switches, numbers, selects, etc.) will be replaced with read-only sensors. This allows you to monitor all settings without being able to change them.
Register Block SizeBlock size for register reads. Use 125 (default) for most inverters. Use 40 for older firmware that doesn't support larger reads.
Connection Retry AttemptsNumber of connection retry attempts before giving up (default is 3).
Enable Device GroupingGroup entities into sub-devices (PV, Grid, EPS, Generator, Battery) for better organization.
Battery EntitiesSet to 'none' to disable, 'auto' to auto-discover batteries, or enter comma-separated battery serial numbers.
Battery Voltage (V)The nominal voltage of your battery bank: 12, 24 or 48 V. Voltage limits are written for 48 V systems and are scaled to match your battery.

Texts from the code of ant0nkr/luxpower-ha-integration.

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

A comprehensive Home Assistant integration to monitor and control LuxPower inverters via their Modbus TCP interface.
This integration connects directly to your inverter's WiFi dongle, providing real-time data and control over various settings without relying on the cloud.
Real-time Monitoring: Track PV power, battery state of charge (SOC), grid import/export, load consumption, and more.
Inverter Control: Change charge/discharge currents, set timed charging/discharging periods, and enable/disable features like grid feed-in.
Organized Device Structure: (v0.2.0+) Entities are automatically grouped into logical sub-devices (PV, Grid, EPS, Generator, Battery) for better organization in Home Assistant.
Detailed States: A user-friendly text sensor shows exactly what the inverter is doing (e.g., "PV Powering Load & Charging Battery").
Calculated Sensors: Includes derived sensors like "Load Percentage" for a clearer view of your system's performance.
Local Polling: All communication is local. No cloud dependency.

From the README of ant0nkr/luxpower-ha-integration, MIT License. Shortened.