xG22 Bluetooth LE SDK Software

“

Specifications:

• Product Name: Simplicity SDK Suite
• Version: 2024.12.2
• Release Date: April 1, 2025
• Compatible Compilers:
  • IAR Embedded Workbench for ARM (IAR-EWARM) version 9.40.1
  • GCC (The GNU Compiler Collection) version 12.2.1, provided with
    Simplicity Studio
• Bluetooth Version: 9.1.0.0

Product Usage Instructions:

Compatibility and Use Notices:

For information about security updates and notices, refer to the
Security chapter of the Platform Release Notes installed with this
SDK or visit the TECH DOCS tab on Silicon
Labs website. It is recommended to subscribe to Security
Advisories for up-to-date information.

Using This Release:

If you are new to the Silicon Labs Bluetooth SDK, refer to the
instructions and notes provided in the user manual for Using This
Release section.

Key Features:

• Compatible Compilers:
  • IAR Embedded Workbench for ARM (IAR-EWARM) version 9.40.1
  • GCC (The GNU Compiler Collection) version 12.2.1

New Features:

New Items in Release 9.1.0.0:

• GATT Client for ATT MTU Exchange Only:
  • Added component
    bluetooth_feature_gatt_client_att_mtu_request_only to automatically
    initiate an ATT MTU exchange procedure when the GATT connection is
    open.
  • Use sl_bt_gatt_server_set_max_mtu API to set the maximum size
    of ATT MTU in the BLE Host Stack.
• Components for Specific Connection Roles:
  • New components bluetooth_feature_connection_role_central and
    bluetooth_feature_connection_role_peripheral provide support for
    specific connection roles.
  • Include one or both of the role-specific components based on
    the application’s needs when including
    bluetooth_feature_connection.
• Better Code Optimization in Bluetooth Security Manager:
  • The Bluetooth security manager now automatically manages
    central or peripheral state machines based on included
    components.

New Items in Release 9.0.0.0:

• TX Power Higher Than 10 dBm in Low Power Mode:
  • Supports using TX power higher than 10 dBm in low power mode in
    NCP and SoC modes.
  • Configure power limits in low power mode using
    sl_bt_system_linklayer_configure() with key
    sl_bt_system_linklayer_config_key_low_power_mode_power_limit.
• New Scanner Option:
  • Added SL_BT_SCANNER_IGNORE_BONDING option for use with
    sl_bt_scanner_set_parameters_and_filter command to avoid
    unnecessary searching of bondings if bonding information is not
    needed in advertisement reports.
• New Custom Address Option:
  • Added SL_BT_CONFIG_SET_CUSTOM_ADDRESS_FROM_NVM3 option for
    configuring whether the stack should use a custom address stored in
    NVM3 as the device identity address.
  • This option is enabled by default.

FAQ:

Q: Where can I find information about security updates?

A: Refer to the Security chapter of the Platform Release Notes
installed with this SDK or visit the TECH DOCS tab on Silicon Labs
website for security updates.

Q: How do I configure the power limits in low power mode?

A: Configure power limits in low power mode using
sl_bt_system_linklayer_configure() with key
sl_bt_system_linklayer_config_key_low_power_mode_power_limit.

Q: What compilers are compatible with this product?

A: Compatible compilers include IAR Embedded Workbench for ARM
version 9.40.1 and GCC version 12.2.1 provided with Simplicity
Studio.

