TSUN Local · Read-only community hardware validation

Test your TSUN microinverter with TSUN Local

Not listed yet, or communication unstable? Start with the Windows app or use the Python diagnostic.

Windows · Python 3.10+ · Strictly read-only

Your model may already be compatible

TSUN Local 1.6.0 detects supported local protocol families, not only a fixed list of commercial model names. The validated families include 1511, 02B0 and 1097 / GEN4.

✅ An unlisted model does not mean an unsupported model.If your inverter exposes a supported local protocol, automatic discovery may already be enough.

Windows diagnostic

Recommended on Windows. Download the app, launch the guided read-only diagnostic, then send the anonymized report directly from the interface after consent.

Simple guided test.No Python installation is required.

Python diagnostic — all platforms

Prefer the terminal? Download tsun_dump.py and run it with Python 3.10+.

Recommended full diagnostic
Python 3.10+
python tsun_dump.py --full

To target one known logger or a routed subnet:

Known logger
python tsun_dump.py --host 192.168.1.50 --full
Routed subnet / VLAN
python tsun_dump.py --network 192.168.1.0/24 --full

Four clear steps

1Disable TSUN Local

Temporarily disable the affected config entry in Home Assistant to avoid two simultaneous polling sessions on the logger.

2Run the diagnostic

Use the Windows app or Python. Discovery and evidence capture remain read-only.

3Direct upload

Recommended in the desktop app. Add an optional tester name and micro-inverter models, review the consent, then upload. You receive a TSL receipt and a link to view exactly what was sent.

4Manual fallback

If direct upload is unavailable, send the generated JSON manually by e-mail. Re-enable TSUN Local when the capture is complete.

What the diagnostic investigates

The read-only engine discovers local TSUN loggers, identifies 1511 / 02B0 / 1097 protocol families, captures known-safe register ranges and gathers bounded passive logger metadata. It can recognize multiple Wi-Fi RSSI layouts in percent or dBm and, in full mode, test whether the logger answers the read-only AT+WSDNS DNS getter without storing the returned DNS address.

✅ It worksReport the exact model and result so the hardware can be added to the validated compatibility list.
❌ It fails or becomes unavailableThe report preserves protocol evidence that can distinguish a register-range issue, logger response marker, firmware variant or communication behaviour.

Safety and privacy

The hardware diagnostic remains strictly read-only. Direct upload is a separate HTTPS action and happens only after explicit consent. The consent state is never remembered.

After upload: the app shows the unique TSL-... receipt and a private-token Worker link that displays exactly the anonymized report submitted by that tester. It does not expose the private reports repository or reports from other users.