Skip to content

Home

Jump to bottom
Marcin Gaszewski edited this page May 25, 2026 · 4 revisions

Sunsynk / Deye Solar Inverter — Home Assistant Integration

A native Home Assistant integration for monitoring and controlling Sunsynk and Deye hybrid solar inverters via the Sunsynk cloud API. No add-on, no YAML, no Docker container — everything is configured through the Home Assistant UI.

Why this integration exists

The Sunsynk Wi-Fi dongle has no local API. It communicates exclusively with the Sunsynk cloud, so cloud polling is the only option. The existing community solution was an add-on (a separate sidecar process), not a real HA integration — meaning no proper device model, no entity registry, no Config Flow UI, and no HACS update support. This integration was written from scratch as a proper native component.

Pages

Page Description
Installation HACS and manual install steps
Configuration Initial setup — API server, credentials, serials
Solar Forecast Predicted PV yield, irradiance and weather sensors
Tariff Manager Automatic battery charging & discharging based on electricity price
Entities Reference Full list of sensors, numbers and switches
Dashboard Auto-generated Lovelace dashboard — how it works and how to customise
Automations Ready-to-use automation examples
Troubleshooting Common problems and fixes
Architecture Code structure, API details, developer notes

Quick facts

  • Inverter access: Sunsynk cloud API (api.sunsynk.net or pv.inteless.com)
  • Poll interval: configurable, default 5 minutes (300 s), minimum 60 s
  • Platforms: sensor, number, switch, text
  • Entities per inverter: ~60 sensors, ~30 numbers, ~25 switches, ~6 text entities
  • Solar Forecast: 6 additional sensors via Open-Meteo (free, no API key)
  • Tariff Manager: automatic charging/discharging based on any HA price sensor; all thresholds adjustable as Number entities
  • HA Diagnostics: download a full diagnostic snapshot from the integration page
  • HA Repairs: integration raises issues automatically on auth failure or inverter going offline
  • HA Services: force_charge, force_discharge, set_work_mode for use in automations
  • HA version: 2024.1 or newer
  • GitHub: https://github.com/MarcinG81/SunSynk_HA_Integration

Clone this wiki locally