AeoTec Zi-Stick USB Controller User Guide

: June 13, 2024
: Aeotec

Table of Contents

AeoTec Zi-Stick USB Controller
Product Information
Product Usage Instructions
Important safety information
Advanced
References
Read User Manual Online (PDF format)
Download This Manual (PDF format)

AeoTec Zi-Stick USB Controller

AeoTec-Zi-Stick-USB-Controller-PRODUCT-IMG

Product Information

The Zi-Stick is a self-powered Zigbee 3.0 USB Adapter developed by Aeotec. It is designed to control actuators and sensors in a Zigbee 3.0 Network. The technical specifications of the Zi-Stick can be viewed here.

Important safety information:

Keep the product away from open flames and extreme heat.
Avoid direct sunlight or heat exposure.
Improper battery use may damage the product.
The Zi-Stick is intended for indoor use in dry locations only.
Do not use it in damp, moist, and/or wet locations.

Product Usage Instructions

Quick Start

To use the Zi-Stick when it is attached to a host controller (PC) as a primary controller, follow these steps:

Plug the Zi-Stick into a host controller (e.g., PC, Mac, RPi).
- For Windows: Open Device Manager and go to Ports (COM & LPT). The Zi-Stick will be listed as a COMX device (where X can be a number value range of 0 – 1000).
- For Linux: Open your command prompt and type “dmesg | grep tty” to get a list of all tty devices connected. The Zi-Stick will show as a ttyUSB0 device.
- For OSX: Choose Apple > System Preferences, then click
  Network. You can find the Zi-Stick listed as a USB Modem device/dev/cu.usbmodem.
Open the selected third-party software that you want to use with the Zi-Stick.
- For instructions on using Home Assistant, refer to Home Assistant installation.
- For instructions on using OpenHAB, refer to OpenHAB installation.
In most cases, devices already paired with the Zi-Stick network will automatically show up in the software’s interface. If necessary, you may need to rescan the Zi-Stick to detect devices it has not previously detected.

Advanced

In most cases, you do not need to install drivers for the Zi-Stick as most operating systems have the necessary drivers. However, if the drivers are not installed on your OS, you can find the serial bridge drivers here.

Zi-Stick user guide

Modifi ed on: Thu, 2 Mar, 2023 at 10:09 PM

AeoTec-Zi-Stick-USB-Controller-FIG-1

Zi-Stick was developed to control actuators and sensors in a Zigbee 3.0 Network as a self-powered Zigbee 3.0 USBAdapter.
The technical specifications of Zi-Stick (https://aeotec.freshdesk.com/a/solutions/articles/6000263591) can be viewed atthat link.

Important safety information

Please read this and other device guides carefully. Failure to follow the recommendations set forth by Aeotec Limited maybe dangerous or cause a violation of the law.
The manufacturer, importer, distributor, and/or reseller will not be heldresponsible for any loss or damage resulting from not following any instructions in this guide or in other materials.
Keep product away from open flames and extreme heat. Avoid direct sunlight or heat exposure. Improper battery use maydamage the product.
Zi-Stick is intended for indoor use in dry locations only. Do not use it in damp, moist, and/or wet locations.

Quick start
The following will step you through using Zi-Stick when it is attached to a host controller (PC) as a primary controller.
Please make sure the host controller is pre-installed; this includes any drivers that the corresponding OS may need. In most cases, the host controller automatically installs the required USB drivers.
If not, the USB driver can be downloaded from www.silabs.com (https://www.silabs.com/) part CP2102N which can be found here: SiLabs CP2102N Driver (https://www.silabs.com/products/development-tools/software/usb-to-uart- bridge-vcpdrivers).

Plug Zi-Stick into a host controller (that can be a PC, Mac, RPi, etc).
- Windows – Open up “Ports (COM & LPT” under Device Manager. The Zi-Stick shows as a COMX device (where X can be a number value range of 0 – 1000).
- Linux – under your command prompt, type in “dmesg | grep tty” which will give you a list of all tty devices connected. Zi-Stick will show as a “ttyUSB0” device.
- OSX – Choose Apple > System Preferences, then click “Network”. You can find Zi-Stick as a USB Modem device “/dev/cu.usbmodem”.
Open the selected third-party software. You can find some instructions for some popular third-party software here:
- Home Assistant installation (https://www.home-assistant.io/installation/)
- OpenHAB installation (https://www.openhab.org/docs/installation/)
Following your third-party software instructions for connecting a ZigBee USB adapter. Select the COM or virtual port Zi-Stick is associated with. (You can refer to home assistant and openHAB setup articles in the section
- “Current compatible software and setup guides”).
- Setup Zi-Stick with Home Assistant (https://aeotec.freshdesk.com/a/solutions/articles/6000261821) (https://aeotec.freshdesk.com/a/solutions/articles/6000261822) Setup Zi-Stick with OpenHAB (https://aeotec.freshdesk.com/a/solutions/articles/6000261822)

In most cases, any devices already paired with Zi-Stick network will automatically show up in the software’s interface, it may require you to rescan the Zi-Stick in order to re-detect devices it has not detected before.

Advanced

Drivers for Zi-Stick

Typically you do not need to install drivers, most operating systems will have the drivers necessary to run the Zi-Stick.
But in some cases these drivers may not be installed on some OS systems, you can find the serial bridge drivers here:
https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers (https://www.silabs.com/developers/usb-touart-bridge-vcp-drivers) (https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)
(https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)

Current compatible software and setup guides
Zi-Stick will be used with your software of choice. Below is a list of all the known software that is compatible with Zi-Stick and how to set them up.