thing-it-device-z-wave

    0.1.6 • Public • Published

    thing-it-device-z-wave

    NPM NPM

    [thing-it-node] Device Plugin for arbitrary Z-Wave networks and their devices.

    This allows you to

    • control Z-Wave-enabled devices over the Internet,
    • define complex scenes, storyboards and timer controlled execution

    by means of thing-it-node and thing-it.com.

    As you can combine Z-Wave devices with other devices and can orchestrate scenarios across locations, this goes far beyond what Z-Wave networks allow you to do with scenes and alerts.

    Installation

    Installation of Open Z-Wave

    Linux

    The [thing-it] team is testing with a Aeon Labs Z-Wave Z-Stick Series 2 USB Dongle. Most Linux distributions such as Raspbian Jessie require no driver installation. [thing-it] expects the USB stick to be found at "/dev/ttyUSB0".

    You will need to ensure the OpenZWave library and headers are installed first. You can do this one of two ways:

    • Downloading the source tarball from the OpenZWave repository and then compiling it and installing on your system via make and sudo make install.
    • You could also install OpenZWave via a precompiled package that's suitable for your Linux distribution and architecture. Notice: Be sure to install BOTH the binary (libopenzwave-x.y) AND the development package (libopenzwave-dev).

    OSX

    The [thing-it] team is testing with a Aeon Labs Z-Wave Z-Stick Series 2 USB Dongle. On Mac OSX this dongle requires the installation of a driver which can be found on the support section of Aeon Lab's website. [thing-it] is going to try to communicate with the driver via "/dev/cu.SLAB_USBtoUART".

    You will need to ensure the OpenZWave library and headers are installed first. You can do this one of two ways:

    • Downloading the source tarball from the OpenZWave repository and then compiling it and installing on your system via make and sudo make install.
    • You could also install OpenZWave via a precompiled package that's suitable for your Linux distribution and architecture. Notice: Be sure to install BOTH the binary (libopenzwave-x.y) AND the development package (libopenzwave-dev).

    If an error related to pkg-config occurs during the build process, perform the following steps and try again.

    • brew uninstall pkg-config
    • brew install pkg-config
    • brew unlink pkg-config && brew link pkg-config

    Windows

    Since there is no standard installation location for Open Z-Wave on Windows, it will be automatically downloaded, compiled, and installed when you install openzwave-shared via npm (see below).

    Installation of NodeJS and [thing-it-node]

    First, install nodejs on your computer (e.g. your PC or your Raspberry Pi).

    Then install [thing-it-node] via

    npm install -g thing-it-node
    

    Initialization and Start of [thing-it-node]

    The [thing-it-device-z-wave] Plugin is installed with [thing-it-node], hence there is no need to install it separately.

    The Plugin supports Autodiscovery for an existing Z-Wave network and its devices, hence you only have to create a directory in which you intend to run the configuration, e.g.

    mkdir ~/hue-test
    cd ~/hue-test
    

    and invoke

    tin init
    

    and then start [thing-it-node] via

    tin run
    

    Install the thing-it Mobile App from the Apple Appstore or Google Play and set it up to connect to [thing-it-node] locally as described here or just connect your browser under http://localhost:3001.

    Z-Wave Setup

    Procure a Z-Wave USB Stick e.g. the (Aeonlab Z-Stick)[http://aeotec.com/z-wave-usb-stick] and connect it to the USB port of your node computer. Make sure that you have the latest driver installed and identify the device the stick is connected to.

    Examples are:

    • /dev/ttyUSB0 on Linux/Mac OS or
    • /dev/cu.SLAB_USBtoUART on Linux/Mac OS or
    • \\.\COM3 on Windows.

    Follow the instructions for your stick to pair Z-Wave devices.

    If you start [thing-it-node] after configuring your Z-Wave network will automatically add all Z-Wave devices to your [thing-it-node] Configuration and you will be able control these from the [thing-it] Mobile App immediately.

    Mobile UI

    The following screenshot shows a few typical Z-Wave devices in the [thing-it] Mobile UI:

    • Binary power switch with electricity consumption measurement
    • Multilevel switch, often used as dimmer, with the ability to switch on and off as well as setting the level
    • Multilevel sensor with temperature, luminance and humidity data

    Tested Devices

    The following Devices have been tested regarding

    • Autodiscovery,
    • State Change Detection and
    • Service Invocation:
    Device Device Class Manufacturer Details
    Aeotec Z-Stick Controller Aeon Labs
    Aeotec Gen5 Z-wave Plus 6-in-1 Multisensor 6 ZW100-A Multisensor Aeon Labs
    DSC06106-ZWUS - Z-Wave Smart Energy Switch Switch Aeon Labs
    CT-100 Thermostat Thermostat Radio Thermostat
    GoControl Z-Wave Dimmable LED Light Bulb Light Bulb GoControl

    Where to go from here ...

    After completing the above, you may be interested in

    Install

    npm i thing-it-device-z-wave

    DownloadsWeekly Downloads

    15

    Version

    0.1.6

    License

    none

    Unpacked Size

    1.08 MB

    Total Files

    25

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar