RAIL Library Version 2.19.0 (June 16, 2025) - Release Notes#

Simplicity SDK Version 2025.6.0

Silicon Labs RAIL (Radio Abstraction Interface Layer) provides an intuitive and easily-customizable radio interface that is designed to support proprietary or standards-based wireless protocols.

Click here for earlier releases.

Release Summary#

Key Features | API Changes | Bug Fixes | Chip Enablement

Key Features#

Added support for Concurrent Listening in combination with IEEE 802.15.4 High Data Rate (1 Mbps and 2 Mbps custom 802.15.4 SUN PHYs) on the EFR32xG26 part.
Added support for the EFR32xG27 SiP Module.
Added support for storing Antenna calibrations like RSSI offset, PA mode, PA curves/tables in NVM3 on EFR32xG24 and EFR32xG26 parts.

API Changes#

Added new APIs to store Antenna Calibrations in persistent NVM3 on EFR32xG24 and EFR32xG26 parts.

Bug Fixes#

Minor Improvements.

Chip Enablement#

Added support for EFR32xG29 part.
Added support for EFR32xG22L part.

Key Features#

New Features | Enhancements | Removed Features | Deprecated Features

Note: See Feature Matrix for a list of any appliable APIs, examples, software variants, modes, hardware, and host interfaces applicable for each feature.

New Features#

The rail_util_rssi component can now store and retrieve the chip RSSI offset from NVM3 persistent storage.
Added new component "RAIL Utility, NVM storage of PA configs and mode" component providing ability to store PA mode and/or PA curves/tables configs in persistent NVM3 on EFR32xG24 and EFR32xG26, overriding their compile-time configurations.
Added RAIL support for the MGM270SC32SNA2 module.

Enhancements#

None.

Removed Features#

None.

Deprecated Features#

The RAIL 2.x API is planned for deprecation in the 2025.12.0 release (December 2025). At that time, the new RAIL 3.0 API will be released for all supported chips along with a RAIL 2.x compatibility layer and migration guide.
- The goal of this new API is to get rid of some unused features, add better support for concurrent listening use cases, and to simplify channel and PA configurations.
- The migration is intended to be straight forward and simple for the majority of customers. However, in some cases manual help might be required to ease this transition.
Note: RAIL 3.0 API is in evaluation in sl_rail_*.h files, though subject to change, and the RAIL library has RAIL 3.0 symbols alongside RAIL 2.x, with some stacks and RAIL apps having started to use it in 2025.6.0.

API Changes#

New APIs | Modified APIs | Removed APIs | Deprecated APIs

New APIs#


New API Signature	Deprecated API replaced by this (if any)
sl_status_t sl_rail_util_pa_nvm_read_config(sl_rail_nvm_pa_config_t *p_pa_config)	None
RAIL_TxPowerMode_t sl_rail_util_pa_nvm_read_mode(void)	None
sl_status_t sl_rail_util_pa_nvm_write_config(const sl_rail_nvm_pa_config_t *p_pa_config)	None
sl_status_t sl_rail_util_pa_nvm_write_mode(RAIL_TxPowerMode_t pa_mode)	None

Modified APIs#


Old API	Modified
RAIL_Status_t RAIL_ZWAVE_ConfigBeamRx(RAIL_Handle_t railHandle, RAIL_ZWAVE_BeamRxConfig_t *config)	RAIL_Status_t RAIL_ZWAVE_ConfigBeamRx(RAIL_Handle_t railHandle, const RAIL_ZWAVE_BeamRxConfig_t *config)
RAIL_Status_t RAIL_ZWAVE_SetTxLowPowerDbm(RAIL_Handle_t railHandle, RAIL_TxPower_t powerLevel)	RAIL_Status_t RAIL_ZWAVE_SetTxLowPowerDbm(RAIL_Handle_t railHandle, RAIL_TxPower_t power)

Removed APIs#

None.

Deprecated APIs#

None.

Bug Fixes#

