SILICON LABS RAIL SDK 2.18.0.0 GA Simplicity SDK Suite User Guide

User Guide for SILICON LABS models including: 2.18.0.0, RAIL SDK 2.18.0.0 GA Simplicity SDK Suite, SDK 2.18.0.0 GA Simplicity SDK Suite, 2.18.0.0 GA Simplicity SDK Suite, Simplicity SDK Suite, SDK Suite, Suite

Proprietary Flex Release Notes

Silicon Labs Silicon Labs

Version 2.18.0.0

Flex SDK - Radio Abstraction Interface Layer (RAIL) - Silicon Labs

File Info : application/pdf, 7 Pages, 491.78KB

rail-sdk-release-notes-2.18.0.0

RAIL SDK 2.18.0.0 GA
Simplicity SDK Suite 2024.12.0 December 16, 2024

The RAIL SDK is a complete software development suite for proprietary wireless applications. It was previously part of the Proprietary SDK. Starting with the RAIL SDK 2.18.0.0 release, Proprietary SDK is split into RAIL SDK and Connect SDK.
Silicon Labs RAIL (Radio Abstraction Interface Layer) is an intuitive and easily-customizable radio interface layer designed to support both proprietary and standards-based wireless protocols.
The RAIL SDK is supplied with extensive documentation and sample applications.
These release notes cover SDK version(s):
2.18.0.0 GA released December 16, 2024.

RAIL APPS AND LIBRARY KEY FEATURES
· RAIL Tutorial moved to docs.silabs.com: https://docs.silabs.com/rail/latest/railstart/rail-training
· RAIL SDK supported on BRD4276A radio board with EFR32FG25 and SKY66122-11 frontend module for high TX power applications
· Improved RangeTest Sample Application to fully support multi-PHY configurations and added new feature to control measurements on RX side in alpha quality
· Sigfox TX PHYs and RX PHYs supported on EFR32FG23 and EFR32FG28 parts for EU and NA region

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/flex-sdk-connect-networking-stack. 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 Silicon Labs Flex SDK, see Using This Release.
Compatible Compilers:
IAR Embedded Workbench for ARM (IAR-EWARM) version 9.40.1 · 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.
GCC (The GNU Compiler Collection) version 12.2.1, provided with Simplicity Studio.

silabs.com | Building a more connected world.

RAIL 2.18.0.0

Contents
Contents
1 RAIL Applications ............................................................................................................................................................................... 3 1.1 New Items................................................................................................................................................................................... 3 1.2 Improvements............................................................................................................................................................................. 3 1.3 Fixed Issues ............................................................................................................................................................................... 3 1.4 Known Issues in the Current Release ........................................................................................................................................ 3 1.5 Deprecated Items ....................................................................................................................................................................... 3 1.6 Removed Items .......................................................................................................................................................................... 4
2 Using This Release ............................................................................................................................................................................ 5 2.1 Installation and Use .................................................................................................................................................................... 5 2.2 Security Information.................................................................................................................................................................... 5 2.3 Support ....................................................................................................................................................................................... 6 2.4 SDK Release and Maintenance Policy ....................................................................................................................................... 6

silabs.com | Building a more connected world.

RAIL 2.18.0.0 | 2

1 RAIL Applications

RAIL Applications

1.1 New Items
Added in release 2.18.0.0 · simplicity_sdk/app/flex is splitt into two:
o simplicity_sdk/app/rail (RAIL SDK) o simplicity_sdk/app/connect (CONNECT SDK) · RAIL SDK Services are documented at https://docs.silabs.com/rail/latest/rail-start/

1.2 Improvements
Changed in release 2.18.0.0
· The Range Test Applications are extended with 2x new features: o Remote Control: The receiver node can configure the transmitter node. Also, the measurement can be started by the re-
ceiver node (only).
o Runtime PHY change: During measurement, the user can switch between more Profiles/PHYs. To ensure this, more
PHYs must be added to the particular Range Test application with the Radio Configurator UI.
· Improve sleep by using Power Manager Integration component for all sleeping capable applications

1.3 Fixed Issues
Fixed in release 2.18.0.0

ID # 1322797

Description Absolute time overflow has been fixed for Wireless M-Bus Meter.

1.4 Known Issues in the Current Release

ID # 1268208 1268301
1274248

Description
The power consumption of DK2600 can't be optimized if configuration time for EM2 if UART is being used, as the value of SL_IOSTREAM_USART_{instance}_BAUDRATE doesn't take effect. The default value used instead is 115200 bps. Typical use case is RAIL - SoC Wireless Mbus Meter with DK2600 board.
Range Test DMP instabilities in case of LTO.

Workaround Update UART baud rate to 9600 bps at Simplicity Studio Admin Console. This is necessary for EM2.
Do not use LTO.

1.5 Deprecated Items
Deprecated in release 2.18.0.0 None.

silabs.com | Building a more connected world.

RAIL 2.18.0.0 | 3

1.6 Removed Items
Removed in release 2.18.0.0 None.

RAIL Applications

silabs.com | Building a more connected world.

RAIL 2.18.0.0 | 4

Using This Release
2 Using This Release
This release contains the following: · RAIL and Connect Sample Applications · RAIL and Connect Components and Application Framework
This SDK depends on the Simplicity Platform. The Simplicity Platform code provides functionality that supports protocol plugins and APIs in the form of drivers and other lower layer features that interact directly with Silicon Labs chips and modules. Simplicity Platform components include EMLIB, EMDRV, RAIL Library, NVM3, and mbedTLS. Simplicity Platform release notes are available through Simplicity Studio's Documentation tab.
For more information about the Flex SDK v3.x see UG103.13: RAIL Fundamentals and UG103.12: Silicon Labs Connect Fundamentals. If you are a first time user, see QSG168: Proprietary Flex SDK v3.x Quick Start Guide.

