Page 1
ZB-Stick with Home Assistant This document describes how to use POPP ZB-Stick with existing Home Automation platform called Home Assistant (Hass.io) (https://www.home-assistant.io/). POPP ZB-Stick firmware version, referenced in this guide: 6.3.0 Home Assistant (Hass.io) software version, referenced in this guide: 0.112.4...
Page 2
Introduction POPP ZB-Stick 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 ZB-Stick with Home Assistant rev. 0.4 | 2...
Page 3
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/). ZB-Stick with Home Assistant rev. 0.4 | 3 popp.eu...
Page 4
Connect POPP ZB-Stick to 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 Navigate to the Supervisor -> System -> Hardware menu...
Page 5
Zigbee HA Component configuration To work with POPP ZB-Stick 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...
Page 6
Select Enter Manually Select EZSP radio type Enter /dev/ttyUSB0 as Serial Port and select Baud rate 115200 ZB-Stick with Home Assistant rev. 0.4 | 6 popp.eu...
Page 7
The installation should be successful Now the Zigbee Integration should appear: ZB-Stick with Home Assistant rev. 0.4 | 7 popp.eu...
Page 8
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 ZB-Stick with Home Assistant rev. 0.4 | 8 popp.eu...
Page 9
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” ZB-Stick with Home Assistant rev. 0.4 | 9 popp.eu...
Page 10
During this period, you need to follow Device manual to put it in Pairing mode. Sometimes you just need to give it power. If the device is found, you will be able to see it in the logs (example device) ZB-Stick with Home Assistant rev. 0.4 | 10 popp.eu...
Page 11
Open Configuration and go to Devices. Select the device, which you would like to remove Once you call this service you can verify in the logs, that the device has left the network. ZB-Stick with Home Assistant rev. 0.4 | 11 popp.eu...
Page 12
Call Add Devices service as explained in Add devices section of this guide Power ON the Lightbulb Confirm it is added to the Home Assistant Now you can control it directly or use in the scenarios. ZB-Stick with Home Assistant rev. 0.4 | 12 popp.eu...
Troubleshooting If your issue is not described here or you need help resolving it, please contact support at info@popp.eu ZB-Stick with Home Assistant rev. 0.4 | 13 popp.eu...
Need help?
Do you have a question about the ZB-Stick and is the answer not in the manual?
Questions and answers