01 Introduction and Goals

Introduction and Goals

What is tsun-gen3-proxy?

This proxy enables a reliable connection between TSUN third generation microinverters and an MQTT broker. With the proxy, you can easily retrieve real-time values such as power, current and daily energy and integrate the inverter into typical home automations. This works even without an internet connection. The optional connection to the TSUN Cloud can be disabled!

Requirements Overview

• Supports TSUN GEN3 PLUS inverters: TSOL-MS2000, MS1800 and MS1600
• Supports TSUN GEN3 inverters: TSOL-MS800, MS700, MS600, MS400, MS350 and MS300
• MQTT protocol support
• Home-Assistant auto-discovery support
• MODBUS access via MQTT topics
• AT-Command support via MQTT topics (GEN3PLUS only)
• Faster DataUp interval sends measurement data to the MQTT broker every minute
• Self-sufficient island operation without internet
• Security-Features:
  • controls access via AT-commands
  • Runs in a non-root Docker Container

Quality Goals

The most important quality requirements for this project:

• Must work without internet connection
• Highly reliable for continuous operation without intervention
• High fault tolerance, especially in the event of unexpected behaviour from inverter or TSUN Cloud
• No dependency on paid tools or frameworks

Stakeholders

Role/Name	Contact	Expectations
Balcony power plant operator	Photovoltaikforum	- Monitoring the function of the PV system - Would like to make important settings myself - Interested in self-sufficiency - Open to technical innovations
Home Assistant User	Home Assistant Community	- Would like easy integration into Home Assistant
Hobby Automator	<Contact>	- No data outflow into public cloud systems - Would like to collect and display all PV system data - Would like to be able to combine data sources easily