HomeKit Enviro+

An Apple HomeKit accessory for the Pimoroni Enviro+ running on a Raspberry Pi.

Dependencies

• Go - this accessory is written in Go
• HomeControl - to expose climate readings from the Enviro+ as an Apple HomeKit accessory
• enviroplus-exporter - to read the sensors of the Enviro+ and export them for scraping by Prometheus

Installation

Install this on a Raspberry Pi, or test it on macOS.

Setup

1. Install Go >= 1.14 (useful Gist for Raspberry Pi)
2. Clone this project: git clone https://github.com/sighmon/homekit-enviroplus and then cd homekit-enviroplus
3. Install the Go dependencies: go get
4. Install and run the Prometheus enviroplus-exporter
5. Optionally if you'd prefer a Docker container of the exporter, see: balena-enviro-plus

Build

1. To build this accessory: go build homekit-enviroplus.go
2. To cross-compile for Raspberry Pi on macOS: env GOOS=linux GOARCH=arm GOARM=7 go build homekit-enviroplus.go

Run

1. Execute the executable: ./homekit-enviroplus
2. Or run with the command: go run homekit-enviroplus.go

Optional flags

The flag defaults can be overridden by handing them in at runtime:

• -host=http://0.0.0.0 The host of your Enviro+ sensor
• -port=1006 The port of your Enviro+ sensor
• -sleep=5s The time between updating the accessory with sensor readings (5s equals five seconds)
• -dev This turns on development mode to return a random temperature reading without needing to have an Enviro+

e.g. to override the port run: go run homekit-enviroplus.go -port=8000 or ./homekit-enviroplus -port=8000

Reset this accessory

If you uninstall this accessory from your Apple Home, you'll also need to delete the stored data for it to be able to be re-added.

macOS

1. Delete the data in the folder created: homekit-enviroplus/Enviro+/
2. Restart the executable

Raspberry Pi

1. Remove the persistent data: rm -rf /var/lib/homekit-enviroplus/data
2. Restart the Raspberry Pi

Thanks

This project uses the amazing work of Matthias. Please consider donating if you found this useful.