RBK-ZW500DEV-CON2

MSRP $1000.00

Z-Wave 500 Series Controller Development Kit

Easily Create Feature-rich, IoT-enabled Z-Wave Controllers

The Z-Wave controller developers kit gives you the fastest and easiest path to develop feature rich Z-Wave controller applications. It includes both the Z/IP Gateway and Z-Ware offering as full source code releases, which you can use and/or modify for your own Z-Wave Controller products.

MSRP $1000.00

 

Hardware for the CE SDK

  • 3 x UZB USB Stick Bridge Controller
  • 1 x E HW – contains EU protocol
  • 1 x U HW – contains US protocol
  • 1 x H HW – contains JP protocol
  • 1 x TI BeagleBone™ Black

Hardware for the Portal SDK

  • Z-Ware Middleware running on Beaglebone™ Black with UZB
  • 1 x E HW – contains EU protocol
  • 1 x U HW – contains US protocol
  • 1 x H HW – contains JP protocol

Hardware for RF Testing and De-Bugging

  • 3x ZDB5101 E/U/H
  • 1 x UZB-S – USB Stick Network-Sniffer

Key Benefits

  • Faster time to market
  • Reduced development cost
  • Rapid IoT gateway development
  • SDKs contains full source code
  • One kit covers all Z-Wave regions
  • Access to Z-Wave technical website
  • Industry-standard TI BeagleBone™
  • License to use Z-Wave technology world-wide

Target Applications

  • Gateways
  • Set-top boxes
  • Televisions
  • Consumer electronics
  • Cloud-based services

Step 1: Download Software

The SDK contains pre-compiled binaries for instant use of the Z/IP Gateway, along with the full source code.

Download Ubuntu from Ubuntu official website.

The Z/IP Gateway is a developed for Ubuntu Linux, and will also run on virtual machines. For development purposes we recommend using Oracle VM VirtualBox, if a dedicated Ubuntu Linux computer is not available. This guide is based on Ubuntu 16.04.4, which was released March 1, 2018.

If needed, download Oracle VM VirtualBox.
 

Step 2: Run Software

Z/IP Gateway Running on Ubuntu Linux

This section guides you through the following:

  • Step 1: Install the Z/IP Gateway
  • Step 2: Configure the Z/IP Gateway
  • Step 3: Start the Z/IP Gateway Service
     

Step 1: Install the Z/IP Gateway

a. Update

$ sudo apt-get update

b. Install dependencies

$ sudo apt-get install libusb-1.0-0:i386 libssl1.0.0:i386 radvd:i386 parprouted:i386 bridge-utils:i386

c. Install Z/IP Gateway Debian package

$ sudo dpkg -i zipgateway-2.81.0-Linux-i386.deb

Installation might fail if any of the Z/IP Gateway dependencies are not installed because of any reason. Steps below can this issue by installing the dependencies automatically.

$ sudo apt-get update $ sudo apt-get -f install

d. Installation wizard prompts for the following information

Serial port for the Z-Wave Controller. The default value is ‘ttyACM0’ which is usually correct when using the UZB Bridge Controller that ships with the Developer Kit. This guide demonstrates the use of a Z-Wave module programmed with the Serial API Bridge Controller (part of the Embedded SDK), which usually maps to ‘ttyUSB0’. This setting can be changed later, when the correct port has been found.

IPV6 address of Z/IP Gateway. Leave default.

IPV6 prefix of Z-wave Network. Leave default.

The type of network interface: ‘wireless’ or ‘wired’. The network interface in question here is the interface where Z/IP Gateway will listen for Z/IP Client connection requests. This guide is using ‘wired’.

e. Reboot system Because of various network configuration changes, its strongly recommended that the system is rebooted after Z/IP Gateway installation.
 

Step 2: Configure the Z/IP Gateway

a. Plug in hardware.

Plug in the Z-Wave Bridge Controller.

Determine which port the USB device is using, by using the following command after the USB device was plugged in:

$ dmesg | grep tty

In this guide, devices are both attached to ‘ttyACM0‘ and ‘ttyUSB0’. Be sure to choose the correct port. If you are unsure which port to use, disconnect your device and run the command again. In this guide, we are using ‘ttyUSB0’.

b. Configuration file

In case the port differs from the one during installation, the Z/IP Configuration file needs to be changed. The config-file is located:

/usr/local/etc/zipgateway.cfg

Nano can be used as editor, which comes preinstalled on Ubuntu. Change the variable ‘ZipSerialAPIPortName’.

A simpler user interface for changing the port can be found by calling the following command, which will ask the same questions as while installing:

