homebridge-udp-json
v1.0.1
Published
UDP server receiving JSON messages from sensors for Homebridge: https://github.com/nfarina/homebridge"
Downloads
6
Maintainers
Readme
homebridge-udp-json
UDP server for receiving JSON messages from remote sensors on your network, plugin for Homebridge
Installation
- Install Homebridge using
npm install -g homebridge
- Install this plugin
npm install -g homebridge-udp-json
- Update your configuration file - see below for an example
Configuration
accessory
: "UDPJSON"name
: descriptive namename_temperature
(optional): descriptive name for the temperature sensorname_humidity
(optional): descriptive name for the humidity sensorlisten_port
(8268): UDP port to listen for packets on
This currently plugin creates two services: TemperatureSensor and HumiditySensor, but other sensor types could easily be added in the future.
UDP packets are expected to be sent from a remote sensor in JSON, for example:
{"temperature_c": 24.35, "pressure_hPa": 1010.73, "altitude_m": 21.01, "humidity_percent": 38.20}
This is a custom structure, but is simple enough to send from cheap Wi-Fi enabled microcontrollers such as the ESP8266. Example sender program for Arduino: https://github.com/rxseger/dooper
See also
- homebridge-bme280
- homebridge-udp-lightsensor
- homebridge-udp-contactsensor
- homebridge-udp-lock
- homebridge-blinds-udp
- homebridge-udp-multiswitch
License
MIT