“`

Bluetooth® LE SDK 9.1.0.0 GA
Simplicity SDK Suite 2024.12.2 April 1, 2025

Silicon Labs is a leading vendor in Bluetooth hardware and software technologies, used in products such as sports and fitness, consumer electronics, beacons, and smart home applications. The core SDK is an advanced Bluetooth 5.4-compliant stack that provides all of the core functionality along with multiple API to simplify development. The core functionality offers both standalone mode, allowing a developer to create and run their application directly on the SoC, or in NCP mode allowing for the use of an external host MCU. These release notes cover SDK version(s):
9.1.0.0 GA released April 1, 2025 9.0.1.0 GA released February 5, 2025 9.0.0.0 GA released December 16, 2024
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/bluetooth-low-energy. Silicon Labs also strongly recommends that you subscribe to Security Advisories for up-to-date information. For instructions as well as notes on using Secure Vault features, or if you are new to the Silicon Labs Bluetooth SDK, see Using This Release.

KEY FEATURES
Bluetooth · GA release of Periodic Advertisement
BGAPI event · BT LE Connection Subrating · Accept List Based Auto-connect · BT Atlanta (v6.0) LL and Host Qualifi-
cation · Channel Sounding sparse channel map
support · Channel Sounding antenna switching
support · CBAP – CPMS integration Multiprotocol · ZigbeeD and OTBR support on Open-
WRT ­ GA · DMP BLE + CMP ZB & Matter/OT with
Concurrent Listening on MG26 for SoC ­ GA · 802.15.4 Unified radio scheduler priority component · Debian packaging support for MP host applications – Alpha

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.

Copyright © 2025 by Silicon Laboratories

Bluetooth 9.1.0.0

Contents
Contents
1 New Items …………………………………………………………………………………………………………………………………………………………………… 3 1.1 New Features ……………………………………………………………………………………………………………………………………………………….. 3 1.2 New APIs……………………………………………………………………………………………………………………………………………………………… 4
2 Improvements………………………………………………………………………………………………………………………………………………………………. 5 2.1 Changed Items ……………………………………………………………………………………………………………………………………………………… 5 2.2 Changed APIs ………………………………………………………………………………………………………………………………………………………. 5
3 Fixed Issues ………………………………………………………………………………………………………………………………………………………………… 6 4 Known Issues in the Current Release ……………………………………………………………………………………………………………………………… 8 5 Deprecated Items …………………………………………………………………………………………………………………………………………………………. 9 6 Removed Items ………………………………………………………………………………………………………………………………………………………….. 10 7 Multiprotocol Gateway and RCP …………………………………………………………………………………………………………………………………… 11
7.1 New Items…………………………………………………………………………………………………………………………………………………………… 11 7.2 Improvements……………………………………………………………………………………………………………………………………………………… 11 7.3 Fixed Issues ……………………………………………………………………………………………………………………………………………………….. 12 7.4 Known Issues in the Current Release …………………………………………………………………………………………………………………….. 13 7.5 Deprecated Items ………………………………………………………………………………………………………………………………………………… 13 7.6 Removed Items …………………………………………………………………………………………………………………………………………………… 13 8 Using This Release …………………………………………………………………………………………………………………………………………………….. 14 8.1 Installation and Use ……………………………………………………………………………………………………………………………………………… 14 8.2 Security Information……………………………………………………………………………………………………………………………………………… 14 8.3 Support ………………………………………………………………………………………………………………………………………………………………. 15 8.4 SDK Release and Maintenance Policy ……………………………………………………………………………………………………………………. 15

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 2

1 New Items

New Items

1.1 New Features
Added in release 9.1.0.0
GATT Client for ATT MTU Exchange Only
Added component bluetooth_feature_gatt_client_att_mtu_request_only. This component provides a minimal GATT Client to automatically initiate an ATT MTU exchange procedure when the GATT connection is open. This component does not provide the GATT Client API. Use the GATT Server API sl_bt_gatt_server_set_max_mtu to set the maximum size of ATT MTU in the BLE Host Stack.
Components for Specific Connection Roles
Added new components bluetooth_feature_connection_role_central and bluetooth_feature_connection_role_peripheral. These components provide support for a specific connection role. When an application includes bluetooth_feature_connection, the application should also include one or both of the role-specific components based on the application’s needs. If the application includes only bluetooth_feature_connection, both connection roles will be supported for backwards compatibility.
Better Code Optimization in Bluetooth Security Manager
The Bluetooth security manager now automatically drops the central or peripheral state machine if either the bluetooth_feature_connection_role_central or the bluetooth_feature_connection_role_peripheral component, respectively, is not included, in the application.
Added in release 9.0.0.0
TX power higher than 10 dBm in low power mode
Using TX power higher than 10 dBm in low power mode is supported in NCP and SoC modes. The power limits in low power mode can be configured using sl_bt_system_linklayer_configure() with key sl_bt_system_linklayer_config_key_low_power_mode_power_limit.
New scanner option
Added a new scanner option, SL_BT_SCANNER_IGNORE_BONDING, for use with sl_bt_scanner_set_parameters_and_filter command. If the application does not need the bonding information in advertisement reports, it can set this scanner option to avoid unnecessary searching of the bondings.
New custom address option
Added a new option, SL_BT_CONFIG_SET_CUSTOM_ADDRESS_FROM_NVM3, for configuring whether the stack should use a custom address stored in the defined key in Bluetooth region of NVM3 as the device identity address. By default, this option is enabled.
Event System IPC support for Bluetooth events
The new optional component, bluetooth_event_system_ipc, provides support for getting Bluetooth events via the Event System mechanism in an application that uses an RTOS.
Connection Subrating
The new optional component, bluetooth_feature_connection_subrate, provides Bluetooth Connection Subrating feature. The feature is provided in experimental quality in this release.
LTO support in host stack libraries
Selected host stack GCC libraries are built with LTO options (-flto, -ffat-lto-objects). This enables better code size optimization if the application uses LTO.
HCI Event Filtering
Allows defining custom event filters for HCI event processing. The filter callback is called before the event is sent to the host stack. This can be used to limit unnecessary traffic over an HCI connection.
Extended RTOS support
Added RTOS variant of multiple existing example applications.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 3

New Items
ESL: Accept-List based Auto-Connect Added a new connection method to the Electronic Shelf Label (ESL) Access Point (AP) to speed up large network setup. ESL: Re-synchronisation by scanning Tags can now attempt scan-based re-synchronization on sync loss before starting to advertise (vendor specific, opt-in enhancement of ESL Tag Core component) This feature also requires the AP to advertise the PAwR parameters. ESL: preset network configuration The ESL AP can import and export network sessions to and from JSON format describing ESL groups and IDs. After importing a complete network configuration to be used by the auto mode for automatic addressing, an exclusive mode can also be set to discard any nearby advertising ESLs that are not in the configuration. The ESL AP can continue a previous network session after a power cycle by reconfiguring the same devices with the same ESL ID in the same group as before. ESL: extended key library The functionality of the ESL AP Key Library Python class has been extended to utilize the ESL Address, Response Key Material, and bonded AP fields of the key database. CS Initiator: configurable channel map The channel map of the CS Initiator example is now configurable. BRD2608A Development Kit: BRD2608A Dev Kit example application now supports the IMU sensor.
1.2 New APIs
Added in release 9.0.0.0 sl_bt_gap_get_identity_address() command: Get the Bluetooth identity address used by the device. sl_bt_gatt_read_variable_length_characteristic_values() command: Read multiple variable-length characteristic values from a remote GATT server. sl_bt_gatt_server_read_attribute_properties() command: Read the properties of an attribute from local GATT database. sl_bt_gattdb_get_attribute_state() command: Get the attribute state from local GATT database when using the dynamic GATT database feature. sl_bt_gatt_server_find_primary_service() command: Find primary services with UUID from local GATT database. sl_bt_connection_set_default_acceptable_subrate() command: Set the default acceptable parameters for subrating requests. sl_bt_connection_request_subrate() command: Request a change to the subrating factor and other parameters. sl_bt_evt_connection_subrate_changed event: Report the completion of subrating procedure or subrating parameter changes on a connection. sl_bt_evt_connection_request_subrate_failed event: Report that a subrating procedure failed. sl_bt_evt_periodic_advertiser_status event: Report the latest status of periodic advertising on an advertising set. sl_bt_system_linklayer_config_key_set_periodic_advertising_status_report (0x8): New key to sl_bt_system_linklayer_configure() to enable or disable the status report of periodic advertising.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 4

2 Improvements

Improvements

2.1 Changed Items
Changed in release 9.0.0.0

ID # 1233899
1234000
1298645 1318468 1321901 1329672 1332939
1334523
1324517

Description
Selected Bluetooth host stack libraries are compiled with LTO options (-flto -ffat-lto-objects) for allowing better dead code elimination in applications.
Certificate fields have been updated for Certificate Based Authentication and Pairing. Database added for issued certificates.
Changed returned error codes to use the actual values from NVM3 when accessing it using BGAPI.
Certificate Based Authentication and Pairing is now supported on xG22 devices.
Object tracking mode ‘stationary object tracking’ can now be selected in bt_cs_host.
Released the CBAP library source. CBAP refactoring enabled. Connection handling improved.
A bonding confirmation event is sent even when the connection has already been encrypted and pairing request is received from the central device.
BLE host stack can now operate without the presence of NVM3. To drop NVM3 from a Bluetooth application, the application must not use bluetooth_feature_builtin_bonding_database, bluetooth_feature_nvm, or bluetooth_feature_sm components.
Added link layer configuration flag to report number of transmitted packets in direct test modes.

2.2 Changed APIs
Changed in release 9.0.0.0 None.
2.3 Intended Behavior
Changed in release 9.0.0.0 None.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 5

3 Fixed Issues
Fixed in release 9.1.0.00

Fixed Issues

ID # 1404920
1405476 1417581

Description
Fixed an issue where a macro to reset the terminal colors was defined but not used. _app_log_reset_color was defined but not used in app_log.h This fix adds it to the end of macros that use _app_log_print_color.
Fixed an issue that prevented the NCP from initializing properly when BGAPI message encryption is enabled.
Fixed init time issue when one advertising handle is used by both legacy and extended advertisements. This caused a race condition which stopped the advertiser prematurely.

Fixed in release 9.0.1.0

ID # 1381647
1355908 1383315 1388519
1393811

Description
In Channel Sounding (CS) multi-connection use case, where the reflector is running CS procedures with more than one initiator, the reflector sometimes selected parameters that would lead to procedures overlap. This has been fixed.
Periodic Advertisement did not work properly in dynamic multiprotocol with OpenThread. This has been fixed.
Unused bluetooth_feature_extended_scanner component was removed from ESL AP NCP.
Fixed a regression in the built-in battery level measurement of the ESL Tag that was preventing the correct value from being measured.
Fixed a regression in the QR code generator for the ESL demo that was introduced with Pillow v11.x Python module update.

Fixed in release 9.0.0.0

ID # 845506 1082103, 1141041, 1212061 1284611
1328923
1335919 1349058 1356037
1371005
1362681 1336266

Description
The adaptivity of AFH can be disabled or enabled with command sl_bt_system_linklayer_configure() and key sl_bt_system_linklayer_config_key_set_channelmap_flags.
Using TX power higher than 10 dBm in low power mode is supported in NCP and SoC modes. The power limits in low power mode can be configured using sl_bt_system_linklayer_configure() key sl_bt_system_linklayer_config_key_low_power_mode_power_limit.
Clarified in the API documentation that starting a DTM transmitter or receiver test while other Bluetooth activities are active will either result in an error response or will cause functionality issues. The API documentation now suggests that the application should make sure other Bluetooth activities are stopped when performing a test.
Fixed an issue in dynamic GATT database feature that, after adding a new descriptor to a GATT characteristic that has been enabled to be visible to remote GATT clients, the remote GATT client cannot see the new descriptor.
Make bluetooth_feature_advertiser component configurable on Simplicity Studio component browser GUI.
Fixed an issue which allowed security properties to downgrade during re-pairing. Now the security properties must match or exceed ones used during previous pairing.
sl_bt_nvm_save(), sl_bt_nvm_load(), and sl_bt_nvm_erase() now properly validate that a specified NVM3 key is in the range assigned for user data. The key range for user data stored in the Bluetooth region of NVM3 is extended to 0x4000 – 0x5fff.
Fixed an issue in the Bluetooth LE linklayer, where an advertising device that is sending out connectable extended advertisements replies to an AUX_CONN_REQ with an invalid AUX_CONN_RSP. This issue happened when the user set a random address to the extended advertising set only.
Fixed PAwR subevent_start. It was not incrementing correctly.
Fixed an issue with sl_bt_advertiser_set_timing() not working properly with higher than 16000 (10sec). Interval_max.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 6

ID # 1330263

Fixed Issues
Description Fixed an issue in the Bluetooth LE link-layer that caused the PAwR advertiser to stop accepting subevent data setting from the host.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 7

Known Issues in the Current Release

4 Known Issues in the Current Release

Issues in bold were added since the previous release. If you have missed a release, recent release notes are available on https://www.silabs.com/developers/bluetooth-low-energy in the Tech Docs tab.

ID # 361592 368403 641122 682198
756253
1031031 1334418 1335263
1373310 1383864 1397074
1399177

Description
The sync_data event does not report TX power.
If setting CTE interval to 1, a CTE request should be sent in every connection interval. But it is sent only in every second connection interval.
The Bluetooth stack component does not provide a configuration for RF antenna path.
The Bluetooth stack has an interoperability issue on the 2M PHY with a Windows PC.
The RSSI value on a Bluetooth connection returned by the Bluetooth API is incorrect on EFR32M|B21 devices. It is about 8~10 dBm higher than the actual value, according to a measurement.
Changing the configuration in the bt_aoa_host_locator application results in the application crashing.
Channel sounding minor jitter issue when transmitting RTT sync packets on the initiators side. This might be visible when doing channel sounding to some other vendor devices.
RTOS Priorities are not set correctly in SoC/NCP case if not using dynamic multiprotocol. This might cause radio priorities to be blocked by less important priorities.
Scan event may contain additional garbage bytes in a noisy environment, where lots of BLE devices advertise at the same time.
In the Channel Sounding use case, if the unsupported Free-Running mode is selected in the configuration header file, some connections will be closed by the application and re-established.
In case of Channel Sounding multi-connection scenario, where the reflector is connected to more than one initiator, some connections may close due to operation timeout.

Workaround None
None
This is an issue specifically for BGM210P. One workaround is to manually update the configuration in sl_bluetooth_config.h in text edit mode. No workaround exists. For application development and testing, the disconnection can be avoided by disabling 2M PHY with sl_bt_connection_set_preferred_phy() or sl_bt_connection_set_default_preferred_phy(). Install the “RAIL Utility, RSSI” component in the application project. This component provides a default RSSI offset for the chip that is applied at the RAIL level and can help to achieve more accurate RSSI measurements.
None
None
Radio priorities need to set radio priorities in the application software.
None
Set the maximum procedure count to 0.
None

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 8

Deprecated Items
5 Deprecated Items
Deprecated in release 9.0.0.0 Overriding the HFXO CTUNE with a value in the NVM3 Bluetooth region is deprecated. By default, CTUNE override using NVM3 Bluetooth region is disabled. Enable it with the SL_BT_CONFIG_SET_CTUNE_FROM_NVM3 configuration. Since the Simplicity SDK 2024.12.1 release, the alternative of CTUNE override is to use the platform component clock_manager_oscillator_calibration_override. This platform component supports both the HFXO and LFXO CTUNE overrides.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 9

6 Removed Items
Removed from release 9.0.1.0

ID # 1382948

Description Bluetooth RTOS examples are no longer supported on xG22 devices.

Removed from release 9.0.0.0 sl_bt_connection_get_rssi sl_bt_rtos_has_event_waiting sl_bt_rtos_event_wait sl_bt_rtos_get_event sl_bt_rtos_set_event_handled Parameter `txsize’ of event sl_bt_evt_connection_parameters

