nrc

node-red-contrib-zigbee

Node-RED Nodes for ZigBee Devices 🐝

Showing:

Popularity

Downloads/wk

154

GitHub Stars

79

Maintenance

Last Commit

7mos ago

Contributors

7

Package

Dependencies

6

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

node-red-contrib-zigbee

NPM version Dependencies Status Build Status XO code style License

Control Zigbee Devices (Xiaomi Aqara, Hue, Lightify, Tradfri, ...) with Node-RED via a CC253x Module. No need for proprietary bridges anymore, use devices of different vendors in one Zigbee network.

Work in progress Will bump version to 1.0 as soon as todo is done, zigbee-herdsman api is stable and everything is tested.

Credits

Based on zigbee-herdsman, Koenkk's fork of Zigbee Shepherd. Strongly inspired by his awesome zigbee2mqtt project.

Hardware Prerequisites

see https://www.zigbee2mqtt.io/getting_started/what_do_i_need.html Ready to use firmware images are available here: https://github.com/Koenkk/Z-Stack-firmware/tree/master/coordinator

Getting started

Add any Zigbee Node, open it's configuration, add a "herdsman" node, configure it, close both nodes and deploy. Wait a few seconds and go to the configuration of the "herdsman" node again, now you should be able to pair devices. Keep an eye on Node-RED's log output.

Nodes

herdman

Config node that holds the serial port and ZigBee network configuration of zigbee-herdsman. You should change the networkKey for security reasons before pairing the first devices. I suggest to use a password manager (like e.g. KeyPass) to create and store a random key (has to be 16 Byte in uppercase hex representation (32 chars 0-9A-F). With this config node you can also manage your devices (pairing, removing, renaming), reporting, groups and binds.

converter

This Node utilizes Koenkk's zigbee-herdsman-converters and offers payload formats as known from zigbee2mqtt. In fact most of this nodes code is taken 1:1 from zigbee2mqtt.

hue

This node aims to be a drop-in replacement for https://github.com/hobbyquaker/hue2mqtt.js

offline

This node outputs the online/offline status of the devices.

event

This Node outputs events as received from zigbee-herdsman.

command

Send a command to a device endpoint or group.

controller

Call methods of the herdsman controller

Todo

  • Converter node: readAfterWrite
  • Hue node: readAfterWrite
  • Converter node: Determine endpoint
  • Converter node: Group support
  • Converter node: Get command
  • Hue node: Group support
  • Command node: Group support
  • Group bind support
  • remove frontend debug output
  • per-device configurable ping
  • per-device configurable configure
  • Secure shepherd node REST API, use Authentication
  • Documentation
  • Adapt to Node-RED 1.0 message API
  • OTA Update

License

MIT (c) Sebastian Raff

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
Ron HolmesUK4 Ratings0 Reviews
I am somewhat cheerier than this photo shows, but not much younger. This is my G G G Grandfather born 1813.
1 year ago