On/Off Server Switch ZED

• Introduction
• Software Prerequisites
• Functional Description
  • Software Overview
    • Application Files
• Configuration With SysConfig
• Example Usage
  • Buttons
  • Commissioning the Device Into the Network

Introduction

This document discusses how to use the On/Off Server Switch ZED Sample App and the different parts that compose it. On/Off Server Switch Sample Application is an example that exercises different features of TI Zigbee for a Zigbee End Device (ZED) implementation.

Some of the features exercised include:

• Zigbee End Device commissioning
• Switch device that acts as Initiator of Finding and Binding
• On/Off Toggle data frame

Software Prerequisites

• Code Composer Studio™ (CCS) v12.7 or newer

• SimpleLink™ LOWPOWER SDK

Functional Description

Software Overview

This section describes the software components and the corresponding source files.

Application Files

The On/Off Server Switch ZED Sample App works in conjuction with a Zigbee Coordinator (ZC), which is assumed to have formed a Zigbee network that the On/Off Server Switch ZED can join. For this, the On/Off Server Output ZC Sample App can be used. Upon startup, On/Off Server Switch ZED sends a commissioning request to attempt to join the network. Once it has joined the network successfully, BTN1 on the Launchpad can be pressed to send a Toggle command.

• on_off_switch.c: Contains the application's event loop, device initialization function calls, and commissioning and on/off toggle command specific logic.

Configuration With SysConfig

SysConfig is a GUI configuration tool that allows for TI driver and stack configurations.

To configure using SysConfig, import the SysConfig-enabled project into CCS. Double click the *.syscfg file from the CCS project explorer, where * is the name of the example project. The SysConfig GUI window will appear, where Zigbee stack and TI driver configurations can be adjusted. These settings will be reflected in the generated files.

The example project comes with working default settings for SysConfig. For the purposes of this README, it is not recommended to change the default driver settings, as any changes may impact the functionality of the example. The Zigbee stack settings may be changed as required for your use case.

Note that some Zigbee settings are stored in non-volatile storage, and Zigbee prioritizes stored settings over SysConfig settings. To guarantee SysConfig settings are applied, perform a factory reset of the device to clear non-volatile storage.

Example Usage

This section describes how to use this sample application.

Buttons

• BTN-1: Sends On/Off Toggle commands

Commissioning the device Into the network

Zigbee End Devices can only join networks. At startup, the On/Off Server Switch ZED Sample App goes into ZB_BDB_NETWORK_STEERING mode where it will first send a Beacon Request, wait for beacons, and then send a Network Commissioning Request packet to a ZC/ZR. The ZR/ZC then responds and the commissioning process will continue until the ZED is joined into the network.