Felicity Solar Local for Home Assistant (Marketplace integration)

On Home Assistant 2026.10 or older? Open it in HACS

Installs: 50 sharing analytics
GitHub stars: 8
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v1.10.0, November 13, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: felicity_solar_local
Source: github.com/fabiomatavelli/ha-felicity-solar-local
Issues: Report an issue

Shows in Vulpo Chart card, Apple Watch.

Download Vulpo

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

About

Home Assistant HACS integration for Felicity Solar batteries over the local network (no cloud)

Description from fabiomatavelli/ha-felicity-solar-local

Shows in Vulpo

Chart card, Apple Watch.

Download Vulpo

Installs over time

Oct 21Nov 14

#1,570 of 1,584 Marketplace integrations. Installs sharing analytics.

Supports

Works locallyTalks to your devices on your own network. No vendor cloud in between.
Found by itselfHome Assistant spots it on the network and offers to add it.
From the MarketplaceInstalled through the Marketplace, formerly HACS.
Actively maintainedIts author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

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

Connect to a Felicity Solar battery

Host (IP address)The battery's local IP address, e.g. 192.168.1.50 - find it in your router's DHCP client list.
PortTCP port of the battery's local protocol. Leave the default (53970) unless you changed it on the device.

Reconfigure the Felicity Solar battery connection

Host (IP address)
Port

After setup

Keep connection openKeep the TCP connection to the battery open between updates instead of reconnecting every time (this is the default). Allows much faster polling (down to 5s) at the cost of holding a socket open on the battery's WiFi module; the OS is asked to probe the connection while idle so a dropped connection is still detected between polls.
Update interval (seconds)
Enable raw data sensorAdds a diagnostic sensor exposing the full raw device payload as attributes. Off by default - at fast poll intervals, updating this sensor's large attribute set on every poll adds meaningful overhead. Turn it on for troubleshooting or when contributing a new battery model profile.
Invert current/power signHome Assistant's convention for batteries is negative current/power while charging and positive while discharging - this battery reports the opposite. On by default so the sign matches Home Assistant out of the box; turn off to pass through the battery's raw sign unmodified.

Texts from the code of fabiomatavelli/ha-felicity-solar-local.

Entities

SensorsVoltage, Current, Power, Charging state, State of charge, State of health, Capacity, Cycle count, Max cell voltage, Min cell voltage, Max voltage cell number, Min voltage cell number, and 23 more

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

A Home Assistant custom integration that reads Felicity Solar battery data directly over your local network - no cloud account, no internet dependency. It talks to the battery's onboard WiFi module using its local TCP/JSON protocol.
Felicity's LUX-E and LUX-Y series (e.g. LUX-E-48100LG03, LUX-Y-48300LG01) are supported too (see Battery model support).
Local polling, no cloud: connects straight to the battery's IP over TCP.
UI configuration: add a battery by IP, no YAML required.
All battery data: voltage, current, power, SOC, SOH, capacity, cycle count (only on firmware that reports it), all 16 individual cell voltages, min/max cell voltage, temperatures, charge/discharge…
Nothing hidden: an optional diagnostic "Raw data" sensor exposes the complete device payload as attributes, even fields not mapped to a dedicated sensor (off by default - see Configuration below).
Translated: English, Portuguese (Brazil and Portugal), Spanish, German, French, Italian, Ukrainian and Russian. Spotted an awkward translation? PRs from native speakers are very welcome.
Multi-model aware: sensor field mapping is looked up per battery model (see Battery model support below) instead of hardcoded to one model.

From the README of fabiomatavelli/ha-felicity-solar-local, MIT License. Shortened.