WiSeConnect Release Notes#

Release notes are provided with each version of the WiSeConnect™ SDK.

WiSeConnect 2.6.1 Release Notes#

Last updated: September 14, 2022

Highlights#

  • Bug fixes

Release Details#

Item

Details

Release date

September 16, 2022

API Version (SAPI)

2.6.1 (Build 6)

Firmware Version

2.6.1.6 (Build 6)

Package Name

RS9116W.2.6.1.6

Supported RTOS

FreeRTOS

Hardware Modules

QMS, B00, C00, CC1, AB0, AB1, AA0, AA1

Hardware Chipsets

Chip Revision 1.4, Chip Revision 1.5

Operating Modes Supported

Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE

Additional Operating Modes Supported (Beta Quality)

Wi-Fi STA+BT, Wi-Fi STA+BT+BLE

Updating to this Release#

RS9116W 2.6.1 release consists of two components, as follows:

  • Firmware - RS9116 Firmware Binary

  • SAPI Library - SAPI Library runs on Host

This release is meant only for use with designs based on RS9116 Silicon rev 1.4 (RS9116X-xxx-xxx-Bxx) and RS9116 Silicon rev 1.5 (RS9116X-xxx-xxx-Cxx).
Customers using the RS9116X-xxx-xxx-Xxx parts (Silicon rev 1.3) can also upgrade to the latest firmware, however the power optimization feature macro EXT_FEAT_LOW_POWER_MODE must be disabled for revision 1.3.

Choose the firmware to match the silicon revision used in your design, as follows:

  • RS9116W.2.6.1.0.6.rps

    • RS9116X-xxx-xxx-Xxx (Silicon rev 1.3)

    • RS9116X-xxx-xxx-Bxx (Silicon rev 1.4)

  • RS916W.2.6.1.0.6.rps

    • RS9116X-xxx-xxx-Cxx (Silicon rev 1.5)

Changes and Fixes#

Wi-Fi#

  • Resolved issues with DHCP renewal process when HTTP download is in progress.

  • Enhanced frequency offset calibration by reducing the number of iterations required. Also added checks to ensure frequency offset tuning doesn't get wrapped-around.

  • Resolved stability issues with static IP assignment when a duplicate IP address on the network is configured on STA.

  • For RSSI Query, responding with beacon avg rssi instead of last beacon RSSI.

  • Memory read/write support added in AT mode.

  • Fixed firmware stuck issue in WAP3 connection failure cases and also added changes to support WPA3-R3 certification.

  • Fixed issue with error code 0x0015 observed for Configuration save or Configuration Enable commands with some Opermode configurations. Bluetooth

  • Fix for fragmentation issue with 1Mbps to improve BLE performance.

  • Fix to change BLE advertise frame Tx power by rsibt_updategaintableoffsetMaxpower.

  • Fix to reduce the timing for BT pairing and connection with with BT_Power_save application.

  • Fix for BLE disconnection with different error coes (4e08,4e22,4e3e) in AT modes.

  • Fix to improve BLE scan performance on 1.3 revison boards.

  • Fix for disconnection in audio streaming after connecting DUT to remote BLE device.

  • Fix to get exact response for "at+rsibt_getlocalcod?" command.

  • Fix for Bluetooth classic work in the coex mode of RSI_OPERMODE_WLAN_BT_DUAL_MODE.

  • Fix for module returning the improper remote device MTU size in the rsi_bt_app_on_spp_connect callback.

  • Fix for first byte missing During the spp_tx in AT_commands.

  • Fix for AFH map reported by HCI command HCI_Read_AFH_Channel_Map.

  • Fix for bluetooth AFH disabling after role switch.

  • Fix for SPP issues reported by automation team.

  • Fix for BLE TX Power is not changing for TELEC and KCC regions.

  • Fix for BLE SMP connection, if pairing information available, slave does not require to send pairing request. Documentation

  • Updated documentation for user store configurations feature.

  • Updated Wi-Fi PRM with information on the commands supported in concurrent mode.

  • Indicating error(0xFFF8) for UDP command when wrong parameters are issued.

  • Added a note point in SAPI PRM that provided values for x0_ctune in calibration app.

  • Updated the Document by adding WPA3 new features. Known Issues

  • Power save in PTA 3-Wire Co-Existence functionality requires a weak pull up to be applied to the GRANT pin. However, Beacon protection with power save is unsupported.

WiSeConnect 2.6 Release Notes#

Index#

Highlights#

  • Support for storing server IP and port in non-volatile memory

  • IP conflict detection support for RS9116 internal network stack

  • SNI (Server Name Indication) support for RS9116 silicon revision 1.4 and 1.5

  • Enhancements to support for logging

  • Enhancements to PTA 3-wire coexistence to protect beacon reception

  • Swyentooh and braktooth vulnerability fixes for BT/BLE

Release Details#

Item

Details

Release date

June 15, 2022

API Version (SAPI)

2.6.0 (Build 34)

Firmware Version

2.6.0 (Build 34)

Package Name

RS9116W.2.6.0.34

Supported RTOS

FreeRTOS

Hardware Modules

QMS, B00, C00, CC1, AB0, AB1, AA0, AA1

Hardware Chipsets

Chip Revision 1.4, Chip Revision 1.5

Operating Modes Supported

Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE

Additional Operating Modes Supported (Beta Quality)

Wi-Fi STA+BT, Wi-Fi STA+BT+BLE

Updating to this Release#

RS9116W 2.6 release consists of two components, as follows:

  • Firmware - RS9116 Firmware Binary

  • SAPI Library - SAPI Library runs on Host

This release is meant only for use with designs based on RS9116 Silicon rev 1.4 (RS9116X-xxx-xxx-Bxx) and RS9116 Silicon rev 1.5 (RS9116X-xxx-xxx-Cxx). Customers using the RS9116X-xxx-xxx-Xxx parts (Silicon rev 1.3) can also upgrade to the latest firmware, however the power optimization feature macro EXT_FEAT_LOW_POWER_MODE must be disabled for revision 1.3.

Choose the firmware to match the silicon revision used in your design, as follows:

  • RS9116W.2.6.0.0.34.rps

    • RS9116X-xxx-xxx-Xxx (Silicon rev 1.3)

    • RS9116X-xxx-xxx-Bxx (Silicon rev 1.4)

  • RS916W.2.6.0.0.34.rps

    • RS9116X-xxx-xxx-Cxx (Silicon rev 1.5)

This release includes bug-fixes, enhancements, relevant AT command updates, new SAPI features, and firmware. Most of the new features have associated APIs, which are available in the latest SAPI implementation only. It is strongly recommended to upgrade SAPI and Firmware together.

New Features#

Wi-Fi#

  • Support for storing server IP and port in non-volatile memory

  • IP Conflict detection support for RS9116 internal network stack

  • SNI (Server Name Indication) support for RS9116 silicon revision 1.4 and 1.5

  • Enhancements to PTA 3-Wire coexitence to protect beacon reception

Bluetooth - Common#

  • Swyentooh and braktooth vulnerability fixes for BT/BLE

General#

  • Enhancements to support for logging

  • Wi-Fi interoperability bug fixes

