jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-06 02:58:57 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_components/zwave.markdown

1.6 KiB
Raw Blame History

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category
layout title description date sidebar comments sharing footer logo ha_category
component Z-Wave Instructions how to integrate your existing Z-Wave within Home Assistant. 2015-03-23 19:59 true false true true z-wave.png Hub

Z-Wave integration for Home Assistant allows you to observe and control connected Z-Wave devices. Z-Wave support requires a supported Z-Wave USB stick to be plugged into the host.

There is currently support for switches, lights and sensors. All will be picked up automatically after configuring this platform.

Installation

To allow Home Assistant to talk to your Z-Wave USB stick you will have to compile Python Open Z-Wave. This can be done using this script. (The Home Assistant docker image has support for Z-Wave built-in)

Make sure you have the correct dependencies installed before running the script:

$ apt-get install cython3 libudev-dev python-sphinx python3-setuptools
$ pip3 install "cython<0.23"

Configuration

# Example configuration.yaml entry
zwave:
  usb_path: /dev/ttyUSB0
  config_path: /usr/local/share/python-openzwave/config

Configuration variables:

  • usb_path (Required): The port where your device is connected to your Home Assistant host.
  • config_path (Optional): The path to the Python Open Z-Wave configuration files.

To find the path of your Z-Wave stick, run:

$ ls /dev/ttyUSB*