---
title: "TSUN Local"
description: "TSUN Local is a Marketplace integration for Home Assistant. It has 54 installs sharing analytics, works locally and was last updated October 31, 2026."
canonical: "https://vulpo.app/integrations/marketplace/jptstar-tsun-local"
url: "https://vulpo.app/integrations/marketplace/jptstar-tsun-local.md"
last-updated: "2026-11-01"
version: "1.4"
---

# TSUN Local

> TSUN Local is a Marketplace integration for Home Assistant. It has 54 installs sharing analytics, works locally and was last updated October 31, 2026.

TSUN Local is a Home Assistant integration that reads TSUN solar micro-inverters over the local network. It talks directly to the inverter, with no cloud service and no proxy in the data path, and it only reads data without writing any inverter configuration. It adds sensors, binary sensors for inverter online status and alarm state, and a button to refresh data on demand. Active alarms are shown as readable descriptions with stable protocol position codes, and unknown positions stay visible with neutral wording. Polling is adaptive, with separate intervals for normal operation, after an error and while offline or at night. Advanced diagnostic entities are disabled by default, and setup is done in the UI by entering an address manually or using discovery.

Automatic summary of the README and code of jptstar/tsun-local. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/support)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=jptstar&repository=tsun-local&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=jptstar&repository=tsun-local&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **From the Marketplace**: Installed through the Marketplace, formerly HACS.
- **Actively maintained**: Its author released or pushed a change in the last six months.

## Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

### Add a device manually

- **IP address**
- **Port**
- **SN**
- **Protocol selection method**

### TSUN devices found

- **Discovered address**
- **Port**
- **SN**

### Search another subnet

- **IPv4 subnet**
- **Port**

### Update connection

- **IP address**
- **Port**

### After setup

- **Adaptive polling**
- **Normal interval**
- **Interval after error**
- **Offline / night**
- **Failures before offline**

Texts from the code of [jptstar/tsun-local](https://github.com/jptstar/tsun-local).

## Entities

- **Binary sensors**: Micro-inverter online, Inverter alarm
- **Buttons**: Refresh data
- **Sensors**: Raw global alarm 0, Raw global alarm 1, Raw global alarm 2, Raw global alarm 3, Raw secondary alarm 0, Raw secondary alarm 1, Raw secondary alarm 2, Raw secondary alarm 3, Raw alarm code 1, Raw alarm code 2, Raw alarm code 3, Raw alarm code 4, and 117 more

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.

## At a glance

- Kind: Marketplace integration
- Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries
- Number: 54 installs sharing analytics; 7 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v1.6.2, last updated October 31, 2026
- Domain: `tsun_local`
- Source: <https://github.com/jptstar/tsun-local>
- Issues: <https://github.com/jptstar/tsun-local/issues>

In Vulpo: Button card, Chart card, Apple Watch

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-11-01. Source: https://vulpo.app/integrations/marketplace/jptstar-tsun-local

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/jptstar-tsun-local
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml