TSUN Local Entities for Home Assistant

Validated hardware and protocol families

Protocol	Validated hardware	Status
1511	TSOL-MP3000	✅ Validated
02B0	TSOL-MX500 · TSOL-MS800 · Sunology PLAY2	✅ Validated
1097	GEN3 / GEN3 PLUS candidates	🧪 Experimental

TSOL-MS800 and Sunology PLAY2 have both been independently validated on real hardware through TSUN Local. See the dedicated hardware pages below for tested local paths.

Common everyday entities

PV productionpvN_voltage
pvN_current
pvN_power
pvN_energy_today
pvN_energy_total

AC productionac_voltage
ac_current
ac_frequency
ac_power
ac_energy_today
ac_energy_total

Communicationcommunication_online
communication_last_success
communication_duration
communication_blocks
communication_failures

PV entities are dynamic: only inputs actually detected by TSUN Local are created.

1.5.4 STABLE

Readable alarm entities

TSUN Local keeps the compact alarm interface across 1511, 02B0 and 1097.

Entity	Purpose	Default
`inverter_alarm`	Problem binary sensor	✅
`alarm_active_count`	Number of currently active alarm positions	✅
`active_alarm_names`	Localized human-readable active alarm descriptions with stable protocol-position codes	✅

Examples

02B0 / PLAY2 familyGrid undervoltage (02B0-A014)

1511 / MP3000PV1 input voltage too low (1511-A137)

Unknown positionUnidentified inverter alarm (1097-A041)

Known meanings get clear text. Unknown or reserved positions remain visible with neutral wording instead of guessed semantics.

Protocol	Alarm catalogue	Raw diagnostics
1511	224 positions	14 complete raw words, disabled by default
02B0	64 positions	4 raw alarm words, disabled by default
1097	64 positions	4 raw alarm words, disabled by default

Device and logger information

Entity key	Home Assistant name	Availability
`label_serial_number`	SN	when provided
`inverter_serial_number`	Micro-inverter SN	when provided
`logger_firmware_version`	Logger firmware version	protocol dependent
`dsp_firmware_version`	DSP firmware version	protocol dependent
`logger_mac_address`	Logger MAC address	when provided
`logger_wifi_signal`	Logger Wi-Fi signal	when provided
`rated_power`	Rated inverter power	when provided
`max_designed_power`	Maximum designed power	when provided

1511 · TITAN / TSOL-MP3000

Validated with up to six dynamically detected PV inputs. In addition to everyday telemetry, the adapter exposes firmware, inverter temperatures, read-only grid-protection diagnostics and field-validation data.

PV inputsUp to 6 dynamic inputs with voltage, current, power and energy.

Grid diagnosticsRead-only threshold, recovery and timing values; advanced entities disabled by default.

Alarm coverage224 source positions preserved through the compact alarm interface.

TSOL-MP3000 compatibility & local integration →

02B0 · GEN3 / GEN3 PLUS

Validated on TSOL-MX500, TSOL-MS800 and Sunology PLAY2. Up to four PV inputs are created dynamically when exposed by the device.

TSOL-MX500Validated 02B0 reference hardware path on a real TSUN microinverter.

TSOL-MS800Community-validated real hardware with two MPPT inputs and an anonymized Home Assistant diagnostic.

Sunology PLAY2Normal automatic integration flow validated on real hardware.

PV inputsUp to 4 dynamic inputs for supported 02B0 layouts.

Advanced diagnosticsRead-only grid and power diagnostics where available.

TSOL-MX500 compatibility →TSOL-MS800 compatibility →Sunology PLAY2 compatibility →

NEW IN 1.5.4

02B0 diagnostics added in 1.5.4

Nine additional read-only 02B0 diagnostics are now exposed. Expert/raw values remain disabled by default where appropriate.

Entity	Meaning	Type
`inverter_temperature`	Inverter temperature	°C
`inverter_firmware_version`	Inverter firmware version	text
`boot_status_raw`	Boot status	raw
`dsp_status_raw`	DSP status	raw
`work_mode_raw`	Work mode	raw
`output_shutdown_raw`	Output shutdown status	raw
`rated_level_raw`	Rated level	raw
`input_coefficient`	Input coefficient	%
`product_compliance_type_raw`	Product compliance type	raw

product_compliance_type_raw is kept raw and is not presented as a country/grid profile until independently validated.

1097 · GEN3 / GEN3 PLUS

Experimental protocol support. Up to six PV inputs can be created dynamically. Semantics that still require broader real-device confirmation remain explicitly marked as experimental.

Advanced diagnostics

Advanced entities are intentionally disabled by default. In Home Assistant open Settings → Devices & services → TSUN Local → Device → Entities → Disabled entities and enable only the diagnostics you need.

Open full technical reference Back to TSUN Local