Skip to content
This repository has been archived by the owner on Feb 28, 2024. It is now read-only.

Commit

Permalink
expanded readme
Browse files Browse the repository at this point in the history
  • Loading branch information
simonarnell committed Dec 23, 2020
1 parent c74e2b5 commit 4f37cd0
Showing 1 changed file with 5 additions and 1 deletion.
6 changes: 5 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,6 @@
# homebridge-solis
A homebridge plugin that collects solar panel generation data from Solis PV inverters and publishes to the HomeKit system.
A [homebridge](https://homebridge.io) plugin that collects solar panel generation data from [Solis PV inverters](https://www.ginlong.com/) with attached [data logging sticks](https://www.ginlong.com/accessories2/1083.html) and publishes the collected data to the Apple [HomeKit](https://developer.apple.com/homekit/) ecosystem.

Due to Apple's HomeKit currently only natively supporting a limited set of service types and specifically not domestic energy generation equipment, the inverters are modelled as [outlets](https://developer.apple.com/documentation/homekit/hmservicetypeoutlet). Whilst outlets are modelled in Apple's [Home](https://www.apple.com/uk/ios/home/) app on iOS and macOS, it is only to the degree of representing and allowing modification of their state (on/off).

Fortunately [Eve](https://www.evehome.com/en)'s [app](https://www.evehome.com/en/eve-app) supports their own smart outlets that extend the HomeKit API to publish consumption data. The plugin, uses these consumption characteristics to represent PV generation data. In the Eve app, the inverter appears as an outlet that switches on and off according to the sun's intensity and its ability to energise the inverter, in addition the energy generated appears as consumption data.

0 comments on commit 4f37cd0

Please sign in to comment.