RAIL Library Version 3.0.0 - Release Notes (Jan 22, 2026)#

Simplicity SDK Version 2025.12.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 RAIL support for MGM270SC22SNA4 and BGM270SC22SNA4 modules.

API Changes#

RAIL APIs have been updated to 3.0, which brings several improvements in the areas of RAIL initialization, RX FIFOs and companion Packet Queues, TX FIFOs, and TX power management. Refer RAIL 3.0 Migration guide for more details.

Bug Fixes#

Minor improvements.

Chip Enablement#

None.

Key Features#

New Features | Enhancements | Removed Features | Deprecated Features

New Features#

  • Added RAIL support for MGM270SC22SNA4 and BGM270SC22SNA4 modules.

  • Updated the entries in the power setting table to include PA submode for the SixG301 part.

  • The RAIL Utility, RSSI Internal component can now store and retrieve the chip RSSI offset from NVM3 persistent storage.

  • In RAIL 3.0, sl_rail_set_tx_fifo() now supports configuring a transmit FIFO whose size is not a power-of-2. Such a FIFO is usable only in TX SL_RAIL_DATA_METHOD_PACKET_MODE and not TX SL_RAIL_DATA_METHOD_FIFO_MODE. In RAIL 2.x, RAIL_SetTxFifo() does not support this; its functionality remains unchanged.

  • Added a callback sl_railcb_convert_ddbm_to_power_setting_entry which provides register settings for requested deci-dBm power. This replaces the now-deprecated RAIL 2.x RAIL_ConvertDbmToRaw() API.

  • Added sl_rail_ieee802154_config_signal_identifier() and sl_rail_ble_config_signal_identifier() APIs to the configure signal identifier for IEEE 802.15.4 and BLE protocols, respectively.

  • Provided ability to adjust the RAIL default high and low RF Sense sensitivity thresholds.

  • Added RAIL Utility, IEEE802.15.4 Fast Channel Switching and RAIL Utility, IEEE802.15.4 Duty Cycling components to be used with RAIL Utility, IEEE802.15.4 PHY Configuration on the SixG301 part.

  • Added sl_rail_abort_rx_incoming_packet() allowing an application to abort an incoming packet during its reception.

  • Added a new API sl_rail_ble_config_channels() to load any BLE channel configuration.

  • Added a new RAIL library variation that uses secure peripheral addresses.

Enhancements#

  • The RAIL_ConfigData() API has been split into two RAIL 3 functions, sl_rail_config_rx_data() and sl_rail_config_tx_data(), to allow independent control of Rx and Tx data configuration, respectively.

  • Renamed ver.h to rail_version.h and ver_def.h to rail_version_def.h.

  • Updated the railtest and new sl_rail_test apps to use memory_manager (sl_malloc/free()) component rather than silabs_core_memory_manager. Due to this change, code size increases and interrupt latency may also increase a negligible amount.

Removed Features#

None.

Deprecated Features#

RAIL 2.x APIs are now deprecated in this release. Refer to Deprecated APIs for more details.

API Changes#

New APIs | Modified APIs | Removed APIs | Deprecated APIs

New APIs#

For all the new APIs that are added in this release, please refer New APIs.

Modified APIs#

For all the new APIs that are modified in this release, please refer Modified APIs.

Removed APIs#

None.

Deprecated APIs#

Complete list of the deprecated APIs can be found here.

Bug Fixes#

