Solar Manager Integration (solar-manager.ch) – local sensor polling + full device control

Hi all,

I’ve built a custom integration for the Solar Manager gateway (Swiss energy management system), since there wasn’t a complete one available.

GitHub: https://github.com/Soardiac/ha-solarmanager

What it does:

  • Site-level sensors: real-time PV power, consumption, battery, and grid; daily energy totals for the Energy Dashboard; self-consumption/autarky stats
  • Per-device sensors, auto-created and auto-discovered at runtime for whatever the gateway reports (power, SOC, temperature, connection status, etc.) — no reload needed for new devices
  • Mode selects and setpoints for batteries (Eco/Peak-Shaving/Manual/Tariff), wallboxes/car chargers, V2X, heat pumps, water heaters, smart plugs, switches, and inverter feed-in limit
  • Bilingual entity names (DE/EN), with fixed-value select options so automations stay stable regardless of HA language
  • HA Quality Scale (self-assessed): Bronze ✓, Silver ~95%, working toward Gold

Cloud or Local — pick one at setup:

  • Cloud mode: full feature set including all control entities, daily statistics, and self-consumption/autarky sensors. Auth via a Cloud API Key (recommended) or legacy email/password (supported until June 30, 2027).
  • Local mode (since v1.5.0): connects directly to the gateway’s local REST API — just an IP address, no Solar Manager account, no internet required. Covers real-time and daily energy sensors, but not self-consumption/autarky stats, mode selects, setpoints, or datetime entities — the local API is currently read-only, so control still needs Cloud mode.

You choose the mode during setup; switching later means removing and re-adding the integration (credentials/IP/host can be changed anytime without that).

Installation:
Via HACS as a custom repository (Integrations → → Custom repositories → add https://github.com/Soardiac/ha-solarmanager, category Integration), or manually by copying custom_components/solarmanager into your config folder.

Status:
Actively maintained. Feedback, issues, and PRs welcome on GitHub.

1 Like