Removed Items

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 10

7 Multiprotocol Gateway and RCP

Multiprotocol Gateway and RCP

7.1 New Items
Added in release 9.1.0.0
The zigbee_throughput plugin start command now includes an optional uint8_t argument “plugin throughput start 0” which will not clear the stack counters before a throughput test begins. This is intended for testing purposes. If no additional arugment is included and/or not 0, the current behavior remains the same and will clear the device counters when a throughput test begins.
Added in release 9.0.0.0
Enabled GA SoC support for BLE DMP with Zigbee + Openthread CMP with concurrent listening on xG26 parts.
Debian alpha support has been added for zigbeed, OTBR and Z3Gateway applications. Zigbeed and OTBR are provided in DEB package format for the chosen reference platform (Raspberry PI 4) as well. See Running Zigbee, OpenThread, and Bluetooth Concurrently on a Linux Host with a Multiprotocol Co-Processor, for details.
Added Zigbeed support for Tizen-0.1-13.1 for arm32 and aarch64 as well as Android 12 for aarch64. More information on Zigbeed can be found at docs.silabs.com.
Added the new “802.15.4 Unified radio scheduler priority” component. This component is used to configure the radio priorities of a 15.4 stack. The component also requires the new “radio_priority_configurator” component. This component allows projects to use the Radio Priority Configurator tool in Simplicity Studio to configure the radio priority levels of the stacks that require it.

