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 TSUN Local to HACS Documentation ⭐ Star on GitHub 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 plus concise adaptive-polling diagnostics: state, last response, failures and current interval.
🧩 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. TSOL-MX3000D is validated in Home Assistant on GEN4 / 1097 with all telemetry values confirmed by its owner. TSOL-MX450 is now also validated by its Home Assistant user. Earlier connection interruptions were traced to Wi-Fi rather than protocol incompatibility.

✅ 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-MS300TSUN TSOL-MX450TSUN · Home Assistant validated TSOL-MX500TSUN TSOL-MS800TSUN · Home Assistant validated TSOL-MS2000TSUN PLAY2Sunology
GEN4 Protocol 1097
✅ Validated
Tested microinverters
PLAY2Sunology · G4 variant TSOL-MX3000DTSUN · Home Assistant validated

October 2026: an additional 800 W / two-PV 02B0 diagnostic captured 144 registers on logger firmware LSW5_SSL_02B0_1.05. Its exact commercial model was not declared, so this is additional protocol evidence, not a separate Home Assistant validation. Read the MS800 field evidence →

Alarms you can actually read

TSUN Local presents readable alarms 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 MS300, MX500, MS800, MS2000 and Sunology PLAY2 paths.
109764 catalogue positions on validated GEN4 / 1097 paths, including PLAY2 and TSOL-MX3000D.

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

Diagnostic tools

Choose the simplest way to capture a read-only TSUN diagnostic.

Entity reference →Visual guide to the main Home Assistant entities, protocol-specific diagnostics and alarm fields. Windows diagnostic →Download the Windows app and run the guided diagnostic. No Python required. Python diagnostic →Python 3.10+ command-line diagnostic with clear terminal commands.

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 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. @phildeg31 — real-hardware Sunology PLAY2 GEN4 / 1097 diagnostics and ongoing stability validation. @nxenara — repeated read-only TSOL-MS300 hardware dumps confirming the validated 02B0 / GEN3 path, 300 W rated power and one PV input. phklrz (Philippe K.) — TSOL-MX450 / 02B0 diagnostics, subsequently validated in Home Assistant; past connection problems were attributed to Wi-Fi. Valentin Fleuret — two complete TSOL-MX3000D GEN4 / 1097 diagnostics confirming six PV inputs and firmware V3.2.68; the device owner confirms TSUN Local works in Home Assistant with all telemetry available. @Kmotr — independent TSOL-MS800 validation with TSUN Local and an anonymized Home Assistant diagnostic. @paloindici — independent TSOL-MS2000 validation with four PV inputs, plus anonymized TSOL-MS2000 / MP3000 diagnostics and a hardware dump that improved the standalone diagnostic tool. Full contributors & credits →