0.1.6 • Published 6 years ago

thing-it-device-z-wave v0.1.6

Weekly downloads
218
License
-
Repository
github
Last release
6 years ago

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:
DeviceDevice ClassManufacturerDetails
Aeotec Z-StickControllerAeon Labs
Aeotec Gen5 Z-wave Plus 6-in-1 Multisensor 6 ZW100-AMultisensorAeon Labs
DSC06106-ZWUS - Z-Wave Smart Energy SwitchSwitchAeon Labs
CT-100 ThermostatThermostatRadio Thermostat
GoControl Z-Wave Dimmable LED Light BulbLight BulbGoControl

Where to go from here ...

After completing the above, you may be interested in

0.1.6

6 years ago

0.1.5

6 years ago

0.1.4

6 years ago

0.1.3

6 years ago

0.1.2

6 years ago

0.1.1

6 years ago

0.0.39

7 years ago

0.0.38

7 years ago

0.0.37

7 years ago

0.0.33

8 years ago

0.0.32

8 years ago

0.0.29

8 years ago

0.0.28

8 years ago

0.0.27

8 years ago

0.0.26

8 years ago

0.0.25

8 years ago

0.0.24

8 years ago

0.0.23

8 years ago

0.0.22

8 years ago

0.0.21

8 years ago

0.0.20

8 years ago

0.0.19

8 years ago

0.0.18

8 years ago

0.0.17

8 years ago

0.0.16

8 years ago

0.0.15

8 years ago

0.0.14

8 years ago

0.0.13

8 years ago

0.0.12

8 years ago

0.0.11

8 years ago

0.0.10

8 years ago

0.0.9

8 years ago

0.0.8

8 years ago

0.0.7

8 years ago

0.0.5

8 years ago

0.0.4

8 years ago

0.0.3

8 years ago

0.0.2

8 years ago