Changes and Fixes#

  • rsi_recv timeout granularity changed from 1s to 10 ms.

  • Fix for BLE disconnection and BLE SMP connection issues in example applications

  • Fix for Wi-Fi reconnections due to improper handling of isolated cipher mismatch event

  • Fix in example application for SonyMDR headset glitch issue

  • Fix for glitches and audio pauses for AirPods Pro, Sennheiser, Jabra Elite and Mi Earphones while connected to Wi-Fi

  • Fix for the issue where at+rsi_scan return invalid channel in case of reconnection with 5GHz band AP

  • Fix for HTTPS file download issue in EAP-TLS network

New APIs#

For a complete list of new APIs, see SAPI Changelog

Recommendations and New Options#

Wi-Fi#

  • To ensure graceful handling during asynchronous TCP closures from a peer, enable the opermode parameter ext_tcp_ip_feature_bit_map[16]

  • Enable aggregation using the opermode parameter feature_bit_map[2]

  • To avoid TCP disconnects during a rejoin, set TCP retransmission count to >= 30

  • To make a connection more robust for low throughput applications in busy networks, disable high MCS rates. For example, in a congested wireless envionment, a Smart Lock may benefit by disabling MCS6 and MCS7.

  • To restart the RS9116, the application should call rsi_driver_deinit() followed by rsi_driver_init() and rsi_device_init(). For OS cases, additionally call rsi_task_destroy(driver_task_handle) to delete the driver task before calling rsi_driver_deinit() and create again after rsi_device_init() using rsi_task_create().

  • Register the 'Join Fail Callback' function each time join is called. This is required because if a join fails, the callback is deregistered. Failure to register the callback may stop scan working correctly on a rejoin failure.

BT/BLE#

  • In BLE, the recommended range of the BLEConnection Interval is as follows:

    • Power Save (BLE Only) - 100 ms to 1.28 s

    • BT Classic + BLE Dual Mode is >= 200 ms

    • Wi-Fi + BLE coex - 30 ms to 250 ms

  • In BLE during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended

  • In BT Classic, the recommended Sniff Interval configuration during powersave is limited to 100 ms (<= 100).

  • In BLE, if a device is acting as Central, the scan window (in set_scan_params() and create_connection() APIs) must be less than the existing Connection Interval.

  • In BLE mode, if scanning and advertising is in progress, and the device subsequently connects and moves to the central role, scanning and advertising stops. To further establish connection to another peripheral device or to a central device, the application must initiate advertising and scanning again.

  • Device powersave must be disabled prior to BT init and de-init.

Co-Existence#

  • For concurrent Wi-Fi + BLE, and while a Wi-Fi connection is active, we recommend setting the ratio of the BLE scan window to BLE scan interval to 1:3 or 1:4.

  • Wi-Fi + BLE Advertising

    • All standard advertising intervals are supported. As Wi-Fi throughput is increased, a slight difference in on-air advertisements compared to configured intervals may be observed.

    • BLE advertising is skipped if the advertising interval collides with Wi-Fi activity.

  • Wi-Fi + BLE scanning

    • All standard scan intervals are supported. For better scan results, we recommend setting the ratio of the BLE scan window to BLE scan interval to 1:3 or 1:4.

    • BLE scanning will be stopped for intervals that collide with Wi-Fi activity.

  • Wi-Fi + BLE Central/Peripheral Connections

    • All standard connection intervals are supported.

    • For a stable connection, use optimal connection intervals and max supervision timeout in the presence of Wi-Fi activity.

  • Wi-Fi + BLE Central/Peripheral Data Transfer

    • To achieve higher throughput for both Wi-Fi and BLE, use medium connection intervals, such as 45 to 80 ms with maximum supervision timeout.

    • Ensure Wi-Fi activity consumes lower intervals.

  • For Wi-Fi + BT + BLE, Wi-Fi + BT, Wi-Fi + BLE operating modes, connect Wi-Fi before BT/BLE connections to ensure seamless, stable connection for all 3 protocols.

  • For Wi-Fi + BT + BLE, Wi-Fi + BT, Wi-Fi + BLE operating modes, if BT/BLE needs to be connected before a Wi-Fi connection, use with high supervision timeout and high connection interval for BLE and high sniff interval for BT, to ensure seamless, stable connection. This configuration also ensures a stable BT/BLE connection when Wi-Fi connects/disconnects/rejoins.

  • Wi-Fi + BLE Central/Peripheral Data Transfer

System#

  • For User Store configuration and Configuration Save, do not enable power save or save it as a configuration. If power save is enabled and saved as a configuration, upon boot up, the RS9116 will boot with the saved configuration and will go to powersave without any indication to the host.

  • Set the compiler optimization level to O0 in project settings for IDE (KEIL).

  • Memory configuration must be 384K for BT/BLE and co-ex operating modes

    • Usage of low power flash mode bit (bit 19 in extended customer feature bitmap). Enable this bit for ultra low power standby associated scenarios. This results in about 20µA lower Wi-Fi standby associated current consumption.

  • Memory Configuration in SAPI functions: The default memory configuration is 384K. The memory configuration can be changed to 256/320/384kB by changing the macros defined in the following files:

    • In rsi_wlan_config.h : RSI_EXT_CUSTOM_FEATURE_BIT_MAP EXT_FEAT_256K_MODE or EXT_FEAT_320K_MODE or EXT_FEAT_384K_MODE

    • In rsi_common.c : rsi_uint32_to_4bytes(rsi_opermode->ext_custom_feature_bit_map, (EXT_FEAT_256K_MODE (or) EXT_FEAT_320K_MODE (or) EXT_FEAT_384K_MODE | RSI_EXT_CUSTOM_FEATURE_BIT_MAP));

  • Apply Opermode commands in AT mode correctly. Using the wrong opermode may lead to unspecified behavior.

  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.

  • During firmware updates, powersave operation should be disabled.

  • For high throughput applications, powersave operation should be disabled.

  • The application must set the real-time clock with correct timestamp when the feature is enabled before establishing a TLS connection.

  • The socket select and socket receive timeout must be at least 1 second. A timeout value under 1 second is not supported.

  • For more details, see 'Configuration parameters' in the SAPI Reference Manual.

Known Issues#

Network Stack#

  • DHCP renewal during HTTP download may fail, this may cause disconnection.

  • Sometimes during a TLS handshake, ECC curve parameters may be incorrectly generated resulting in connection failure with BBD2 error. However, this recovers in the next attempt.

  • MQTT disconnects during firmware update when power save is enabled. Disable power save during firmware update and re-enable on update completion.

  • All GCM-based cipher suites are implemented in software and have limited performance.

  • The recommended MQTT publish payload is 1 kBytes.

  • If HTTP server functionality is enabled, do not use port 80 for the MQTT client.

  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with powersave.

  • Secure TLS renegotiation is not supported in the embedded networking stack.

  • IPv6 support is not available in this release.

Wi-Fi#

  • WPA3 known issues

    • Connection takes about 3-4 second

    • SAE H2E (Hash to Element) is not supported

    • Transition disable indication is not supported

    • PMK SA caching is not supported

  • If the station performs a scan in concurrent mode (Wi-Fi STA+AP), stations connected to the AP may be disconnected. Enable AP after STA connection is completed.

  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

  • If background scan is enabled along with custom feature bit map bit (8) configuration of the DFS channel support, issues may occur in obtaining an IP address for the Wi-Fi STA.

  • In fast PSP, configuration socket close is observed in full duplex communication in long duration tests.

  • PTA 3-wire co-existence does not work with powersave. However, if a weak pull up is applied to the GRANT pin, PTA 3-wire functionality will work with powersave. Details can be found in application notes.

