Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/madchicken/homebridge-zigbee-nt

A standalone ZigBee plugin that works with CC2531 USB dongle or Deconz
https://github.com/madchicken/homebridge-zigbee-nt

cc2531 deconz homebridge homebridge-zigbee ikeatradfri philips-hue xiaomi-smart-home zigbee zigbee-herdsman

Last synced: about 2 months ago
JSON representation

A standalone ZigBee plugin that works with CC2531 USB dongle or Deconz

Awesome Lists containing this project

README

        

![Logo](zigbee-logo.png)

# homebridge-zigbee-nt

ZigBee Platform plugin for [HomeBridge](https://github.com/homebridge/homebridge)

[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[![madchicken](https://circleci.com/gh/madchicken/homebridge-zigbee-nt.svg?style=svg)](https://app.circleci.com/pipelines/github/madchicken/homebridge-zigbee-nt)

## Description

This Homebridge plugin exposes ZigBee devices connected to TI's [CC253X](http://www.ti.com/wireless-connectivity/simplelink-solutions/zigbee/products.html) wireless SoC to Apple's HomeKit.
It uses [zigbee-herdsman](https://github.com/Koenkk/zigbee-herdsman) and [zigbee-herdsman-converters](https://github.com/Koenkk/zigbee-herdsman-converters) under the hood, so technically all supported devices mapped in zigbee-herdsman-converters should be supported.
To enable a new device you must implement a new HomeKit Device class and regirster it.

This project has been heavily inspired by [homebridge-zigbee](https://github.com/itsmepetrov/homebridge-zigbee) plugin by Anton Petrov.

## Supported devices

[See wiki page](https://github.com/madchicken/homebridge-zigbee-nt/wiki/Supported-devices)

## Build from sources

To build and run the plugin from sources, you need to install [yarn](https://yarnpkg.com) first.

Clone the repo:

git clone [email protected]:madchicken/homebridge-zigbee-nt.git

Once you get it, run yarn command:

cd homebridge-zigbee-nt
yarn && yarn build

You should end up with a new `dist/` folder containing the compiled version of the plugin.

## WEB UI

From version 1.0.8 you can see which device is paired through the [WEB UI exposed on port 9000](http://homebridge.local:9000).
To change the default port, set `httpPort: YOUR_PORT_NUMBER` in the configuration.
To completely disable http UI, set `disableHttpServer: true` in the configuration.

## License

Licensed under [Apache 2.0](LICENSE)

## Contribute

Any PR is welcome to this project, so please, fork and open one if you can!

If otherwise, you simply enjoyed using this plugin, and you want to contribute in some way, you can always donate something!

[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/madchicken74)