Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sighmon/homekit-powerwall
An Apple HomeKit accessory for the Tesla Powerwall 2 written in Go
https://github.com/sighmon/homekit-powerwall
apple golang homekit powerwall tesla
Last synced: about 1 month ago
JSON representation
An Apple HomeKit accessory for the Tesla Powerwall 2 written in Go
- Host: GitHub
- URL: https://github.com/sighmon/homekit-powerwall
- Owner: sighmon
- License: mit
- Created: 2023-12-24T10:59:02.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-16T11:29:46.000Z (12 months ago)
- Last Synced: 2024-11-26T20:40:13.137Z (about 1 month ago)
- Topics: apple, golang, homekit, powerwall, tesla
- Language: Go
- Homepage:
- Size: 3.2 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HomeKit Tesla Powerwall 2
An Apple HomeKit accessory for the [Tesla Powerwall 2](https://www.tesla.com/en_au/powerwall).
## Software
* Install [Go](http://golang.org/doc/install) >= 1.14 ([useful Gist](https://gist.github.com/pcgeek86/0206d688e6760fe4504ba405024e887c) for Raspberry Pi)
* Build: `go build homekit-powerwall.go`
* Build for Raspberry Pi by cross-compiling on macOS: `env GOOS=linux GOARCH=arm GOARM=7 go build homekit-powerwall.go`
* Run: `go run homekit-powerwall.go -ip POWERWALL_IP -username YOUR_USERNAME -password YOUR_PASSWORD`
* In iOS Home app, click Add Accessory -> "More options..." and you should see "Tesla"
### Prometheus exporter
To export the `battery`, `load`, and `solar` for [Prometheus](https://prometheus.io) use the optional flag `-prometheusExporter`.
* Run: `go run homekit-powerwall.go -ip POWERWALL_IP -username YOUR_USERNAME -password YOUR_PASSWORD -prometheusExporter`
You'll then see the data on port `8001`: http://localhost:8001/metrics
```
# HELP battery Charge (%)
# TYPE battery gauge
battery 90
# HELP load Watt (W)
# TYPE load gauge
load 3980
# HELP solar Watt (W)
# TYPE solar gauge
solar 6230
```
## Powerwall setup
Follow the instructions in [Connecting to Tesla Gateway](https://www.tesla.com/en_au/support/energy/powerwall/own/connecting-network) to set your `username` and `password` for your Powerwall.
Then use these credentials to run this HomeKit exporter app.
## Thank you
* Powerwall module: [go-powerwall](https://github.com/foogod/go-powerwall)
* Powerwall HomeKit for hc: [powerwall-homekit](https://github.com/brianmario/powerwall-homekit)
## TODO
- [x] Update to use `hap` instead of `hc
- [ ] Add energy exported/imported from [meters](https://github.com/foogod/go-powerwall/blob/main/meters.go)
- [ ] Add pull-request to the original repository