BT/BLE#

  • SPP as MASTER connection doesn't work in AT/Binary mode

  • In AT Mode for SPP Transfer the first byte is missing

  • BT/BLE User Gain table APIs don't work for Korea and Japan region

  • In the configuration of WLAN connection, BT A2DP Streaming and BLE Slave connection with SMP mode, BLE disconnections are observed

  • Wake on Wireless is not supported for BLE.

  • BT-HID may not interoperate with Apple devices.

  • In Wi-Fi + BT/BLE Co-Ex mode, high Wi-Fi broadcast traffic might cause BT/BLE disconnections.

  • In Wi-Fi + BT mode when there is continuous Wi-Fi data, you might observe BT not re-connecting to remote after disconnection.

  • BT-A2DP may not interoperate with some headsets.

  • For BLE, dual role scenario issues may occur when connecting as a central when the peripheral is advertising. Central connections can be made after peripheral connections are established and advertising stops.

  • A BLE disconnection will occur if both the peer and RS9116 already have bond info and the RS9116 initiates security as part of BLE secure connections. To workaround this issue, the application should not initiate a security request if it already has bond info.

  • A2DP music streaming glitches may be observed if a Wi-Fi download is in progress at the same time.

Co-Existence#

  • After powersave is enabled in co-ex mode, radio_init() must be called to turn off powersave.

  • In Wi-Fi + BLE mode:

    • BLE may disconnect when the supervision timeout is configured to less than 16 seconds.

    • WPS does not work.

  • In Wi-Fi + BLE / BLE only modes:

    • For SPI as host interface, continuous BLE Tx notification may cause the host interface to hang needing a hardware reset. The issue is not seen with discrete burst BLE data.

    • When Wi-Fi disconnects, a BT/BLE reconnection issue is observed.

Interoperability#

  • Disconnection may occur in Wi-Fi client mode if an AP does not acknowledge QoS null frames with powersave configured.

  • Under some scenarios, the RS9116 may not send unicast probe requests if the access point does not send beacons as expected. This may result in disconnection from the AP.

System#

  • Chip Revision 1.3 doesn't support Low power mode optimization using bit setting defined by EXT_FEAT_LOW_POWER_MODE, setting this results in hang issue.

  • Sometimes the RS9116 enters powersave mode before the configured monitor interval for inactivity when co-ex is configured.

  • Wake on Wireless support has only been tested for the UART AT command interface.

  • Powersave without RAM retention does not work when the SPI interface is used.

  • The FTP client application does not work with EFx32/STM32 when an RTOS is used.

  • The HTTP OTA update application does not work with EFR32 and EFM32 when an RTOS is used.

  • Firmware update does not work for the EFM32 platform.

Limitations and Unsupported Features#

Wi-Fi/Network Stack#

  • AMSDU transmit is not supported.

  • Fragmentation is not supported.

  • AMSDU's within AMPDU is not supported.

  • Currently, the RS9116 does not support the radio measurement requests feature of CCX V2

  • 802.11k is not supported

  • Short GI is not supported

  • 40 MHz bandwidth for both the 2.4 & 5 GHz band is not supported.

  • 802.11j channels less than 16 are not supported.

  • The USB host interface and USB powersave are not supported.

  • In AT mode, the total MQTT command length (apart from MQTT publish) should not exceed 150 bytes. This includes at+rsi (start of command) to (end of command)\r\n.

  • Configure MQTT_VERSION in rsi_mqtt_client.h based on the server configuration; only version 3 and 4 are supported.

  • 3xTLS connections or 1xTCP and 2xTLS connection, connections are supported concurrently in Wi-Fi only mode.

  • TLS curve IDs supported are 15-28. TLS handshake with 3rd party clients depends on the TLS curve.

BT/BLE#

  • BT A2DP is only supported for RS9116 silicon revision 1.5.

  • BT sniff mode does not work if BT multiple slaves feature is enabled.

  • For BLE, if the connection is established with a small connection interval (<15 ms), simultaneous roles are not supported (i.e., Central/Peripheral + Advertising/Scanning).

  • A maximum of 2 concurrent BLE connections are supported; the connections can be either a connection to two peripheral devices or to 1 central and 1 peripheral device.

  • For BT Classic, only 1 connection is supported at any time.

  • BLE slave latency value is valid up to 32 only.

  • BT-A2DP encoder is not supported in the firmware.

  • BT-A2DP not supported in AT mode.

Co-Existence#

  • In Wi-Fi + BLE mode, if BLE scan interval and window have the same value, then there will be issue in making successful Wi-Fi connection.

  • For AT commands, Wi-Fi + BT + BLE (Opermode 9), BT + BLE (Opermode 8) do not work.

  • Wi-Fi STA + BT + BLE multiprotocol use cases require a detailed understanding of use cases and associated configurations. Contact Silicon Labs support for additional details.

  • Wi-Fi AP + BLE, Wi-Fi AP + BT & Wi-Fi AP + BT + BLE modes are not supported.


WiSeConnect 2.5.2 Release Notes#

Last updated: April 13, 2022

Highlights#

  • Issue fixes

Release Details#

Item

Details

Release date

April 13, 2022

API Version (SAPI)

2.5.2 (Build 4)

Firmware Version

2.5.2.0.4 (Build 4)

Package Name

RS9116W.2.5.2.0.4

Supported RTOS

FreeRTOS

Hardware Modules

QMS, B00, C00, CC1, AB0, AB1, AA0, AA1

Hardware Chipsets

Chip Revision 1.4, Chip Revision 1.5

Operating Modes Supported

Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE

Additional Operating Modes Supported (Beta Quality)

Wi-Fi STA+BT, Wi-Fi STA+BT+BLE

Updating to this Release#

RS9116W 2.5.2 release consists of two components

  • Firmware - RS9116 Firmware Binary

  • SAPI Library - SAPI Library runs on Host

This release contains bug-fixes and firmware binary updates. It is strongly recommended to update SAPI and firmware together.

Changes and Fixes#

  • Fix for Bluetooth SPP Rx latency with SDIO as host interface

  • Fix for Bluetooth host application freeze issue with SDIO as host interface

  • Documentation updates to address following issues

    • SNTP Error BB08

    • BT Classic and BLE PER Stats command responses are NULL

Known Issues#

  • PTA 3-Wire is not supported with power save being enabled.


WiSeConnect 2.5.1 Release Notes#

Last updated: March 29, 2022

Highlights#

  • PTA 3-Wire Co-Existence support in Wi-Fi only mode with Thread protocol

  • Issue fixes

Release Details#

Item

Details

Release date

March 29, 2022

API Version (SAPI)

2.5.1 (Build 5)

Firmware Version

2.5.1.5 (Build 5)

Package Name

RS9116W.2.5.1.5

Supported RTOS

FreeRTOS

Hardware Modules

QMS, B00, C00, CC1, AB0, AB1, AA0, AA1

Hardware Chipsets

Chip Revision 1.4, Chip Revision 1.5

Operating Modes Supported

Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE

Additional Operating Modes Supported (Beta Quality)

Wi-Fi STA+BT, Wi-Fi STA+BT+BLE

Updating to this Release#

RS9116W 2.5.1 release consists of two components

  • Firmware - RS9116 Firmware Binary

  • SAPI Library - SAPI Library runs on Host

This release contains bug-fixes and firmware binary updates. It is strongly recommended to update SAPI and firmware together.

