Elelabs ELU013 Manual de usuario
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 1
UG11: HOME ASSISTANT
This document describes how to use Elelabs Zigbee USB Adapter
(https://elelabs.com/products/elelabs_usb_adapter.html) with existing Home Automation platform
called Home Assistant (Hass.io) (https://www.home-assistant.io/).
Elelabs Zigbee USB Adapter firmware version, referenced in this guide: 6.3.0
Home Assistant (Hass.io) software version, referenced in this guide: 0.112.4
This guide focuses on:
-Connect Elelabs USB adapter to the target PC or Raspberry Pi
-Setup Zigbee Home Automation component in Home Assistant
-Troubleshooting
-Zigbee devices Pairing and Removal
-Zigbee devices examples
This guide DOES NOT focus on Home Assistant (Hass.io) installation and initial configuration. Please
follow the official instructions https://www.home-assistant.io/hassio/installation/.
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 2
Table of Contents
Introduction.......................................................................................................................................................................... 3
Initial setup and connection........................................................................................................................................... 4
Connect Elelabs USB Adapter to your Raspberry Pi or PC............................................................................... 4
Zigbee HA Component configuration.......................................................................................................................... 6
Configure Zha component .......................................................................................................................................... 6
Setup Logging (optional)............................................................................................................................................. 8
Zigbee HA Component Usage ......................................................................................................................................10
Add your devices to the Home Assistant .............................................................................................................10
Remove your device from Home Assistant .........................................................................................................11
Example: Philips Hue Bulb .......................................................................................................................................13
Example: Xiaomi Smoke Sensor .............................................................................................................................14
Troubleshooting................................................................................................................................................................15
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 3
Introduction
Elelabs Zigbee USB adapter can be used in 2 options with Home Assistant:
With a generic Linux machine, with Home Assistant installed
With a Raspberry Pi (any other single board computer) with Home Assistant installed
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 4
Initial setup and connection
This guide does not cover Home Assistant (Hass.io) installation. We assume, that you can access
Home Assistant Web Interface using your browser.
It is highly recommended to have SSH Server and Configurator addons installed, at least during the
Zigbee setup phase. To install them just follow the Hass.io installation guide (https://www.home-
assistant.io/hassio/installation/).
Connect Elelabs USB Adapter to your Raspberry Pi or PC
Once you have inserted the USB adapter, check the configuration.
-Wait for Hass.io to boot
-Connect to the web interface using your favourite browser
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 5
-Navigate to the Supervisor -> System -> Hardware menu
-Confirm the USB Adapter is detected and visible as serial ports (/dev/ttyUSB0 and in this
example)
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 6
Zigbee HA Component configuration
To work with Elelabs Zigbee USB Adapter from Home Assistant we are using Zigbee Home
Automation Component (https://www.home-assistant.io/components/zha/). It comes preinstalled
into Hass.io so we only need to configure it properly to get it working.
Configure Zha component
To setup Zigbee Home Automation component to work properly with Elelabs Zigbee Adapter we
need to:
-Navigate to the Configuration -> Integrations
-Add new Integration and search for Zigbee Home Automation
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 7
-Select Enter Manually
-Select EZSP radio type
-Enter /dev/ttyUSB0as Serial Port and select Baud rate 115200
-The installation should be successful
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 8
Now the Zigbee Integration should appear:
Setup Logging (optional)
To spot any potential issues it is good practice to enable logging, at least during the setup and
installation period. To do it, just add the following lines to the configuration file
/config/configuration.yaml:
logger:
default: warn
logs:
homeassistant.components.zha: debug
bellows.ezsp: debug
bellows.uart: debug
zigpy.zdo: debug
zigpy.application: debug
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 9
elelabs.com UG11: Home Assistant with Elelabs USB adapter rev. 0.4 | 10
Zigbee HA Component Usage
Once Zigbee Component is added and configured properly you can start to use it.
Add your devices to the Home Assistant
Open Configuration and go to Devices and Zigbee Coordinator
Start “Add Devices via this device”
When you will call it, you have 60 seconds to add the device.
Tabla de contenidos
