Zigbee Configuration

These instructions cover all Zigbee sample applications. Configurables differ between standard Zigbee device types (ie. Coordinator, Router, End Device, ZNP) and Green Power Devices (GPD).

Note

SysConfig will only make changes to selected files, listed in the Generated Files view. Any required changes to your application files must be done on your own.

Open An Example Project

Open the stand-alone SysConfig tool or import a SysConfig-enabled example project (found in the {SDK_INSTALL_DIR}/examples/rtos/<board>/zigbee folder) and open the .syscfg file with the System Configuration Editor.

Zigbee Settings

In the RF STACKS → Z-Stack view, you can configure Zigbee stack parameters. Parameters are explained in the tooltip that appears when you hover over it but further explanations are provided in the Zigbee 3.0 Overview and 4. Migrate Configuration Header File sections. Zigbee stack settings are stored in default/sysconfig/ti_zigbee_config.h (which appears after building the project).

Here is an example of what you would see for an End Device switch example:

../_images/syscfg_settings_zboss.png

Radio Configuration

Standard Zigbee Device

The basic Radio parameters to consider for the Zigbee stack include primary channel mask. This is also where the TX power output can be selected.

Green Power Device

Configure the channel which the GPD will operate on and the TX power it will use.

Network Configuration

Green Power Device

Green Power Device Type determines what function the GPD embodies in the network (eg. switch, temperature sensor, etc). Green Power Device ID Type determines how the GPD identifies itself (eg. Configurable GPD ID, IEEE address). If Configurable GPD ID is selected, the developer may choose a 32-bit ID which the GPD will use (sec-green-power-device).

Security Configuration

Green Power Device

Security settings which are specific towards Green Power devices, such as level and key type, and key, which are further discussed in sec-green-power-security.

Advanced Configuration

Green Power Device

Data Frame Retries determines how many times the GPD will transmit each packet. Auto-commissioning determines whether the GPD will set the auto-commissioning bit in the packets (sec-green-power-commissioning). Radio Receive After Transmit determines whether the GPD should expect to receive a packet after transmitting. Sequence Number Capability determines whether the GPD will use sequential MAC sequence numbers (sec-green-power-data-frames).

Adjust Your Application

When you have finished adjusting the parameters, save the .syscfg file.

You can preview the files which will be generated by clicking the <> symbol. In this example, ti_devices_config.c, ti_drivers_config.c/h, and ti_zigbee_config.h were generated respectively by the TI DEVICES, TI DRIVERS, and RF STACKS → Zigbee views.

../_images/show_generated_zboss.png

If you are using the System Configuration stand-alone tool, you will have to import every generated file to your IDE. For the SysConfig CCS plug-in, you can generate all the files by building your project. After the build has completed, you will find the generated files in the output folder of your project, called default/syscfg. All parameters configured in the Zigbee view of SysConfig will result in a #define in ti_zigbee_config.h alongside other macros which are not included in SysConfig.

Attention

Whenever you re-build the project, SysConfig will re-generate the files. Because of this, any changes made directly to ti_zigbee_config.h will be overwritten.