Changes and Fixes#

  • PTA 3-Wire Co-existence support in Wi-Fi only mode with Thread protocol

  • Fix for rsi_timer_left() to return the remaining time for expiry instead of total time expired so far

  • Fix for low transmit power issue reported on latest AA0 modules

  • Fix for firmware version showing differently in the package and in the software

  • Fix for configuration of SPI_INTR to active low

  • Fix for regulator voltages (VOUTLDOAFE, UULP_VOUTSCDC) not matching data sheet specifications

  • Fix for HTTP OTAF upgrade issue when done with corrupt firmware in loop

  • Fix for EAP TLS certificate loading issue in TCP/IP bypass enabled mode

  • Fix for SNTP BB08 error


WiSeConnect 2.5 Release Notes#

Index#

Highlights#

  • Support for RS9116 chip revision 1.5

  • WPA2 Security Enhancements support

  • WPA3 Personal support for Station Mode

  • Support for Enhanced MaxPSP in Co-Ex Mode

  • Support for FAST PSP

  • PTA 3-Wire Co-existence Support for Wi-Fi as PTA Master

  • BT/BLE User Gain API support

  • WRECK Vulnerability fixes

  • FragAttacks vulnerability Fixes

  • SDIO Interface support

  • A2DP Source support with Co-existence

  • EFM32 (Silicon Labs MCU SLSTK3701A) platform support

Release Details#

Item

Details

Release date

December 31, 2021

API Version (SAPI)

2.5.0 (Build 26)

Firmware Version

2.5.0 (Build 26)

Package Name

RS9116W.2.5.0.26

Supported RTOS

FreeRTOS

Hardware Modules

QMS, B00, C00, CC1, AB0, AB1, AA0, AA1

Hardware Chipsets

Chip Revision 1.4, Chip Revision 1.5

Operating Modes Supported

Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE

Additional Operating Modes Supported (Beta Quality)

Wi-Fi STA+BT, Wi-Fi STA+BT+BLE

Updating to this Release#

RS9116W 2.5 release consists of two components, as follows:

  • Firmware - RS9116 Firmware Binary

  • SAPI Library - SAPI Library runs on Host

This release is meant only for use with designs based on RS9116 Silicon rev 1.4 (RS9116X-xxx-xxx-Bxx) and RS9116 Silicon rev 1.5 (RS9116X-xxx-xxx-Cxx).
Customers using the RS9116X-xxx-xxx-Xxx parts (Silicon rev 1.3) can also upgrade to the latest firmware. However, you will have to disable the power optimization feature enabling macro EXT_FEAT_LOW_POWER_MODE.

Choose the firmware to match the silicon revision used in your design, as follows:

  • RS9116W.2.5.0.26.rps

    • RS9116X-xxx-xxx-Xxx (Silicon rev 1.3)

    • RS9116X-xxx-xxx-Bxx (Silicon rev 1.4)

  • RS916W.2.5.0.26.rps

    • RS9116X-xxx-xxx-Cxx (Silicon rev 1.5)

This release has bug-fixes, enhancements, relevant AT command updates, new SAPI features, and firmware. Most of the new features have associated APIs, which are available in the latest SAPI implementation only. It is strongly recommended to upgrade SAPI and Firmware together.

New Features#

Wi-Fi#

  • WPA2 Security Enhancements

  • WPA3 Personal Support for Station Mode

  • Support for Enhanced MaxPSP in Co-Ex Mode

  • Support for FAST PSP

  • WRECK Vulnerability Fixes

  • FragAttacks Vulnerability Fixes

  • PTA 3-Wire Co-Existence Support in Wi-Fi only mode (with external Zigbee and BLE)

Bluetooth - Common#

  • BT/BLE User Gain API support

Bluetooth - Classic#

  • Support for BT Advanced Audio Distribution Profile Source in Co-Ex mode. An example application project is included for the RT595 host platform. This is supported for Chip Revision 1.5 only.

Power Save#

  • None

General#

  • Support for RS9116 chip revision 1.5

  • Support for SDIO interface

  • Logging Infrastructure support for SAPI logging

  • 802.11b Tx gain table improvements for chip revision 1.5 QMS

  • Chip revision 1.5 B00 certified FCC/ETSI/TELEC gain tables included

  • RS9116X-DB00-CCX-BXX certified TELEC gain tables included

  • TELEC certified

  • Support for examples on EFM32 (Silicon Labs MCU SLSTK3701A) platform for SDIO interface only

  • Certified gain tables for FCC/IC, CE and TELEC are included in the release package in the folder: .../resources/gain_tables

Changes and Fixes#

  • Fix for BT connectivity issue with HID profile with Windows 10 PC

  • New API, which allows destroying a driver task before driver de-initialization to facilitate clean termination

  • Fix for WLAN scan issue with error code 3 in some of the 1.3-based AA0 modules(RS9116X-SB00-AAX-XXX)

  • Fix for Module not responsive after few iterations of SPP profile data transfer in AT mode

  • Fix for SPP throughput issue

  • Fix for UDP Server socket issue in AP mode New APIs

For a complete list of new APIs, see SAPI Changelog

Recommendations and New Options#

Wi-Fi#

  • Enable bit 16 of the 'Extended TCP IP Feature' bit map in opermode command for all Wi-Fi socket operations from host to ensure graceful handling during asynchronous closures from peer.

  • Enable aggregation (bit 2 of feature_bit_map) in opermode.

  • TCP retransmission count value should be 30 or higher, so that the TCP does not disconnect while the rejoin happens.

  • For low throughput applications, such as smart lock, disabling the highest MCS rates, such as MCS7 and MCS6 might help reducing packet retransmissions and ensure robust connection during heavy interference.

  • To restart the RS9116, the application needs to call rsi_driver_deinit() followed by rsi_driver_init() and rsi_device_init(). For OS cases, additionally call rsi_task_destroy(driver_task_handle) to delete the driver task before calling rsi_driver_deinit() and create again after rsi_device_init() using rsi_task_create().

  • Register 'Join Fail Callback' function every time when join is called, as in the rejoin failure path the callback is deregistered. If not done, this may result in scan not working on rejoin failure.

BT/BLE#

  • In BLE, the recommended range of the connection interval is as follows:

    • Power Save (BLE Only) - 100 ms to 1.28 s

    • BT Classic + BLE Dual Mode is >= 200 ms

    • Wi-Fi + BLE coex - 30 ms to 250 ms

  • In BLE during connection, the configuration of scan interval and scan window with the same value is not recommended.

  • In BT Classic, the recommended sniff interval configuration during powersave is limited to 100 ms (<= 100).

  • In BLE, if a device is acting as central, the scan window (in set_scan_params and create_connection command) must be less than the existing connection interval.

  • In BLE mode, if scanning and advertising is in progress and subsequently gets connected and moves to the central role, scanning and advertising stops. To further establish connection to another peripheral device or to a central device, the application should - give a command for starting advertising and scanning again.

  • Device Power save need to be disabled before BT init and de-init.