2.1 Installation and Use
The Proprietary Flex SDK is provided as part of the Simplicity SDK, the suite of Silicon Labs SDKs. To quickly get started with the Simplicity SDK, install Simplicity Studio 5, which will set up your development environment and walk you through Simplicity SDK installation. Simplicity Studio 5 includes everything needed for IoT product development with Silicon Labs devices, including a resource and project launcher, software configuration tools, full IDE with GNU toolchain, and analysis tools. Installation instructions are provided in the online Simplicity Studio 5 User's Guide.
Alternatively, Simplicity SDK may be installed manually by downloading or cloning the latest from GitHub. See https://github.com/SiliconLabs/simplicity_sdk for more information.
Simplicity Studio installs the GSDK by default in: · (Windows): C:\Users\<NAME>\SimplicityStudio\SDKs\simplicity_sdk · (MacOS): /Users/<NAME>/SimplicityStudio/SDKs/simplicity_sdk
Documentation specific to the SDK version is installed with the SDK. Additional information can often be found in the knowledge base articles (KBAs). API references and other information about this and earlier releases is available on https://docs.silabs.com/.

2.2 Security Information
Secure Vault Integration
When deployed to Secure Vault High devices, sensitive keys are protected using the Secure Vault Key Management functionality. The following table shows the protected keys and their storage protection characteristics.

Wrapped Key Thread Master Key PSKc Key Encryption Key MLE Key Temporary MLE Key MAC Previous Key MAC Current Key MAC Next Key

Exportable / Non-Exportable Exportable Exportable Exportable Non-Exportable Non-Exportable Non-Exportable Non-Exportable Non-Exportable

Notes Must be exportable to form the TLVs Must be exportable to form the TLVs Must be exportable to form the TLVs

Wrapped keys that are marked as "Non-Exportable" can be used but cannot be viewed or shared at runtime.

Wrapped keys that are marked as "Exportable" can be used or shared at runtime but remain encrypted while stored in flash. For more information on Secure Vault Key Management functionality, see AN1271: Secure Key Storage.

silabs.com | Building a more connected world.

RAIL 2.18.0.0 | 5

Using This Release
Security Advisories
To subscribe to Security Advisories, log in to the Silicon Labs customer portal, then select Account Home. Click HOME to go to the portal home page and then click the Manage Notifications tile. Make sure that `Software/Security Advisory Notices & Product Change Notices (PCNs)' is checked, and that you are subscribed at minimum for your platform and protocol. Click Save to save any changes.
The following figure is an example:

2.3 Support
Development Kit customers are eligible for training and technical support. Use the Silicon Labs Flex web page to obtain information about all Silicon Labs Thread products and services, and to sign up for product support. You can contact Silicon Laboratories support at http://www.silabs.com/support.
2.4 SDK Release and Maintenance Policy
For details, see SDK Release and Maintenance Poilcy.

silabs.com | Building a more connected world.

RAIL 2.18.0.0 | 6

Simplicity Studio
One-click access to MCU and wireless tools, documentation, software, source code libraries & more. Available for Windows, Mac and Linux!

IoT Portfolio
www.silabs.com/IoT

SW/HW
www.silabs.com/simplicity

Quality
www.silabs.com/quality

Support & Community
www.silabs.com/community

Disclaimer Silicon Labs intends to provide customers with the latest, accurate, and in-depth documentation of all peripherals and modules available for system and software implementers using or intending to use the Silicon Labs products. Characterization data, available modules and peripherals, memory sizes and memory addresses refer to each specific device, and "Typical" parameters provided can and do vary in different applications. Application examples described herein are for illustrative purposes only. Silicon Labs reserves the right to make changes without further notice to the product information, specifications, and descriptions herein, and does not give warranties as to the accuracy or completeness of the included information. Without prior notification, Silicon Labs may update product firmware during the manufacturing process for security or reliability reasons. Such changes will not alter the specifications or the performance of the product. Silicon Labs shall have no liability for the consequences of use of the information supplied in this document. This document does not imply or expressly grant any license to design or fabricate any integrated circuits. The products are not designed or authorized to be used within any FDA Class III devices, applications for which FDA premarket approval is required or Life Support Systems without the specific written consent of Silicon Labs. A "Life Support System" is any product or system intended to support or sustain life and/or health, which, if it fails, can be reasonably expected to result in significant personal injury or death. Silicon Labs products are not designed or authorized for military applications. Silicon Labs products shall under no circumstances be used in weapons of mass destruction including (but not limited to) nuclear, biological or chemical weapons, or missiles capable of delivering such weapons. Silicon Labs disclaims all express and implied warranties and shall not be responsible or liable for any injuries or damages related to use of a Silicon Labs product in such unauthorized applications.
Trademark Information Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® and the Silicon Labs logo®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo and combinations thereof, "the world's most energy friendly microcontrollers", Redpine Signals®, WiSeConnect , n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, the Telegesis Logo®, USBXpress® , Zentri, the Zentri logo and Zentri DMS, Z-Wave®, and others are trademarks or registered trademarks of Silicon Labs. ARM, CORTEX, Cortex-M3 and THUMB are trademarks or registered trademarks of ARM Holdings. Keil is a registered trademark of ARM Limited. Wi-Fi is a registered trademark of the Wi-Fi Alliance. All other products or brand names mentioned herein are trademarks of their respective holders.
Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 USA
www.silabs.com

References

Silicon Labs Adobe PDF Library 24.4.48