This is a Raspberry Pi based Home Automation Manager. It utilises mosquitto, Homebridge, Homebridge-mqtt, Domoticz, the Apple HomeKit app and the projects contained in my other GitHub repositories to automate window blinds, a garage door opener, z-wave sensors and devices, an aquarium monitor, environment monitors, Shelly energy metering and a TRMNL e-ink information display.
Over time this project has evolved to match the devices actually running in my home. Several controllers that were once part of it — the Mitsubishi ducted air conditioner, the Fermax door intercom (Doorbell Monitor), BlueAir air purifiers, the Seneye aquarium sensor, the EV Charger Monitor and the Fan Monitor — have been retired from the live code.
If you rely on any of that earlier functionality (in particular the air conditioner / damper controller), use the v11.33 release. That release is the last version containing the full feature set, and it remains available and unchanged.
The current
Northcliff_Home_Manager_Gen.pyis a sanitised ("Gen") copy of the production code — replace every<Your ...>placeholder with your own values before running it.
.
The System Overview shows the Raspberry Pi based controllers that comprise the system, the mqtt messages that allow them to communicate with each other and the end devices that they manage. These overview diagrams depict the earlier, fuller system (see the version note above); they have not been redrawn for the current slimmed-down code and are retained for reference.
.
The Functional Overview outlines the Python objects of the Home Manager controller and how they interact with Domoticz, Homebridge and the other controllers that comprise the overall system. As with the System Overview, this diagram reflects the earlier full system.
Control of the Living Room window blinds is provided through a Hunter Douglas PowerView Gen 2 hub. Because PowerView Gen 2 does not expose its scenes to HomeKit, the Home Manager activates the matching PowerView scene via the hub's local API. Each blind group can be manually adjusted via the Apple Home App to one of three positions — Closed, Venetian or Open — represented (as PowerView's own HomeKit integration does) through target/current position and horizontal tilt angle. The Home Manager also provides the capability to:
- Link the blind control to an external light sensor and temperature sensor so that the blinds automatically adjust to external light, season and outdoor-temperature conditions. That automatic mode can be manually over-ridden from the Apple Home App.
- Link the blind control to door states so that any blinds covering a door cannot be closed while that door is open.
This Garage Door Opener is a simple Raspberry Pi project to open a garage door remotely using mqtt commands generated by this Home Manager when requested by the Apple Home App button. It uses an existing garage door remote.
The Home Manager interacts with Z-Wave sensors and devices (flood sensors, door sensors and multisensors) via Domoticz and uses Homebridge to allow users to view and control those sensors and devices using the Apple Home App. The following screenshot provides some examples:
The Home Manager receives aquarium sensor readings over mqtt from a separate aquarium monitor controller, exchanges heartbeats with it, and forwards the readings so they can be recorded and displayed.
The Environment Monitor captures, displays and reports on air particles and gases. Its readings are received via mqtt messages and are recorded/displayed in Domoticz and sent to Homebridge.
The Home Manager subscribes to power and energy readings published by Shelly metering devices over mqtt, making household power and energy consumption available to the rest of the system.
The Home Manager drives a TRMNL e-ink display through TRMNL's custom-plugin API. It publishes a combined view that includes local weather (from the Australian Bureau of Meteorology), upcoming calendar events (via a CalDAV calendar such as iCloud) and electricity tariff / peak-period information. See TRMNL/ for the plugin markup, a browser preview, and a field map of how each display variable maps to what the Home Manager pushes.
This project is licensed under the MIT License - see the LICENSE.md file for details
This project has, over its history, built on the work of several others. Acknowledgements for components used by earlier releases (for example the Foobot/BlueAir interface) are retained in the v11.33 release documentation.