Sunplug

Setup guides → Home Assistant

Home Assistant

The widest-reaching connection here. Home Assistant already speaks to nearly every inverter, battery and meter on the market, so if it can read yours, so can Sunplug — including brands with no cloud API at all.

Tested against a simulator

Exercised against a simulated Home Assistant, including entity lookup and unit handling. No live instance yet.

How freshAs fast as your sensors update
Sees house loadIf you have a sensor for it
Sees the batteryIf you have sensors for it
Setup timeTen minutes

What you need

Making a token

  1. Click your name, bottom left → Security
  2. Long-lived access tokens → Create token
  3. Copy it — it is shown once

Finding your entities

Developer tools → States, and search. You are looking for up to five:

Solar productionRequired — e.g. sensor.solar_power
Grid powerStrongly recommended — without it there is no surplus
House consumptionOptional — worked out if absent
Battery powerOptional
Battery levelOptional — the percentage, not the power

Which way is positive

Integrations disagree about signs, so Sunplug asks rather than guesses. For the grid sensor, say whether a positive number means importing or exporting. Same for the battery: positive means discharging, or charging. Get these wrong and Sunplug will think you are importing on a sunny afternoon and never charge — it is the first thing to check if that happens.

Units are read from the entity itself, so watts and kilowatts both work without you converting anything.

Connecting

  1. Settings → Equipment → Home Assistant
  2. Your Home Assistant address — e.g. http://homeassistant.local:8123
  3. The token, then the entity IDs
  4. Check it works — the numbers shown should match your dashboard

Reaching it

Sunplug's servers cannot see inside your network, so either expose Home Assistant over HTTPS, or run the agent alongside it and let that do the reading. The agent is the better answer: nothing needs exposing and the data is fresher.

When it does not work

"Home Assistant rejected the access token"

Tokens are shown once and are easy to truncate when copying. Make a new one.

"No entity called…"

Check it in Developer tools → States. Entity IDs change when an integration is reconfigured, which is a common cause of a connection that used to work.

"Sensor is unavailable"

Sunplug treats an unavailable sensor as an error rather than as zero, deliberately — reading it as zero would look exactly like a cloudy day and quietly stop your charging.

Stuck? Email me with the entity IDs and I will tell you what Sunplug is seeing.