$ sudo dpkg-reconfigure zipgateway
 

Step 3: Start the Z/IP Gateway Service

The Z/IP Gateway service can be controlled with these commands:

$ sudo /etc/init.d/zipgateway start

$ sudo /etc/init.d/zipgateway stop

$ sudo /etc/init.d/zipgateway restart

$ sudo /etc/init.d/zipgateway status

In another terminal, open up the Z/IP Gateway log file:

$ sudo tail -f /tmp/zipgateway.log

If the following message show, some settings are not correct, or the USB device is not plugged in:

Change the port name and / or plug in the USB, and then restart the service. The log file should start writing a lot of log information, indication the connection is successful. Check the status of the service. If the status us ‘exited’, the service is not running. The status should show ‘running’.

The Z/IP Gateway Service is now up and running!

 

Z/IP Gateway Running on Beaglebone

When you connect the Beaglebone to Linux/Widows PC with the mini-USB cable, it creates network interface with IP 192.168.7.1 for your Linux/Windows PC and Beaglebone itself has IP 192.168.7.2. In addition, make sure to connect an ethernet cable to download the necessary dependencies.

Warning: Only Beaglebone with Debian version 8.3 is supported. Download from Beaglebone website.
 

Step 1: Install the Z/IP Gateway on the Beaglebone

a. Connect to the Beaglebone

On your Linux PC run following command to connect (ssh) to Beaglebone.

$ ssh -l root 192.168.7.2

Make sure you are using Debian version 8.3, as that is the only version currently supported.

$ cat /etc/debian_version

b. Copy the Z/IP Gateway Debian package to the Beaglebone

On your Linux PC, navigate to the Debian package and run following command to copy the Z/IP Gateway Debian package.

$ scp zipgateway-2.81.0-Linux-armhf.deb root@192.168.7.2:

c. Install the Z/IP Gateway on the Beaglebone

In the terminal from Step 1, do the following:

$ sudo apt-get update

$ sudo apt-get install libusb-1.0-0 libssl1.0.0 radvd parprouted bridge-utils

$ sudo dpkg -i zipgateway-2.81.0-Linux-armhf.deb
 

Step 2: Configuration and start of service

Refer to steps in the guide above for Ubuntu Linux.

 

PyZ/IP Client

PyZ/IP is a GUI application written in python. You may use PyZ/IP to manage and test your Z-Wave network.

This guide will demonstrate how to install the client on Ubuntu Linux, but it can also be installed on Windows. Refer to the documentation (see below) for instructions.
 

Step 1: Source code

When downloading the Gateway SDK, part of this package is the source code for the PyZ/IP Client. Extract the files, and change the directory to the uncompressed files:

$ unzip pyzip_ver1_11b.zip

$ cd pyzip
 

Step 2: Install

Python. Set the PYTHONPATH to where the Pyzip sources are uncompressed, and install Python.

$ export PYTHONPATH=$PWD

$ sudo apt-get install python-wxgtk3.0
 

Step 3: Run the application

$ cd pyzip

$ python2 gui.py
 

Step 4: Setup the network

The PyZ/IP client is now running, and will automatically detect the gateway. Connect to it, and start adding nodes to the network.

Step 3: Building the Documentation

The Z/IP Gateway SDK comes with a lot of documentation. The documentation needs to be build using Doxygen, which generates a set of HTML files. The documentation contains getting starting information, similar to this guide, along with further troubleshooting steps. It also contains documentation for the source code.
 

Step 1: Install dependencies

32-bit Ubuntu

$ sudo apt-get install doxygen roffit cmake gcc libssl-dev libusb-1.0- 0-dev libc6-dev bison flex

64-bit Ubuntu

$ sudo apt-get install doxygen roffit cmake gcc libssl-dev libssl-dev:i386 libusb-1.0-0-dev:i386 libusb-1.0-0-dev libc6-dev-i386 bison:i386 flex:i386
 

Step 2: Build documentation

Navigate to the source code directory, and create a new folder called ‘build’, and enter that folder:

$ mkdir build

$ cd build/

Make the documentation:

$ cmake ..

$ make doc
 

Step 3: Refer to the user guide for detailed description on compiling and using Z/IP Gateway

Open src/doc/html/index.hml in browser.

$ xdg-open src/doc/html/index.html

Next step, download the Z-Ware SDK to start developing your own Z/IP Client.

Knowledge Base Articles

Browse our knowledge base articles for information about specific products.

View Knowledge Base

User Forums

Browse technical questions, share your ideas, and learn more about our latest solutions.

Search the forums

Still need help?

Contact technical support or review a case.

Request Support
Close
Loading Results