ID Issue Description GitHub / Salesforce Reference (if any) Affected Software Variants, Hardware, Modes, Host Interfaces
233012 Fixed an issue with coexistence and CSMA transmits where Request could be improperly de-asserted on CCAs (clear channel assessments) with zero backoff preventing that CCA from seeing a clear channel to permit transmit. None All chips
1309208 Fixed a minor issue on the EFR32xG21 where the TX-to-RX turnaround timing could be slightly longer than specified. None EFR32xG21
1434510 Fixed an issue on the SixG301 where a ramp time of more than 1000us would trigger an assert; the maximum ramp time is now limited to 1000us. None SixG301
1470529 Fixed an issue with coexistence where some CSMA transmit CCAs (clear channel assessments) provided no advance warning to assert Request and be Granted in time for the CCA to see a clear channel and permit transmit. None All chips
1474636 Fixed an issue where a very small packet (1-2 bytes) with a very fast PHY (>= 2mbps) can be improperly dropped or trigger SL_RAIL_ASSERT_FAILED_UNEXPECTED_STATE_RX_FIFO. On EFR32xG2x platforms it is still possible such packets will not properly respect an RX transition to TX, e.g., for autoAck. None EFR32xG2x
1478786 Fixed an issue where the BGM260PB32VNA module failed to build due to incorrect signatures. None BGM260PB32VNA
1490308 Fixed an issue where RAIL_ConfigData() or sl_rail_config_rx_data() would mistakenly return success if the RX buffer write offset is not properly aligned for the requested RX source to function properly. Also clarified documentation around these function's alignment requirements. None All chips
1496415 Expanded the fix for issue 1470529 to cover fixed and 0-backoff CSMA/LBT operations and issue SL_RAIL_EVENT_TX_CCA_ACTIVATED when LBT is actually started and not sooner. None All chips
1499282 Fixed an issue where RAIL could hang in its idle code path when switching from the IEEE 802.15.4 High Data Rate (HDR) PHY to the normal 802.15.4 PHY. None
  • EFR32xG21
  • EFR32xG26
  • SixG301
1503687 Fixed sl_rail_get_rx_time_preamble_start() and sl_rail_get_rx_time_sync_word_end() on the EFR32xG25 part for OFDM and OQPSK modulations. None EFR32xG25
1514841 RAIL libraries are now built to avoid instructions or optimizations that might cause an unaligned access trap, should one be enabled on Cortex M platforms. None Cortex M platforms
1518333 Fixed an issue on the EFR32xG25 where the radio could not receive any frame after the radio is idled while OFDM frame detection is ongoing. None EFR32xG25
1523880 Fixed an issue on the EFE32xG25, where the radio could get a sync detect event without a completion event when sl_rail_idle() was called just before the frame detection. None EFE32xG25
1524998 Fixed an issue with Concurrent RX Channel Switching on EFR32xG2x platforms which could cause transmit to lock up and never complete. None EFR32xG2x
1530983 Fixed an issue with BLE on EFR32xG27 and EFR32xG29 where RX overflow could render the protocol deaf. None
  • EFR32xG27
  • EFR32xG29
1531433 In RAIL 3.0, Modules are not yet supported by the new sl_rail_util_pa plugin. This is fixed by adding a sl_rail_util_compatible_pa component that will pull in the correct PA plugin depending on whether building for modules or SoC's. None All chips
1542463 Fixed a race condition on the EFR32xG25 with OFDM-FSK concurrent PHYs where idling the radio during a SL_RAIL_EVENT_RX_PREAMBLE_LOST event would not idle the software modem. None EFR32xG25
1557444 Fixed a Channel Sounding issue on the EFR32xG24 platform where the device would transmit a tone longer than expected on Phase-Based Ranging steps. None EFR32xG24

Chip Enablement#

None.

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
1572298 Calling sl_rail_ieee802154_config_gb863_mhz_radio() or sl_rail_ieee802154_config_gb915_mhz_radio() no longer implicitly enables SL_RAIL_IEEE802154_G_OPTION_GB868. As a result, some of the 802.15.4G-2012 features needed for GB868 may not be configured. None After calling sl_rail_ieee802154_config_gb863_mhz_radio() or sl_rail_ieee802154_config_gb915_mhz_radio(), explicitly enable \ref SL_RAIL_IEEE802154_G_OPTION_GB868 by calling sl_rail_ieee802154_config_g_options()
  • EFR32xG23
  • EFR32xG25
  • EFR32xG28
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#

RAIL APIs have been updated to 3.0 bringing several improvements in the areas of RAIL initialization, RX FIFOs and companion Packet Queues, TX FIFOs, and TX power management. Refer to RAIL 3.0 Migration guide for more details.

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:

  1. Go to https://community.silabs.com/.

  2. Log in with your account credentials.

  3. Click your profile icon in the upper-right corner of the page.

  4. Select Notifications from the dropdown menu.

  5. In the Notifications section, go to the My Product Notifications tab to review historical Security and Software Advisory notifications

  6. To manage your preferences, use the Manage Notifications tab to customize which product updates and advisories you receive.

Help and Feedback#

Unsupported Features#

None.

SDK Release and Maintenance Policy#

See our SDK Release and Maintenance Policy.