mirror of
https://github.com/nikdoof/hapz2m.git
synced 2026-01-30 09:18:17 +00:00
7fbbec79d9
There doesn't seem to be any distinction in Z2M between occupancy and motion sensors, but HomeKit has separate types. Most of the sensors are PIR, so they are technically motion sensors instead of occupancy sensors. There are of course _real_ occupancy sensors like mmWave, but we'll deal with those when we get there.
49 lines
1.7 KiB
Markdown
49 lines
1.7 KiB
Markdown
hap-z2m Bridge
|
|
===============
|
|
|
|
A HomeKit <-> Zigbee2MQTT bridge written in Go, so I don't have to install more NodeJS rubbish.
|
|
It is essentially a Homebridge + homebride-z2m replacement.
|
|
It compiles down to a <10 MB static binary instead of another 200++ MB Docker container.
|
|
It uses the [hap library](https://github.com/brutella/hap) for interfacing with HomeKit.
|
|
|
|
It is quite barebones, so there is no configuration for the bridge, apart from the MQTT server & credentials.
|
|
The bridge configures and exposes devices based on z2m's MQTT messages.
|
|
|
|
Currently only supports the types of Zigbee devices I have:
|
|
|
|
- Climate sensors (temp, humidity)
|
|
- Contact sensors
|
|
- Motion sensors
|
|
- Wall switch
|
|
|
|
If you do use this software, note that it's in development and may contains bugs,
|
|
or may even burn your house down. I offer no warranty, but you are welcome to file bugs.
|
|
|
|
|
|
Building
|
|
=========
|
|
|
|
To compile `hap-z2m`, use:
|
|
|
|
go build -v -trimpath -ldflags="-s -w" ./cmd/...
|
|
|
|
License
|
|
========
|
|
|
|
hap-z2m is licensed under the GNU General Public License v3.
|
|
|
|
Copyright (C) 2023 Darell Tan
|
|
|
|
This program is free software: you can redistribute it and/or modify it under
|
|
the terms of the GNU General Public License as published by the Free Software
|
|
Foundation, either version 3 of the License, or (at your option) any later
|
|
version.
|
|
|
|
This program is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
|
PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License along with
|
|
this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|