7.2 Improvements
Changed in release 9.1.0.0
The Zigbee-NCP + OpenThread-RCP (UART & SPI) samples, as well as the Zigbee-NCP + BLE-NCP (UART & SPI) samples, are now only allowed for generation on parts with sufficient RAM (>=96kB).
Changed in release 9.0.1.0
The Zigbee BLE – DynamicMultiprotocolLightSed sample project can now be built for boards with only one LED if the LED1 component is excluded from the project.
This revision has the following improvements for multi-protocol applications when, for example, running Zigbee or OpenThread for the custom use-case of running one protocol at a time: · The sl_zigbee_af_zll_unset_factory_new() API has been added to allow applications to unset a Zigbee node from the default factory
new state when necessary. · A callback, sl_rail_mux_invalid_rx_channel_detected_cb(), has been added to Zigbee+OT applications. This callback notifies the
application when there has been an attempted RX on two different channels while concurrent listening is not enabled. The application can then implement its own logic to handle this situation.
Changed in release 9.0.0.0
Application note Running Zigbee, OpenThread, and Bluetooth Concurrently on a Linux Host with a Multiprotocol Co-Processor (AN1333) has been moved to docs.silabs.com.
OpenWRT support is now GA quality. OpenWRT support has been added for zigbeed, OTBR and Z3Gateway applications. Zigbeed and OTBR are provided in IPK package format for the reference platform (Raspberry PI 4) as well. See Running Zigbee, OpenThread, and Bluetooth Concurrently on a Linux Host with a Multiprotocol Co-Processor, for details.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 11

