README.md

homebridge-sma-home-manager

Homebridge plugin to:

1. integrate your home with an SMA inverter: observe live power (W, V, A), today's production (kWh) and device status/health using ModBus (and firmware version & serial number)
2. integrate your home with the SMA Home Manager: observe live power consumed (W) and today's consumption (kWh) using Speedwire (and firmware version & serial number)
3. combine this data to compute the following custom characteristics:
   • Consumption
   • Production
   • Import (from grid, i.e. consumption not produced)
   • Export (to grid, i.e. production not consumed)
   • Self-sufficiency level (-100% if no production, 0–99% if some production, 100–1000% if production and no import)
4. add 3 new accessories to your home:
   • Live power flow: live view in W of the above, updated every second
   • Recent power flow: average of last 3 minutes in W, updated every second
   • Today's energy flow: view of today in kWh, updated every minute

   

5. optionally, add energy signals an additional accessory per energy signal:
   • Off grid: 0 W is imported from the grid for the past minute
   • No sun: 0 W is produced during the past 15 minutes
   • High Grid Import: 15 minute mean import is >2500 W.
     _{Some distribution network operators charge extra to reduce peak load on their infrastructure. Use this signal to apply peak load shaving. For example "demand tariff or capacity charge" in Australia (30 min window during peak hours), "capacity tariff" in Belgium (≥ 2.5 kW in any 15 min window).}
6. optionally, add configurable PV surplus signals as additional accessories:
   • enter a label
   • enter a number of Watts
   • enter a number of minutes.
   • … then that configured PV surplus signal's accessory will be toggled on when there has been surplus production (i.e. export) of the entered Watts for the entered minutes, with some margin to cover base load variability (to avoid frequent toggling)

   

All energy signals have an On/Off status with a Reason to make it easy to understand why this energy signal is on or off.

Requirements

• SMA inverter with the ModBus setting enabled (it's off by default)
• SMA Home Manager 2.0

All 100% local, no internet access needed.

Credit

This was forked from https://github.com/codyc1515/homebridge-sma-inverter. Differences:

• Omitted the Eve-based history support which didn't quite work. Recommended alternative: sbfspot ^{Docker image} (which reads data locally, via SMAData2+), and optionally upload your production data to https://pvoutput.org (easy to use UI)
• Omitted the "Total". Observe that in SMA's SMA Energy app.
• Stopped exposing the inverter's information as light sensors (pseudo-live, today, total).
• Removed inverter IP address configuration in favor of zero config thanks to a link-local address zero config thanks to mDNS/DNS-SD discovering the inverter instead.
• Many bugfixes.
• Added support for SMA Home Manager, also using zero config thanks to SMA Speedwire
• Added combined view of inverter & Home Manager's data.
• Added energy signals.