Texas Instruments, Inc.

Z-Stack Energy Release Notes

--------------------------------------------------------------------------------------------------------------------------------------------------------------

Version 1.1.0September 19, 2013

Notices: - Z-Stack Energy 1.1.0 is based on Z-Stack Core 2.6.0.3. See the "Z-Stack Core Release Notes" for details.

- Z-Stack Energy 1.1.0 introduces support for Texas Instruments' new CC2538. Please visit: http://www.ti.com/product/cc2538 for more information.

- Z-Stack for the CC2520 and CC2530 platforms has been built and tested with IAR's CLIB library, which provides a light-weight C library which does not support Embedded C++. Use of DLIB is not recommended for those platforms. Z-Stack for the CC2538 platform has been tested with the DLIB library.

- Z-Stack projects specify compile options in two ways: (1) "-D" statements in f8wConfig.cfg and other *.cfg files, (2) entries in the IDE Compiler Preprocessor Defined Symbols. When using the EW8051 or EW430 compilers, settings made in the IDE will override settings in the *.cfg files. When using the EWARM compiler, settings in the *.cfg files will override any made in the IDE.

- When programming devices for the first time with this release, it is recommended to erase the entire flash memory. For CC2530, select the "Erase Flash" option in the "Debugger->Texas Instruments->Download" tab of the project options. For CC2538, select Project->Download->Erase memory from the main menu.

- The library files have been built and tested with the following versions of IAR tools and may not work with different versions of the IAR tools: - CC2538 + SRF06EB: EWARM 6.50.5 (6.50.5.4862) - CC2530 + SRF05EB: EW8051 8.20.2 (8.20.2.41139) - CC2520 + EXP5438: EW430 5.51.6 (5.51.6.50669)

- Foundation software library files for the CC2538 include the following: - bsp.lib, version 1.3.1 - driverlib.lib, version 1.3.1 - usblib.lib, version 1.0.1

Changes: - [5301] Increased the default STACK_SIZE from 200 to 512 (32-bit words) to accomodate additional stack requirements of the CBKE process.

- [5252] Added new NV item, ZCD_NV_KE_MAX_DEVICES, that permits application control of the maximum number of concurrent SE key establishment processes.

- [4637] Disabled the ZCL_KEY_ESTABLISH compile option in the 'f8wZCL.cfg' configuration file. This option is not used in Home Automation projects and caused some non-HA related code to be included in HA builds.

Bug Fixes: - [5290] Modified the 'zmain_ext_addr()' function to properly read the IEEE address from CC2538 INFO memory by swapping the upper/lower 32-bit words.

- [5288] Fixed serial boot loader that is used with ZNP projects.

- [5266] Fixed a problem in CC2538 version of osal_nv.c where an NV item header was read instead of an NV item page header, possibly causing stack corruption.

- [5239] Fixed a problem in 'OTA_Send_DongleInd()' where the response length was one byte short, causing the "OTA_Dongle_devState" item to be dropped.

- [5077] Changed the Confirm Key Establishment Command to send the "Default Response" (instead of "ZCL_STATUS_CMD_HAS_RSP") if CBKE succeeds when the Disable Default Response Bit is '0'.

- [4844] Fixed processing of Key Establish command to check that the extended address of the initiator (included in message) matches the actual address of the device stored in address manager.

- [4752] Updated the "zclCCLoadControlEvent_t" structure to replace the 24-bit 'deviceGroupClass' element with a 16-bit 'deviceClass' element and an 8-bit 'utilityEnrolementGroup' element.

- [4421] Fixed the "zclOTA_ProcessImageData()" signature verification when the OTA image is received.

Memory Sizes: - Actual usage of Flash and RAM memory is variable, of course, and dependent on the specific application. Developers should adjust various parameters, such as, program stack size and dynamic memory heap size to meet their specific needs.

- The following tables provide comparison of Flash and RAM sizes for certain device configurations for the SE SampleApp provided with this release. The SampleApp is found in the installed ..\Projects\zstack\SE\SampleApp folder. In most Z-Stack sample applications, generic heap settings are used which have been selected to accomodate a wide range of applications. For the SE SampleApp, heap settings were: Coordinator/Router = 8Kb, EndDevice = 8Kb. See the "Heap Memory Management" document for details on profiling heap memory usage.

- Memory sizes (Flash/RAM) are shown below for the 3 ZigBee device types on various MCU and RF platforms with ZigBee-PRO enabled and Security enabled. See the Z-Stack User's Guide for more details on the platform of interest.

CC2538EM on SmarfRF06EB ======================= ESP-Coordinator 112.7K / 12.7K Metering-Router 110.4K / 12.3K IPD-End-Device 87.0K / 11.4K

CC2530EM on SmarfRF05EB ======================= ESP-Coordinator 214.4K / 7.5K Metering-Router 207.3K / 7.3K IPD-End-Device 171.8K / 6.2K

EXP5438 with CC2520EM ===================== ESP-Coordinator 123.0K / 11.6K Metering-Router 119.7K / 11.8K IPD-End-Device 99.7K / 11.2K

Known Issues: - To disable security at build time, use the "SECURE=0" compile option. Do not attempt to disable security by setting the SECURITY_LEVEL to zero.

- Texas Instruments' Over-Air-Download (OAD) is not supported on CC2538.

- The ZDO Complex Descriptor is not supported.

--------------------------------------------------------------------------------------------------------------------------------------------------------------