Popp ZB-Stick User manual

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
This guide focuses on:
-Connect POPP ZB-Stick 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/.
ZB-Stick with Home Assistant

ZB-Stick with Home Assistant
rev. 0.4 | 2
popp.eu
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 | 3
popp.eu
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/).

ZB-Stick with Home Assistant
rev. 0.4 | 4
popp.eu
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
-
-Confirm the USB Adapter is detected and visible as serial ports (/dev/ttyUSB0 and in
this example)

ZB-Stick with Home Assistant
rev. 0.4 | 5
popp.eu
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
To setup Zigbee Home Automation component to work properly with POPP ZB-Stick we
need to:
-Navigate to the Configuration -> Integrations
-Add new Integration and search for Zigbee Home Automation

ZB-Stick with Home Assistant
rev. 0.4 | 6
popp.eu
-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 | 7
popp.eu
-The installation should be successful
Now the Zigbee Integration should appear:

ZB-Stick with Home Assistant
rev. 0.4 | 8
popp.eu
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

ZB-Stick with Home Assistant
rev. 0.4 | 9
popp.eu
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”

ZB-Stick with Home Assistant
rev. 0.4 | 10
popp.eu
When you will call it, you have 60 seconds to add the device.
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 | 11
popp.eu
Remove your device from Home Assistant
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 | 12
popp.eu
Example: Philips Hue Bulb
This example is done with Hue White Single bulb E26 but is applicable to other products as
well.
To control Philips Hue Light bulb using Home Assistant, one first needs to reset it.
Once it is reset, you can follow the regular process to Add it to the Home Assistant.
-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 | 13
popp.eu
Troubleshooting
If your issue is not described here or you need help resolving it, please contact support
at [email protected]