Texas Instruments, Inc.

Z-Stack Energy Release Notes

------------------------------------------------------------------------------------------------------------------------------------------------------------Version 1.1.0
September 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.
-------------------------------------------------------------------------------------------------------------------------------------------------------------