7.3 Fixed Issues
Fixed in release 9.1.0.0

Multiprotocol Gateway and RCP

ID # 1392015
1393057 1399687 1420018

Description
SL_OPENTHREAD_ENABLE_SERIAL_TASK is now set to 0 by default to reduce the task memory size which is not required for RCP applications. (Other ref: 1424440)
Fixed an issue where the Zigbee-NCP + OpenThread-RCP (UART & SPI) samples, as well as the Zigbee-NCP + BLE-NCP (UART & SPI) samples, were allowed for generation on parts with insufficient RAM.
Fixed an issue where the Zigbee-BLE DMP Light app may fail to go to EM2 sleep.
Fixed an issue where a CPC message from an RTOS-enabled RCP to host could be waiting in a send queue until something woke up the serial task.

Fixed in release 9.0.1.0

ID #
1363050
1378298 1381165

Description
Zigbee stack initialization no longer activates the radio (or RCP for host stacks) prior to stack APIs being called by the application. This prevents unwanted multi-PAN operation on Channel 11 (the default channel) when using a multiPAN-capable RCP configuration. (Other ref: 1390724)
Fixed an issue that caused a crash when entering “keys print” on an DMP Light app with LTO enabled.
Fixed an issue on Zigbee-NCP + OT-RCP, when disabling PTA would have caused NCP/RCP reset.

