mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-03 00:36:50 +00:00
68 lines
2.3 KiB
Markdown
68 lines
2.3 KiB
Markdown
---
|
|
layout: page
|
|
title: "Zigbee Home Automation"
|
|
description: "Instructions on how to integrate your Zigbee Home Automation within Home Assistant."
|
|
date: 2017-02-22 19:59
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: zigbee.png
|
|
ha_category: Hub
|
|
ha_release: 0.44
|
|
ha_iot_class: "Local Polling"
|
|
---
|
|
|
|
[Zigbee Home Automation](http://www.zigbee.org/zigbee-for-developers/applicationstandards/zigbeehomeautomation/)
|
|
integration for Home Assistant allows you to connect many off-the-shelf Zigbee devices to Home Assistant, using a compatible Zigbee radio.
|
|
|
|
There is currently support for the following device types within Home Assistant:
|
|
|
|
- [Binary Sensor](../binary_sensor.zha) (e.g., motion and door sensors)
|
|
- [Sensor](../sensor.zha) (e.g., temperature sensors)
|
|
- [Light](../light.zha)
|
|
- [Switch](../switch.zha)
|
|
- [Fan](../fan.zha)
|
|
|
|
Known working Zigbee radios:
|
|
|
|
- Nortek/GoControl Z-Wave & Zigbee USB Adapter - Model HUSBZB-1
|
|
- XBee Series 2C
|
|
- [Elelabs Zigbee USB Adapter](https://elelabs.com/products/elelabs_usb_adapter.html)
|
|
- [Elelabs Zigbee Raspberry Pi Shield](https://elelabs.com/products/elelabs_zigbee_shield.html)
|
|
|
|
## {% linkable_title Configuration %}
|
|
|
|
To configure the component, a `zha` section must be present in the `configuration.yaml`,
|
|
and the path to the serial device for the radio and path to the database which will persist your network data is required.
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
zha:
|
|
usb_path: /dev/ttyUSB2
|
|
database_path: /home/homeassistant/.homeassistant/zigbee.db
|
|
```
|
|
|
|
{% configuration %}
|
|
radio_type:
|
|
description: One of `ezsp` or `xbee`.
|
|
required: false
|
|
type: string
|
|
default: ezsp
|
|
usb_path:
|
|
description: Path to the serial device for the radio.
|
|
required: true
|
|
type: string
|
|
baudrate:
|
|
description: Baud rate of the serial device.
|
|
required: false
|
|
type: integer
|
|
default: 57600
|
|
database_path:
|
|
description: _Full_ path to the database which will keep persistent network data.
|
|
required: true
|
|
type: string
|
|
{% endconfiguration %}
|
|
|
|
To add new devices to the network, call the `permit` service on the `zha` domain, and then follow the device instructions for doing a scan or factory reset. In case you want to add Philips Hue bulbs that have previously been added to another bridge, have a look at: [https://github.com/vanviegen/hue-thief/](https://github.com/vanviegen/hue-thief/)
|