Co-Existence#

  • For Wi-Fi + BLE, during Wi-Fi connection, lesser BLE scan Window and larger BLE scan Interval are recommended (1:3 or 1:4).

  • Wi-Fi + BLE Advertising

    • All advertising intervals are supported, as per the BT Spec. If the Wi-Fi transactions are more, you may see a slight difference in on-air advertisements compared to the configured intervals.

    • BLE Advertising will be stopped for intervals that collide with Wi-Fi activity.

  • Wi-Fi + BLE scanning

    • All scan intervals are supported as per BT Spec. For better scan results, use scan-window and scan interval in 1:3 or 1:4 ratio when the Wi-Fi scan activity is present.

    • BLE scanning will be stopped for intervals that collide with Wi-Fi activity.

  • Wi-Fi + BLE Central/Peripheral Connections

    • All connection intervals are supported as per BT Spec.

    • For a stable connection, use optimal connection intervals and max supervision timeout in the presence of Wi-Fi activity.

  • Wi-Fi + BLE Central/Peripheral Data Transfer

    • To get better throughputs in both Wi-Fi and BLE, use medium connection intervals, such as 45 to 80 ms with maximum supervision timeout.

    • Ensure Wi-Fi activity consumes lesser intervals.

  • For Wi-Fi + BT + BLE, Wi-Fi + BT, Wi-Fi + BLE operating modes, connect Wi-Fi ahead of BT/BLE connections to ensure seamless, stable connection for all 3 protocols.

  • For Wi-Fi + BT + BLE, Wi-Fi + BT, Wi-Fi + BLE operating modes, if BT/BLE needs to be connected ahead of Wi-Fi connection, use with high supervision timeout and high connection interval for BLE and high sniff interval for BT, to ensure seamless, stable - connection. This configuration will also ensure a stable BT/BLE connection when Wi-Fi connects/disconnects/rejoins.

  • Wi-Fi + BLE Central/Peripheral Data Transfer

System#

  • For User Store configuration and Configuration Save, do not enable power save or save it as a configuration. If power save is enabled and saved as a configuration, upon boot up, the module will come up with the saved configuration and will go to power save without any indication to the host.

  • Set Optimization level to O0 in project settings for IDE (KEIL).

  • Memory Configuration must be 384K for BT/BLE and Co-Ex Operating Modes

    • Usage of Low Power Flash mode bit (Bit 19 in Extended customer feature bitmap). Enable this bit for ultra low power standby associated scenarios. This results in about 20µA lower Wi-Fi standby associated current consumption.

  • Memory Configuration in SAPI functions: The default memory configuration is 384K. You can configure it to 256/320/384kB by changing the macros defined in the below two files:

    • In rsi_wlan_config.h : RSI_EXT_CUSTOM_FEATURE_BIT_MAP EXT_FEAT_256K_MODE or EXT_FEAT_320K_MODE or EXT_FEAT_384K_MODE

    • In rsi_common.c : rsi_uint32_to_4bytes(rsi_opermode->ext_custom_feature_bit_map, (EXT_FEAT_256K_MODE (or) EXT_FEAT_320K_MODE (or) EXT_FEAT_384K_MODE | RSI_EXT_CUSTOM_FEATURE_BIT_MAP));

  • Apply opermode commands in AT mode correctly. The wrong opermode in some cases might lead to unspecified behavior.

  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.

  • Disable power save during firmware upgrade and re-enable on upgrade completion.

  • Disable power save for high throughput applications.

  • The application needs to ensure that it sets RTC with correct timestamp when the feature is enabled before establishing the SSL connection.

  • Timeout value should be minimum 1 second for socket select and socket receive calls. Timeout value less than 1 second is not currently supported.

  • For more details, see 'Configuration parameters' in the SAPI Reference Manual.

Known Issues#

Network Stack#

  • Sometimes during the SSL Handshake, the generated ECC curve parameters are incorrect, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.

  • MQTT disconnects during firmware upgrade using OTAF, when power save is enabled. Disable power save during firmware upgrade and re-enable on upgrade completion.

  • Newly Added GCM Based Strong Cipher Suites will have performance issues as Hardware support is not available in the current platform.

  • Recommended MQTT Publish payload is 1 KB.

  • If the HTTP Server is configured in the module, MQTT client port should not be port configured on port 80.

  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.

  • Secure SSL Renegotiation not supported in Embedded Networking Stack.

  • IPv6 support is not available in this release.

Wi-Fi#

  • WPA3 known issues

    • Connection takes about 1 second

    • SAE H2E (Hash to Element) is not supported

    • Transition disable indication is not supported

    • PMK SA caching is not supported

  • If the station performs the scan in concurrent mode (Wi-Fi STA+AP), it is possible for stations connected to the AP to get disconnected. Enable AP after STA connection is completed.

  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

  • If BG Scan is enabled along with custom feature bit map bit (8) configuration of the DFS channel support, issues may occur in getting IP address for the Wi-Fi STA.

  • In FAST PSP, a configuration socket close is observed in full duplex communication in long duration tests.

BT/BLE#

  • Wake on Wireless not supported for BLE.

  • BT-HID might not inter-operate with Apple devices.

  • In Wi-Fi + BT/BLE Co-Ex mode, high Wi-Fi broadcast traffic might cause BT/BLE disconnections.

  • In Wi-Fi + BT mode when there is continuous Wi-Fi data, you might observe BT not re-connecting to remote after disconnection.

  • BT-A2DP interoperability issue might be observed with some headsets.

  • For BLE, dual role scenario issues might occur when connecting as central if the advertising is also going out for the peripheral role. Central connections can be made after the peripheral connections are established and advertising is stopped.

  • BLE disconnection is observed if both peer and module already have bond info and module initiating security as part of BLE secure connections. A possible workaround in the application is not to initiate a security request if the bond information is already available.

  • LMP timeout BLE disconnection observed with latest Realme mobile handsets.

  • Some of the A2DP music streaming glitches are observed if the Wi-Fi download is in progress at the same time.

  • Issue with EDR-3DH5 packet reception, where in bit error rate of more than 50% is observed.

Co-Existence#

  • In co-ex Mode if power save is enabled, it stays in enabled state even after Wi-Fi disconnection. Disable power save after every radio_init() and enable it when intended by application.

  • BLE may disconnect with Wi-Fi + BLE configuration and Wi-Fi continuous data transfer when the low BLE supervision timeout is configured. When the supervision timeout is configured with the value of 16 seconds, no disconnections are observed.

  • WiFi + BLE mode WPS is not working.

  • Wi-Fi +BLE/BLE only mode: For SPI as host interface, continuous BLE TX notification might cause the host interface to hang needing a hardware reset. The issue is not seen with discrete burst BLE data.

  • In Wi-Fi + BT/BLE configuration with Wi-Fi disconnects, BT/BLE reconnection issue is observed (see the earlier section 'Recommended Configurations and Application Development options' in this document).

Interoperability#

  • QoS null frames indicating going to power save if not acknowledged by AP may cause AP not to sync with the power save state, resulting in possible disconnections.

  • If 3rd party access points are periodically not sending beacons, in some scenarios unicast probe requests are not sent from the module, as expected, which might result in disconnections.

System#

  • Chip Revision 1.3 doesn't support low power mode optimization using bit setting defined by EXT_FEAT_LOW_POWER_MODE, setting, which results in hang issue.

  • Sometimes the module goes to power save before the configured monitor interval for inactivity whenn Co-Ex mode is configured.

  • Wake on Wireless support is tested only for UART AT command interface.

  • Power save without RAM retention is not working for the SPI interface.

  • FTP Client application is not working with EFx32/STM32 in the OS scenario. The demo app to be tested only for non-OS scenario.

  • HTTP OTAF Application is not working with EFR32 and EFM32 in OS scenario. The demo app to be tested only for Non-OS scenario on EFR32.

  • Firmware upgrade for both OS and non-OS scenarios is not working for EFM32 application.

