Solarman
davidrapan/ha-solarman · vv25.08.16
⚡ Solarman Stick Logger integration for 🏡 Home Assistant
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
Reads Solarman WiFi/LAN loggers on Deye, Sofar, Afore, Solis and other inverters locally over port 8899; polling can disturb cloud uploads and unsupported models fail setup.
- Works3
- Partly works3
- Not working2
- Requested5
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Afore T4 BNT series | Works Local | Power, current scale and losses updatedSaved copy… read from two registers - Power is now read from two registers - New Device group with status/error registers - Rename Output group to Grid *tested on Afore BNT010KTL ("T4" serial number) Excerpt saved from GitHub on 2026-10-23. | PR #464 · 2025-03 | |
| Deye SUN-12K-SG04LP3-EU | Works Local | Negative zero-export power allowed on firmware 1135Saved copyBy using a SUN-12K-SG04LP3-EU inverter with firmware 1135 it's possible to use negative zero export power. For example to set the zero export power to -20W we can set it to 65516. So for using negative 'Zero Export power' we need to have a higher limit for that setting. Excerpt saved from GitHub on 2026-10-23. | PR #663 · 2025-06 | |
| Megarevo inverter | Works | PV power combines all four stringsSaved copyThis fix properly identifies and combines all four PV strings into one PV Power. Before this fix, PV Power was displaying inaccurate results as seen in the screenshot below (PV1 and PV2 were the only two active strings at the time). Excerpt saved from GitHub on 2026-10-23. | PR #877 · 2025-11 | |
| Deye 8kW SG01LP1 with LSW3 | Partly works Local | Polling makes the logger drop its Deye Cloud connectionSaved copyHello, I have deye 8kw SG01LP1 with Solarman LSW3 and just found this integration. When installed it i found that in the Deye UI the status switches from Online to Partially offline immediately if the integration is enabled and goes back to Online when i disable it. I not sure exactly how it affects the cloud and what "partially" means. Am i supposed to use both in the same time or have to choose one of them. If its a matter of configuration, can i change some parameter to make them work together? I had one more issue but not sure if its related, the night after i installed ha-solarman the … Excerpt saved from GitHub on 2026-10-23. | Issue #516 · 2025-04 | |
| Deye SG05 with LSW5 logger | Partly works Local | Setup fails with parser error after network or dongle changesSaved copyHi, I’m trying to integrate my Deye inverter locally into Home Assistant using the Solarman custom integration (HACS), but setup consistently fails with a parser error. ⸻ ⚙️ System Details • Inverter: Deye Hybrid (SG05 series, single-phase) • Logger / Dongle: LSW5 WiFi stick • Connection type: Local (TCP) • IP address: 192.168.1.xxx (static) • Port: 8899 • Home Assistant: Latest version (HAOS) • Solarman integration: Latest from HACS ⸻ 🔌 Network & Access • Logger is connected via WiFi (no LAN option available on this model) • IP is reachable and responds on port 8899 • Logger web interface: • … Excerpt saved from GitHub on 2026-10-23. | Issue #1035 · 2026-04 | |
| Deye SUN-15K-SG05LP3 | Partly works Local | Grid power factor register read wrongly; fix PR openSaved copyProblem `deye_p3` reads holding register 0x026D (621) "Grid Power Factor" as unsigned 16-bit × 0.1 % with a 0–100 validation range. On a Deye SUN-15K-SG05LP3 (MAIN 2107-1184-1809) the register is a signed 16-bit value × 0.001 in the range −1…1, negative while the inverter imports from the grid. Under the current definition the value fails validation whenever it is negative or above 100 (i.e. practically always), so the sensor never shows up. ## Fix - signed 16-bit (`S16`) - scale 0.001 - validation −1…1 ## Verification Live on the same SUN-15K-SG05LP3, compared against the Eastron … Excerpt saved from GitHub on 2026-10-23. | PR #1173 · 2026-09 | |
| Afore BNT015KTL / BNT025KTL | Not working Local | Profiles fail IllegalDataAddress; T5 not covered; closed staleSaved copyDescription ## Description I have two Afore BNT inverters with separate Solarman WiFi loggers. Local TCP communication to both loggers works on port 8899, but neither available Afore profile completes setup. ## Hardware ### Inverter 1 - Model: Afore BNT015KTL - Serial: T532500032007140 - Logger IP: 192.168.0.5 ### Inverter 2 - Model: Afore BNT025KTL - Serial: T421500032007062 - Logger IP: 192.168.0.24 ### Logger - Device serial: 2105015295 - Firmware: ME_0A_1E03_5.06 - Web version: 1.0.24 - TCP port: 8899 - Modbus slave ID tested: 1 The logger web interface and Solarman Smart work correctly. … Excerpt saved from GitHub on 2026-10-23. | Issue #1127 · 2026-08 | |
| Deye 3P with ethernet logger | Not working Local | Connection drops every couple of minutes; closed staleSaved copyDescription The connection is dropping from 2 to 2 minutes and i don have connection to deye cloud or solarman The issue appeared when i switch from wifi loggeer to ethernet logger Also i have error with consuption reading with high peak to 60000w I tried to update the logger with deye support buth same Also i tried previous version and now i am on prerelease ### Reproduction Steps Just switch from wifi logger to ethernet logger ### Log home-assistant_solarman_2025-11-16T16-53-12.486Z.log ### Version 25.08.16 ### Home Assistant Core Version 2025.11.1 ### Home Assistant Operating System … Excerpt saved from GitHub on 2026-10-23. | Issue #868 · 2025-11 | |
| Deye SUN-BK250 Micro Hybrid ESS | Requested | Device type 260 unsupported; wrongly falls back to deye_hybridSaved copyDescription Two related problems seen with a Deye SUN-BK250 Micro Hybrid ESS (device type register = 260 / 0x0104, not yet supported, see feature request #1191 and discussion #1190). 1. Unknown device type is silently mapped to a wrong profile - On v25.08.16 setup failed with `Unknown Device Type: 260` (clear error, but selecting a profile manually did not bypass the check). - On v26.01.31 the entry loads with lookup_file = Auto, but the device is created as "Deye / SG0*LP1" with `deye_hybrid.yaml`. All values come from the 500–700 block, which is all zeros on this device, so sensors show … Excerpt saved from GitHub on 2026-10-23. | Issue #1192 · 2026-10 | |
| Deye SUN-EVSE22K01-EU EV charger | Requested | Support PR openSaved copyAdds support for the Deye AC EV Charger (SUN-EVSE11K01-EU/SUN-EVSE22K01-EU) with full profile, autodetection, and automatic slave ID discovery. This PR extends the EVSE support that was partially introduced in PR #1065 (inverter-based control via the LoRa communication channel). NOTE: Deye has not published an official Modbus specification for the EV Charger. All register mappings in this profile are based on reverse engineering. Special thanks to @Stormhand for his reverse engineering work that made this possible and @ZajoCZ for MCU9_EV_C020_EU_3_26.bin firmware file. Profile … Excerpt saved from GitHub on 2026-10-23. | PR #1073 · 2026-05 | |
| INVT XD3-6KTL | Requested | Battery charging switch PR openSaved copyThank you for all your job, i made a proposal to add switch for enable charging battery in INVT model XD3-6KTL inverter: Tested in my invertir and it's working fine Thank you. Excerpt saved from GitHub on 2026-10-23. | PR #881 · 2025-11 | |
| Microtek Solar Grid Tie 3.3KW-M11 | Requested | Rebranded Sofar; PR closedSaved copythis is rebranded Sofa inverter in India grid tied single phase 1 PV configs are based on sofar_lsw3 since logger stick is running LSW3_15_FFFF_1.0.89R firmware product page Excerpt saved from GitHub on 2026-10-23. | PR #273 · 2024-12 | |
| Solis 3P grid-tie inverter | Requested | Export limiter meter sensors PR openSaved copyAdds two sensors to `solis_3p-4g.yaml` for Solis 3P grid-tie inverters that have an export limiting meter fitted: - Grid Power: S32 at input registers 3056/3055 (pysolarman addressing). Positive means exporting, negative means importing. It reads 0 without a meter. - Consumption Power: inverter output (3005/3004) minus Grid Power, i.e. what the house is using. Tested on an S5-GR3P8K-AU with a Solis smart meter configured for 0 W export. For example: | | SolisCloud | Registers | |---|---|---| | PV / AC output | 5.22 kW | 5.08 kW | | Load | 5.10 kW | 5.08 kW | | Grid | ~0 (0.12 kW export) | 0 W … Excerpt saved from GitHub on 2026-10-23. | PR #1170 · 2026-09 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Found automatically over
- DHCP
Details
| Installs (analytics) | 10,449 (1.47%) |
|---|---|
| GitHub stars | 530 |
| Latest version | v25.08.16 (2026-05-03) |
| Set up in the UI | Yes |
| Maintainers | @davidrapan |
| License | MIT |
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| jverhoeven/ha-solarman Newer code | ★ 0 | 2026-10-03 | ⚡ Solarman Stick Logger integration for 🏡 Home Assistant |
| Danieldiazi/ha-solarman Newer code | ★ 0 | 2026-10-23 | ⚡ Solarman Stick Logger integration for 🏡 Home Assistant |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/davidrapan/ha-solarman
- Source code: https://github.com/davidrapan/ha-solarman
- Issues: https://github.com/davidrapan/ha-solarman/issues
- HACS: https://hacs.xyz