TI Z-Stack 3.3.1 Release Notes
Table of Contents
Introduction
Z-Stack 3.x is a component of the SimpleLink™ CC13x2 / CC26x2 Software Development Kit. This component enables development of Zigbee® 3.0 specification based products. Z-Stack is TI’s complete solution for developing certified Zigbee 3.0 solution on CC13x2 and CC26x2 platforms. Z-Stack contained in this release is based on Zigbee 3.0 specification with the added benefit of running on top of TI-RTOS.
Key features of Z-Stack 3.3.1 :
- Zigbee certified stack - Zigbee Pro 2017 (R22) and Green Power Proxy v1.1.1 (Z-Stack Core v1.0.0.0)
- Zigbee Cluster Library (ZCL) 7 integration
- Standalone Home Automation sample applications to jump start development
- Generic example application to start creating custom Zigbee 3.0 certifiable products
- Green Power Device (GPD) and Sink (GPS) examples for battery-less devices
- Integrated User Interface or Zigbee network processor (ZNP) dual-device configurations
- Secure Over-the-Air Download (OAD) firmware upgrade support and Over-the-Air Update (OTA) examples for updating Zigbee device firmware wirelessly
- Dynamic Multiprotocol Manager (DMM) Integration - BLE + Zigbee coexistence examples included in the SDK
- Full integration with TI-RTOS for real-time scheduling, automatic power management and utilizing peripheral device drivers
- Free code development option with Code Composer Studio™ (CCS)
Additional information about TI’s Zigbee solution can be found at www.ti.com/zigbee
Z-Stack Documentation
The SimpleLink CC13x2 and CC26x2 Software Development Kit(SDK) allows easier product development by combining TI-RTOS and the Zigbee protocol stack in one unified SDK. All Z-Stack sample applications are based off the TI-RTOS Kernel. Key documents needed for Zigbee application development include:
- Z-Stack Quick Start Guide
- TI Z-Stack User’s Guide
- Z-Stack Application APIs
- Z-Stack Migration Guides
- Z-Stack Monitor and Test API
- Z-Stack ZCL APIs
Installation and Usage
- To build the sample applications with this SDK a supported IDE must be installed (refer to Dependencies below)
- Install the simplelink_cc13x2_26x2_sdk_3_10_00_xx installer package on a supported host operating system build machine with Administrator privileges
- The default install path for Windows is C:\ti\simplelink_cc13x2_26x2_sdk_3_10_00_xx
- Changing the default install path and/or drive letter may require updating project variables. Do not use a space in the install path
- It is recommended to make a backup of the installation in order to revert modifications to the SDK
What’s New
ID | Summary |
---|---|
ZIGBEE-238 | Add callback to UI to indicate when FN reset is done to allow App remove Zigbee App related NV |
ZIGBEE-237 | Reduce Scenes table size according to the clusters supported to save NV |
ZIGBEE-225 | R22: send nwk status msg for unknown commands |
ZIGBEE-224 | R22 (CCB 2255): If a frame is received with endDevInitiator=1 from a child device that is not ours, send it a leave w/ rejoin to allow it to recover. |
ZIGBEE-156 | Zigbee Power Consumption Test profiles |
ZIGBEE-135 | Add SysConfig support to GPD projects |
ZIGBEE-111 | Add Z-stack EPID configurable |
ZIGBEE-107 | Add SysConfig support to all applicable Z-stack projects |
ZIGBEE-90 | Update legacy HAL TRNG with Random.c (TI-RTOS Driver) |
Fixed Issues
ID | Summary |
---|---|
ZIGBEE-236 | GPP v1.1.1: Fixes to validate correct format of GPDF |
ZIGBEE-235 | GPP v1.1.1: Fixes to process multiple communication modes to sinks |
ZIGBEE-234 | GPP v1.1.1: Fix GP response to accept broadcast frames. |
ZIGBEE-233 | GPP v1.1.1: Fix to parse correctly GP Pairing command |
ZIGBEE-232 | GPP v1.1.1: Fix to filter duplicate frames according to SecLvl and use SrcId |
ZIGBEE-231 | GPP v1.1.1: bidirectional commissioning fixes |
ZIGBEE-230 | GPP v1.1.1: Fix alias frames for GP commission notification command |
ZIGBEE-229 | GPP v1.1.1: Fix for auto-commissioning pairing |
ZIGBEE-228 | GPP v1.1.1: Green Power unsecure GPDF processing fix |
ZIGBEE-227 | R22: Fixes to allow Trust Center rejoin |
ZIGBEE-226 | Fix in Mgmt LQI relationship returned for other ZR (unknown –> sibling) |
ZIGBEE-220 | Fix for supporting legacy devices that use pre-configured APS keys |
ZIGBEE-219 | Fixes to R22 unsecure Trust Center Rejoin logic |
ZIGBEE-216 | CIE UI does not loop properly |
ZIGBEE-212 | Fixes for R22 End Device Timeout Req method of Child Aging |
ZIGBEE-192 | Fix Default Response logic to comply with ZCLv7 |
ZIGBEE-181 | Memory leak in BDB Finding and Binding ( bdb_ProcessSimpleDesc() ) |
ZIGBEE-171 | TCLK entry not removed from NV when device leaves the network |
ZIGBEE-148 | 13x2 gpd tempsensors do not work when flashed with hex file |
ZIGBEE-147 | IAR Projects have a semicolon at the end of hex file name |
ZIGBEE-144 | Applications with MT do not receive ZDO callbacks in application |
ZIGBEE-142 | Restore application poll rate after successful rejoin |
Known Issues
ID | Summary |
---|---|
ZIGBEE-155 | ZED may attempt polling more than MAX_POLL_FAILURE_RETRIES under certain conditions |
Upgrade and Compatibility Information
The Z-Stack 3.3.1 only supports Revision E SimpleLink CC13x2 and CC26x2 devices. No support for previous silicon revisions or LaunchPad™ development kits using earlier silicon revisions. If you’re unsure of the revision number of your device, please see the Package Symbolization and Revision Identification section of the Errata Note.
Operating System Support
- Microsoft Windows® 7 SP1, Windows 8.1 or Windows 10
- Ubuntu 14.04 64-bit, Ubuntu 16.04 64-bit
- macOS Sierra
Dependencies
The Z-Stack sample applications were built & tested with the Integrated Development Environments (IDEs) and listed in the top-level SDK release notes.
Note: Earlier IDE/toolchain versions are not supported and compatibility with newer versions of supported IDEs is not assured.
Device Support
Development Board Support
Validation
The Z-Stack sample applications were built & tested with versions of the following Integrated Development Environments (IDEs) and tool chains listed in the top-level SDK release notes:
- Code Composer Studio using the TI C Compiler for Arm
- IAR Embedded Workbench for Arm
This release is for evaluation and development purposes only. End products being developed with this protocol stack version will require a future update prior to obtaining Zigbee and/or regulatory certification.
Versioning
This product follows a version format, M.mm.pp.bb, where:
- M is a 1 digit major number,
- mm is a 2 digit minor number,
- pp is a 2 digit patch number,
- bb is a 2 digit incrementing build counter.