Zigbee Version 8.2 Revision 2 (September 24, 2025) - Release Notes#

Simplicity SDK Version 2025.6.2

Silicon Labs is the vendor of choice for OEMs developing Zigbee networking into their products. The Silicon Labs Zigbee platform is the most integrated, complete, and feature-rich Zigbee solution available.

Silicon Labs EmberZNet SDK contains Silicon Labs’ implementation of the Zigbee stack specification.

Click here for earlier releases.

Release Summary#

Release Item	Version	Release Date	Release Notes	Key Features	API Changes	Bug Fixes	Chip Enablement
SDK	8.2 Revision 2	September 24, 2025	Release Notes	Refer to the Key Features section.	Refer to the API Changes section.	Refer to the Bug Fixes section.	Refer to the Chip Enablement section.
802.15.4 Mesh + BLE Multiprotocol	8.2 Revision 2	September 24, 2025	Release Notes	None	None	Targeted quality improvements and bug fixes.	None

Impact of Release Changes#

Impact Statements | Migration Guide

Impact Statements#

None.

Migration Guide#

See the sl_system to sl_main migration guide for detailed instructions.
Learn more about using sl_system_compatibility in baremetal applications here.

Using This Release#

What's in the Release? | Compatible Software | Installation and Use | Help and Feedback

What's in the Release?#

This release contains the following:

Zigbee stack
Zigbee Application Framework
Zigbee Sample Applications

For more information about Zigbee and the EmberZNet SDK see Zigbee Fundamentals.

If you are a first-time user, see QSG180: Zigbee EmberZNet Quick-Start Guide for SDK 7.0 and Higher, for instructions on configuring your development environment, building and flashing a sample application, and documentation references pointing to next steps.

Compatible Software#

Compatibility and Use Notices: For information about security updates and notices, see the Security chapter of the Platform Release Notes installed with this SDK or on the TECH DOCS tab on https://www.silabs.com/developers/zigbee-emberznet. Silicon Labs also strongly recommends that you subscribe to Security Advisories for up-to-date information.

For instructions, or if you are new to the Zigbee EmberZNet SDK, see Using This Release.

Software	Compatible Version or Variant
IAR Embedded Workbench for ARM (IAR-EWARM) Using wine to build with the IarBuild.exe command line utility or IAR Embedded Workbench GUI on macOS or Linux could result in incorrect files being used due to collisions in wine’s hashing algorithm for generating short file names. Customers on macOS or Linux are advised not to build with IAR outside of Simplicity Studio. Customers who do should carefully verify that the correct files are being used. Important Note : Users are reminded that applications intended for series 3 parts are not supported with the IAR toolchain in this release.	Version 9.40.1
GCC (The GNU Compiler Collection)	Version 12.2.1
EZSP Protocol	Version 0x12

Installation and Use#

To run your first demo, see our Getting Started Guides.

To kick start your development, see our Developer's Guide.

For information about Secure Vault Integration, see Secure Vault.

To review Security and Software Advisory notifications and manage your notification preferences:

Go to https://community.silabs.com/.
Log in with your account credentials.
Click your profile icon in the upper-right corner of the page.
Select Notifications from the dropdown menu.
In the Notifications section, go to the My Product Notifications tab to review historical Security and Software Advisory notifications
To manage your preferences, use the Manage Notifications tab to customize which product updates and advisories you receive.

To learn more about the software in this release, dive into our online documentation.

Additional Information#

Zigbee Certification

The Ember ZNet 8.2 release has been qualified for Zigbee Compliant Platform for SoC, NCP and RCP architectures. For ZCP certification ID tied to this release, please check the CSA website here: https://csa-iot.org/csa-iot_products/.

Please note that the ZCP certification is filed post the release, and takes a few weeks before getting reflected on the CSA web-site. For any further queries, please contact Silicon Laboratories support at http://www.silabs.com/support.

Help and Feedback#

Contact Silicon Labs Support.
To use our Ask AI tool to get answers, see the search field at the top of this page.
Note: Ask AI is experimental.
Get help from our developer community.

Feature Matrix#

Supported Features | Unsupported Features

Supported Features#

Feature Name	Description	Quality	Related API Names	Supported Software Variants, Hardware, Modes, Host Interfaces	Related Example Names
Updated filtering of InterPAN messages	Updated the message filtering mechanism to allow the inter-pan messages to be available to the application.	Production	sl_zigbee_pre_incoming_packet_filter_cb sl_zigbee_pre_outgoing_packet_filter_cb sl_zigbee_post_incoming_packet_filter_cb sl_zigbee_post_outgoing_packet_filter_cb	SoC Host-NCP	All
GCC Link Time Optimization (LTO)	Link Time Optimization (LTO) is now enabled for Zigbee applications and libraries in this release for GCC.	Production	All	SoC NCP	All
Added support for Tunneling functionality in Zigbee Direct.	Added support for Tunneling functionality in Zigbee Direct.	Production	All	SoC	All
Improved status notification for packet sent.	Improved status notification for messages sent.	Production	All	SoC Host-NCP	All
Application Initialization Utilizing sl_main.	sl_system is deprecated in 25q2 and is being replaced with sl_main.	Production	All	SoC NCP	All

Revision 1#

Feature Name	Description	Quality	Related API Names	Supported Software Variants, Hardware, Modes, Host Interfaces	Related Example Names
Added Common Token Manager integration	In the 2025.6.1 SDK release, a new platform component has been added called the Common Token Manager (CTM). This component is meant to eventually replace the longstanding legacy Token Manager that the Zigbee stack has used for years.	Production	All	SoC Host-NCP	All

Revision 2#

Feature Name	Description	Quality	Related API Names	Supported Software Variants, Hardware, Modes, Host Interfaces	Related Example Names
Updated filter match for InterPAN messages.	Updated Filtering of InterPAN message to support multiple filters matching regardless of whether ZLL or Custom filters match. The matched filter value will be passed up to the application using sli_802154_stack_filter_match_message_handler().	Production	sl_zigbee_af_mac_filter_match_message_cb sl_zigbee_ezsp_mac_filter_match_message_handler sl_802154_filter_match_message_handler	SoC Host-NCP	All
Updated zigbee_token_interface and zigbee_trust_center_backup usage.	This revision adds the Silabs series 3 radio micro controllers that required certain updates and limitations regarding zigbee_token_interface and zigbee_trust_center_backup usage for series 2 and series 3 applications.	Production	NA	SoC Host-NCP	All
reeRTOS support for Zigbee NCP applications.	Added FreeRTOS support for Zigbee UART NCP applications.	Production	NA	SoC Host-NCP	All

Unsupported Features#

Revision 2#

Feature Name	Description	Quality	Related API Names	Supported Software Variants, Hardware, Modes, Host Interfaces	Related Example Names
IAR toolchain for Series 3	Users are reminded that applications intended for series 3 parts are not supported with the IAR toolchain in this release.	Production		SoC NCP CPC	Series 3
Zigbee NCP SPI Applications on Series 3	Applications utilizing direct SPI access (that is, without the use of CPC) are currently not working for series 3 hardware. This includes the "Zigbee - NCP ncp-spi" and "Zigbee - NCP MpNcpSpi" applications, as well as any application that brings in the "NCP SPI" component. Generations of such applications will fail, indicating unmet dependencies or incompatible dependencies.	Production	NA	NCP SPI	Series 3

SDK Release and Maintenance Policy#

See our SDK Release and Maintenance Policy.