ID	Issue Description	GitHub / Salesforce Reference (if any)	Affected Software Variants, Hardware, Modes, Host Interfaces
1274214	Fixed an issue on EFR32xG23, EFR32xG25, EFR32xG26 and EFR32xG28 where radio was blocked in RAIL_RF_STATE_RX_ACTIVE.	None	EFR32xG23, EFR32xG25, EFR32xG26 and EFR32xG28
1355305	Fixed an issue where the events RAIL_EVENT_RX_PREAMBLE_DETECT, RAIL_EVENT_RX_PREAMBLE_LOST and RAIL_EVENT_RX_SYNC1_DETECT were not generated for WiSUN OQPSK PHYs on the EFR32xG25 part.	None	EFR32xG25
1357024	Fixed a false CCA busy issue on the EFR32xG28 part.	None	EFR32xG28
1426472	Fixed an issue were PTI was only partially disabled when configured with RAIL_PTI_MODE_DISABLED (which is RAIL's default), and accordingly clarified RAIL_ConfigPti() and RAIL_EnablePti() documentation.	None	All chips
1435514	Fixed an issue on the EFR32xG24, where enabling channel sounding under certain conditions can potentially result in hanging the system in the default handler.	None	EFR32xG24
1437972	Fixed an issue on the EFR32xG24, where the RSSI reported on certain channel sounding SYNC packets could be lower than expected.	None	EFR32xG24
1439816	Fixed an issue with Wi-SUN mode switch where idling the radio after RAIL_EVENT_IEEE802154_MODESWITCH_START can prevent reception of future mode switch headers.	None	Unknown
1445964	Fixed an issue in RAIL_GetRxPacketDetails() where the duration of the packet would be incorrect when packet size is larger than 534 bytes on the EFR32xG25 part.	None	EFR32xG25
1450906	Fixed an issue on the EFR32xG24, where CS antenna switching would not work when configured for GPIOs on PortC or PortD.	None	EFR32xG24

Chip Enablement#

Chip Family	OPNs / Boards / OPN Combinations	Supported Software Variants (if applicable)	Supported Modes	Supported Host Interfaces
EFR32xG29	Not Applicable	Not Applicable	Not Applicable	Not Applicable
EFR32xG22L	Not Applicable	Not Applicable	Not Applicable	Not Applicable
EFR32xG27	MGM270SC32SNA2	Not Applicable	Not Applicable	Not Applicable

Application Example Changes#

New Examples | Modified Examples | Removed Examples | Deprecated Examples

New Examples#

None.

Modified Examples#

None.

Removed Examples#

None.

Deprecated Examples#

None.

Known Issues and Limitations#

ID	Issue or Limitation Description	GitHub / Salesforce Reference (if any)	Workaround (if any)	Affected Software Variants, Hardware, Modes, Host Interfaces
1465156	Excessively long Rx2Tx turnaround time reported on EFR32xG25 after hours of network stack test. Issue has been seen after CCA. Turnaround time increases by jump over time and has been observed at 10x its nominal value.	None	None	EFR32xG25
1458845	When running Channel Sounding RTT with a non-BG24 CS device, RTT has an error of +/- 12.5 ns depending on CS role. Precision is not affected. BG24 to BG24 RTT is not affected.	None	None	non-BG24 CS devices Channel Sounding RTT
641705	Infinite receive operations where the frame's fixed length is set to 0 are not working correctly on the EFR32xG23 series chips.	Not Applicable	Not Applicable	EFR32xG23 series chips
732659	Wi-SUN FSK mode 1a exhibits a PER floor with frequency offsets around ± 8 to 10 KHz Wi-SUN FSK mode 1b exhibits a PER floor with frequency offsets around ± 18 to 20 KHz.	Not Applicable	Not Applicable	EFR32xG23 series chips

Impact of Release Changes#

Impact Statements | Migration Guide

Impact Statements#

None.

Migration Guide#

None.

Using This Release#

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

What's in the Release?#

RAIL Library packages and plugins.

Compatible Software#

None.

Installation and Use#

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.

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.

Unsupported Features#

None.

SDK Release and Maintenance Policy#

See our SDK Release and Maintenance Policy.