Fixed in release 9.0.0.0

ID # 1275378 1300848 1332330
1337101
1337228 1337295 1346785 1346849 1365665

Description
Fixed an issue where calling sl_802154_radio_set_scheduler_priorities() prior to sli_mac_lower_mac_init() could result in a crash.
Fixed an issue where Z3Gateway in OpenWRT environment couldn’t start EZSP communication caused by mismatching termios control characters running on OpenWRT and other environments.
Fixed an issue where a 15.4+BLE RCP operating in an environment with heavy network traffic could occasionally encounter a race condition that would leave it unable to send messages up to CPCd until rebooting the device.
Incomplete 15.4 transmit operations (Tx waiting for an ack, Tx an ack in response to a message, etc) are no longer prematurely considered as failed upon radio interruption due to DMP. This allows said operation to be given a chance to be rescheduled after the interruption or permanently failed by RAIL (scheduler status error events).
In Zigbeed the halCommonGetInt32uMillisecondTick() tick API is now updated to use MONOTONIC clock, so that it does not get affected by the NTP in a host system.
The DMP CLI command “plugin ble gap print-connections” will now print “No BLE connections” if the connection table is empty, instead of providing no response.
Fixed a race condition which could cause concurrent listening to be disabled on the 802.15.4 RCP when both protocols were transmitting simultaneously.
Adding the rail_mux components to a project will now cause it to automatically build with the associated stack library variants.
Fixed an issue where the host would report receiving a packet with an invalid checksum on end-point 12.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 12

