Define a network Z-Wave with Aeotec Z-Stick (or similar) e Home Assistant

4 minutes of reading
  • Create a network Z-Wave domestic to integrate accessories based on this standard a Home Assistant
  • Difficulty level: bass
  • Software use and configuration
GUIDE more indicated for:

All environments

Notes and disclaimer
  • qualsiasi modifica all'impianto elettrico dev'essere progettata ed effettuata da personale qualificato;
  • any changes implemented in probefore is a propersonal responsibility as well as a profirst risk and danger (the contents of the present page are purely educational);
  • any changes implemented in proprior to a device it voids the guarantee, quality approvals and certifications.
Driving review: 1.1


The networks Z-Wave I am particularly apprezzed for two main factors: possibility of covering a large area (thanks to the adoption of a network topology mesh type) is ease of use of the hundreds of devices compatible with this standard.

Z-Wave More

The concept of "mesh network"Comes appused by exploiting the capacity of the components Z-Wave (only those powered by mains, not battery-powered) to serve not only as home automation accessories, but also from "signal repeaters", thus creating an "umbrella" of signal as wide as they are, appgreased, these repeaters and obviously based on what are the constructive characteristics of the environment (beams, floors, walls, installations etc.).

To check through Home Assistant of the components Z-Wave it is necessary that the computer on which theHUB have access, somehow, to the network Z-Wave on which the accessories are connected. To make this happen, it is sufficient to connect to the computer an element that allows to appear to this network, thus givingHUB the possibility of contacting the accessories.

If the computer it has its own controller Z-Wave, all the better. In the case of the most used computer to implement Home Assistant – Raspberry Pi - this element is not available and therefore it is necessary to add one. Home Assistant can control a large number of different external controllers; in this guide we will see in detail how to implement theAeotec Z-Stick, although the described technique is substantially the same for all other compatible models.

Controller connection

Applect the controller Z-Wave on the computer it is simple: just connect it to one of the USB ports, any one.

Before doing so, however, it is convenient to reset the stick in order to be certain of giving life to a new network Z-Wave scratch. To do this it is sufficient hold down the small button on the back of the stick (hidden in a small hole): the LED on the back will begin to flash red light with an increasing rhythm, until finally thelumiit will turn blue and then go out. At that point Aeotec Z-Stick will have been reset and can be connected to the computer. Once done, restart the latter.


Once the controller is connected Z-Wave and restarting the computer it is necessary to understand to which logical port has been associated.

sudo nano

and copy inside the editor that will open the following code:


for sysdevpath in $(find /sys/bus/usb/devices/usb*/ -name dev); do
        devname="$(udevadm info -q name -p $syspath)"
        [[ "$devname" == "bus/"* ]]
        eval "$(udevadm info -q property --export -p $syspath)"
        [[ -z "$ID_SERIAL" ]]
        echo "/dev/$devname - $ID_SERIAL"

Then exit and save (CTRL-X, Y, enter).
Then execute the following commands:

sudo chmod 777 

The second command will execute the script, which will report an output similar to the following:

/dev/bus/usb/001/001 - Linux_4.19.81-v7+_dwc_otg_hcd_DWC_OTG_Controller_3f980000.usb
/dev/bus/usb/001/007 - dresden_elektronik_ingenieurtechnik_GmbH_ConBee_II_DE2119893
/dev/ttyACM1 - dresden_elektronik_ingenieurtechnik_GmbH_ConBee_II_DE2119893
/dev/bus/usb/001/003 - 0424_2514
/dev/bus/usb/001/006 - 0424_7800
/dev/bus/usb/001/002 - 0424_2514
/dev/ttyACM0 - 0658_0200
/dev/bus/usb/001/004 - 0658_0200

The line containing the id0658_0200”(The identification id of the Aeotec Z-Stick Gen5) is the one that identifies the door (in this case the / Dev / ttyACM0).

users HASSIO

Users HASSIO they can more easily identify the door by going to the menu item "">"SYSTEM">"HARDWARE”And examine the list of assigned ports, thus easily identifying the Aeotec Z-Stick.


At this point we are proset to configure Home Assistant. Activate the component "Z-Wave"(Which for theappactivates the functionalities of theHUB for this protocollo) is quite simple: it is sufficient to add the following code to the configuration:

  usb_path: /dev/ttyACM0

where obviously "usb_path"Is a key that tells the component with which USB port to communicate with the controller Z-Wave, in this case "/ Dev / ttyACMx"

Restart Home Assistant.
Caution: the restart may take a long time (variable depending on the performance of the computer on which it is running) Home Assistant) due to the initial installation of the components Z-Wave.

Nb USERS HASSIO@Docker - To guarantee a HASSIO access to the stick, prosee to add "–device= / Dev / ttyACM0"(Or which is the door) at the launch command, example:

docker run -d --name="home-assistant" -v /home/pi/homeassistant:/config -v /etc/localtime:/etc/localtime:ro --net=host --device=/dev/ttyACM0 homeassistant/raspberrypi3-homeassistant


Once activated the support to proProtocol Z-Wave, Home Assistant presents a new entry in the "Settings" menu call, easy to guess, "Z-Wave"

On entering, you will be on the functional management panel of Z-Wave. By clicking on the drop-down menu at "Z-Wave Node Management"- if everything is done correctly - will have to appenter the entry for the first node on the network Z-Wave so defined, or that rappresurrected fromAeotec Z-Stick:

Home Assistant  -  Z-Wave  -  Aeotec Z-Stick Node


At this point the network Z-Wave domestic è pronta: to add new nodes (therefore new accessories) it will be sufficient to click - always on the panel Z-Wave di Home Assistant - on "Add Node"Or"Add Node Secure" is prothen see the association of the accessory in question which is subsequently indicated in the list of operating nodes on the network Z-Wave managed by Home Assistant.

Once a new node (accessory) has been added to the network Z-Wave, Home Assistant behaves accordingly based on the characteristics of the component: if it is, let's say, a switch-type actuator, it is intuitive to imagine that the integration generates entity presso Home Assistant of that type; similarly other types of elements will consequently generate corresponding entities consistent with the profirst nature.

Home Assistant Official LogoATTENZIONE: remember that there is on our FORUM community an ad hoc section dedicated to Home Assistant, for any doubt, question, information on the specific merit of these components.

Please comment below