Limitations and Unsupported Features#

Wi-Fi/Network Stack#

  • AMSDU TX is not supported.

  • Fragmentation is not supported.

  • AMSDU's within AMPDU is not supported.

  • Currently, the module does not support Radio Measurement Requests feature of CCX V2

  • 802.11k is not supported

  • Short GI is not supported

  • 40 MHz bandwidth for both 2.4 & 5 GHz band is not supported.

  • 802.11J channels less than 16 are not supported.

  • USB host interface and USB Power save are not supported.

  • Total MQTT Command Length, apart from MQTT Publish, should not exceed 150 bytes. This includes at+rsi (start of command) to (end of command)\r\n.

  • Configure MQTT_VERSION in rsi_mqtt_client.h based on the server configuration; only version 3 and 4 are supported.

  • 3xSSL connections or 1xTCP and 2xSSL connection, connections are supported concurrently in Wi-Fi only mode.

  • SSL Curve IDs supported are 15-28. SSL handshake with 3rd party clients depends on the SSL Curve ID.

BT/BLE#

  • BT A2DP is supported on chip version 1.5 only

  • BT Sniff mode does not work if BT multiple slaves feature is enabled.

  • For BLE, if the connection is established with a small connection interval (< 15 ms), simultaneous roles (i.e., Central/Peripheral + Advertising/Scanning) are not supported.

  • BLE maximum 2 concurrent connections are supported, which can be either a connection to two peripheral devices or to 1 central and 1 peripheral device.

  • For BT Classic, only 1 connection is supported at any time

  • BLE Slave latency value is valid up to 32 only.

  • BT-A2DP encoder is not supported in the firmware

  • BT-A2DP not supported in AT mode

Co-Existence#

  • In Wi-Fi + BLE during Wi-Fi connection, if both BLE scan interval and window are the same, an issue will occur in successfully making the Wi-Fi connection.

  • For AT commands, Wi-Fi + BT + BLE (Opermode 9) B + BLE (Opermode 8) are not working. However, BT, Wi-Fi + BT modes (Opermode 5) works fine. Also, all combinations work fine with SAPI.

  • Wi-Fi STA + BT + BLE multiprotocol cases require detailed understanding of use cases and associated configurations. Contact Silicon Labs support for more details.

  • Wi-Fi AP + BLE, Wi-Fi AP + BT & Wi-Fi AP + BT + BLE modes are not supported.

SDK Refactor#

The SDK folder structure and names were significantly changed in the 2.4 release. For detailed information, see SAPI Changelog


WiSeConnect 2.4.1 Release Notes#

Last updated: September 10, 2021

Highlights#

  • FragAttack vulnerability fixes

  • Wi-Fi Interoperability issue fixes

Release Details#

Item

Details

Release date

September 1, 2021

API Version (SAPI)

2.4.1 (Build 16)

Firmware Version

2.4.1.0.16 (Build 16)

Package Name

RS9116W.2.4.1.16

Supported RTOS

FreeRTOS

Hardware Modules/Chipsets

QMS, B00, C00, CC1, AB0, AB1, AA0, AA1

Operating Modes Supported

Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE

Additional Operating Modes Supported (Beta Quality)

Wi-Fi STA+BT, Wi-Fi STA+BT+BLE

Updating to this Release#

RS9116W 2.4.1 release consists of two components

  • Firmware - RS9116 Firmware Binary

  • SAPI Library - SAPI Library runs on Host

This release has bug-fixes and Firmware. It is strongly recommended to upgrade SAPI and Firmware together.

Changes and Fixes#

  • Fix for FragAttack Vulnerabilities

  • Fix for issues on Swyentooth Vulnerability fixes

  • Fix for few Wi-Fi interoperability issues with certain Access Points

  • Fix for issue in BLE local attribute setting, when notification not enabled in remote, resulting in error 4046

  • Fix for issue in AP mode, switching to 5 GHz band results in 0x5B error

  • Fix for UDP Asynchronous socket not storing and providing remote IP and Port information

  • Fix for Wi-Fi low RF transmit power output issue for AA0 modules

  • Fix for ping failure after reconnection to AP in concurrent mode

  • Fix for HTTP OTAF upgrade failing in subsequent iterations if first iteration fails due to network connections resulting in 0xBBED error

  • Fix for issue with BLE connection 2nd iteration onwards after connect/disconnect when remote device is advertising as connectable

  • Fix for issue of BT disconnection with continous SPP_rx traffic, sometime due to LMP timeout

Known Issues#

Workarounds#

CC0/CC1 Host Interface Detection at Low Temperatures#

One or more of the serial host interfaces of RS9116 CC0/CC1 modules may fail to respond to host detection at ambient temperatures lower than approximately -20 degC. Execute the following sequence of commands to adjust the module calibration to workaround this issue.

#define BURN_INTO_FLASH      1 
#define BURN_XO_FAST_DISABLE 8

rsi_wireless_init(8, 0);  // Set the operating mode of the module
rsi_wlan_radio_init();    // Set the operating band and initialize the module
rsi_calib_write(BURN_INTO_FLASH, BURN_XO_FAST_DISABLE, 0, 0);   // Trigger the calibration write process to update the 
                                                                // information in flash and wait for a response from the firmware.

Note!

  • The workaround must be executed at room temperature, ~25 degC.

  • The command sequence must be executed once ONLY.

  • Ensure the power supply to the module is stable while issuing commands.

  • The workaround is needed for existing products/boards already mounted with CC0/CC1 modules only.

  • Once executed, the module must be power-cycled before it can be used for normal operation.


WiSeConnect 2.4 Release Notes#

Index#

Highlights#

  • Azure and AWS cloud connectivity support

  • SweynTooth vulnerabilities fixes

  • Strong cipher suite support

  • Co-Existence Algorithm Enhancements

  • EN 300 328 v.2.2.2 certification support

  • TELEC certification support

  • Wi-Fi interoperability fixes and enhancements

  • Crystal calibration support (Needed for RS9116 QMS)

  • Significant reorganization and refactoring of the SDK

  • Integrated support for EFR32MG21 hosts and Simplicity Studio

Release Details#

Item

Details

Release date

June 30, 2021

API Version (SAPI)

2.4.0 (Build 36)

Firmware Version

2.4.0 (Build 36)

Package Name

RS9116W.2.4.0.36

Supported RTOS

FreeRTOS

Hardware Modules/Chipsets

QMS, B00, C00, CC1, AB0, AB1, AA0, AA1

Operating Modes Supported

Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE

Additional Operating Modes Supported (Beta Quality)

Wi-Fi STA+BT, Wi-Fi STA+BT+BLE

Updating to this Release#

RS9116W 2.4 release consists of two components

  • Firmware - RS9116 Firmware Binary

  • SAPI Library - SAPI Library runs on Host

This release has bug-fixes, enhancements, new SAPI features and Firmware. Most of the new features have associated APIs, which are available in the latest SAPI implementation only. It is strongly recommended to upgrade SAPI and Firmware together.

New Features#

