TSUN microinverter integration · Home Assistant

TSUN microinverters in Home Assistant — local monitoring with TSUN Local

Your inverter. Your network. Your data.

Plug-and-play local monitoring for compatible TSUN microinverters and the Sunology PLAY2, directly inside Home Assistant.

Automatic discovery · Local · Read-only · No cloud · No proxy

Add to HACS Documentation Compatibility

Everything you need from your TSUN inverter

TSUN Local focuses on useful Home Assistant entities first, while keeping protocol details and advanced diagnostics out of the way until you need them.

☀️ PV productionVoltage, current, power, daily energy and total energy for each detected PV input.
⚡ AC telemetryVoltage, current, frequency, power, daily energy and total energy.
🚨 AlarmsCompact alarm state, active alarm count and readable alarm names where available.
📡 CommunicationOnline state, last successful communication, duration and consecutive failures.
🧩 Device informationFirmware, logger information and dynamically detected PV inputs.
🛡️ Advanced diagnosticsRead-only expert diagnostics stay disabled by default until they are needed.

Compatibility

TSUN Local support is organized by inverter family and local protocol. Below each family are the microinverters that have been tested on real hardware.

✅ Your microinverter may already be compatible — even if it is not listed below. TSUN Local identifies supported devices by their local protocol family, not only by commercial model name.
TITAN Protocol 1511
✅ Validated
Tested microinverters
TSOL-MP3000TSUN
GEN3 / GEN3 PLUS Protocol 02B0
✅ Validated
Tested microinverters
TSOL-MX500TSUN
TSOL-MS800TSUN
PLAY2Sunology
GEN3 / GEN3 PLUS Protocol 1097
🧪 Experimental
Experimental protocol support. Independent hardware validation is still in progress.
NEW IN 1.5.3

Alarms you can actually read

The 1.5.3 extends readable alarm presentation across 1511, 02B0 and 1097. Known alarms get clear localized descriptions while stable protocol-position codes remain available for diagnosis.

Grid undervoltage (02B0-A014) PV1 input voltage too low (1511-A137)
Unidentified inverter alarm (1097-A041) Stable code preserved for diagnosis
1511224 catalogue positions.
02B064 catalogue positions, including validated MX500, MS800 and Sunology PLAY2 paths.
109764 catalogue positions while protocol support remains experimental.

Install through HACS

Install TSUN Local, add the integration, and let it discover the available PV inputs.

1Install

Add TSUN Local through HACS.

2Add

Add TSUN Local from Home Assistant.

3Discover

TSUN Local detects available PV inputs automatically.

Automatic discovery · Local · Read-only · No cloud · No proxy

Documentation and entity reference

Technical details remain available without overwhelming the normal installation path. Use the entity reference for protocol-specific capabilities and the dedicated hardware pages for validated local paths.

Entity reference →Common and protocol-specific Home Assistant entities, defaults and advanced diagnostics. TSOL-MP3000 →Dedicated Home Assistant page for the validated TSUN TITAN / 1511 local integration path. TSOL-MX500 →Dedicated page for the validated TSUN 02B0 reference hardware path. TSOL-MS800 →Community-validated 02B0 hardware with two MPPT inputs and independent Home Assistant diagnostic feedback. Sunology PLAY2 →Dedicated compatibility and protocol-validation page for PLAY2 owners. Test your microinverter →Your model may already work with TSUN Local. Try automatic discovery and share the result to help expand the validated compatibility list.

Documentation in eight languages

TSUN Local documentation and integration translations cover the complete project language set.

EnglishFrançaisDeutschEspañolItalianoNederlandsPolski简体中文

Credits & independent community project

TSUN Local is unofficial and independent. It is not developed, approved, endorsed or maintained by TSUN, Sunology, Solarman or the projects and contributors credited below. Product and project names belong to their respective owners.

Created and maintained by Jean-Philippe TESTART (jptstar) for the Home Assistant community.

Public protocol research & community contributions David Rapan · ha-solarman — public Home Assistant Solarman protocol and inverter-profile work used as an independent cross-reference during selected 02B0 register research. Stefan Allius · tsun-gen3-proxy — public GEN3 / 1097 protocol research and country/profile references used during experimental protocol validation. @TheSmartGerman — real-device testing that revealed the additional 1097 protocol family. @dca31 — independent Sunology PLAY2 validation through the normal TSUN Local Home Assistant flow. @Kmotr — independent TSOL-MS800 validation with TSUN Local and an anonymized Home Assistant diagnostic. Full contributors & credits →