Homebridge plugin exposing Waveshare Raspberry Pi Relay Board as a series of switches
npm install homebridge-plugin-waveshare-relayHomebridge plugin exposing Waveshare Raspberry Pi Relay Board as a series of switches.
You will need one or more Raspberry Pis with the Waveshare Relay board running rpi-relay-hat-api. All the relays are retrieved from the boards, and are automatically created in the Home App.
You will also need a server running Homebridge.
Install the plugin by searching for "Waveshare Relay Homebridge Plugin" through the Homebridge Plugins UI or manually by:
``sh`
sudo npm -g i homebridge-plugin-waveshare-relay
Use the plugin Config UI X to specify all the board urls and all the associated individual relays will be added to Homebridge:
Room View with Waveshare Relays | Waveshare Relay Main View
| :---------------------: | :-------------------: |
!Room with Waveshare Relays | !Waveshare Relay Main View
Each relay on the board appears as a lightbulb in the Home app, and the relay can be turned on and off as if it were a lightbulb.
`sh`
git clone git@github.com:jondarrer/homebridge-plugin-waveshare-relay
cd homebridge-plugin-waveshare-relay
yarn
Run the tests with the usual command:
`sh`
yarn test
Debug within VS Code by running the npm run local-homebridge task.
`sh`
yarn build
npm version patch -m "%s"
git push && git push --tags
NB. Requires docker-compose.
`sh`
npm run containerised-homebridge
This will build the plugin and copy the necessary files to the appropriate places within container volume space (./volumes/homebridge). It will then start it, making it available at http://localhost:8581.
It is necessary to re-run this process on changes to the source code.
To stop the container, simply run docker-compose down`.