Wi-Fi#

  • Azure support for cloud connectivity

  • AWS support for cloud connectivity

  • Support for dynamic switching between AP and STA mode of operation (see config_feature_bit_map[16])

  • Support for loading certificate without requiring a reboot of the chip

  • Configurability option for disabling transmit Data rates MCS5, MCS6 and MCS7

  • Support for stronger cipher suites

  • Support for enhanced max-PSP mode for better interoperability, see config_feature_bit_map[26] and refer to API rsi_wlan_power_save_profile(). This PSP type is supported for STA-only mode.

  • Enhancements for better interoperability. Keep alive configuration, graceful closure of previous WLAN connections.

  • Enhancements to Wi-Fi Auto Rate adaptation algorithm

  • Enhancements to Wi-Fi + BLE Co-Existence support

  • Improvements to Wi-Fi + BLE provisioning examples

Bluetooth - Common#

  • Resolution to SweynTooth family of BT vulnerabilities

Bluetooth - Classic#

  • Support for BT Advanced Audio Distribution Profile Source (BT alone mode only). Example Application project included for RT595 host platform

Power Save#

  • Fixes for functional issues in power save mode at high temperature, 85°C

General#

  • WLAN EN 300 328 v.2.2.2 ETSI Certification Compliance support added for the following modules and SoC Versions: B00 1.4, QMS 1.3, QMS 1.4, CC0/CC1 1.3, CC0/CC1 1.4, and AA0/AA1 1.3

  • Certified gain tables are added for these modules for different antennas, which can be configured using the user gain Table API for Wi-Fi and rsi_bt_set_antenna_tx_power_level() API for BT/BLE. Default firmware configuration is for the internal PCB/Chip Antenna

    • B00: Internal antenna (Fractus FR05-S1-N-0-102) and Dipole antenna (Taoglas GW.34.5153)

    • CC0/CC1 1.4 FCC/ETSI: Dipole Antenna (GW.71.5153), dipole Antenna (Inside WLAN PRO-IS 299), PCB antenna (RSIA7), PIFA antenna (Smarteq 4211613980), PIFA antenna (MARS-31A8 Wi-Fi antenna)

    • CC0/CC1 1.3 : PCB antenna , dipole antenna

    • AA0/AA1-1.3: chip antenna, Heavy-duty screw mount antenna

  • TELEC certification support

  • Support for chip manufacturing software (Crystal Calibration support for RS9116 QMS chip integration)

  • Support for examples on the EFR Platform

  • Package and documentation restructure

Changes and Fixes#

  • Fixes for memory leak in SSL, ensuring stability for longer connection

  • Resolved issue with TCP long data transfer with low power configuration for memory configuration greater than 256k.

  • Fix for setting device local name for BLE

  • Fix for rsi_ble_white_list_using_adv_data() failure

  • Fix for store config/auto-config keep-alive timeout not working.

  • Fix for HID Keyboard notifications not being seen on the iOS mobile side

  • Configurability support in Firmware update APIs for the SAFE and FAST upgrade

  • Mishandling of SDIO interrupts addressed in SAPI driver by calling rsi_hal_intr_pin_status() API. MCU HAL APIs will need to port this API for respective platform. Refer to SAPI porting guide for more information.

  • Boot up Issue at low temperature (refer to API rsi_calib_write() Bit of 3)

New APIs#

For a complete list of new APIs, see SAPI Changelog

Recommendations and New Options#

Wi-Fi#

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in opermode command for all Wi-Fi Socket Operations from host to ensure graceful handling during asynchronous closures from peer.

  • Aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode.

  • TCP retransmission count value is recommended to be 30 or higher, so that the TCP does not disconnect while the rejoin happens.

  • For low throughput applications, such as a Smart lock, disabling the highest MCS rates, such as MCS7 and MCS6 might help reducing packet retransmissions and ensure robust connection during heavy interference.

  • To restart the module, the application needs to call rsi_driver_deinit() followed by rsi_driver_init() and rsi_device_init(). For OS cases, additionally call rsi_task_destroy(driver_task_handle) to delete the driver task before calling rsi_driver_deinit() and create again after rsi_device_init() using rsi_task_create()

  • Register 'Join Fail Callback' function every time when join is called, as in the rejoin failure path the callback is deregistered. If not done, this might result in a scan not functioning on rejoin failure.

BT/BLE#

  • In BLE, recommended range of Connection Interval in

    • Power Save (BLE Only) - 100 ms to 1.28 s.

    • BT Classic + BLE Dual Mode is >= 200 ms.

    • Wi-Fi + BLE coex - 30 ms to 250 ms

  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with same value is not recommended.

  • In BT Classic, recommended Sniff Interval configuration during Power Save is limited to 100 ms (<= 100).

  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection command) must be less than the existing Connection Interval.

  • In BLE mode, if scanning and advertising is in progress and subsequently gets connected and moves to the central role, scanning and advertising stops. To further establish connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

  • Device Power save need to be disabled before BT init and de-init.

Co-Existence#

  • For Wi-Fi + BLE, during Wi-Fi connection, lesser BLE scan window and larger BLE scan interval are recommended (1:3 or 1:4).

  • Wi-Fi + BLE Advertising

    • All the advertising intervals are supported, as per the BT Spec. If the Wi-Fi transactions are more, you may observe a slight difference in on-air advertisements compared to the configured intervals.

    • BLE Advertising will be stopped for intervals that collide with Wi-Fi activity.

  • Wi-Fi + BLE scanning

    • All scan intervals are supported as per BT Spec. For better scan results, use scan-window and scan interval in 1:3 or 1:4 ratio when the Wi-Fi scan activity is present.

    • BLE scanning will be stopped for intervals that collide with Wi-Fi activity.

  • Wi-Fi + BLE Central/Peripheral Connections

    • All connection intervals are supported as per BT Spec.

    • For stable connection, use optimal connection intervals and max supervision timeout in the presence of Wi-Fi activity.

  • Wi-Fi + BLE Central/Peripheral Data Transfer

    • To get better throughputs in both Wi-Fi and BLE, use medium connection intervals, such as 45 to 80 ms with Maximum supervision timeout.

    • Ensure Wi-Fi activity consumes lesser intervals.

  • For Wi-Fi + BT + BLE, Wi-Fi + BT, Wi-Fi + BLE operating modes, connect Wi-Fi ahead of BT/BLE connections to ensure seamless, stable connection for all 3 protocols.

  • For Wi-Fi + BT + BLE, Wi-Fi + BT, Wi-Fi + BLE operating modes, if BT/BLE needs to be connected ahead of Wi-Fi connection, use with high supervision timeout and high connection interval for BLE and high sniff interval for BT, to ensure seamless, stable connection. This configuration will also ensure a stable BT/BLE connection when Wi-Fi connects/disconnects/rejoins.

  • Wi-Fi + BLE Central/Peripheral data transfer

