Site Tools


This is an old revision of the document!

To run unit tests, please do the following:

  1. At root of repository/project directory issue command: "scons TEST=1"

To set up your environment and run the sample applications please follow below instructions:

First and foremost you will need a Telegesis USB Dongle. The model I used during development was a Telegesis USB Dongle “ETRX357USB-LR”. The firmware on this dongle will need to be upgraded. This firmware will need to be obtained through contacting the sales team at Telegesis’ website (we used this link to find a sales representative for our devices: You will need to ask for a firmware upgrade to version 3.10 (known as R310). The stock firmware version will not work as it only supports a subset of the required full functionality used in our plugin architecture.

From here on out this “ETRX357USB-LR” module will be referred to as Telegesis Dongle, Telegesis USB Dongle, or USB Dongle.

  1. If using Linux you will need to ensure your user is a part of the “dialout” group. You can do this on Ubuntu by issuing command “sudo adduser <MY_USER_NAME> dialout” and then restart your computer.
  2. Ensure you’re building the sample applications by issuing the following build command at the root of the IoTivity repository/project directory: “scons plugins”
  3. cd <IOTIVITY>/out/linux/<ARCH_TYPE>/<DEBUG_or_RELEASE>/plugins/samples/linux/
  4. Turn on/Reset any of the devices (only required once as the Telegesis Dongle remembers it’s pairings from last time) from the below table.
  5. issue following command to start the server: ./iotivityandzigbeeserver
  6. Wait >20 seconds to ensure that discovery and pairing has occurred in the server.
  7. In different terminal, issue the following command to start the client: ./iotivityandzigbeeclient
  8. Wait for client to discover resources types from the following table. You can use the commands in the client application to control ZigBee devices now.
Physical Device (You can buy this on the market) ZigBee Cluster IDs Supported OCF Smart Home Resource Types Supported
SmartThings Water Leak Sensor 0x0402, 0x0500 oic.r.temperature,
SmartThings Open/Close Sensor (Multipurpose) 0x0402, 0x0500 oic.r.temperature,
SmartThings Motion Sensor 0x0402, 0x0500 oic.r.temperature,
SmartThings Smart Plug 0x0006 oic.r.binary.switch
OSRam Lightify Light Bulb 0x0008, 0x0006 oic.r.light.dimming, oic.r.binary.swtich
GE Wink Light Bulb 0x0008, 0x0006, 0x0300 oic.r.light.dimming, oic.r.binary.swtich, oic.r.colour.chroma (Invalid Mapping)
ZigBee Cluster ID ZigBee Cluster Name OCF Smart Home Resource
0x0402 Temperature Cluster oic.r.temperature
0x0008 Level Control Cluster oic.r.light.dimming
0x0006 On Off Cluster oic.r.binary.switch
0x0500 IAS Zone Cluster (Motion Sensor, Contact Sensor, Water Sensor)
0x0300 Color Control Cluster oic.r.colour.chroma (Invalid Mapping)

ZigBee Cluster Reference:

OCF Resource Reference:

zigbee_plugin_-_using_plugin_interface_module.1463430505.txt.gz · Last modified: 2016/05/16 20:28 by josephlm