Multiprotocol Gateway and RCP

7.4 Known Issues in the Current Release
Issues in bold were added since the previous release. If you have missed a release, recent release notes are available on https://www.silabs.com/developers/simplicity-software-development-kit.

ID # 937562 1074205 1122723 1209958 1221299 1385052
1385486

Description

Workaround

Bluetoothctl `advertise on’ command fails with rcp-uart802154-blehci app on Raspberry Pi OS 11.

Use btmgmt app instead of bluetoothctl.

The CMP RCP does not support two networks on the same PAN id.

Use different PAN ids for each network. Support is planned in a future release.

In a busy environment, the CLI may become unresponsive in the z3-light_ot-ftd_soc app.

No known workaround.

The ZB/OT/BLE RCP using concurrent listening on MG24 and MG21 may stop working in endurance test (lasts ~2 hours) with constant and concurrent traffic on all 3 stacks.

Disable concurrent listening in use cases involving constant and concurrent traffic across all 3 protocols.

Mfglib RSSI readings differ between RCP and NCP.

Will be addressed in a future release.

Coex-enabled RCP may still occasionally transmit TX ACK after losing the Grant even when Acking is disabled and TX Abort is enabled.

Will be addressed in a future release.

TX from RCP may infrequently happen without the request after turning on the non-802.15.4 compliant MAC Holdoff coex option.

Will be addressed in a future release.

7.5 Deprecated Items
The “Multiprotocol Container” which is currently available on DockerHub (siliconlabsinc/multiprotocol) will be deprecated in an upcoming release. The container will no longer be updated and able to be pulled from DockerHub. The Debian-based packages for cpcd, zigbeed, and ot-br-posix, along with natively generated and compiled projects, will replace the functionality lost with the removal of the container.
7.6 Removed Items
Removed in release 9.0.1.0 sl_sec_man_init() has been removed, since it no longer serves a purpose. Removed in release 9.0.0.0 None.

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 13

Using This Release
8 Using This Release
This release contains the following · Silicon Labs Bluetooth stack library · Bluetooth sample applications For more information about the Bluetooth SDK see https://docs.silabs.com/bluetooth/latest/ . If you are new to Bluetooth see UG103.14: Bluetooth LE Fundamentals.

8.1 Installation and Use
The Bluetooth 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 GSDK 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 Simplicity by default in: · (Windows): C:Users<NAME>SimplicityStudioSDKssimplicity_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/.

8.2 Security Information
Secure Vault Integration
When deployed to Secure Vault High devices, sensitive keys such as the Long Term Key (LTK) are protected using the Secure Vault Key Management functionality. The table below shows the protected keys and their storage protection characteristics.

Wrapped Key Remote Long Term Key (LTK) Local Long Term Key (legacy only) Remote Identity Resolving Key (IRK)
Local Identity Resolving Key

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

Notes
Must be Exportable for future compatibility reasons Must be Exportable because the key is shared with other devices.

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.

Bluetooth 9.1.0.0 | 14

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.

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

silabs.com | Building a more connected world.

Bluetooth 9.1.0.0 | 15

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

Documents / Resources

SILICON LABS xG22 Bluetooth LE SDK Software [pdf] User Guide xG22, xG22 Bluetooth LE SDK Software, Bluetooth LE SDK Software, LE SDK Software, SDK Software, Software

References

• User Manual