System#

  • For User Store configuration and Configuration Save, do not enable power save or save it as a configuration. If power save is enabled and saved as a configuration, upon boot up, the module will come up with the saved configuration and will go to power save without any indication to the host.

  • Set Optimization level to O0 in project settings for IDE (KEIL).

  • Memory Configuration must be 384K for BT/BLE and Co-Ex Operating Modes

    • Usage of Low Power Flash mode bit (Bit 19 in Extended customer feature bitmap). Enable this bit for Ultra low power standby associated scenarios. This results in about 20µA lower Wi-Fi standby associated current consumption.

  • Memory Configuration in SAPI functions: The default memory configuration is 384K. Users can configure it to 256/320/384kB by changing the macros defined in the below two files

    • In rsi_wlan_config.h : RSI_EXT_CUSTOM_FEATURE_BIT_MAP EXT_FEAT_256K_MODE or EXT_FEAT_320K_MODE or EXT_FEAT_384K_MODE

    • In rsi_common.c : rsi_uint32_to_4bytes(rsi_opermode->ext_custom_feature_bit_map, (EXT_FEAT_256K_MODE (or) EXT_FEAT_320K_MODE (or) EXT_FEAT_384K_MODE | RSI_EXT_CUSTOM_FEATURE_BIT_MAP));

  • Apply Opermode commands in AT mode correctly. The wrong opermode in some cases might lead to unspecified behavior.

  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP for Wi-Fi alone mode and MAX PSP for Wi-Fi Co-Ex Modes.

  • Disable power save during firmware upgrade and re-enable on upgrade completion.

  • Disable power save for high throughput applications.

  • The application needs to ensure that it sets RTC with correct timestamp when the feature is enabled before establishing the SSL connection.

  • Timeout value should be minimum 1 second for socket select and socket receive calls. Timeout value less than 1 second is not currently supported.

  • For more details, see 'Configuration parameters' in the SAPI Reference Manual.

Known Issues#

Network Stack#

  • MQTT disconnects during firmware upgrade using OTAF, when power save is enabled. Disable power save during firmware upgrade and re-enable on upgrade completion.

  • Newly Added GCM Based Strong Cipher Suites will have performance issues as Hardware support is not available in the current platform.

  • Recommended MQTT Publish payload is 1 kBytes.

  • If HTTP Server is configured in the module, MQTT client port should not be port configured on port 80.

  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.

  • Secure SSL Renegotiation not supported in Embedded Networking Stack.

  • IPv6 support is not available in this release.

Wi-Fi#

  • If the station performs the scan in concurrent mode (Wi-Fi STA+AP), it is possible for stations connected to the AP to get disconnected. Enable AP after STA connection is completed.

  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

  • If BG Scan is enabled along with custom feature bit map bit (8) configuration of the DFS Channel support, issues may occur in getting IP address for the Wi-Fi STA.

BT/BLE#

  • Wake on Wireless not supported for BLE.

  • BT-HID might not inter-operate with Apple devices.

  • In Wi-Fi + BT/BLE Co-Ex mode, high Wi-Fi broadcast traffic might cause BT/BLE disconnections.

  • Continuous data transfer on SPP (Rx/Tx) with packet size ~800 bytes in some scenarios might lead to BT disconnection. Introduce delay in between transfers to work around this issue.

  • In Wi-Fi + BT mode when there is continuous Wi-Fi data, you might observe BT not re-connecting to remote after disconnection.

  • BT-A2DP interoperability issue might be observed with some headsets.

  • For BLE, dual role scenario issues might occur when connecting as central if the advertising is also going out for the peripheral role. Central connections can be made after the peripheral connections are established and advertising is stopped.

Co-Existence#

  • In Co-Ex Mode if power save is enabled, it stays in enabled state even after Wi-Fi disconnection. Disable power save after every radio_init() and enable it when intended by application.

  • BLE may disconnect with Wi-Fi + BLE configuration and Wi-Fi continuous data transfer when the low BLE supervision timeout is configured. When the supervision timeout is configured with the value of 16 seconds, no disconnections are observed.

  • WiFi + BLE mode WPS is not working.

  • Wi-Fi +BLE/BLE only mode: For SPI as host interface, continuous BLE TX Notification might cause the host interface to hang needing a hardware reset. The issue is not seen with discrete burst BLE data.

  • In Wi-Fi + BT/BLE configuration with Wi-Fi disconnects, BT/BLE reconnection issue is observed (see the earlier section 'Recommended Configurations and Application Development options' in this document).

Interoperability#

  • QoS Null frames indicating going to Power Save if not acknowledged by AP may cause AP not to sync with the power save state, resulting in Possible disconnections.

  • If 3rd Party Access Points are periodically not sending beacons, in some scenarios unicast probe requests are not sent from the module, as expected, which might result in disconnections.

System#

  • A known issue exists with FAST-PSP mode. Use Enhanced MAX-PSP power save.

  • Wake on Wireless support is tested only for UART AT command interface.

  • 802.11b transmit power of some AA0 modules might be 4 dBm less than that mentioned in data sheets. As a result, connectivity issues might be observed at 2.4 GHz when the AP is far.

  • Power Save without RAM retention is not working for the SPI interface.

Limitations and Unsupported Features#

Wi-Fi/Network Stack#

  • AMSDU TX is not supported.

  • Fragmentation is not supported.

  • AMSDU's within AMPDU is not supported.

  • Currently, the module does not support Radio Measurement Requests feature of CCX V2

  • 802.11k is not supported

  • Short GI is not supported

  • 802.11w is not supported

  • 40 MHz bandwidth in 2.4 GHz band is not supported.

  • 802.11J channels less than 16 are not supported.

  • USB host interface and USB Power save are not supported.

  • Total MQTT Command Length, apart from MQTT Publish, should not exceed 150 bytes. This includes at+rsi (start of command) to (end of command)\r\n.

  • Configure MQTT_VERSION in rsi_mqtt_client.h based on the server configuration; only version 3 and 4 are supported.

  • 3xSSL connections or 1xTCP and 2xSSL connection, connections are supported concurrently in Wi-Fi only mode.

  • SSL Curve IDs supported are 15-28. SSL handshake with 3rd party clients depends on the SSL Curve ID.

BT/BLE#

  • BT Sniff mode does not work if BT multiple slaves feature is enabled.

  • For BLE, if the connection is established with a small connection interval (< 15 ms), simultaneous roles (i.e., Central/Peripheral + Advertising/Scanning) are not supported.

  • BLE maximum 2 concurrent connections are supported, which can be either a connection to two peripheral devices or to 1 central and 1 peripheral device.

  • For BT Classic, only 1 connection is supported at any time

  • BLE Slave latency value is valid up to 32 only.

  • BT-A2DP Encoder is not supported in the firmware

  • BT-A2DP not supported in AT mode

  • User Gain Table API is not available for BT/BLE Path. Limit the BT/BLE TX power for a specific antenna using rsi_bt_set_antenna_tx_power_level API.

Co-Existence#

  • In Wi-Fi + BLE during Wi-Fi connection, if both BLE scan interval and window are the same, an issue will occur in successfully making the Wi-Fi connection.

  • For AT commands, Wi-Fi + BT + BLE (Opermode 9), BT + BLE(Opermode 8) are not working. However, BT, Wi-Fi + BT modes (Opermode 5) works fine. Also, all combinations work fine with SAPI.

  • Wi-Fi STA + BT + BLE multiprotocol cases require detailed understanding of use cases and associated configurations. Contact Silicon Labs Support for more details.

  • Wi-Fi AP + BLE, Wi-Fi AP + BT & Wi-Fi AP + BT + BLE modes are not supported.

SDK Refactor#

The SDK folder structure and names were significantly changed in the 2.4 release. For detailed information, see SAPI Changelog

Terminology#

Term

Description

New Features

These items are new to this release

Changes/Issues Fixed

Changes made to existing features found in previous releases of the software.

Enhancements to existing product flow and feature set.

Bug fixes done in the Release

Deprecated Items

Features or functions or APIs that are removed from the distributed release to align with the software roadmap

Known Issues

Features or functions that do not work as planned at time of release. Workarounds may be offered to meet short term development goals, but longer-term solutions will be added in future software releases

Limitations/Recommendations

Describes the limitations on product usage and recommendations for optimal use cases