Skip to content

Latest commit

 

History

History
5038 lines (3903 loc) · 288 KB

index_soc.md

File metadata and controls

5038 lines (3903 loc) · 288 KB

WiSeConnect3_SDK_3.2.0 SoC Release Notes

Release Details

Item Details
Release date May 7th, 2024
SDK Version 3.2.0
Firmware Version 1711.2.11.1.0.0.7
GSDK Version 4.4.3
Release Package Name WiSeConnect3_SDK_3.2.0
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
  • SiWx917 release consists of two components:
    • Wireless Firmware - SiWx917 Firmware Binary available as SiWG917-B.2.11.1.0.0.7.rps
    • Wiseconnect3 Library - Wiseconnect3 SDK library runs on internal Cortex M4

NOTE: Mandatory to upgrade the earlier version of boards (Si917-6031A Prokit or BRD4338A boards) or 917 Silicon ICs with instructions as outlined in this document "SiWG917–TA_Flash_Memory_Map_ChangeGuide_v1.3.pdf" for more details.

Supported Hardware

Hardware OPN
Silicon (IC OPN) SiWG917M111MGTBA, SiWG917M100MGTBA
Development Kits

Pro Kit: SiWx917-PK6031A, Si917-PK6031A, SiWx917-PK6032A.

(Pro Kit includes Mother board "SI-MB4002A" + Radio board)

Radio boards: SiWx917-RB4338A, SiWx917-RB4342A

Supported Features

System

  • Operating Modes
    • Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Security
    • Secure Boot, Secure Key storage and HW device identity with PUF, Secure Zone, Secure XIP (Execution in place) from flash, Secure Attestation, Anti Rollback, Secure Debug and Flash Protection.
    • Secure firmware upgrade options:
      • Firmware loading support by Commander Tool through Jlink Debugger. Jlink connected to Serial Wire Debug (SWD)
      • Firmware loading via ISP using UART (Commander or Serial terminal), SPI Interface
      • Secure Over the Air (OTA) Upgrade
      • Firmware update via Bootloader
  • Crypto Support
    • Crypto API's for Hardware Accelerators:
    • Advanced Encryption Standard (AES) 128/256/192, Secure Hash Algorithm (SHA) 256/384/512, Hash Message Authentication Code (HMAC), Random Number Generator (RNG), SHA3, AES-Galois Counter Mode (GCM)/ Cipher based Message Authentication Code (CMAC), ChaCha-poly, True Random Number Generator (TRNG)
    • Software Accelerators: RSA, ECC
    • PSA Crypto APIs support for all crypto operations.
    • Wrapping Secret keys (Symmetric crypto).
    • Added ECDSA Sign and Verify APIs
  • System Power Save
    • Deep Sleep with RAM retention and without RAM retention.
    • Wireless Power Save: Connected Sleep (Wi-Fi Standby Associated), BLE Advertising with powersave, BLE Scan with powersave , BLE connection with powersave. Only Max PSP power save mode is supported in BLE.

MCU

  • Memory
    • Common Flash: Single shared Flash for both Cortex-M4 and NWP (Wireless Processor)
    • Common Flash + External PSRAM
  • Power States
    • Active: PS4, PS3, PS2, and PS1
    • Standby: PS4, PS3, and PS2
    • Sleep: PS4, PS3 and PS2
    • Deep Sleep(Shutdown): PS0
  • Peripherals
    • High Performance (HP) - ADC, Calendar, Config Timer (CT), eFuse, EGPIO, GSPI, I2C, I2S, MCPWM, SDIO Secondary, SIO, SSI, SYSRTC, UART, uDMA, USART, WDT, Analog Comparator, DAC, Temperature Sensors (RO and BJT), Bod, CTS, OPAMP, PSRAM, QEI and RTC
    • Ultra Low Power (ULP) - ULP_TIMER, ULP_GPIO and ULP_CALENDAR,
    • UC Supported Peripherals - I2C, Calendar, SPI, SSI, SIO, uDMA, UART/USART, WDT, Config Timers, ULP Timers, SDIO Secondary, PWM, ADC, DAC, I2S and Analog Comparator
  • Services
    • Sleep Timer, IOSTREAM, Power Manager, SensorHub, NVM3
    • The flash write feature has been enhanced to support the NWP area, providing a 20k allocation within the NWP flash memory for storing user data. Moreover, a Read API has been introduced to retrieve data from the NWP flash region.
  • Development Pro-Kit Peripheral Support
    • LED, Button, MEMLCD, Joystick, RHT Sensor

Development Environment

  • Simplicity Studio IDE (SV5.8.0 version) and Debugger Integration. Refer to the latest version of the SoC "Getting-Started-with-SiWx917" guide for more details.
  • Recommended to install and use Silicon labs Gecko SDK, Git hub based version 4.4.3.
  • Simplicity Commander to supports Flash loading, provision of MBR programming, security key management, and calibration support for crystal and gain offsets. refer "siwx917-soc-manufacturing-utility-user-guide" for more details.
  • Advanced Energy Monitoring (AEM) to measure ultra-low power capability on Development boards (Pro Kit).
  • PinTool Supported peripherals - I2C, GSPI, SSI, SIO, UART/USART, Config Timers, PWM, I2S, ADC, DAC and Analog comparator

Wi-Fi

  • Wi-Fi Protocols
    • IEEE 802.11 b/g/n/ax (2.4GHz)
  • Access Point (AP) Mode
    • 4 Client Support, Hidden SSID Mode, Auto Channel Selection, Scan in AP mode (Alpha)
    • Wi-Fi Security
      • WPA2 Personal, WPA3 Personal (H2E method only) (Alpha), WPA Mixed mode (WPA/WPA2)
  • Wi-Fi Scan
    • Selective Scan, Active/Passive Scan (world domain)
  • Wi-Fi STA (Security Modes)
    • Open Mode, WPA2 Personal, WPA2 Enhancements, WPA3 Personal, Mixed Mode (WPA/WPA2), WPA3 Personal Transition Mode (WPA2/WPA3)
  • WPA2 Enterprise security (STA)
    • Method
      • PEAP/TTLS/TLS 1.0/TLS 1.2/FAST/LEAP
  • Wi-Fi STA Rejoin
  • Wi-Fi STA Roaming
    • BG Scan, OKC (Opportunistic Key caching), PMK (Pairwise Master Key) caching, Pre-Authentication
  • Wi-Fi Protocol Power Save
    • Deep sleep (unconnected state), Max PSP, Enhanced Max PSP, Fast PSP, TWT
  • QoS
    • WMM-QoS
  • Wi-Fi 6 Feature
    • MUMIMO (DL), OFDMA (UL/DL), iTWT, TWT I-Frame & TWT Enhancements (Automatic TWT Configuration), BSS coloring, MBSSID
  • Wi-Fi Concurrency
    • AP+STA (Same channel)
  • Wi-Fi Band/Channels
    • 2.4GHz CH1-11, 2.4GHz CH1-13, 2.4GHz CH1-14
  • Known Security Vulnerabilities Handled
    • WPA2 KRACK Attacks, Fragment and Forge Vulnerability

Network Stack

  • Core Networking Features
    • IPv4/IPv6/UDP/TCP/ARP/ICMP/ICMPv6
    • SSL client versions TLSV1.0, TLSV1.2, TLSV1.3
    • SSL server versions TLSV1.0 and TLSV1.2
    • DHCPv4 (Client/Server)/ DHCPv6 Client
    • TCP/IP Bypass (LWIP as Hosted stack for reference),
  • Advanced Network Features
    • HTTP Client/HTTPS Client//DNS Client/SNTP Client, Embedded MQTT/MQTT on host (AWS and AZURE)
  • Wi-Fi IoT Cloud Integration
    • AWS IoT Core
    • Azure IoT
  • BSD and IoT sockets application programming interface(API)

BLE

  • GAP(Advertising, Scanning, initiation, Connection and Bonding)
  • Generic Attribute Protocol(GATT)
  • Attribute protocol(ATT)
  • Security
  • LL Privacy 1.2
  • Accept list
  • Directed Advertising
  • Extended Advertising
  • Periodic Advertising
  • Periodic Advertising scanning
  • Extended Advertising scanning
  • Periodic Advertising list
  • LE periodic advertising synchronization
  • LE PHY(1Mbps, 2Mbps) & Coded PHY(125Kbps, 500kbps)
  • Simultaneous scanning on 1Mbps and Coded PHY
  • LE dual role topology
  • LE data packet length extensions(DLE)
  • Asymmetric PHYs
  • LE channel selection algorithm 2 (CSA#2)
  • LE Secure connections
  • Bluetooth 5.4 Qualified

SDK

  • Simplified and Unified DX for Wi-Fi API and Platform APIs
  • Simplifies application development and presents clean and standardized APIs
  • UC (Universal Configurator) enables componentization, simplifying configuration of peripherals and examples
  • BSD and ARM IoT-compliant socket API
  • Available through Simplicity Studio and GitHub

Multi-protocol

  • Wi-Fi STA + BLE

PTA/Coexistence

  • 3 wire coex acting as Wi-Fi with external Bluetooth
  • 3 wire coex acting as Wi-Fi with external Zigbee/OT

Changes in this release compared to v3.1.4 Release

System

  • Fixed M4 FW update(OTAF) issue for 1.8MBR

MCU

  • Enhancements
    • Implemented I2C 7 or 10-bit combined format transfers
    • Integrated SSI with SL DMA
    • Updated documentation and UC for Consistency - API Documentation, Readme, SRM and UC
    • Added an empty C project for SoC
    • Renamed below UART macro's in RTE_Device_917.h file
      • RTE_UART1_FRAC_DIV_EN changed to RTE_UART1_FRAC_DIV_SEL
      • RTE_USART0_FRAC_DIV_EN changed to RTE_USART0_FRAC_DIV_SEL
  • Fixed Issues
    • Fixed SYSRTC application serial console prints documentation issue in readme
    • The issue with separate channel selection in the pwm application has been resolved and updated the associated readme documentation.
    • The issue with pwm_start not working after pwm_stop in pwm application has been resolved.
    • Resolved PWM toggles stopping issue when BTN0 is pressed in Combo app
    • Fixed the transfer for ULP SSI Master DMA issue
    • Resolved SSI DMA issue when buffer size is 10000
    • Fixed SSI functionality issue when GSPI component is added to project
    • Fixed UART Fractional clock divisor value issue
    • Resolved build error issue while adding IOSTREAM components in DAC example
    • Resolved UDMA and RAM memory overlapping issue in default examples
    • Resolved issues observed with 1 byte I2C read
    • Resolved RAM retention issues in Smart Lock application with Power Manager
    • Fixed Power Manager component issues observed in SDK v3.1.4
    • Resolved problems in peripheral UC configuration.
    • Fixed peripheral documentation links

SDK

  • Enhancements
    • Added sl_si91x_mem_pool_buffers_with_quota component
    • API reference guide enhancement with a callback usage note
    • Readme enhancements of the example application
    • Added support for wifi_data_transfer_application_soc, wifi_ap_throughput_soc, wifi_https_ble_dual_role_soc, flash_read_write example application
  • Fixed Issues
    • Fixed TCP RX failure in concurrent mode in multithreading_application example
    • Fixed RPS header corruption during firmware update
    • Fixed the issue of DUT returning SL_STATUS_TIMEOUT after multiple iterations during wifi init and deinit sequence
    • Fixed handling of EAP-FAST PAC file loading manually.

Wi-Fi/Network Stack

  • Enhancements
    • Added long url support (max 2048 bytes) for HTTP OTAF.
    • Removed a limitation in Embedded where MQTT keep alive interval should be either 0 or a value greater than 35 seconds. Now allowing keep alive interval less than 35 seconds also.
    • Added support for LEAP security in EAP mode
    • For Flash less parts support added to update customer gain offset and xo_ctune offset to external flash.
  • Fixed Issues
    • Fixed issues with Embedded MQTT state machine, when remote terminate and WLAN disconnection is triggered
    • Fixed issues with MDNS services not responding to the queries from other devices
    • Fixed same MAC address being generated for AP and Station address incase of concurrent mode.
    • Fixed the issue where DUT is getting hang while running HTTP_PUT Method in http client application
    • Fixed the issue where sl_net_set_credential API is failed with 0x10026 (SL_STATUS_SI91X_WRONG_PARAMETERS) error when trying to load HTTP certificate(SL_NET_HTTP_CLIENT_CREDENTIAL_ID) for HTTPs
    • Added hostname support to HTTP client request
    • Fixed issue where http otaf firmware update failed with "BBE1(SL_STATUS_SI91X_HTTP_TIMEOUT) error" for HTTP and BBD6(SL_STATUS_SI91X_SSL_TLS_HANDSHAKE_TIMEOUT_OR_FTP_FILE_NOT_CLOSED) for HTTPS otaf
    • Fixed issue where failure/no response during the 2nd iteration of HTTP Server response
    • Fixed DUT hang issue which is caused because of HW calibrations.
    • Fixed xo captune calibration issue. Issue was xo captune getting overwritten with default value.
    • Fixed the issue of module not entering into deep sleep after AP stop API call.
    • Fixed an issue of AP VAP initialization in the scenario of AP-start, AP-stop and AP-start again.
    • Fixed issues with static IPV4 assignment to DUT.
    • Fixed issues with ECDSA ciphers.

BLE

  • Enhancements
    • Added "bt_stack_bypass" demo for validating Direct test mode in SOC.
    • Added change to obtain 6 bytes Bluetooth device address when the "rsi_bt_get_local_device_address" API is called in all BLE applications.
  • Fixed Issues
    • Fixed BLE disconnection issue while running wifi_https_ble_dual_role application when powersave is disabled.
    • Resolved the issue with BLE PER stats cmd API.
    • Fixed reconnection issue in case of pairing failure.
    • Fixed invalid connection request(CVE-2019-19193) vulnerability.
    • Updated readme files for "ble_accept_list" and "ble_testmodes" applications.
    • Updated "tx_power" description for HP mode in "rsi-ble-per-transmit-s" structure.
    • Fixed issue where WLAN power save API is failing with error code: SL_STATUS_TIMEOUT while executing the ble_ae_central application

Multi-protocol

  • Enhancements
    • NA
  • Fixed Issues
    • NA

Recommendations

System

  • The current revision of SiWx917 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in SoC mode.
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement. EXT_FEAT_352K_M4SS_320K is the default configuration, based on requirement EXT_FEAT_480K_M4SS_192K configuration is selected for SoC mode multi-protocol examples.
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • SoC mode should not use 672k_M4SS_0K memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.
  • There are 2 Versions of Pro-Kits/Radio boards. Si917-6031A based on Si917-4338A (Rev A01 - A11) and SiWx917-6031A based on SiWx917-4338A (Rev A12). To get optimal power numbers, enable macro "SL_SI91X_ENABLE_LOWPWR_RET_LDO" pre-processor define for ICs or while using SiWx917-6031A Pro-kit, SiWx917-4338A version of boards. This macro should be disabled for earlier variant of board (Si917-6031A, Si917-4338A).
  • With RAM configuration (EXT_FEAT_352K_M4SS_320K), only 352K memory is available to TA which limits the features supported, Recommended to enable EXT_FEAT_416K_M4SS_256K in Wi-Fi + BLE Multi protocol mode to enable more Network features.
  • For EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K memory configurations, it is recommended to retain both TA and M4 RAMs in power save.

Wi-Fi/Network Stack

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • For high throughput applications, aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode.
  • Users can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature' bit map in opermode for (HTTPS server) supporting 16k record.
  • TWT
    • Recommendation is to use sl_wifi_target_wake_time_auto_selection() API for all TWT applications.
    • It is recommended to issue iTWT setup command once IP assignment, TCP connection, application specific socket connections are done.
    • When using sl_wifi_enable_target_wake_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured. It's highly recommended to use sl_wifi_target_wake_time_auto_selection() as an alternative.
    • In case of TWT in coex mode, when using sl_wifi_enable_target_wake_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
    • For iTWT GTK interval in AP should be configured to max possible value or zero. If GTK interval is not configurable on AP side, recommended TWT interval (in case of sl_wifi_enable_target_wake_time API) or RX Latency (in case of sl_wifi_target_wake_time_auto_selection API) is less than 4sec.
    • When sl_wifi_enable_target_wake_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wake interval of less than or equal to 1 min.
    • When using sl_wifi_enable_target_wake_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Disable power save for high throughput applications or use FAST PSP power save mode as per application requirement.
  • The application needs to ensure that it sets RTC with the correct timestamp before establishing the SSL/EAP connection.
  • The minimum timeout value should not be less than 1 second for socket select and socket receive calls.
  • Please refer Keep alive intervals supported by MQTT broker and configure keep alive interval values accordingly.
  • The minimum keep alive interval value recommended for embedded MQTT is 10 Seconds.
  • Disable power save and suspend any active TWT sessions before triggering HTTP OTAF.
  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.
  • Recommended to configure VAP_ID properly for Si91x STA and AP using sl_si91x_setsockopt_async(), in case of data transfer.
  • Recommended to use valid length(<= 202 bytes) for topic to be published while using Embedded MQTT, else it leads to return wrong error code(0x21).

BLE

  • In BLE, the recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

Multi-protocol

  • 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.

Known Issues of WiSeConnect3_SDK_3.2.0 Release

MCU

SensorHub

  • Power transitions with AWS are not stable in SensorHub
  • Support for ADC FIFO Mode and Multi channel is open
  • PS1-state supports only ADC senso

SSI

  • SSI Dual and Quad mode are not functional
  • SSI Primary: Mode3 and TI are not working as expected
  • SSI Primary will not be operable at 40 MHz
  • SSI Full Duplex in DMA mode is not working as expected

I2C

  • ULP I2C High speed and Fast plus modes are not working at specified speed

UART

  • Flow control is not supported in ULP UART.

ADC

  • In ADC Multichannel mode, sampling rate is limited to less than 15Ksps. Number of samples is less than 500 and with a maximum of 4 channel
  • In ADC Multichannel mode, when using different sampling rates for different channels behavior is not as expected

CT (Config Timer)

  • Config Timer(CT) support as an external event, in 32-bit mode, and DMA are not working as expected

Power Manager

  • The wakeup sources BOD, Comparator, and SYSRTC are not working in the Power Manager service

RO Clock

  • Few peripherals like WDT, SYSRTC when configured with RO clock is not working as expected. No impact on the feature but the clocks are not accurate.

ULP Peripheral examples

  • ULP Peripheral examples (ULP_ADC, ULP_ADC_MULTICHANNEL, ULP_I2S, ULP_SSI_MASTER, ULP_UART, ULP_DMA, ULP_I2C_LEADER, ULP_DAC, and ULP_I2C_DRIVER_LEADER) are being integrated with the Power Manager Service, ULP Peripheral examples without Power Manager are removed from SDK and available through Apps repo for reference.

SDK

  • Observed Wi-Fi connection is successful even after deleting the stored network credentials using sl_net_delete_credential and responding with SL_NET_INVALID_CREDENTIAL_TYPE for sl_net_get_credential.
  • Enhanced sl_wifi_get_firmware_version() API to provide more details (ROM ID, chip ID, security version, etc) which is not backward compatible with firmware older than 1711.2.10.1.0.0.4. Firmware binary notation does not include the security version number.
  • In PSRAM enabled demos, moving of text, data and stack segments to PSRAM is allowed. BSS and Heap should still be in SRAM.
  • Asynchronous Azure MQTT is not supported, this will be addressed in upcoming release(s).
  • mDNS with IPV6 is not supported.
  • Observing DUT is getting stuck while running MQTT publish with 2 different topics
  • Observed MQTT RX is failing when continuous data sent every 1 second in aws_mqtt application
  • Observed DUT Failed to connect to AP with timeout error 0x7(SL_STATUS_TIMEOUT) while single MQTT subscribe and publish in loop with embedded MQTT application
  • Observing LAST_WILL_MESSAGE is random at every MQTT connection rather than the configured Message/Length with embedded MQTT application
  • Observed DUT is not initiating the AWS connection post-rejoin failure indication after publishing 10-15 packets, turning OFF AP and trying to rejoin the network with aws_mqtt application
  • Observing MQTT disconnect API is getting failed with 0x7(SL_STATUS_TIMEOUT) error while doing publish & subscribe with embedded MQTT application
  • Bus thread stack may need to increase if local variables are used in user callback to avoid stack overflow.
  • Low Power examples usage and documentation still under scope of improvement.

Wi-Fi/Network Stack

Wi-Fi STA

  • STA Connection with the WPA3 Hunting and Pecking algorithm takes about 3-4 seconds.
  • Observed connection failures with some AP's in more channel congestion ~50-60% occupancy open lab environment.
  • Region selection based on country IE in the beacon is not supported
  • Observed intermittent beacon reception from Access Point ( beacon misses) when channel congestion > 85%.

Access Point (AP) Mode

  • Scan feature in AP mode not fully functional.
  • Fixed rate configuration in AP mode using sl_wifi_set_transmit_rate API is not being set as expected.

WPA2 Enterprise security (STA)

  • Observed connection issue with configuring certificate key and programming 4096 bit key and SHA384/SHA512 certificates.
  • Observing DUT is throwing 0x1001c when configuring .data.certificate_key as "123456789".
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

Wi-Fi Concurrency (AP + STA in same channel)

  • Observed 3rd party STA association fail with 917 AP while 917 STA mode is connecting/reconnecting to configured 3rd party AP. Reconnect 3rd party STA to 917 AP in such scenarios.

OFDMA (UL/DL)

  • Less throughput observed in DL-OFDMA with some APs that enabled Low density parity check coding.

MUMIMO (DL)

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test.
  • Observed Performance, Interop issues with MU MIMO with certain APs.
  • Less throughput observed in MU-MIMO with some APs that enabled LDPC.

MU-MIMO (UL)

  • UL MU-MIMO is not supported.

TWT

  • When sl_wifi_enable_target_wake_time() API is used, occasional MQTT disconnections may be observed if TWT is configured with longer TWT intervals (>30secs) with embedded MQTT + TWT. As an alternative, it's highly recommended to use sl_wifi_target_wake_time_auto_selection() API, where these dependencies are internally handled.

Wi-Fi STA Rejoin

  • Observed Scanning (probe request) in all channels instead of the channels configured in selective channel(channel_bitmap_2g4) during rejoin process.

IPv4/IPv6

  • IP change notification is not indicated to the application.

BSD Socket API

  • Every server socket created consumes a socket (maximum of 10 sockets supported) and every subsequent connection to server socket consumes an additional socket (from the same pool of 10 sockets), which limits the number of server connections supported.
  • Observed socket shutdown is not happening and DUT is getting stuck at "prvCheckTasksWaitingTermination" while doing socket connection-> data transfer -> socket shut down for multiple iterations.
  • Observed DUT is not sending TCP retry packets on air when configured through setsockopt().

SSL Client/Server

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Secure SSL renegotiation is not supported in the Embedded Networking Stack

HTTP Client/ HTTPS Client

  • Observed occasional HTTPS continuous download failures when power save is enabled. Recommended to disable it before performing HTTPS continuous downloads
  • Observed HTTPS post data is failing with error code: BBE2 (HTTP Failed).

SNTP

  • Unable to get SNTP async events when Coex mode and power save are enabled

Throughputs & Performance

  • Wi-Fi alone throughput is about SDK 3.x (42Mbps). SDK refinements are in progress to further improve Wi-Fi Standalone and Coex Throughputs.

Wi-Fi IOT Cloud integration

  • AWS IOT Core
  • Observed AWS MQTT keepalive transmission is not happening at expected intervals with power save enabled.
  • AZURE IOT Core
    • Observed DUT after sending the data, its not sending the MQTT keep alive packet due to this Azure HUB closing the connection.

Wi-Fi Interoperability (IOP)

  • Observed disconnections with Amplifi (AFI-INS-R) AP with powersave enable
  • TWT session is failing due to disconnections observed in DUT if rx_latency is set to 55 seconds and receive data is also set to 55 seconds on MI Xiaomi RA72 and Tplink AX53 AP's
  • Observed less throughput(~1Mb) while running TCP RX with Max_PSP powersave with DLink 810 AP
  • Observed interop issue (random disconnections) with few APs (EERO 6+, EERO PRO 6E, Cisco Catalyst 9120AXID)
  • Disconnections observed with Netgear RAX120 AP in WPA3 Security

BLE

GAP

  • BLE reconnection is not working in ble_multiconnection_gatt demo when power save is enabled in SoC.
  • When power save is enabled in the SoC, the DUT hangs with the ble_multiconnection_gatt demo while performing continuous Tx/Rx notifications.

DTM/PER

  • Recommend to limit BLE Tx Maximum power to 18 dBm. Please don't use for 127 power_index for BLE HP chain with this release.

IOP

  • BLE connection failure has been observed on a few mobile devices (Samsung S23& Oneplus 9pro) when the Si917 device is configured as central.

Multi-protocol

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test.
  • Observed Wi-Fi + BLE intermittent connection failures, disconnections, and data transfer stalls in the long run when power save is enabled.
  • Observed "DUT is not disconnecting to the AP when initiating disconnection from EFR connect app screen using wifi_station_ble_provisioning_aws example
  • Observed DUT failed to load certificate with error "0x10026" (SL_STATUS_SI91X_WRONG_PARAMETERS) while running wifi_https_ble_dual_role_v6 application

System

  • Observed random hang issues with encrypted firmwares on some earlier variant of boards (Si917-6031A, Si917-4338A) with powersave enable.

Simplicity Studio and Commander

  • Simplicity commander does not support options under "Debug Lock tools".
  • All projects in the package are compatible with GNU ARM V12.2.1 toolchain

Planned Roadmap Features

SDK

  • WPS 2.0 PIN/PUSH, Network Manager Enhancements
  • Websockets
  • Matter integration with Embedded TCP/IP stack
  • Enhanced buffer management, Throughput optimization
  • TLS over LWIP, Network layer applications (MQTT, HTTP, etc.) over LWIP.
  • Debugging utilities, UC Configurator for Wireless configurations

System

  • Secure communication over CPC (UART & SDIO interfaces)

MCU

  • Pin Tool for MCU - Pin tool for Analog Peripherals (ADC, DAC. Analog Comparator)
  • Dual Flash: Separate flash for Cortex M4 and Wireless Processor
  • Peripherals: Capacitive Touch Sensor, OPAMP, HSPI, GPDMA, QEI, RNG, IR decoder, CRC and BOD
  • Software-configurable MCU application memory options (192 or 256 or 320 kB)
  • RTOS support for MCU Peripheral examples
  • SensorHub: Support for SDC_ADC and CLOUD connectivity
  • SIO support for features Pattern matching, DMA flow control, self-loop mechanism and as a clock qualifier
  • Support for I2S PCM functionality
  • Stacked and external PSRAM: Pseudo Static RAM for storing application data and executing SoC applications.

Wi-Fi/Network Stack

  • Spatial Re-Use, BSS Max Idle
  • Provisioning using Wi-Fi AP

BLE

  • Support for 8 Peripheral + 2 Central connections
  • Support for BLE Mesh (4 nodes only) for limited Mesh use case

Limitations and Unsupported Features

System

  • None

SDK

  • Baremetal mode is not supported.
  • WiSeConnect3_SDK_3.1.3 and later versions are not compatible with firmware versions prior to 1711.2.10.1.2.0.4, due to enhancements in max transmit power configuration during Wi-Fi join/connection, need to be cautious while doing OTA firmware upgrade.

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported.
  • 40 MHz bandwidth for 2.4 GHz and 5 GHz band is not supported.
  • Max 3 SSL sockets are supported in Wi-Fi alone and CoEx modes. No.of SSL Sockets in Wi-Fi + BLE based on RAM memory configuration selected.
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • The number of Non-Transmitting BSSIDs processed is limited by the beacon length that can be processed by the stack (which is 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • Multiprotocol (STA +BLE) + EAP Security modes supported only with Memory configurations EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K.
  • UL MUMIMO is not supported.
  • WPA3 AP supports only H2E algorithm.
  • PMKSA caching is not supported in WPA3 AP mode.
  • Maximum embedded MQTT Publish payload is 1 kbyte.
  • Timeout value for socket select and socket receive calls of less than 1 second is not currently supported.
  • SA query procedure not supported in 11W AP mode.
  • WPA3 AP transition mode is not supported.
  • In Concurrent mode (AP/STA) aggregation (Tx and Rx) is not supported.
  • AP standalone mode does not support Tx aggregation. Rx aggregation is supported with limited number of BA sessions.
  • Embedded HTTP Server is not supported.
  • mDNS with IPV6 is not supported.

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections (1 Central and 1 Peripheral) with AE.
  • Advertising Extension feature is not supported in Coexistence.
  • The ae_central & ae_peripheral applications are not supported with TA_352K_M4_320K RAM configuration.
  • Two BLE connections are not supported with M4 powersave. It only supports a single connection.
  • Isochronous channels feature is not supported.
  • Connection subrating feature is not supported.
  • LE power controller feature is not supported.
  • EATT feature is not supported.
  • Periodic Advertising with a response feature is not supported.
  • BLE Audio is not supported.
  • The feature of dynamically changing the TX power when extended advertising is active is not supported.
  • EFR Connect mobile application doesn't have support to differentiate the BLE configurators based on the Bluetooth Device address.

MCU

  • SensorHub supports PS1-power state with ADC sensor. In this mode, other sensors operation is not supported.

Multi-protocol

  • Wi-Fi AP + BLE currently not supported.
  • EXT_FEAT_352K_M4SS_320K RAM configuration is not supported for coex mode with SSL

WiSeConnect3_SDK_3.1.4 SoC Release Notes

Release Details

Item Details
Release date Mar 14th, 2024
SDK Version 3.1.4
Firmware Version 1711.2.10.1.3.0.7
Release Package Name WiSeConnect3_SDK_3.1.4
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
  • SiWx917 release consists of two components:
    • Wireless Firmware - SiWx917 Firmware Binary available as SiWG917-B.2.10.1.3.0.7.rps
    • Wiseconnect3 Library - Wiseconnect3 SDK library runs on internal Cortex M4

NOTE: Mandatory to upgrade the earlier version of boards (Si917-6031A Prokit or BRD4338A boards) or 917 Silicon ICs with instructions as outlined in this document "SiWG917–TA_Flash_Memory_Map_ChangeGuide_v1.3.pdf" for more details.

Supported Hardware

Hardware OPN
Silicon (IC OPN) SiWG917M111MGTBA, SiWG917M111XGTBA, SiWG917M141XGTBA, SiWG917M121XGTBA, SiWG917M110LGTBA, SiWG917M100MGTBA
Development Kits

Pro Kit: SiWx917-PK6031A, Si917-PK6031A, SiWx917-PK6032A.

(Pro Kit includes Mother board "SI-MB4002A" + Radio board)

Radio boards: SiWx917-RB4338A, SiWx917-RB4342A

Supported Features

System

  • Operating Modes
    • Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Security
    • Secure Boot, Secure Key storage and HW device identity with PUF, Secure Zone, Secure XIP (Execution in place) from flash, Secure Attestation, Anti Rollback, Secure Debug and Flash Protection.
    • Secure firmware upgrade options:
      • Firmware loading support by Commander Tool through Jlink Debugger. Jlink connected to Serial Wire Debug (SWD)
      • Firmware loading via ISP using UART (Commander or Serial terminal), SPI Interface
      • Secure Over the Air (OTA) Upgrade
  • Crypto Support
    • Crypto API's for Hardware Accelerators:
      • Advanced Encryption Standard (AES) 128/256/192, Secure Hash Algorithm (SHA) 256/384/512, Hash Message Authentication Code (HMAC), Random Number Generator (RNG), SHA3, AES-Galois Counter Mode (GCM)/ Cipher based Message Authentication Code (CMAC), ChaCha-poly, True Random Number Generator (TRNG)
    • Software Accelerators: RSA, ECC
    • PSA Crypto APIs support for all crypto operations.
    • Wrapping Secret keys (Symmetric crypto).
  • System Power Save
    • Deep Sleep with RAM retention and without RAM retention.
    • Wireless Power Save: Connected Sleep (Wi-Fi Standby Associated), BLE Advertising with powersave, BLE Scan with powersave , BLE connection with powersave. Only Max PSP power save mode is supported in BLE.

MCU

  • Memory
    • Common Flash: Single shared Flash for both Cortex-M4 and NWP (Wireless Processor)
    • Common Flash + External PSRAM
  • Power States
    • Active: PS4, PS3, PS2, and PS1
    • Standby: PS4, PS3, and PS2
    • Sleep: PS4, PS3 and PS2
    • Deep Sleep(Shutdown): PS0
  • Peripherals
    • High Performance (HP)- ADC, Calendar, Config Timer(CT), eFuse, EGPIO, GSPI, I2C, I2S, MCPWM, SDIO Secondary, SIO, SSI, SYSRTC, UART, uDMA, USART, WDT, Analog Comparator, DAC and Temperature Sensors(RO and BJT), Bod, CTS, OPAMP, PSRAM, QEI and RTC**
    • Ultra Low Power (ULP) - ULP_TIMER, ULP_UART, ULP_I2C, ULP_I2S, ULP_uDMA, ULP_SSI, ULP_GPIO, ULP_ADC, ULP_IR_DECODER and ULP_SPI
    • UC Supported Peripherals - I2C, Calendar, SPI, SSI, SIO, uDMA, UART/USART, WDT, Config Timers, ULP Timers, SDIO Secondary, PWM, ADC, DAC, I2S and Analog Comparator
  • Services
    • Sleep Timer, IOSTREAM, Power Manager, SensorHub, NVM3
    • The flash write feature has been enhanced to support the NWP area, providing a 20k allocation within the NWP flash memory for storing user data. Moreover, a Read API has been introduced to retrieve data from the NWP flash region.
  • Development Pro-Kit Peripheral Support
    • LED, Button, MEMLCD, Joystick, RHT Sensor

Development Environment

  • Simplicity Studio IDE (SV5.8.0 version) and Debugger Integration. Refer to the latest version of the SoC "Getting-Started-with-SiWx917" guide for more details.
  • Recommended to install and use Silicon labs Gecko SDK, Git hub based version 4.4.1.
  • Simplicity Commander to supports Flash loading, provision of MBR programming, security key management, and calibration support for crystal and gain offsets. refer "siwx917-soc-manufacturing-utility-user-guide" for more details.**
  • Advanced Energy Monitoring (AEM) to measure ultra-low power capability on Development boards (Pro Kit).
  • PinTool Supported peripherals - I2C, GSPI, SSI, SIO, UART/USART, Config Timers, PWM, I2S

Wi-Fi

  • Wi-Fi Protocols
    • IEEE 802.11 b/g/n/ax (2.4GHz)
  • Access Point (AP) Mode
    • 4 Client Support, Hidden SSID Mode, Auto Channel Selection, Scan in AP mode (Alpha Version)
    • Wi-Fi Security
      • WPA2 Personal, WPA3 Personal (H2E method only) (Alpha Version), WPA Mixed mode (WPA/WPA2)
  • Wi-Fi Scan
    • Selective Scan, Active/Passive Scan
  • Wi-Fi STA (Security Modes)
    • Open Mode, WPA2 Personal, WPA2 Enhancements, WPA3 Personal, Mixed Mode (WPA/WPA2), WPA3 Personal Transition Mode (WPA2/WPA3)
  • WPA2 Enterprise security (STA)
    • Method
      • PEAP/TTLS/TLS 1.0/TLS 1.2/FAST
  • Wi-Fi STA Rejoin
  • Wi-Fi STA Roaming
    • BG Scan, OKC (Opportunistic Key caching), PMK (Pairwise Master Key) caching, Pre-Authentication
  • Wi-Fi Protocol Power Save
    • Deep sleep (unconnected state), Max PSP, Enhanced Max PSP, Fast PSP,** TWT
  • QoS
    • WMM-QoS
  • Wi-Fi 6 Feature
    • MUMIMO (DL), OFDMA (UL/DL), iTWT, TWT I-Frame & TWT Enhancements, BSS coloring, MBSSID
  • Wi-Fi Concurrency
    • AP+STA (Same channel)
  • Wi-Fi Band/Channels
    • 2.4GHz CH1-11, 2.4GHz CH1-13, 2.4GHz CH1-14 (Japan)
  • Known Security Vulnerabilities Handled
    • WPA2 KRACK Attacks, Fragment and Forge Vulnerability

Network Stack

  • Core Networking Features
    • TCP/IP Bypass (LWIP as Hosted stack for reference), IPv4/IPv6/UDP/TCP/ARP/ICMP/ICMPv6
    • SSL client versions TLSV1.0, TLSV1.2, TLSV1.3
    • SSL server versions TLSV1.0 and TLSV1.2
    • DHCPv4 (Client/Server)/ DHCPv6 Client
  • Advanced Network Features
    • HTTP Client/HTTPS Client//DNS Client/SNTP Client, Embedded MQTT/MQTT on host
  • Wi-Fi IoT Cloud Integration
    • AWS IOT Core
  • BSD and IoT sockets application programming interface(API)

BLE

  • GAP(Advertising, Scanning, initiation, Connection and Bonding)
  • Generic Attribute Protocol(GATT)
  • Attribute protocol(ATT)
  • Security
  • LL Privacy 1.2
  • Accept list
  • Directed Advertising
  • Extended Advertising
  • Periodic Advertising
  • Periodic Advertising scanning
  • Extended Advertising scanning
  • Periodic Advertising list
  • LE periodic advertising synchronization
  • LE PHY(1Mbps, 2Mbps) & Coded PHY(125Kbps, 500kbps)
  • Simultaneous scanning on 1Mbps and Coded PHY
  • LE dual role topology
  • LE data packet length extensions(DLE)
  • Asymmetric PHYs
  • LE channel selection algorithm 2 (CSA#2)
  • LE Secure connections
  • Bluetooth 5.4 Qualified

SDK

  • Simplified and Unified DX for Wi-Fi API and Platform APIs
  • Simplifies application development and presents clean and standardized APIs
  • UC (Universal Configurator) enables componentization, simplifying configuration of peripherals and examples
  • BSD and ARM IoT-compliant socket API
  • Available through Simplicity Studio and GitHub

Multi-protocol

  • Wi-Fi STA + BLE

PTA/Coexistence

  • 3 wire coex acting as Wi-Fi with external Bluetooth
  • 3 wire coex acting as Wi-Fi with external Zigbee/OT

Changes in this release compared to v3.1.3 Release

System

  • Enhancements
    • The flash write feature has been enhanced to support the NWP area, providing a 20k allocation within the NWP flash memory for storing user data. Moreover, a Read API has been introduced to retrieve data from the NWP flash region.
    • Added combined image support (NWP and M4) over-the-air update in a single instance.
  • Fixed Issues
    • None

MCU

  • Enhancements
    • The LF clock source has been switched from RO (32kHz) to RC. Adjustments were made in power save applications to reflect this switch
  • Fixed Issues
    • SensorHub now supports support ADC multi-channel
    • PWM Special event trigger for synchronizing analog-to-digital conversions is working now
    • The wakeup source ULP-SSI is working in the Power Manager service now
    • ADC, ULP_ADC and ULP_ADC Multichannel applications are printing float values in serial console

SDK

  • Enhancements
    • Added support for HTTP Server and provided demo application.
    • Added Support for OPN Based Project Creation.
    • Added Mem pool component support for SoC demos.
    • Added multithreaded support for the Concurrent mode demo.
    • Added IPv6 support in AWS IoT MQTT Client application.
    • Added API support to get socket information from firmware.
    • Enhancements in Wi-Fi throughputs.
  • Fixed Issues
    • Updated the missing error codes in the documentation.
    • Fixed SNTP client stop issue.

Wi-Fi/Network Stack

  • Enhancements
    • Added support to configure IPv6 link local address from the host while skipping the configuration of IPv6 unique global address for the network interface.
    • Added support for configuration of SU Beamforming capability
    • Added DNS-SD record in the MDNS query response to allow discovery of DUT's MDNS service with consistency.
  • Fixed Issues
    • Fixed the server-side dependency that was causing the repetition of the firmware binary header (64 bytes) during OTA process
    • Fixed MBSSID feature Interop issue with WiFi7 Access Points.

BLE

  • Enhancements
    • Added BLE error code details in 917 documentation.
    • Added external PSRAM support for ble_accept_list, ble_ae_central, ble_ae_peripheral, ble_central, ble_datalength, ble_heart_rate_profile, ble_hid_on_gatt, ble_ibeacon, ble_longrange_2mbps, ble_multiconnection_gatt_test, ble_privacy, ble_secureconnection, ble_testmodes, ble_unified_ae_coex_app, ble_update_gain_table gatt_long_read and ble_datalength applications.
  • Fixed Issues
    • Resolved the BLE hang issue when DUT was trying to connect to the nRf dongle with I/O capability as 0x00.
    • Fixed BLE start advertising API failed within five minutes of continuously doing ble start, stop, and clear the address resolution API, with an error code 0xffffffe2 (RSI_ERROR_RESPONSE_TIMEOUT).

Multi-protocol

  • Enhancements
    • Added new macro BLE_ADVERTISE_ONLY for wifi_ble_power_save application.
    • Enabled support for 3 SSL sockets in COEX mode.
  • Fixed Issues
    • None.

Recommendations

System

  • The current revision of SiWx917 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in SoC mode.
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement. EXT_FEAT_352K_M4SS_320K is the default configuration, based on requirement EXT_FEAT_480K_M4SS_192K configuration is selected for SoC mode multi-protocol examples.
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • SoC mode should not use 672k_M4SS_0K memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.
  • There are 2 Versions of Pro-Kits/Radio boards. Si917-6031A based on Si917-4338A(Rev: A01 - A11) and SiWx917-6031A based on SiWx917-4338A(Rev: A12). To get optimal power numbers, enable macro "SL_SI91X_ENABLE_LOWPWR_RET_LDO" pre-processor define for ICs or while using SiWx917-6031A Pro-kit, SiWx917-4338A version of boards. This macro should be disabled for earlier variant of board (Si917-6031A, Si917-4338A).
  • With RAM configuration (EXT_FEAT_352K_M4SS_320K), only 352K memory is available to TA which limits the features supported, Recommended to enable EXT_FEAT_416K_M4SS_256K in Wi-Fi + BLE Multi protocol mode to enable more Network features.
  • For EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K memory configurations, it is recommended to retain both TA and M4 RAMs in power save.

Wi-Fi/Network Stack

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • For high throughput applications, aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode.
  • To reset TA (NWP), the application needs to call sl_wifi_deinit() followed by sl_wifi_init(). Users must ensure that no execution happens from flash at this point of time. (Refer to example applications)
  • Users can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature' bit map in opermode for (HTTPS server) supporting 16k record.
  • TWT
    • Recommendation is to use sl_wifi_target_wake_time_auto_selection() API for all TWT applications.
    • It is recommended to issue iTWT setup command once IP assignment, TCP connection, application specific socket connections are done.
    • When using sl_wifi_enable_target_wake_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured. It's highly recommended to use sl_wifi_target_wake_time_auto_selection() as an alternative.
    • In case of TWT in coex mode, when using sl_wifi_enable_target_wake_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
    • For iTWT GTK interval in AP should be configured to max possible value or zero. If GTK interval is not configurable on AP side, recommended TWT interval (in case of sl_wifi_enable_target_wake_time API) or RX Latency (in case of sl_wifi_target_wake_time_auto_selection API) is less than 4sec.
    • When sl_wifi_enable_target_wake_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wake interval of less than or equal to 1 min.
    • When using sl_wifi_enable_target_wake_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Disable power save for high throughput applications or use FAST PSP power save mode as per application requirement.
  • The application needs to ensure that it sets RTC with the correct timestamp before establishing the SSL/EAP connection.
  • The minimum timeout value should not be less than 1 second for socket select and socket receive calls.
  • Embedded MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • Disable power save and suspend any active TWT sessions before triggering HTTP OTAF.
  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.

BLE

  • In BLE, the recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

Multi-protocol

  • 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.

Known Issues of WiSeConnect3_SDK_3.1.4 Release

MCU

SensorHub

  • Power transitions with AWS are not stable in SensorHub.

SSI

  • SSI Dual and Quad mode are not functional.
  • SSI primary: Mode3 and TI is not working as expected.
  • SSI Primary will not be operable at 40 MHz
  • SSI Full Duplex in DMA mode is not working as expected
  • SSI in DMA mode is limited to only 1024 bytes of buffer size

I2C

  • ULP I2C High speed and Fast plus modes are not working at specified speed

UART

  • Flow control is not supported in ULP UART.

ADC

  • In ADC Multichannel mode, sampling rate is limited to less than 15Ksps. Number of samples is less than 500 and with a maximum of 4 channel
  • In ADC Multichannel mode, when using different sampling rates for different channels behavior is not as expected.

CT (Config Timer)

  • Config Timer(CT) support as an external event, in 32-bit mode, and DMA are not working as expected

SYSRTC

  • SYSRTC with RO clock is not working as expected.

Power Manager

  • The wakeup sources BOD, Comparator, and SYSRTC are not working in the Power Manager service

SDK

  • Observed Wi-Fi connection is successful even after deleting the stored network credentials using sl_net_delete_credential and responding with SL_NET_INVALID_CREDENTIAL_TYPE for sl_net_get_credential.
  • Enhanced sl_wifi_get_firmware_version() API to provide more details (ROM ID, chip ID, security version, etc) which is not backward compatible with firmwares older than 1711.2.10.1.0.0.4. Firmware binary notation does not include security version number.
  • Matter extension based applications are experiencing compatibility issues with WiseConnect SDK 3.1.4. It is recommended to use WiseConnect SDK 3.1.1 for matter-related applications. This will be addressed in up coming release(s).
  • In PSRAM enabled demos, moving of text, data and stack segments to PSRAM is allowed. BSS and Heap should still be in SRAM.
  • Asynchronous Azure MQTT is not supported, this This will be addressed in up coming release(s).
  • Recommended to configure VAP_ID properly for Si91x STA and AP using sl_si91x_setsockopt_async(), in case of data transfer.
  • Recommended to use valid length(<= 202 bytes) for topic to be published in the "Embedded MQTT" demo, else it leads to return wrong error code(0x21).

Wi-Fi/Network Stack

Wi-Fi STA

  • STA Connection with the WPA3 Hunting and Pecking algorithm takes about 3-4 seconds.
  • Observed connection failures with some AP's in more channel congestion ~50-60% occupancy open lab environment.
  • Region selection based on country IE in the beacon is not supported
  • Observed intermittent beacon reception from Access Point ( beacon misses) in an extremely congested environment

Access Point (AP) Mode

  • Scan feature in AP mode not fully functional.
  • Fixed rate configuration in AP mode using sl_wifi_set_transmit_rate API is not being set as expected.

WPA2 Enterprise security (STA)

  • Observed connection issue with configuring certificate key and programming 4096 bit key and SHA384/SHA512 certificates.
  • Observing DUT is throwing 0x1001c when configuring .data.certificate_key as "123456789".
  • Configuration issue to program PAC file for EAP FAST Manual mode.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

Wi-Fi Concurrency (AP + STA in same channel)

  • Observed 3rd party STA association fail with 917 AP while 917 STA mode is connecting/reconnecting to configured 3rd party AP. Reconnect 3rd party STA to 917 AP in such scenarios.

OFDMA (UL/DL)

  • Less throughput observed in DL-OFDMA with some APs that enabled LDPC.

MUMIMO (DL)

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test.
  • Observed Performance, Interop issues with MU MIMO with certain APs.
  • Less throughput observed in MU-MIMO with some APs that enabled LDPC.

MU-MIMO (UL)

  • UL MU-MIMO is not supported.

TWT

  • Variability with MQTT keep alive interval based on TWT wake up interval.
  • When sl_wifi_enable_target_wake_time() API is used, occasional MQTT disconnections may be observed if TWT is configured with longer TWT intervals (>30secs) with embedded MQTT + TWT. As an alternative, it's highly recommended to use sl_wifi_target_wake_time_auto_selection() API, where these dependencies are internally handled.

Wi-Fi STA Rejoin

  • Observed Scanning (probe request) in all channels instead of the channels configured in selective channel(channel_bitmap_2g4) during rejoin process.

IPv4/IPv6

  • Observed issue with assigning static IP to DUT
  • IP change notification is not indicated to the application.

BSD Socket API

  • Configuration issue to program TCP retry count (default 10) through setsockopt
  • Every server socket created consumes a socket (maximum of 10 sockets supported) and every subsequent connection to server socket consumes an additional socket (from the same pool of 10 sockets), which limits the number of server connections supported.

SSL Client/Server

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Secure SSL renegotiation is not supported in the Embedded Networking Stack
  • Observed connection failures with ECDSA ciphers.

HTTP Client/ HTTPS Client

  • Observed occasional HTTPS continuous download failures when power save is enabled. Recommended to disable it before performing HTTPS continuous downloads
  • Observed HTTPS post data is failing with error code: BBE2 (HTTP Failed).
  • Unable to get HTTP GET response when http length is exceeding 1024 bytes when SL_SI91X_FEAT_LONG_HTTP_URL bit is disabled.

SNTP

  • Unable to get SNTP async events when Coex mode and power save are enabled

Throughputs & Performance

  • Wi-Fi alone throughput is about SDK 3.x (42Mbps). SDK refinements are in progress to further improve Wi-Fi Standalone and Coex Throughputs.

Secure Over the Air (OTA) Upgrade

  • None.

Wi-Fi IOT Cloud integration (AWS IOT Core)

  • Observed AWS MQTT keepalive transmission is not happening at expected intervals with power save enabled.

Wi-Fi Interoperability (IOP)

  • Observed disconnections with Amplifi (AFI-INS-R) AP with powersave enable
  • TWT session is failing due to disconnections observed in DUT if rx_latency is set to 55 seconds and receive data is also set to 55 seconds on MI Xiaomi RA72 and Tplink AX53 AP's
  • Observed less throughput(~1Mb) while running TCP RX with Max_PSP powersave with DLink 810 AP
  • Observed interop issue (random disconnections) with few APs (EERO 6+, EERO PRO 6E, Cisco Catalyst 9120AXID)
  • Disconnections observed with Netgear RAX120 AP in WPA3 Security
  • Disconnections observed while running SSL traffic in power save and CoEx mode with Asus RT-AX3000 AP.

BLE

GAP

  • BLE reconnection is not working in ble_multiconnection_gatt demo when power save is enabled in SoC.
  • When power save is enabled in the SoC, the DUT hangs with the ble_multiconnection_gatt demo while performing continuous Tx/Rx notifications.

DTM/PER

  • Recommend to limit BLE Tx Maximum power to 18 dBm. Please don't use for 127 power_index for BLE HP chain with this release.

IOP

  • BLE connection failure has been observed on a few mobile devices (Samsung S23& Oneplus 9pro) when the Si917 device is configured as central.

Multi-protocol

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test.
  • Observed Wi-Fi + BLE intermittent connection failures, disconnections, and data transfer stalls in the long run when power save is enabled.
  • Observed "DUT is not disconnecting to the AP when initiating disconnection from EFR connect app screen using wifi_station_ble_provisioning_aws example

System

  • Observed random hang issues with encrypted firmwares on some earlier variant of boards (Si917-6031A, Si917-4338A) with powersave enable.

Simplicity Studio and Commander

  • Simplicity commander does not support options under "Debug Lock tools".
  • All projects in the package are compatible with GNU ARM V12.2.1 toolchain

Planned Roadmap Features

SDK

  • WPS 2.0 PIN/PUSH, Network Manager Enhancements
  • MDNS, HTTP Server, Azure MQTT Client, Websockets
  • Matter integration with Embedded TCP/IP stack
  • Enhanced buffer management, Throughput optimization
  • TLS over LWIP, Network layer applications (MQTT, HTTP, etc.) over LWIP.
  • Debugging utilities, UC Configurator for Wireless configurations

System

  • Secure communication over CPC (UART & SDIO interfaces)

MCU

  • Pin Tool for MCU - Pin tool for Analog Peripherals (ADC, DAC. Analog Comparator)
  • Dual Flash: Separate flash for Cortex M4 and Wireless Processor
  • Peripherals: Capacitive Touch Sensor, OPAMP, HSPI, GPDMA, QEI, RNG, IR decoder, CRC and BOD
  • Software-configurable MCU application memory options (192 or 256 or 320 kB)
  • RTOS support for MCU Peripheral examples
  • SensorHub: Support for SDC_ADC and CLOUD connectivity
  • SIO support for features Pattern matching, DMA flow control, self-loop mechanism and as a clock qualifier
  • Support for I2S PCM functionality
  • Stacked and external PSRAM: Pseudo Static RAM for storing application data and executing SoC applications.

Wi-Fi/Network Stack

  • Spatial Re-Use, BSS Max Idle
  • Provisioning using Wi-Fi AP

BLE

  • Support for 8 Peripheral + 2 Central connections
  • Support for BLE Mesh (4 nodes only) for limited Mesh use case

Limitations and Unsupported Features

System

  • None

SDK

  • Baremetal mode is not supported.
  • WiSeConnect3_SDK_3.1.3 and later versions are not compatible with firmware versions prior to 1711.2.10.1.2.0.4, due to enhancements in max transmit power configuration during Wi-Fi join/connection, need to be cautious while doing OTA firmware upgrade.

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported.
  • 40 MHz bandwidth for 2.4 GHz band and 5 GHz is not supported.
  • Max 3 SSL sockets are supported in Wi-Fi alone and CoEx modes. No.of SSL Sockets in Wi-Fi + BLE based on RAM memory configuration selected.
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • The number of Non-Transmitting BSSIDs processed is limited by the beacon length that can be processed by the stack (which is 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • Multiprotocol (STA +BLE) + EAP Security modes supported only with Memory configurations EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K.
  • UL MUMIMO is not supported.
  • WPA3 AP supports only H2E algorithm.
  • PMKSA caching is not supported in WPA3 AP mode.
  • Maximum embedded MQTT Publish payload is 1 kbyte.
  • Timeout value for socket select and socket receive calls of less than 1 second is not currently supported.
  • SA query procedure not supported in 11W AP mode.
  • WPA3 AP transition mode is not supported.

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections (1 Central and 1 Peripheral) with AE.
  • Advertising Extension feature is not supported in Coexistence.
  • The ae_central & ae_peripheral applications are not supported with TA_352K_M4_320K RAM configuration.
  • Two BLE connections are not supported with M4 powersave. It only supports a single connection.
  • Isochronous channels feature is not supported.
  • Connection subrating feature is not supported.
  • LE power controller feature is not supported.
  • EATT feature is not supported.
  • Periodic Advertising with a response feature is not supported.
  • BLE Audio is not supported.
  • The feature of dynamically changing the TX power when extended advertising is active is not supported.

MCU

  • SensorHub supports PS1-power state with ADC sensor. In this mode, other sensors operation is not supported.

Multi-protocol

  • Wi-Fi AP + BLE currently not supported.
  • EXT_FEAT_352K_M4SS_320K RAM configuration is not supported for coex mode with SSL

WiSeConnect3_SDK_3.1.3 SoC Release Notes

Release Details

Item Details
Release date Feb 14th, 2024
SDK Version 3.1.3
Firmware Version 1711.2.10.1.2.0.4
Release Package Name WiSeConnect3_SDK_3.1.3
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
  • SiWx917 release consists of two components:
    • Wireless Firmware - SiWx917 Firmware Binary available as SiWG917-B.2.10.1.2.0.4.rps
    • Wiseconnect3 Library - Wiseconnect3 SDK library runs on internal Cortex M4

NOTE: Mandatory to upgrade the earlier version of boards (Si917-6031A Prokit or BRD4338A boards) or 917 Silicon ICs with instructions as outlined in this document "SiWG917–TA_Flash_Memory_Map_ChangeGuide_v1.3.pdf" for more details.  

Supported Hardware

Hardware OPN
Silicon (IC OPN) SiWG917M111MGTBA
Development Kits

Pro Kit: SiWx917-PK6031A, Si917-PK6031A, SiWx917-PK6032A.

(Pro Kit includes Mother board "SI-MB4002A" + Radio board)

Radio boards: SiWx917-RB4338A, Si917-RB4338A, SiWx917-RB4342A

Supported Features 

System

  • Operating Modes 
    • Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Security 
    • Secure Boot, Secure Key storage and HW device identity with PUF, Secure Zone, Secure XIP (Execution in place) from flash, Secure Attestation, Anti Rollback, Secure Debug and Flash Protection. 
    • Secure firmware upgrade options:
      • Firmware loading support by Commander Tool through Jlink Debugger. Jlink connected to Serial Wire Debug (SWD) 
      • Firmware loading via ISP using UART (Commander or Serial terminal), SPI Interface
      • Secure Over the Air (OTA) Upgrade
  • Crypto Support
    •  Crypto API's for Hardware Accelerators:
      • Advanced Encryption Standard (AES) 128/256/192, Secure Hash Algorithm (SHA) 256/384/512, Hash Message Authentication Code (HMAC), Random Number Generator (RNG), SHA3, AES-Galois Counter Mode (GCM)/ Cipher based Message Authentication Code (CMAC), ChaCha-poly, True Random Number Generator (TRNG)
    • Software Accelerators: RSA, ECC 
    • Integrated with mbed TLS.
    • TRNG, AES, SHA, HMAC, GCM, Chacha-poly, ECDH and AES-CCM hardware crypto engine is integrated with PSA crypto.
  • System Power Save
    • Deep Sleep with RAM retention and without RAM retention. 
    • Wireless Power Save: Connected Sleep (Wi-Fi Standby Associated), BLE Advertising with powersave, BLE Scan with powersave ,  BLE connection with powersave. Only Max PSP power save mode is supported in BLE. 

MCU

  • Memory
    • Common Flash: Single shared Flash for both Cortex-M4 and NWP (Wireless Processor)
    • Common Flash + External PSRAM
  • Power States
    • Active: PS4, PS3, PS2, and PS1 
    • Standby: PS4, PS3, and PS2
    • Sleep: PS4, PS3 and PS2
    • Deep Sleep(Shutdown): PS0
  • Peripherals
    • High Performance (HP)- ADC, CALENDAR, CONFIG TIMER(CT), EFUSE, EGPIO, GSPI, I2C, I2S, MCPWM, SDIO Secondary, SIO, SSI, SYSRTC, UART, uDMA, USART, WDT, Analog Comparator, DAC and Temperature Sensor(RO and BJT)** 
    • Ultra Low Power (ULP) - ULP_TIMER, ULP_UART, ULP_I2C, ULP_I2S, ULP_uDMA and ULP_SSI
  • Services
    • Sleep Timer, IOSTREAM, Power Manager, SensorHub, NVM3
  • Development Pro-Kit Peripheral Support
    • LED, Button, MEMLCD, Joystick, RHT Sensor

Development Environment

  • Simplicity Studio IDE (SV5.8.0 version) and Debugger Integration.   Refer to the latest version of the SoC "Getting-Started-with-SiWx917" guide for more details. 
  • Simplicity Commander to supports Flash loading, provision of MBR programming, security key management, and calibration support for crystal and gain offsets. refer "siwx917-soc-manufacturing-utility-user-guide" for more details.** 
  • Advanced Energy Monitoring (AEM) to measure ultra-low power capability on Development boards (Pro Kit).

Wi-Fi

  • Wi-Fi Protocols
    • IEEE 802.11 b/g/n/ax (2.4GHz)
  • Access Point (AP) Mode
    • 4 Client Support, Hidden SSID Mode, Auto Channel Selection, Scan in AP mode (Alpha Version)
    • Wi-Fi Security  
      • WPA2 Personal, WPA3 Personal (H2E method only) (Alpha Version), WPA Mixed mode (WPA/WPA2) 
  • Wi-Fi Scan
    • Selective Scan, Active/Passive Scan
  • Wi-Fi STA (Security Modes)
    • Open Mode, WPA2 Personal, WPA2 Enhancements, WPA3 Personal, Mixed Mode (WPA/WPA2), WPA3 Personal Transition Mode (WPA2/WPA3)
  • WPA2 Enterprise security (STA)
    • Method
      • PEAP/TTLS/TLS 1.0/TLS 1.2/FAST
  • Wi-Fi STA Rejoin
  • Wi-Fi STA Roaming
    • BG Scan, OKC (Opportunistic Key caching), PMK (Pairwise Master Key) caching, Pre-Authentication
  • Wi-Fi Protocol Power Save 
    • Deep sleep (unconnected state), Max PSP, Enhanced Max PSP, Fast PSP,** TWT
  • QoS
    • WMM-QoS
  • Wi-Fi 6 Feature
    • MUMIMO (DL), OFDMA (UL/DL), iTWT, TWT I-Frame & TWT Enhancements, BSS coloring, MBSSID
  • Wi-Fi Concurrency 
    • AP+STA (Same channel)
  • Wi-Fi Band/Channels
    • 2.4GHz CH1-11, 2.4GHz CH1-13, 2.4GHz CH1-14 (Japan)
  • Known Security Vulnerabilities Handled
    • WPA2 KRACK Attacks, Fragment and Forge Vulnerability

Network Stack

  • Core Networking Features
    • TCP/IP Bypass (LWIP as Hosted stack for reference), IPv4/IPv6/UDP/TCP/ARP/ICMP/ICMPv6
    • SSL client versions TLSV1.0, TLSV1.2, TLSV1.3 
    • SSL server versions TLSV1.0 and TLSV1.2
    • DHCPv4 (Client/Server)/ DHCPv6 Client
  • Advanced Network Features
    • HTTP Client/HTTPS Client//DNS Client/SNTP Client, Embedded MQTT/MQTT on host
  • Wi-Fi IoT Cloud Integration
    • AWS IOT Core
  • BSD and IoT sockets application programming interface(API)

BLE 

  • GAP(Advertising, Scanning, initiation, Connection and Bonding)
  • Generic Attribute Protocol(GATT)
  • Attribute protocol(ATT)
  • Security
  • LL Privacy 1.2
  • Accept list
  • Directed Advertising
  • Extended Advertising
  • Periodic Advertising
  • Periodic Advertising scanning
  • Extended Advertising scanning
  • Periodic Advertising list
  • LE periodic advertising synchronization
  • LE PHY(1Mbps, 2Mbps) & Coded PHY(125Kbps, 500kbps)
  • Simultaneous scanning on 1Mbps and Coded PHY
  • LE dual role topology
  • LE data packet length extensions(DLE)
  • Asymmetric PHYs
  • LE channel selection algorithm 2 (CSA#2)
  • LE Secure connections
  • Bluetooth 5.4 Qualified

SDK

  • Simplified and Unified DX for Wi-Fi API and Platform APIs
  • Simplifies application development and presents clean and standardized APIs
  • UC (Universal Configurator) enables componentization, simplifying configuration of peripherals and examples
  • BSD and ARM IoT-compliant socket API
  • Available through Simplicity Studio and GitHub

Multi-protocol

  • Wi-Fi STA + BLE

PTA/Coexistence

  • 3 wire coex acting as Wi-Fi with external Bluetooth
  • 3 wire coex acting as Wi-Fi with external Zigbee/OT

Changes in this release compared to v3.1.2 Release

System

  • Enhancements
    • Enhancements done in power save module to address a few stability issues
    • Enchancements done in deinit mechanism
  • Fixed Issues
    • Fixed De-init issue for the system which do not support XTAL.

MCU

  • Enhancements
    • Added support for SDC with ADC in SensorHub
    • Provided support for UART multiple instance
    • Provided support for M4 Power transitions (PS4-PS2-PS4) in Power Manager servicepin.
  • Fixed Issues
    • Fix for SPI sensor issue in SensorHub
    • Fix for ADC stuck in powersave initialization

SDK

  • Enhancements
    • Added mDNS feature support (Alpha Version).
    • Added Azure Freertos middleware SDK Support (Alpha Version).
    • Added support for External PSRAM (SiWx917-RB4342A), for featured demos.
    • Added "wifi_http_otaf_twt" demo.
    • Added "Wi-Fi - Azure IoT MQTT Client" demo.
    • Added sl_si91x_set_fast_fw_up() and sl_si91x_upgrade_firmware() APIs for firmware upgrade.
    • Added callback support for handling TCP remote terminate event.
    • Added support for wild cards in MQTT subscription.
    • Added sl_sntp_client_get_time() API to get epoch time for SNTP.
    • Replaced licensed third party certificates with prototype certs for AWS and Azure.
    • It is recommended to enable bit 12 of the 'Feature bit map' in the opermode command for enabling long sized ICMP packet support.
    • Added support in SDK to set absolute power value in scan and join commands.
    • Added wifi6 support in PER mode for CLI demo.
    • Implemented a handshake mechanism between NWP and M4 for Wi-Fi deinit to overcome RAM-based execution dependency.
  • Fixed Issues
    • Added RAM execution for calibration example.
    • Fixed MQTT returning an error when the incoming publish packet length is greater than 64 bytes.
    • Fixed Http client de-init hang issue when wlan disconnect occurs.
    • Fixed issues with Asynchronous socket select.
    • Updated Korea region configuration.
    • Fixed issues in OOB demo.
    • Fixed issues in standard curve parameters for SECP192R1 curve.
    • Modified RSI_HT_CAPS_BIT_MAP to support 20MHz channel width only. 

Wi-Fi/Network Stack

  • Enhancements
    • Added Long URL support of 2048 bytes for HTTP Get Command
    • Added support for Transition Disable Indication (TDI) in AP mode. It is an indication from an Si91x AP to WPA2/3 STA, that the STA is to disable certain transition modes for subsequent connections to the AP's network.
    • Implemented beacon stop feature in AP mode.
    • Enabled HT Caps in AP mode for high throughputs.
    • Increased the topic length and username length size for Embedded MQTT Publish and Subscribe.
  • Fixed Issues
    • Added support for wrapping functionality for unaligned key length.

BLE

  • Enhancements
    • None
  • Fixed Issues
    • Fixed the issue where connectable directed advertising exited without establishing a connection with the central device.
    • Fixed issue where device is throwing an error when it tried to re-enabling AE ADV after establishing an AE connection with two adverting sets.
    • Fixed AE connection fail issue when remote device transmitting AUX ADV packets with Coded PHY rates.

Multi-protocol

  • Enhancements
    • None
  • Fixed Issues
    • Fixed issue where device sometimes failed to respond to connection update request in CoEx which is causing BLE disconnection.

Recommendations

System

  • The current revision of SiWx917 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in SoC mode. 
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement. EXT_FEAT_352K_M4SS_320K is the default configuration, based on requirement EXT_FEAT_480K_M4SS_192K configuration is selected for SoC mode multi-protocol examples.
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • SoC mode should not use 672k_M4SS_0K memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.
  • There are 2 Versions of Pro-Kits/Radio boards.  Si917-6031A based on Si917-4338A and SiWx917-6031A based on SiWx917-4338A. To get optimal power numbers, enable macro "SL_SI91X_ENABLE_LOWPWR_RET_LDO" pre-processor define for ICs or while using SiWx917-6031A Pro-kit, SiWx917-4338A version of boards. This macro should be disabled for earlier variant of board (Si917-6031A, Si917-4338A).
  • With RAM configuration (EXT_FEAT_352K_M4SS_320K), only 352K memory is available to TA  which limits the features supported, Recommended to enable EXT_FEAT_416K_M4SS_256K in Wi-Fi + BLE Multi protocol mode to enable more Network features.
  • For EXT_FEAT_416K_M4SS_256K  and EXT_FEAT_480K_M4SS_192K memory configurations, it is recommended to retain both TA and M4 RAMs in power save.

Wi-Fi/Network Stack

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • For high throughput applications, aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode. 
  • To reset TA (NWP), the application needs to call sl_wifi_deinit() followed by sl_wifi_init(). Users must ensure that no execution happens from flash at this point of time. (Refer to example applications) 
  • Users can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature' bit map in opermode for (HTTPS server) supporting 16k record.
  • TWT
    • Recommendation is to use sl_wifi_target_wake_time_auto_selection() API for all TWT applications. 
    • It is recommended to issue iTWT setup command once IP assignment, TCP connection, application specific socket connections are done.
    • When using sl_wifi_enable_target_wake_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured. It's highly recommended to use sl_wifi_target_wake_time_auto_selection() as an alternative.
    • In case of TWT in coex mode, when using sl_wifi_enable_target_wake_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
    • For iTWT GTK interval in AP should be configured to max possible value or zero. If GTK interval is not configurable on AP side, recommended TWT interval (in case of sl_wifi_enable_target_wake_time API) or RX Latency (in case of sl_wifi_target_wake_time_auto_selection API) is less than 4sec.
    • When sl_wifi_enable_target_wake_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wake interval of less than or equal to 1 min.
    • When using sl_wifi_enable_target_wake_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Disable power save for high throughput applications or use FAST PSP power save mode as per application requirement.
  • The application needs to ensure that it sets RTC with the correct timestamp before establishing the SSL/EAP connection.
  • The minimum timeout value should not be less than 1 second for socket select and socket receive calls. 
  • Embedded MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • Disable power save and suspend any active TWT sessions before triggering HTTP OTAF.
  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.

BLE

  • In BLE, the recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

Multi-protocol

  • 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.

Known Issues of WiSeConnect3_SDK_3.1.3 Release

MCU

SensorHub

  • SensorHub does not support ADC multi-channel. 
  • Power transitions with AWS are not stable in SensorHub.

SSI

  • SSI Dual and Quad mode are not functional. 
  • SSI primary: mode3(TI) is not working as expected. 
  • SSI Primary will not be operable at 40 MHz 

I2C

  • I2C High speed and Fastplus modes are not working at specification speed

UART

  • Flow control is not supported in USART and IOSTREAM applications

ADC

  • In ADC Multichannel, sampling rate is limited to less than 15Ksps. Number of samples is less than 500 and with a maximum of 4 channel
  • In ADC Multichannel, when using different sampling rates for different channels behavior is not as expected
  • ADC, ULP_ADC and ULP_ADC Multichannel applications are not printing float values in serial console.

CT (Config Timer)

  • Config Timer(CT) support as an external event, in 32-bit mode, and DMA are not working as expected

PWM

  • PWM Special event trigger for synchronizing analog-to-digital conversions is not working

SYSRTC

  • SYSRTC with RO clock is not functioning

Power Manager

  • The wakeup sources ULP-SSI, BOD, Comparator, and SysRTC are not working in the Power Manager service

SDK

  • Observed Wi-Fi connection is successful even after deleting the stored network credentials using sl_net_delete_credential and responding with SL_NET_INVALID_CREDENTIAL_TYPE for sl_net_get_credential.
  • Enhanced sl_wifi_get_firmware_version() API to provide more details (ROM ID, chip ID, security version, etc) which is not backward compatible with firmwares older than 1711.2.10.1.0.0.4. Firmware binary notation does not include security version number.
  • Matter applications are experiencing compatibility issues with WiseConnect SDK 3.1.2. It is recommended to use WiseConnect SDK 3.1.1 for matter-related applications. This will be addressed in up coming release(s).
  • In PSRAM enabled demos, moving of text, data and stack segments to PSRAM is allowed. BSS and Heap should still be in SRAM.
  • Asynchronous Azure MQTT is not supported, this This will be addressed in up coming release(s).

Wi-Fi/Network Stack

Wi-Fi STA

  • STA Connection with the WPA3 Hunting and Pecking algorithm takes about 3-4 seconds.
  • Observed connection failures with some AP's in more channel congestion ~50-60% occupancy open lab environment.
  • Region selection based on country IE in the beacon is not supported
  • Observed intermittent beacon reception from Access Point ( beacon misses) in an extremely congested environment

Access Point (AP) Mode

  • Scan feature in AP mode not fully functional. 
  • Fixed rate configuration in AP mode using sl_wifi_set_transmit_rate API is not being set as expected. 

WPA2 Enterprise security (STA)

  • Observed connection issue with configuring certificate key and programming 4096 bit key and SHA384/SHA512 certificates.
  • Observing DUT is throwing 0x1001c when configuring .data.certificate_key as "123456789".
  • Configuration issue to program PAC file for EAP FAST Manual mode.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

Wi-Fi Concurrency (AP + STA in same channel)

  • Observed 3rd party STA association fail with 917 AP while 917 STA mode is connecting/reconnecting to configured 3rd party AP. Reconnect 3rd party STA to 917 AP in such scenarios. 

OFDMA (UL/DL)

  • Less throughput observed in DL-OFDMA with some APs that enabled LDPC.

MUMIMO (DL)

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test. 
  • Observed Performance, Interop issues with MU MIMO with certain APs. 
  • Less throughput observed in MU-MIMO with some APs that enabled LDPC.

MU-MIMO (UL)

  • UL MU-MIMO is not supported.

TWT

  • Variability with MQTT keep alive interval based on TWT wake up interval.  
  • When sl_wifi_enable_target_wake_time() API is used, occasional MQTT disconnections may be observed if TWT is configured with longer TWT intervals (>30secs) with embedded MQTT + TWT.  As an alternative, it's highly recommended to use sl_wifi_target_wake_time_auto_selection() API, where these dependencies are internally handled.

Wi-Fi STA Rejoin

  • Observed Scanning (probe request) in all channels instead of the channels configured in selective channel(channel_bitmap_2g4) during rejoin process. 

IPv4/IPv6

  • Observed issue with assigning static IP to DUT
  • IP change notification is not indicated to the application. 

BSD Socket API

  • Configuration issue to program TCP retry count (default 10) through setsockopt
  • Every server socket created consumes a socket (maximum of 10 sockets supported) and every subsequent connection to server socket consumes an additional socket (from the same pool of 10 sockets), which limits the number of server connections supported.

SSL Client/Server

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Secure SSL renegotiation is not supported in the Embedded Networking Stack
  • Observed connection failures with ECDSA ciphers.

HTTP Client/ HTTPS Client

  • Observed occasional HTTPS continuous download failures when power save is enabled. Recommended to disable it before performing HTTPS continuous downloads
  • Observed HTTPS post data is failing with error code: BBE2 (HTTP Failed).
  • Unable to get HTTP GET response when http length is exceeding 1024 bytes when SL_SI91X_FEAT_LONG_HTTP_URL bit is disabled.

SNTP

  • Unable to get SNTP async events when Coex mode and power save are enabled 

Throughputs & Performance

  • Wi-Fi alone throughput is about SDK 3.x (42Mbps). SDK refinements are in progress to further improve Wi-Fi Standalone and Coex Throughputs. 

Secure Over the Air (OTA) Upgrade

  • Observed firmware upgrade failures after multiple iterations.
  • Observed OTA failures with powersave enable, So recommended to disable powersave during OTA. 
  • Observed "0xffffffff" error at the remote end while doing firmware upgrade via TCP server using (featured) example with ubuntu 21.0x. 

Wi-Fi IOT Cloud integration (AWS IOT Core)

  • Observed AWS MQTT keepalive transmission is not happening at expected intervals with power save enabled.

Wi-Fi Interoperability (IOP)

  • Observed disconnections with Amplifi (AFI-INS-R) AP with powersave enable
  • TWT session is failing due to disconnections observed in DUT if rx_latency is set to 55 seconds and receive data is also set to 55 seconds on MI Xiaomi RA72 and Tplink AX53 AP's
  • Observed less throughput(~1Mb) while running TCP RX with Max_PSP powersave with DLink 810 AP
  • Observed interop issue (random disconnections) with few APs (EERO 6+, EERO PRO 6E, Cisco Catalyst 9120AXID)
  • Disconnections observed with Netgear RAX120 AP in WPA3 Security

BLE

GAP 

  • BLE reconnection is not working in ble_multiconnection_gatt demo when power save is enabled in SoC. 
  • When power save is enabled in the SoC, the DUT hangs with the ble_multiconnection_gatt demo while performing continuous Tx/Rx notifications.
  • BLE start advertising API failed with an error code 0xffffffe2(RSI_ERROR_RESPONSE_TIMEOUT) within 5minutes while executing ble start ,stop and clear the address resolution API's are called in a loop continuously.

DTM/PER

  • Recommend to limit BLE Tx Maximum power to 18 dBm.  Please don't use for 127 power_index for BLE HP chain with this release.

IOP

  • BLE connection failure has been observed on a few mobile devices (Samsung S23& Oneplus 9pro) when the Si917 device is configured as central.
  • Hang issue is observed when DUT is trying to connect to nRF dongle with I/O capability set to 0.

Multi-protocol

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test. 
  • Observed Wi-Fi + BLE intermittent connection failures, disconnections, and data transfer stalls in the long run when power save is enabled.
  • Observed "DUT is not disconnecting to the AP when initiating disconnection from EFR connect app screen using wifi_station_ble_provisioning_aws example

System

  • Observed random hang issues with encrypted firmwares on some earlier variant of boards  (Si917-6031A, Si917-4338A) with powersave enable.

Simplicity Studio and Commander 

  • Simplicity commander does not support options under "Debug Lock tools".
  • All projects in the package are compatible with GNU ARM V12.2.1 toolchain

Planned Roadmap Features

SDK

  • WPS 2.0 PIN/PUSH, Network Manager Enhancements
  • MDNS, HTTP Server, Azure MQTT Client, Websockets
  • Matter integration with Embedded TCP/IP stack 
  • Enhanced buffer management, Throughput optimization
  • TLS over LWIP, Network layer applications (MQTT, HTTP, etc.) over LWIP.
  • Debugging utilities, UC Configurator for Wireless configurations

System

  • Secure communication over CPC (UART & SDIO interfaces)

MCU

  • Pin Tool for MCU 
  • Dual Flash: Separate flash for Cortex M4 and Wireless Processor
  • Peripherals: Capacitive Touch Sensor, OPAMP, HSPI, GPDMA, QEI, RNG, IR decoder, CRC and BOD
  • Software-configurable MCU application memory options (192 or 256 or 320 kB)
  • RTOS support for MCU Peripheral examples
  • SensorHub: Support for SDC_ADC and CLOUD connectivity
  • SIO support for features Pattern matching, DMA flow control, self-loop mechanism and as a clock qualifier
  • Support for I2S PCM functionality
  • Stacked and external PSRAM: Pseudo Static RAM for storing application data and executing SoC applications. 

Wi-Fi/Network Stack

  • Spatial Re-Use, BSS Max Idle
  • Provisioning using Wi-Fi AP

BLE

  • Support for 8 Peripheral + 2 Central connections 
  • Support for BLE Mesh (4 nodes only) for limited Mesh use case

Limitations and Unsupported Features  

System

  • None

SDK

  • Baremetal mode is not supported.
  • WiSeConnect3_SDK_3.1.3 and later versions are not compatible with firmware versions prior to 1711.2.10.1.2.0.4, due to enhancements in max transmit power configuration during Wi-Fi join/connection, need to be cautious while doing OTA firmware upgrade.

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported.
  • 40 MHz bandwidth for 2.4 GHz band and 5 GHz is not supported.
  • Max 3 SSL sockets in Wi-Fi only mode, 2 SSL Socket in Wi-Fi + BLE based on RAM memory configuration selected. 
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • The number of Non-Transmitting BSSIDs processed is limited by the beacon length that can be processed by the stack (which is 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • Multiprotocol (STA +BLE) + EAP Security modes supported only with Memory configurations EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K.
  • UL MUMIMO is not supported.
  • WPA3 AP supports only H2E algorithm.
  • PMKSA caching is not supported in WPA3 AP mode.
  • Maximum embedded MQTT Publish payload is 1 kbyte.
  • Timeout value for socket select and socket receive calls of less than 1 second is not currently supported.
  • SA query procedure not supported in 11W AP mode.
  • WPA3 AP transition mode is not supported.

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections (1 Central and 1 Peripheral) with AE.
  • Advertising Extension feature is not supported in Coexistence.
  • The  ae_central & ae_peripheral applications are not supported with TA_352K_M4_320K RAM configuration.
  • Two BLE connections are not supported with M4 powersave. It only supports a single connection. 
  • Isochronous channels feature is not supported. 
  • Connection subrating feature is not supported. 
  • LE power controller feature is not supported.
  • EATT feature is not supported.
  • Periodic Advertising with a response feature is not supported. 
  • BLE Audio is not supported.
  • The feature of dynamically changing the TX power when extended advertising is active is not supported.

MCU

  • SensorHub supports PS1-power state with ADC sensor. In this mode, other sensors operation is not supported. 

Multi-protocol

  • Wi-Fi AP + BLE currently not supported. 
  • EXT_FEAT_416K_M4SS_256K is the minimum RAM configuration to support coex mode with SSL

WiSeConnect3_SDK_3.1.2 SoC Release Notes

Release Details

Item Details
Release date Jan 17th, 2024
SDK Version 3.1.2
Firmware Version 1711.2.10.1.1.0.2
Release Package Name WiSeConnect3_SDK_3.1.2
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
  • SiWx917 release consists of two components:
    • Wireless Firmware - SiWx917 Firmware Binary available as SiWG917-B.2.10.1.1.0.2.rps
    • Wiseconnect3 Library - Wiseconnect3 SDK library runs on internal Cortex M4

NOTE: Mandatory to upgrade the earlier version of boards (Si917-6031A Prokit or 4338A boards) or 917 Silicon ICs with instructions as outlined in this document "SiWG917–TA_Flash_Memory_Map_ChangeGuide_v1.3.pdf" for more details.  

Supported Hardware

Hardware OPN
Silicon (IC OPN) SiWG917M111MGTBA
Development Kits

Pro Kit: SiWx917-PK6031A, Si917-PK6031A.

(Pro Kit includes Mother board "SI-MB4002A" + Radio board)

Radio boards: SiWx917-RB4338A, Si917-RB4338A

Supported Features 

System

  • Operating Modes 
    • Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Security 
    • Secure Boot, Secure Key storage and HW device identity with PUF, Secure Zone, Secure XIP (Execution in place) from flash, Secure Attestation, Anti Rollback, Secure Debug. Flash Protection. 
    • Secure firmware upgrade options:
      • Firmware loading support by Commander Tool through Jlink Debugger. Jlink connected to Serial Wire Debug (SWD) 
      • Firmware loading via ISP using UART (Commander or Serial terminal), SPI Interface
      • Secure Over the Air (OTA) Upgrade
  • Crypto Support
    •  Crypto API's for Hardware Accelerators:
      • Advanced Encryption Standard (AES) 128/256/192, Secure Hash Algorithm (SHA) 256/384/512, Hash Message Authentication Code (HMAC), Random Number Generator (RNG), SHA3, AES-Galois Counter Mode (GCM)/ Cipher based Message Authentication Code (CMAC), ChaCha-poly, True Random Number Generator (TRNG)
    • Software Accelerators: RSA, ECC 
    • Integrated with mbed TLS.
    • TRNG, AES, SHA, HMAC, GCM, Chacha-poly, ECDH and AES-CCM hardware crypto engine is integrated with PSA crypto.
  • System Power Save
    • Deep Sleep with RAM retention and without RAM retention. 
    • Wireless Power Save: Connected Sleep (Wi-Fi Standby Associated), BLE Advertising with powersave, BLE Scan with powersave ,  BLE connection with powersave. Only Max PSP power save mode is supported in BLE. 

MCU

  • Memory
    • Common Flash: Single shared Flash for both Cortex-M4 and NWP (Wireless Processor)
  • Power States
    • Active: PS4, PS3, PS2, and PS1 
    • Standby: PS4, PS3, and PS2
    • Sleep: PS4, PS3 and PS2
    • Deep Sleep(Shutdown): PS0
  • Peripherals
    • High Performance (HP)- ADC, CALENDAR, CONFIG TIMER(CT), EFUSE, EGPIO, GSPI, I2C, I2S, MCPWM, SDIO Secondary, SIO, SSI, SYSRTC, UART, uDMA, USART, WDT** 
    • Ultra Low Power (ULP) - ULP_TIMER, ULP_UART, ULP_I2C, ULP_I2S, ULP_uDMA and ULP_SSI
  • Services
    • Sleep Timer, IOSTREAM, Power Manager, SensorHub, NVM3
  • Development Pro-Kit Peripheral Support
    • LED, Button, MEMLCD, Joystick, RHT Sensor

Development Environment

  • Simplicity Studio IDE (SV5.8.0 version) and Debugger Integration.   Refer to the latest version of the SoC "Getting-Started-with-SiWx917" guide for more details. 
  • Simplicity Commander to supports Flash loading, provision of MBR programming, security key management, and calibration support for crystal and gain offsets. refer "siwx917-soc-manufacturing-utility-user-guide" for more details.** 
  • Advanced Energy Monitoring (AEM) to measure ultra-low power capability on Development boards (Pro Kit).

Wi-Fi

  • Wi-Fi Protocols
    • IEEE 802.11 b/g/n/ax (2.4GHz)
  • Access Point (AP) Mode
    • 4 Client Support, Hidden SSID Mode, Auto Channel Selection, Scan in AP mode
    • Wi-Fi Security  
      • WPA2 Personal, WPA3 Personal (H2E method only), WPA Mixed mode (WPA/WPA2) 
  • Wi-Fi Scan
    • Selective Scan, Active/Passive Scan
  • Wi-Fi STA (Security Modes)
    • Open Mode, WPA2 Personal, WPA2 Enhancements, WPA3 Personal, Mixed Mode (WPA/WPA2), WPA3 Personal Transition Mode (WPA2/WPA3)
  • WPA2 Enterprise security (STA)
    • Method
      • PEAP/TTLS/TLS 1.0/TLS 1.2/FAST
  • Wi-Fi STA Rejoin
  • Wi-Fi STA Roaming
    • BG Scan, OKC (Opportunistic Key caching), PMK (Pairwise Master Key) caching, Pre-Authentication
  • Wi-Fi Protocol Power Save 
    • Deep sleep (unconnected state), Max PSP, Enhanced Max PSP, Fast PSP,** TWT
  • QoS
    • WMM-QoS
  • Wi-Fi 6 Feature
    • MUMIMO (DL), OFDMA (UL/DL), iTWT, TWT I-Frame & TWT Enhancements, BSS coloring, MBSSID
  • Wi-Fi Concurrency 
    • AP+STA (Same channel)
  • Wi-Fi Band/Channels
    • 2.4GHz CH1-11, 2.4GHz CH1-13, 2.4GHz CH1-14 (Japan)
  • Known Security Vulnerabilities Handled
    • WPA2 KRACK Attacks, Fragment and Forge Vulnerability

Network Stack

  • Core Networking Features
    • TCP/IP Bypass (LWIP as Hosted stack for reference), IPv4/IPv6/UDP/TCP/ARP/ICMP/ICMPv6
    • SSL client versions TLSV1.0, TLSV1.2, TLSV1.3 
    • SSL server versions TLSV1.0 and TLSV1.2
    • DHCP (Client/Server)/ DHCPv6 Client
  • Advanced Network Features
    • HTTP Client/HTTPS Client//DNS Client/SNTP Client, Embedded MQTT/MQTT on host
  • Wi-Fi IoT Cloud Integration
    • AWS IOT Core
  • BSD and IoT sockets application programming interface(API)

BLE 

  • GAP(Advertising, Scanning, initiation, Connection and Bonding)
  • Generic Attribute Protocol(GATT)
  • Attribute protocol(ATT)
  • Security
  • LL Privacy 1.2
  • Accept list
  • Directed Advertising
  • Extended Advertising
  • Periodic Advertising
  • Periodic Advertising scanning
  • Extended Advertising scanning
  • Periodic Advertising list
  • LE periodic advertising synchronization
  • LE PHY(1Mbps, 2Mbps) & Coded PHY(125Kbps, 500kbps)
  • Simultaneous scanning on 1Mbps and Coded PHY
  • LE dual role topology
  • LE data packet length extensions(DLE)
  • Asymmetric PHYs
  • LE channel selection algorithm 2 (CSA#2)
  • LE Secure connections
  • Bluetooth 5.4 Qualified

SDK

  • Simplified and Unified DX for Wi-Fi API and Platform APIs
  • Simplifies application development and presents clean and standardized APIs
  • UC (Universal Configurator) enables componentization, simplifying configuration of peripherals and examples
  • BSD and ARM IoT-compliant socket API
  • Available through Simplicity Studio and GitHub

Multi-protocol

  • Wi-Fi STA + BLE

PTA/Coexistence

  • 3 wire coex acting as Wi-Fi with external Bluetooth
  • 3 wire coex acting as Wi-Fi with external Zigbee/OT

Changes in this release compared to v3.1.1-Doc Release

System

None

MCU

  • Enhancements
    • Provided API for configuring ULP GPIO pin functionality on SoC GPIO pin.
  • Fixed Issues
    • Improved Joystick interface noise filtering.
    • Provided fix for SYSRTC callback unregister for Capture channel.
    • Provided resolution for SI70xx RHT sensor no_hold_read feature.
    • Provided unregister callback API in all the Peripheral deinit API.

SDK

  • Enhancements
    • Resolved warnings in the featured and snippet demos.
    • sl_wifi_get_sta_tsf() API added to get the station TSF time which is synchronized with connected AP beacon TSF.
    • Added “update gain” demo for BLE.
    • Added an option to test user gain table feature in "ble_per" demo by enabling the “GAIN_TABLE_AND_MAX_POWER_UPDATE_ENABLE” macro.
    • Removed unused input parameters in rsi_ble_set_ble_tx_power() API.
  • Fixed Issues
    • Fixed issue with BSSID based connection.
    • Fixed issue with the file descriptors set handling for socket select.
    • Fixed issue with authentication and association timeout is not reflecting as per timeout configuration using sl_si91x_configure_timeout() API
    • Fixed profile id corruption issue for IPV6 demos. 
    • Fixed application hang issue at the AE Clear Periodic Adv list API when used "ble_ae_central" example. 
    • Fixed issue where BLE connect API is failing because of 0xFFFFFFE2(RSI_ERROR_RESPONSE_TIMEOUT) error with ble_central application.
    • Fixed HID data transfer issue when power save is enabled. 

Wi-Fi/Network Stack

  • Enhancements
    • Added support for TSF time which is synchronized with connected AP beacon TSF.
    • Improve PER performance at max input power levels for 11b.
    • Improved ppm error across channels at room temperature.
    • Added Wi-Fi regulatory table for ACx.
    • Updated regulatory tables of WLAN.
  • Fixed Issues
    • Increased supported length for Embedded MQTT username up to 120 bytes and topic length up to 200 bytes.
    • Added support to process long ICMP ping response upto packet size of 1472 Bytes for IPv4 and 1452 Bytes for IPv6.
    • Issue with configuration of TCP MSS through setsockopt() has been fixed.
    • Fixed Listen interval based power save issue when IPV6 mode is enabled
    • Added fix for missing RSN IE in first few AP beacons.

BLE

  • Enhancements
    • Added Region based maximum power index support for both 0dBm & 10dDm LP chains.
  • Fixed Issues
    • Fixed regulatory output power violations with default region based settings in HP chain.
    • Fixed an issue that caused the Set local name API to fail with the error code 0x4e66[Invalid Name length] when a local name given with 16 bytes of length.

Multi-protocol

  • Enhancements
    • None
  • Fixed Issues
    • None

Recommendations

System

  • The current revision of SiWx917 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in SoC mode. 
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement. EXT_FEAT_352K_M4SS_320K is the default configuration, based on requirement EXT_FEAT_480K_M4SS_192K configuration is selected for SoC mode multi-protocol examples.
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • SoC mode should not use 672k_M4SS_0K memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.
  • There are 2 Versions of Pro-Kits/Radio boards.  Si917-6031A based on Si917-4338A and SiWx917-6031A based on SiWx917-4338A. To get optimal power numbers, enable macro "SL_SI91X_ENABLE_LOWPWR_RET_LDO" pre-processor define for ICs or while using SiWx917-6031A Pro-kit, SiWx917-4338A version of boards. This macro should be disabled for earlier variant of board (Si917-6031A, Si917-4338A).
  • With RAM configuration (EXT_FEAT_352K_M4SS_320K), only 352K memory is available to TA  which limits the features supported, Recommended to enable EXT_FEAT_416K_M4SS_256K in Wi-Fi + BLE Multi protocol mode to enable more Network features.
  • For EXT_FEAT_416K_M4SS_256K  and EXT_FEAT_480K_M4SS_192K memory configurations, it is recommended to retain both TA and M4 RAMs in power save.

Wi-Fi/Network Stack

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • For high throughput applications, aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode. 
  • To reset TA (NWP), the application needs to call sl_wifi_deinit() followed by sl_wifi_init(). Users must ensure that no execution happens from flash at this point of time. (Refer to example applications) 
  • Users can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature' bit map in opermode for (HTTPS server) supporting 16k record.
  • TWT
    • Recommendation is to use sl_wifi_target_wake_time_auto_selection() API for all TWT applications. 
    • It is recommended to issue iTWT setup command once IP assignment, TCP connection, application specific socket connections are done.
    • When using sl_wifi_enable_target_wake_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured. It's highly recommended to use sl_wifi_target_wake_time_auto_selection() as an alternative.
    • In case of TWT in coex mode, when using sl_wifi_enable_target_wake_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
    • For iTWT GTK interval in AP should be configured to max possible value or zero. If GTK interval is not configurable on AP side, recommended TWT interval (in case of sl_wifi_enable_target_wake_time API) or RX Latency (in case of sl_wifi_target_wake_time_auto_selection API) is less than 4sec.
    • When sl_wifi_enable_target_wake_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wake interval of less than or equal to 1 min.
    • When using sl_wifi_enable_target_wake_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Disable power save for high throughput applications or use FAST PSP power save mode as per application requirement.
  • The application needs to ensure that it sets RTC with the correct timestamp before establishing the SSL/EAP connection.
  • The minimum timeout value should not be less than 1 second for socket select and socket receive calls. 
  • Embedded MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • Disable power save and suspend any active TWT sessions before triggering HTTP OTAF.
  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.

BLE

  • In BLE, the recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

Multi-protocol

  • 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.

Known Issues of WiSeConnect3_SDK_3.1.2 Release

MCU

SensorHub

  • SensorHub does not support, SPI-based sensors and ADC multi-channel. 

SSI

  • SSI Dual and Quad mode are not functional. 
  • SSI primary: mode3(TI) is not working as expected. 
  • SSI Primary will not be operable at 40 MHz 

I2C

  • I2C High speed and Fastplus modes are not working at specification speed

UART

  • Flow control is not supported in USART and IOSTREAM applications

ADC

  • In ADC Multichannel, sampling rate is limited to less than 15Ksps. Number of samples is less than 500 and with a maximum of 4 channel
  • In ADC Multichannel, when using different sampling rates for different channels behavior is not as expected

CT (Config Timer)

  • Config Timer(CT) support as an external event, in 32-bit mode, and DMA are not working as expected

PWM

  • PWM Special event trigger for synchronizing analog-to-digital conversions is not working

SYSRTC

  • SYSRTC with RO clock is not functioning

Power Manager

  • The wakeup sources ULP-SSI, BOD, Comparator, and SysRTC are not working in the Power Manager service

SDK

  • Observed Wi-Fi connection is successful even after deleting the stored network credentials using sl_net_delete_credential and responding with SL_NET_INVALID_CREDENTIAL_TYPE for sl_net_get_credential.
  • Observed sl_net_deinit is not returning any response for both "SL_NET_WIFI_AP_INTERFACE" and "SL_NET_WIFI_CLIENT_INTERFACE" interfaces, which requires to execute deinit code path to RAM in case of common flash.
  • Enhanced sl_wifi_get_firmware_version() API to provide more details (ROM ID, chip ID, security version, etc) which is not backward compatible with firmwares older than 1711.2.10.1.0.0.4. Firmware binary notation does not include security version number.
  • Matter applications are experiencing compatibility issues with WiseConnect SDK 3.1.2. It is recommended to use WiseConnect SDK 3.1.1 for matter-related applications. This will be addressed in up coming release(s).

Wi-Fi/Network Stack

Wi-Fi STA

  • STA Connection with the WPA3 Hunting and Pecking algorithm takes about 3-4 seconds.
  • Observed connection failures with some AP's in more channel congestion ~50-60% occupancy open lab environment.
  • Region selection based on country IE in the beacon is not supported
  • Observed intermittent beacon reception from Access Point ( beacon misses) in an extremely congested environment
  • Note section in API documentation for sl_wifi_get_sta_tsf  needs to be corrected to "Returns error if station is not connected or at least one beacon is not received."

Access Point (AP) Mode

  • Scan feature in AP mode not fully functional. 
  • Fixed rate configuration in AP mode using sl_wifi_set_transmit_rate API is not being set as expected. 

WPA2 Enterprise security (STA)

  • Observed connection issue with configuring certificate key and programming 4096 bit key and SHA384/SHA512 certificates.
  • Observing DUT is throwing 0x1001c when configuring .data.certificate_key as "123456789".
  • Configuration issue to program PAC file for EAP FAST Manual mode.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

Wi-Fi Concurrency (AP + STA in same channel)

  • Observed 3rd party STA association fail with 917 AP while 917 STA mode is connecting/reconnecting to configured 3rd party AP. Reconnect 3rd party STA to 917 AP in such scenarios. 

OFDMA (UL/DL)

  • Less throughput observed in DL-OFDMA with some APs that enabled LDPC.

MUMIMO (DL)

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test. 
  • Observed Performance, Interop issues with MU MIMO with certain APs. 
  • Less throughput observed in MU-MIMO with some APs that enabled LDPC.

TWT

  • Variability with MQTT keep alive interval based on TWT wake up interval.  
  • When sl_wifi_enable_target_wake_time() API is used, occasional MQTT disconnections may be observed if TWT is configured with longer TWT intervals (>30secs) with embedded MQTT + TWT.  As an alternative, it's highly recommended to use sl_wifi_target_wake_time_auto_selection() API, where these dependencies are internally handled.

Wi-Fi STA Rejoin

  • Observed Scanning (probe request) in all channels instead of the channels configured in selective channel(channel_bitmap_2g4) during rejoin process. 

IPv4/IPv6

  • Observed issue with assigning static IP to DUT
  • IP change notification is not indicated to the application. 

BSD Socket API

  • Configuration issue to program TCP retry count (default 10) through setsockopt
  • Every server socket created consumes a socket (maximum of 10 sockets supported) and every subsequent connection to server socket consumes an additional socket (from the same pool of 10 sockets), which limits the number of server connections supported.

SSL Client/Server

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Secure SSL renegotiation is not supported in the Embedded Networking Stack
  • Observed connection failures with ECDSA ciphers.

HTTP Client/ HTTPS Client

  • Observed occasional HTTPS continuous download failures when power save is enabled. Recommended to disable it before performing HTTPS continuous downloads
  • Observed HTTPS post data is failing with error code: BBE2 (HTTP Failed).

SNTP

  • Unable to get SNTP async events when Coex mode and power save are enabled 

Throughputs & Performance

  • Wi-Fi alone throughput is about SDK 3.x (42Mbps). SDK refinements are in progress to further improve Wi-Fi Standalone and Coex Throughputs. 

Secure Over the Air (OTA) Upgrade

  • Observed firmware upgrade failures after multiple iterations.
  • Observed OTA failures with powersave enable, So recommended to disable powersave during OTA. 
  • Observed "0xffffffff" error at the remote end while doing firmware upgrade via TCP server using (featured) example with ubuntu 21.0x. 

Wi-Fi IOT Cloud integration (AWS IOT Core)

  • Observed AWS MQTT keepalive transmission is not happening at expected intervals with power save enabled.

Wi-Fi Interoperability (IOP)

  • Observed disconnections with Amplifi (AFI-INS-R) AP with powersave enable
  • TWT session is failing due to disconnections observed in DUT if rx_latency is set to 55 seconds and receive data is also set to 55 seconds on MI Xiaomi RA72 and Tplink AX53 AP's
  • Observed less throughput(~1Mb) while running TCP RX with Max_PSP powersave with DLink 810 AP
  • Observed interop issue (random disconnections) with few APs (EERO 6+, EERO PRO 6E, Cisco Catalyst 9120AXID)
  • Disconnections observed with Netgear RAX120 AP in WPA3 Security

BLE

GAP 

  • BLE reconnection is not working in ble_multiconnection_gatt demo when power save is enabled in SoC. 
  • When power save is enabled in the SoC, the DUT hangs with the ble_multiconnection_gatt demo while performing continuous Tx/Rx notifications.

DTM/PER

  • Recommend to limit BLE Tx Maximum power to 18 dBm.  Please don't use for 127 power_index for BLE HP chain with this release.

IOP

  • BLE connection failure has been observed on a few mobile devices (Samsung S23& Oneplus 9pro) when the Si917 device is configured as central.

Multi-protocol

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test. 
  • Observed Wi-Fi + BLE intermittent connection failures, disconnections, and data transfer stalls in the long run when power save is enabled.
  • Observed "DUT is not disconnecting to the AP when initiating disconnection from EFR connect app screen using wifi_station_ble_provisioning_aws example

System

  • Observed random hang issues with encrypted firmwares on some earlier variant of boards  (Si917-6031A, Si917-4338A) with powersave enable.

Simplicity Studio and Commander 

  • Simplicity commander does not support options under "Debug Lock tools".
  • All projects in the package are compatible with GNU ARM V12.2.1 toolchain

Planned Roadmap Features

SDK

  • WPS 2.0 PIN/PUSH, Network Manager Enhancements
  • MDNS, HTTP Server, Azure MQTT Client, Websockets
  • Matter integration with Embedded TCP/IP stack 
  • Enhanced buffer management, Throughput optimization
  • TLS over LWIP, Network layer applications (MQTT, HTTP, etc.) over LWIP.
  • Debugging utilities, UC Configurator for Wireless configurations

System

  • Secure communication over CPC (UART & SDIO interfaces)

MCU

  • Pin Tool for MCU 
  • Dual Flash: Separate flash for Cortex M4 and Wireless Processor
  • Peripherals: Analog Comparator, DAC, Temp Sensor, Capacitive Touch Sensor, OPAMP, HSPI, GPDMA, QEI, RNG, IR decoder, CRC and BOD
  • Software-configurable MCU application memory options (192 or 256 or 320 kB)
  • RTOS support for MCU Peripheral examples
  • SensorHub: Support for SDC_ADC and CLOUD connectivity
  • SIO support for features Pattern matching, DMA flow control, self-loop mechanism and as a clock qualifier
  • Support for I2S PCM functionality
  • Stacked and external PSRAM: Pseudo Static RAM for storing application data and executing SoC applications. 

Wi-Fi/Network Stack

  • Spatial Re-Use, BSS Max Idle
  • Provisioning using Wi-Fi AP

BLE

  • Support for 8 Peripheral + 2 Central connections 
  • Support for BLE Mesh (4 nodes only) for limited Mesh use case

Limitations and Unsupported Features  

System

  • None

SDK

  • Baremetal mode is not supported.

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported.
  • 40 MHz bandwidth for 2.4 GHz band is not supported.
  • Max 3 SSL sockets in Wi-Fi only mode, 2 SSL Socket in Wi-Fi + BLE based on RAM memory configuration selected. 
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • The number of Non-Transmitting BSSIDs processed is limited by the beacon length that can be processed by the stack (which is 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • Multiprotocol (STA +BLE) + EAP Security modes supported only with Memory configurations EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K.
  • UL MUMIMO is not supported.
  • WPA3 AP supports only H2E algorithm.
  • PMKSA caching is not supported in WPA3 AP mode.
  • Maximum embedded MQTT Publish payload is 1 kbyte.
  • Timeout value for socket select and socket receive calls of less than 1 second is not currently supported.

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections (1 Central and 1 Peripheral) with AE.
  • Advertising Extension feature is not supported in Coexistence.
  • The  ae_central & ae_peripheral applications are not supported with TA_352K_M4_320K RAM configuration.
  • Two BLE connections are not supported with M4 powersave. It only supports a single connection. 
  • Isochronous channels feature is not supported. 
  • Connection subrating feature is not supported. 
  • LE power controller feature is not supported.
  • EATT feature is not supported.
  • Periodic Advertising with a response feature is not supported. 
  • BLE Audio is not supported.
  • The feature of dynamically changing the TX power when extended advertising is active is not supported.

MCU

  • SensorHub supports PS1-power state with ADC sensor. In this mode, other sensors operation is not supported. 

Multi-protocol

  • Wi-Fi AP + BLE currently not supported. 

WiSeConnect3_SDK_3.1.1-Hotfix SoC Release Notes

Release Details

Item Details
Release date Jan 2nd, 2024
SDK Version 3.1.1-Hotfix
Firmware Version 1711.2.10.1.0.0.7
Release Package Name WiSeConnect3_SDK_3.1.1-Hotfix
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
  • SiWx917 release consists of two components:
    • Wireless Firmware - SiWx917 Firmware Binary available as SiWG917-B.2.10.1.0.0.x.rps
    • Wiseconnect3 Library - Wiseconnect3 SDK library runs on internal Cortex M4

NOTE: Mandatory to upgrade the earlier version of boards (Si917-6031A Prokit or 4338A boards) or 917 Silicon ICs with instructions as outlined in this document "SiWG917–TA_Flash_Memory_Map_Change_Guide_v1.3.pdf" for more details.  

Supported Hardware

Hardware OPN
Silicon (IC OPN) SiWG917M111MGTBAR
Development Kits

Pro Kit: SiWx917-PK6031A, Si917-PK6031A.

(Pro Kit includes Mother board "SI-MB4002A" + Radio board)

Radio boards: SiWx917-RB4338A, Si917-RB4338A

Supported Features 

System

  • Operating Modes 
    • Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Security 
    • Secure Boot, Secure Key storage and HW device identity with PUF, Secure Zone, Secure XIP (Execution in place) from flash, Secure Attestation, Anti Rollback, Secure Debug. Flash Protection. 
    • Secure firmware upgrade options:
      • Firmware loading support by Commander Tool through Jlink Debugger. Jlink connected to Serial Wire Debug (SWD) 
      • Firmware loading via ISP using UART (Commander or Serial terminal), SPI Interface
      • Secure Over the Air (OTA) Upgrade
  • Crypto Support
    • Crypto API's for Hardware Accelerators:
      • Advanced Encryption Standard (AES) 128/256/192, Secure Hash Algorithm (SHA) 256/384/512, Hash Message Authentication Code (HMAC), Random Number Generator (RNG), SHA3, AES-Galois Counter Mode (GCM)/ Cipher based Message Authentication Code (CMAC), ChaCha-poly, True Random Number Generator (TRNG)
    • Software Accelerators: RSA, ECC 
    • Integrated with mbed TLS.
    • TRNG, AES, SHA, HMAC, GCM, Chacha-poly, ECDH and AES-CCM hardware crypto engine is integrated with PSA crypto.
  • System Power Save
    • Deep Sleep with RAM retention and without RAM retention. 
    • Wireless Power Save: Connected Sleep (Wi-Fi Standby Associated), BLE Advertising with powersave, BLE Scan with powersave ,  BLE connection with powersave. Only Max PSP power save mode is supported in BLE. 

MCU

  • Memory
    • Common Flash: Single shared Flash for both Cortex-M4 and NWP (Wireless Processor)
  • Power States
    • Active: PS4, PS3, PS2, and PS1 
    • Standby: PS4, PS3, and PS2
    • Sleep: PS4, PS3 and PS2
    • Deep Sleep(Shutdown): PS0
  • Peripherals
    • High Performance (HP)- ADC, CALENDAR, CONFIG TIMER(CT), EFUSE, EGPIO, GSPI, I2C, I2S, MCPWM, SDIO Secondary, SIO, SSI, SYSRTC, UART, uDMA, USART, WDT** 
    • Ultra Low Power (ULP) - ULP_TIMER, ULP_UART, ULP_I2C, ULP_I2S, ULP_uDMA and ULP_SSI
  • Services
    • Sleep Timer, IOSTREAM, Power Manager, SensorHub, NVM3
  • Development Pro-Kit Peripheral Support
    • LED, Button, MEMLCD, Joystick, RHT Sensor

Development Environment

  • Simplicity Studio IDE (SV5.8.0 version) and Debugger Integration.   Refer to the latest version of the SoC "Getting-Started-with-SiWx917" guide for more details. 
  • Simplicity Commander to supports Flash loading, provision of MBR programming, security key management, and calibration support for crystal and gain offsets. refer "siwx917-soc-manufacturing-utility-user-guide" for more details.** 
  • Advanced energy measurement for ultra-low power capability available on Development boards (Pro Kit)

Wi-Fi

  • Wi-Fi Protocols
    • IEEE 802.11 b/g/n/ax (2.4GHz)
  • Access Point (AP) Mode
    • 4 Client Support, Hidden SSID Mode, Auto Channel Selection, Scan in AP mode
    • Wi-Fi Security  
      • WPA2 Personal, WPA3 Personal (H2E method only), WPA Mixed mode (WPA/WPA2) 
  • Wi-Fi Scan
    • Selective Scan, Active/Passive Scan
  • Wi-Fi STA (Security Modes)
    • Open Mode, WPA2 Personal, WPA2 Enhancements, WPA3 Personal, Mixed Mode (WPA/WPA2), WPA3 Personal Transition Mode (WPA2/WPA3)
  • WPA2 Enterprise security (STA)
    • Method
      • PEAP/TTLS/TLS 1.0/TLS 1.2/FAST
  • Wi-Fi STA Rejoin
  • Wi-Fi STA Roaming
    • BG Scan, OKC (Opportunistic Key caching), PMK (Pairwise Master Key) caching, Pre-Authentication
  • Wi-Fi Protocol Power Save 
    • Deep sleep (unconnected state), Max PSP, Enhanced Max PSP, Fast PSP,** TWT
  • QoS
    • WMM-QoS
  • Wi-Fi 6 Feature
    • MUMIMO (DL), OFDMA (UL/DL), iTWT, TWT I-Frame & TWT Enhancements, BSS coloring, MBSSID
  • Wi-Fi Concurrency 
    • AP+STA (Same channel)
  • Wi-Fi Band/Channels
    • 2.4GHz CH1-11, 2.4GHz CH1-13, 2.4GHz CH1-14 (Japan)
  • Known Security Vulnerabilities Handled
    • WPA2 KRACK Attacks, Fragment and Forge Vulnerability

Network Stack

  • Core Networking Features
    • TCP/IP Bypass (LWIP as Hosted stack for reference), IPv4/IPv6/UDP/TCP/ARP/ICMP/ICMPv6
    • SSL client versions TLSV1.0, TLSV1.2, TLSV1.3 
    • SSL server versions TLSV1.0 and TLSV1.2
    • DHCP (Client/Server)/ DHCPv6 Client
  • Advanced Network Features
    • HTTP Client/HTTPS Client//DNS Client/SNTP Client, Embedded MQTT/MQTT on host
  • Wi-Fi IoT Cloud Integration
    • AWS IOT Core
  • BSD and IoT sockets application programming interface(API)

BLE 

  • GAP(Advertising, Scanning, initiation, Connection and Bonding)
  • Generic Attribute Protocol(GATT)
  • Attribute protocol(ATT)
  • Security
  • LL Privacy 1.2
  • Accept list
  • Directed Advertising
  • Extended Advertising
  • Periodic Advertising
  • Periodic Advertising scanning
  • Extended Advertising scanning
  • Periodic Advertising list
  • LE periodic advertising synchronization
  • LE PHY(1Mbps, 2Mbps) & Coded PHY(125Kbps, 500kbps)
  • Simultaneous scanning on 1Mbps and Coded PHY
  • LE dual role topology
  • LE data packet length extensions(DLE)
  • Asymmetric PHYs
  • LE channel selection algorithm 2 (CSA#2)
  • LE Secure connections
  • Bluetooth 5.4 Qualified

SDK

  • Simplified and Unified DX for Wi-Fi API and Platform APIs
  • Simplifies application development and presents clean and standardized APIs
  • UC (Universal Configurator) enables componentization, simplifying configuration of peripherals and examples
  • BSD and ARM IoT-compliant socket API
  • Available through Simplicity Studio and GitHub

Multi-protocol

  • Wi-Fi STA + BLE

PTA/Coexistence

  • 3 wire coex acting as Wi-Fi with external Bluetooth
  • 3 wire coex acting as Wi-Fi with external Zigbee/OT

Changes in this release compared to v3.1.1-Doc Release

System

  • None

MCU

  • None

SDK

  • None

Wi-Fi/Network Stack

  • Fixed Issues
    • Updated WLAN regulatory power tables.

BLE

  • Fixed Issues
    • Updated BLE regulatory power tables.

Multi-protocol

  • None

Recommendations

System

  • The current revision of SiWx917 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in SoC mode. 
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement. EXT_FEAT_352K_M4SS_320K is the default configuration, based on requirement EXT_FEAT_480K_M4SS_192K configuration is selected for SoC mode multi-protocol examples.
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • SoC mode should not use 672k_M4SS_0K memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.
  • There are 2 Versions of Pro-Kits/Radio boards.  Si917-6031A based on Si917-4338A and SiWx917-6031A based on SiWx917-4338A. To get optimal power numbers, enable macro "SL_SI91X_ENABLE_LOWPWR_RET_LDO" pre-processor define for ICs or while using SiWx917-6031A Pro-kit, SiWx917-4338A version of boards. This macro should be disabled for earlier variant of board (Si917-6031A, Si917-4338A).
  • With RAM configuration (EXT_FEAT_352K_M4SS_320K), only 352K memory is available to TA  which limits the features supported, Recommended to enable EXT_FEAT_416K_M4SS_256K in Wi-Fi + BLE Multi protocol mode to enable more Network features.
  • For EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K memory configurations, it is recommended to retain both TA and M4 RAMs in power save.

Wi-Fi/Network Stack

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • For high throughput applications, aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode. 
  • To reset TA (NWP), the application needs to call sl_wifi_deinit() followed by sl_wifi_init(). Users must ensure that no execution happens from flash at this point of time. (Refer to example applications) 
  • Users can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature' bit map in opermode for (HTTPS server) supporting 16k record.
  • TWT
    • Recommendation is to use sl_wifi_target_wake_time_auto_selection() API for all TWT applications. 
    • It is recommended to issue iTWT setup command once IP assignment, TCP connection, application specific socket connections are done.
    • When using sl_wifi_enable_target_wake_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured. It's highly recommended to use sl_wifi_target_wake_time_auto_selection() as an alternative.
    • In case of TWT in coex mode, when using sl_wifi_enable_target_wake_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
    • For iTWT GTK interval in AP should be configured to max possible value or zero. If GTK interval is not configurable on AP side, recommended TWT interval (in case of sl_wifi_enable_target_wake_time API) or RX Latency (in case of sl_wifi_target_wake_time_auto_selection API) is less than 4sec.
    • When sl_wifi_enable_target_wake_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wake interval of less than or equal to 1 min.
    • When using sl_wifi_enable_target_wake_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Disable power save for high throughput applications or use FAST PSP power save mode as per application requirement.
  • The application needs to ensure that it sets RTC with the correct timestamp before establishing the SSL/EAP connection.
  • The minimum timeout value should not be less than 1 second for socket select and socket receive calls. 
  • Embedded MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • Disable power save and suspend any active TWT sessions before triggering HTTP OTAF.
  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.

BLE

  • In BLE, the recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

Multi-protocol

  • 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.

Known Issues of WiSeConnect3_SDK_3.1.1 Release

MCU

SensorHub

  • SensorHub does not support, SPI-based sensors and ADC multi-channel. 

SSI

  • SSI Dual and Quad mode are not functional. 
  • SSI primary: mode3(TI) is not working as expected. 
  • SSI Primary will not be operable at 40 MHz. 

I2C

  • I2C High speed and Fastplus modes are not working at specification speed

NVM3

  • When installing Sleeptimer and NVM3 in Studio, is not working as expected. As a workaround these components must be added to project SLCP

UART

  • Flow control is not supported in USART and IOSTREAM applications

ADC

  • In ADC Multichannel, sampling rate is limited to less than 15Ksps. Number of samples is less than 500 and with a maximum of 4 channel
  • In ADC Multichannel, when using different sampling rates for different channels behavior is not as expected

CT (Config Timer)

  • Config Timer(CT) support as an external event, in 32-bit mode, and DMA are not working as expected

PWM

  • PWM Special event trigger for synchronizing analog-to-digital conversions is not working

SYSRTC

  • SYSRTC with RO clock is not functioning

Power Manager

  • The wakeup sources ULP-SSI, BOD, Comparator, and SysRTC are not working in the Power Manager service

SDK

  • Observed Wi-Fi connection is successful even after deleting the stored network credentials using sl_net_delete_credential and responding with SL_NET_INVALID_CREDENTIAL_TYPE for sl_net_get_credential.
  • Observed sl_net_deinit is not returning any response for both "SL_NET_WIFI_AP_INTERFACE" and "SL_NET_WIFI_CLIENT_INTERFACE" interfaces, which requires to execute deinit code path to RAM in case of common flash.
  • Observed issue when NULL is passed for readfds, writefds, excepfds to socket select. 
  • Enhanced sl_wifi_get_firmware_version() API to provide more details (ROM ID, chip ID, security version, etc) which is not backward compatible with firmwares older than 1711.2.10.1.0.0.4. Firmware binary notation does not include security version number.

Wi-Fi/Network Stack

Wi-Fi STA

  • STA Connection with the WPA3 Hunting and Pecking algorithm takes about 3-4 seconds.
  • Observed BSSID-based connection configuration is not reflecting to make a connection with specific access point.
  • Observed connection failures with some AP's in more channel congestion ~50-60% occupancy open lab environment.
  • Region selection based on country IE in the beacon is not supported
  • Observed auth/assoc timeout is not reflecting as per timeout configuration using sl_si91x_configure_timeout() API 
  • Observed intermittent beacon reception from Access Point ( beacon misses) in an extremely congested environment

Access Point (AP) Mode

  • Scan feature in AP mode not fully functional. 
  • Fixed rate configuration in AP mode using sl_wifi_set_transmit_rate API is not being set as expected. 
  • First few beacons (~ 10) don't include RSN IE

WPA2 Enterprise security (STA)

  • Observed connection issue with configuring certificate key and programming 4096 bit key and SHA384/SHA512 certificates.
  • Observing DUT is throwing 0x1001c when configuring .data.certificate_key as "123456789".
  • Configuration issue to program PAC file for EAP FAST Manual mode.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

Wi-Fi Concurrency (AP + STA in same channel)

  • Observed 3rd party STA association fail with 917 AP while 917 STA mode is connecting/reconnecting to configured 3rd party AP. Reconnect 3rd party STA to 917 AP in such scenarios. 

OFDMA (UL/DL)

  • Less throughput observed in DL-OFDMA with some APs that enabled LDPC.

MUMIMO (DL)

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test. 
  • Observed Performance, Interop issues with MU MIMO with certain APs. 
  • Less throughput observed in MU-MIMO with some APs that enabled LDPC.

TWT

  • Variability with MQTT keep alive interval based on TWT wake up interval.  
  • When sl_wifi_enable_target_wake_time() API is used, occasional MQTT disconnections may be observed if TWT is configured with longer TWT intervals (>30secs) with embedded MQTT + TWT.  As an alternative, it's highly recommended to use sl_wifi_target_wake_time_auto_selection() API, where these dependencies are internally handled.

Wi-Fi STA Rejoin

  • Observed Scanning (probe request) in all channels instead of the channels configured in selective channel(channel_bitmap_2g4) during rejoin process. 

IPv4/IPv6

  • Observed issue with assigning static IP to DUT
  • IP change notification is not indicated to the application. 
  • Observed sl_net_up returning 0x27 error code due to an issue in the handling of IPv6 address. 

BSD Socket API

  • Configuration issue to program MSS (default 1460), TCP retry count (default 10) through setsockopt
  • Every server socket created consumes a socket (maximum of 10 sockets supported) and every subsequent connection to server socket consumes an additional socket (from the same pool of 10 sockets), which limits the number of server connections supported.

SSL Client/Server

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Secure SSL renegotiation is not supported in the Embedded Networking Stack
  • Observed connection failures with ECDSA ciphers.

HTTP Client/ HTTPS Client

  • Observed occasional HTTPS continuous download failures when power save is enabled. Recommended to disable it before performing HTTPS continuous downloads
  • Observed HTTPS post data is failing with error code: BBE2 (HTTP Failed).

SNTP

  • Unable to get SNTP async events when Coex mode and power save are enabled 

Throughputs & Performance

  • Wi-Fi alone throughput is about SDK 3.x (42Mbps). SDK refinements are in progress to further improve Wi-Fi Standalone and Coex Throughputs. 

Secure Over the Air (OTA) Upgrade

  • Observed firmware upgrade failures after multiple iterations.
  • Observed OTA failures with powersave enable, So recommended to disable powersave during OTA. 
  • Observed "0xffffffff" error at the remote end while doing firmware upgrade via TCP server using (featured) example with ubuntu 21.0x. 

Wi-Fi IOT Cloud integration (AWS IOT Core)

  • Observed AWS MQTT keepalive transmission is not happening at expected intervals with power save enabled.

Wi-Fi Interoperability (IOP)

  • Observed disconnections with Amplifi (AFI-INS-R) AP with powersave enable
  • TWT session is failing due to disconnections observed in DUT if rx_latency is set to 55 seconds and receive data is also set to 55 seconds on MI Xiaomi RA72 and Tplink AX53 AP's
  • Observed less throughput(~1Mb) while running TCP RX with Max_PSP powersave with DLink 810 AP
  • Observed interop issue (random disconnections) with few APs (EERO 6+, EERO PRO 6E, Cisco Catalyst 9120AXID)
  • Disconnections observed with Netgear RAX120 AP in WPA3 Security

BLE

GATT Profile

  • HID profile data transfer is not working when power save is enabled in SoC. 

GAP 

  • BLE reconnection is not working in ble_multiconnection_gatt demo when power save is enabled in SoC. 
  • When power save is enabled in the SoC, the DUT hangs with the ble_multiconnection_gatt demo while performing continuous Tx/Rx notifications.
  • When running the ble_central application with power save enabled, it was observed that the BLE connect API is failing because of 0xFFFFFFE2(RSI_ERROR_RESPONSE_TIMEOUT) error.
  • When BLE local name is provided with a 16-byte length, the Set local name API fails with error code: 0x4e66[Invalid Name length].

Advertising Extension

  • When running the ble_ae_central example, observed an application hang issue at the AE Clear Periodic Adv list API. 

DTM/PER

  • Recommend to limit BLE Tx Maximum power to 16 dBm.  Please don't use for 127 power_index for BLE HP release with this release.

IOP

  • BLE connection failure has been observed on a few mobile devices (Samsung S23& Oneplus 9pro) when the Si917 device is configured as central.

Multi-protocol

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test. 
  • Observed Wi-Fi + BLE intermittent connection failures, disconnections, and data transfer stalls in the long run when power save is enabled.
  • Observed "DUT is not disconnecting to the AP when initiating disconnection from EFR connect app screen using wifi_station_ble_provisioning_aws example

System

  • Observed random hang issues with encrypted firmwares on some earlier variant of boards  (Si917-6031A, Si917-4338A) with powersave enable.

Simplicity Studio and Commander 

  • Simplicity commander does not support options under "Debug Lock tools".
  • All projects in the package are compatible with GNU ARM V12.2.1 toolchain

Planned Roadmap Features

SDK

  • WPS 2.0 PIN/PUSH, Network Manager Enhancements
  • MDNS, HTTP Server, Azure MQTT Client, Websockets
  • Matter integration with Embedded TCP/IP stack 
  • Enhanced buffer management, Throughput optimization
  • TLS over LWIP, Network layer applications (MQTT, HTTP, etc.) over LWIP.
  • Debugging utilities, UC Configurator for Wireless configurations

System

  • Secure communication over CPC (UART & SDIO interfaces)

MCU

  • Pin Tool for MCU 
  • Dual Flash: Separate flash for Cortex M4 and Wireless Processor
  • Peripherals: Analog Comparator, DAC, Temp Sensor, Capacitive Touch Sensor, OPAMP, HSPI, GPDMA, QEI, RNG, IR decoder, CRC and BOD
  • Software-configurable MCU application memory options (192 or 256 or 320 kB)
  • RTOS support for MCU Peripheral examples
  • SensorHub: Support for SDC_ADC and CLOUD connectivity
  • SIO support for features Pattern matching, DMA flow control, self-loop mechanism and as a clock qualifier
  • Support for I2S PCM functionality
  • Stacked and external PSRAM: Pseudo Static RAM for storing application data and executing SoC applications. 

Wi-Fi/Network Stack

  • Spatial Re-Use, BSS Max Idle
  • Provisioning using Wi-Fi AP

BLE

  • Support for 8 Peripheral + 2 Central connections 
  • Support for BLE Mesh (4 nodes only) for limited Mesh use case

Limitations and Unsupported Features  

System

  • None

SDK

  • Baremetal mode is not supported.

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported.
  • 40 MHz bandwidth for 2.4 GHz band is not supported.
  • Max 3 SSL sockets in Wi-Fi only mode, 2 SSL Socket in Wi-Fi + BLE based on RAM memory configuration selected. 
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • The number of Non-Transmitting BSSIDs processed is limited by the beacon length that can be processed by the stack (which is 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • Multiprotocol (STA +BLE) + EAP Security modes supported only with Memory configurations EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K.
  • UL MUMIMO is not supported.
  • WPA3 AP supports only H2E algorithm.
  • PMKSA caching is not supported in WPA3 AP mode.
  • Maximum embedded MQTT Publish payload is 1 kbyte.
  • Timeout value for socket select and socket receive calls of less than 1 second is not currently supported.

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections (1 Central and 1 Peripheral) with AE.
  • Advertising Extension feature is not supported in Coexistence.
  • The  ae_central & ae_peripheral applications are not supported with TA_352K_M4_320K RAM configuration.
  • Two BLE connections are not supported with M4 powersave. It only supports a single connection. 
  • Isochronous channels feature is not supported. 
  • Connection subrating feature is not supported. 
  • LE power controller feature is not supported.
  • EATT feature is not supported.
  • Periodic Advertising with a response feature is not supported. 
  • BLE Audio is not supported.
  • The feature of dynamically changing the TX power when extended advertising is active is not supported.

MCU

  • SensorHub supports PS1-power state with ADC sensor. In this mode, other sensors operation is not supported. 

Multi-protocol

  • Wi-Fi AP + BLE currently not supported. 

WiSeConnect3_SDK_3.1.1-Doc SoC Release Notes

Release Details

Item Details
Release date Dec 20th, 2023
SDK Version 3.1.1-Doc
Firmware Version 1711.2.10.1.0.0.4
Release Package Name WiSeConnect3_SDK_3.1.1-Doc
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
  • SiWx917 release consists of two components:
    • Wireless Firmware - SiWx917 Firmware Binary available as SiWG917-B.2.10.0.0.4.x.rps
    • Wiseconnect3 Library - Wiseconnect3 SDK library runs on internal Cortex M4

NOTE: Mandatory to upgrade the earlier version of boards (Si917-6031A Prokit or 4338A boards) or 917 Silicon ICs with instructions as outlined in this document "SiWG917–TA_Flash_Memory_Map_Change_Guide_v1.3.pdf" for more details.  

Supported Hardware

Hardware OPN
Silicon (IC OPN) SiWG917M111MGTBAR
Development Kits

Pro Kit: SiWx917-PK6031A, Si917-PK6031A.

(Pro Kit includes Mother board "SI-MB4002A" + Radio board)

Radio boards: SiWx917-RB4338A, Si917-RB4338A

Supported Features 

System

  • Operating Modes 
    • Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Security 
    • Secure Boot, Secure Key storage and HW device identity with PUF, Secure Zone, Secure XIP (Execution in place) from flash, Secure Attestation, Anti Rollback, Secure Debug. Flash Protection. 
    • Secure firmware upgrade options:
      • Firmware loading support by Commander Tool through Jlink Debugger. Jlink connected to Serial Wire Debug (SWD) 
      • Firmware loading via ISP using UART (Commander or Serial terminal), SPI Interface
      • Secure Over the Air (OTA) Upgrade
  • Crypto Support
    • Crypto API's for Hardware Accelerators:
      • Advanced Encryption Standard (AES) 128/256/192, Secure Hash Algorithm (SHA) 256/384/512, Hash Message Authentication Code (HMAC), Random Number Generator (RNG), SHA3, AES-Galois Counter Mode (GCM)/ Cipher based Message Authentication Code (CMAC), ChaCha-poly, True Random Number Generator (TRNG)
    • Software Accelerators: RSA, ECC 
    • Integrated with mbed TLS.
    • TRNG, AES, SHA, HMAC, GCM, Chacha-poly, ECDH and AES-CCM hardware crypto engine is integrated with PSA crypto.
  • System Power Save
    • Deep Sleep with RAM retention and without RAM retention. 
    • Wireless Power Save: Connected Sleep (Wi-Fi Standby Associated), BLE Advertising with powersave, BLE Scan with powersave ,  BLE connection with powersave. Only Max PSP power save mode is supported in BLE. 

MCU

  • Memory
    • Common Flash: Single shared Flash for both Cortex-M4 and NWP (Wireless Processor)
  • Power States
    • Active: PS4, PS3, PS2, and PS1 
    • Standby: PS4, PS3, and PS2
    • Sleep: PS4, PS3 and PS2
    • Deep Sleep(Shutdown): PS0
  • Peripherals
    • High Performance (HP)- ADC, CALENDAR, CONFIG TIMER(CT), EFUSE, EGPIO, GSPI, I2C, I2S, MCPWM, SDIO Secondary, SIO, SSI, SYSRTC, UART, uDMA, USART, WDT** 
    • Ultra Low Power (ULP) - ULP_TIMER, ULP_UART, ULP_I2C, ULP_I2S, ULP_uDMA and ULP_SSI
  • Services
    • Sleep Timer, IOSTREAM, Power Manager, SensorHub, NVM3
  • Development Pro-Kit Peripheral Support
    • LED, Button, MEMLCD, Joystick, RHT Sensor

Development Environment

  • Simplicity Studio IDE (SV5.8.0 version) and Debugger Integration.   Refer to the latest version of the SoC "Getting-Started-with-SiWx917" guide for more details. 
  • Simplicity Commander to supports Flash loading, provision of MBR programming, security key management, and calibration support for crystal and gain offsets. refer "siwx917-soc-manufacturing-utility-user-guide" for more details.** 
  • Advanced energy measurement for ultra-low power capability available on Development boards (Pro Kit)

Wi-Fi

  • Wi-Fi Protocols
    • IEEE 802.11 b/g/n/ax (2.4GHz)
  • Access Point (AP) Mode
    • 4 Client Support, Hidden SSID Mode, Auto Channel Selection, Scan in AP mode
    • Wi-Fi Security  
      • WPA2 Personal, WPA3 Personal (H2E method only), WPA Mixed mode (WPA/WPA2) 
  • Wi-Fi Scan
    • Selective Scan, Active/Passive Scan
  • Wi-Fi STA (Security Modes)
    • Open Mode, WPA2 Personal, WPA2 Enhancements, WPA3 Personal, Mixed Mode (WPA/WPA2), WPA3 Personal Transition Mode (WPA2/WPA3)
  • WPA2 Enterprise security (STA)
    • Method
      • PEAP/TTLS/TLS 1.0/TLS 1.2/FAST
  • Wi-Fi STA Rejoin
  • Wi-Fi STA Roaming
    • BG Scan, OKC (Opportunistic Key caching), PMK (Pairwise Master Key) caching, Pre-Authentication
  • Wi-Fi Protocol Power Save 
    • Deep sleep (unconnected state), Max PSP, Enhanced Max PSP, Fast PSP,** TWT
  • QoS
    • WMM-QoS
  • Wi-Fi 6 Feature
    • MUMIMO (DL), OFDMA (UL/DL), iTWT, TWT I-Frame & TWT Enhancements, BSS coloring, MBSSID
  • Wi-Fi Concurrency 
    • AP+STA (Same channel)
  • Wi-Fi Band/Channels
    • 2.4GHz CH1-11, 2.4GHz CH1-13, 2.4GHz CH1-14 (Japan)
  • Known Security Vulnerabilities Handled
    • WPA2 KRACK Attacks, Fragment and Forge Vulnerability

Network Stack

  • Core Networking Features
    • TCP/IP Bypass (LWIP as Hosted stack for reference), IPv4/IPv6/UDP/TCP/ARP/ICMP/ICMPv6
    • SSL client versions TLSV1.0, TLSV1.2, TLSV1.3 
    • SSL server versions TLSV1.0 and TLSV1.2
    • DHCP (Client/Server)/ DHCPv6 Client
  • Advanced Network Features
    • HTTP Client/HTTPS Client//DNS Client/SNTP Client, Embedded MQTT/MQTT on host
  • Wi-Fi IoT Cloud Integration
    • AWS IOT Core
  • BSD and IoT sockets application programming interface(API)

BLE 

  • GAP(Advertising, Scanning, initiation, Connection and Bonding)
  • Generic Attribute Protocol(GATT)
  • Attribute protocol(ATT)
  • Security
  • LL Privacy 1.2
  • Accept list
  • Directed Advertising
  • Extended Advertising
  • Periodic Advertising
  • Periodic Advertising scanning
  • Extended Advertising scanning
  • Periodic Advertising list
  • LE periodic advertising synchronization
  • LE PHY(1Mbps, 2Mbps) & Coded PHY(125Kbps, 500kbps)
  • Simultaneous scanning on 1Mbps and Coded PHY
  • LE dual role topology
  • LE data packet length extensions(DLE)
  • Asymmetric PHYs
  • LE channel selection algorithm 2 (CSA#2)
  • LE Secure connections
  • Bluetooth 5.4 Qualified

SDK

  • Simplified and Unified DX for Wi-Fi API and Platform APIs
  • Simplifies application development and presents clean and standardized APIs
  • UC (Universal Configurator) enables componentization, simplifying configuration of peripherals and examples
  • BSD and ARM IoT-compliant socket API
  • Available through Simplicity Studio and GitHub

Multi-protocol

  • Wi-Fi STA + BLE

PTA/Coexistence

  • 3 wire coex acting as Wi-Fi with external Bluetooth
  • 3 wire coex acting as Wi-Fi with external Zigbee/OT

Changes in this release compared to v3.1.0 Release

System

  • Moved MCU starting location to increase flash space for NWP.

NOTE: Mandatory to upgrade the earlier version of boards (Si917-6031A Prokit or 4338A boards) or 917 Silicon ICs with instructions as outlined in this document "SiWG917–TA_Flash_Memory_Map_ChangeGuide_v1.3.pdf" for more details.

MCU

  • Enhancements
    • Support for SensorHub Service
    • Support for Power Manager Service
    • Support for Joystick and RHT sensor examples
    • Support for software chip selection in SSI
    • Support for 10-bit addressing mode in I2C
    • Startup file and linker file enhancements. Realigned memory regions and updated IVT table.
    • Default interrupt priority configuration for all MCU interrupts when using RTOS
  • Fixed Issues
    • Fixed implicit placement of uDMA section in SRAM used for placing uDMA descriptors
    • Fixed NVM3 corruption issue in multi-threaded environment

SDK

  • Enhancements
    • Folder restructuring, renamed SLC features and components as part of componentization. (Refer Migration Guide)
    • Standardized build parameters, enum, structures, typedef, and API signatures. (Refer Migration Guide)
    • Added support for TA(NWP) buffer configuration in sl_wifi_init.
    • Added support for sl_wifi_device_context_t in sl_wifi_init.
    • Replaced sl_tls with sl_net credential API.
    • Updated certificate handling APIs.
    • Updated and standardized README files for featured examples, MQTT, TWT, and more.
    • Generic API reference documentation updation.
    • Removed duplicate instances of EXECUTION_FROM_RAM in examples.
    • Added readme files for ble_per and ble_accept_list.
    • Updated BLE API reference documentation with descriptions and navigation links.
    • Replaced printf statements with LOG_PRINT in all Coex example applications.
    • Removal of wifi_https_ble_dual_role and wifi_station_ble_throughput_app examples application support.

Wi-Fi/Network Stack

  • Enhancements
    • Added support for WPA3 personal security (with H2E method only) in AP mode
    • Added support for timeout configuration API 
    • Added support for Server Name Indication (SNI).
    • Added support for Extensible Authentication Protocol (EAP) encrypted certificates.
  • Fixed Issues
    • Resolved issues with CW modes in RF test example.
    • Fixed the issue where the application hangs during SHA operation on larger data exceeding 1400 bytes in TA (NWP).
    • Fixed the issue where the IOT socket connect/bind failed with -3 error in the CLI demo app.

BLE

  • Enhancements
    • Added support for BLE data transfer process when TA & M4 power save is enabled.
    • Added support for M4 sleep and wake-up for BLE alone applications.
    • Added support for standby sleep with RAM retention in Wi-Fi + BLE coex mode.
    • Removed support for unused rsi_ble_set_prop_protocol_ble_bandedge_tx_power(), rsi_bt_ber_enable_or_disable(), and rsi_bt_per_cw_mode() APIs. (Refer Migration Guide)
    • Added support for rsi_ble_prepare_write_async, rsi_ble_execute_write_async, and rsi_ble_get_inc_services in gatt_test application.
  • Fixed Issues
    • DUT transmitting 240 bytes MTU request packet regardless of programmed MTU length.
    • DUT is unable to transmit complete periodic advertising data.
    • Hang issue when transmitting BLE notification with coded PHY rates of 125kbps and 500kbps.
    • DUT not transmitting BLE scan requests after 20sec when power save is enabled.
    • DUT not transmitting packets continuously over the air in BLE test modes.
    • BLE set BD address API failing with error code 0xfffffffd (Command given in the wrong state).
    • rsi_ble_set_local_att_value() API fails with error code 0xFFFFFFE2 (RSI_ERROR_RESPONSE_TIMEOUT) during BLE notification.
    • BLE per stats cmd API fails with error code 0xFFFFFFE2 (RSI_ERROR_RESPONSE_TIMEOUT).
    • Synchronization issue in the host where the device was not able to transfer BLE notification packets when TA & M4 power save is enabled.
    • BLE scanning stops within ~4-5 minutes when power save is enabled.
    • Hang issues during multiple iterations of BLE connect and disconnect tests with TA and M4 power save enabled.

Multi-protocol

  • Enhancements
    • Increased throughputs in Wi-Fi station + BLE mode upto 30Mbps.
    • Added support for alarm-based power save mode in wlan_station_ble_provisioning_with_aws cloud example application.
    • Increased priority of Wi-Fi handling of data transmission in coex mode.
  • Fixed Issues
    • Abrupt termination of HTTP download in the application when power save is enabled.
    • Firmware update fails with 0x7 error code when power save is enabled in wifi_throughput_ble_dual_role application.
    • Handling of PLL value in coex mode.
    • BLE disconnection issue after ~25-30 min while running Wi-Fi HTTP/HTTPs download along with BLE data transfer with power save enabled.

Recommendations

System

  • The current revision of SiWx917 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in SoC mode. 
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement. EXT_FEAT_352K_M4SS_320K is the default configuration, based on requirement EXT_FEAT_480K_M4SS_192K configuration is selected for SoC mode multi-protocol examples.
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • SoC mode should not use 672k_M4SS_0K memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.
  • There are 2 Versions of Pro-Kits/Radio boards.  Si917-6031A based on Si917-4338A and SiWx917-6031A based on SiWx917-4338A. To get optimal power numbers, enable macro "SL_SI91X_ENABLE_LOWPWR_RET_LDO" pre-processor define for ICs or while using SiWx917-6031A Pro-kit, SiWx917-4338A version of boards. This macro should be disabled for earlier variant of board (Si917-6031A, Si917-4338A).
  • With RAM configuration (EXT_FEAT_352K_M4SS_320K), only 352K memory is available to TA  which limits the features supported, Recommended to enable EXT_FEAT_416K_M4SS_256K in Wi-Fi + BLE Multi protocol mode to enable more Network features.
  • For EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K memory configurations, it is recommended to retain both TA and M4 RAMs in power save.

Wi-Fi/Network Stack

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • For high throughput applications, aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode. 
  • To reset TA (NWP), the application needs to call sl_wifi_deinit() followed by sl_wifi_init(). Users must ensure that no execution happens from flash at this point of time. (Refer to example applications) 
  • Users can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature' bit map in opermode for (HTTPS server) supporting 16k record.
  • TWT
    • Recommendation is to use sl_wifi_target_wake_time_auto_selection() API for all TWT applications. 
    • It is recommended to issue iTWT setup command once IP assignment, TCP connection, application specific socket connections are done.
    • When using sl_wifi_enable_target_wake_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured. It's highly recommended to use sl_wifi_target_wake_time_auto_selection() as an alternative.
    • In case of TWT in coex mode, when using sl_wifi_enable_target_wake_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
    • For iTWT GTK interval in AP should be configured to max possible value or zero. If GTK interval is not configurable on AP side, recommended TWT interval (in case of sl_wifi_enable_target_wake_time API) or RX Latency (in case of sl_wifi_target_wake_time_auto_selection API) is less than 4sec.
    • When sl_wifi_enable_target_wake_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wake interval of less than or equal to 1 min.
    • When using sl_wifi_enable_target_wake_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Disable power save for high throughput applications or use FAST PSP power save mode as per application requirement.
  • The application needs to ensure that it sets RTC with the correct timestamp before establishing the SSL/EAP connection.
  • The minimum timeout value should not be less than 1 second for socket select and socket receive calls. 
  • Embedded MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • Disable power save and suspend any active TWT sessions before triggering HTTP OTAF.
  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.

BLE

  • In BLE, the recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

Multi-protocol

  • 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.

Known Issues of WiSeConnect3_SDK_3.1.1 Release

MCU

SensorHub

  • SensorHub does not support, SPI-based sensors and ADC multi-channel. 

SSI

  • SSI Dual and Quad mode are not functional. 
  • SSI primary: mode3(TI) is not working as expected. 
  • SSI Primary will not be operable at 40 MHz. 

I2C

  • I2C High speed and Fastplus modes are not working at specification speed

NVM3

  • When installing Sleeptimer and NVM3 in Studio, is not working as expected. As a workaround these components must be added to project SLCP

UART

  • Flow control is not supported in USART and IOSTREAM applications

ADC

  • In ADC Multichannel, sampling rate is limited to less than 15Ksps. Number of samples is less than 500 and with a maximum of 4 channel
  • In ADC Multichannel, when using different sampling rates for different channels behavior is not as expected

CT (Config Timer)

  • Config Timer(CT) support as an external event, in 32-bit mode, and DMA are not working as expected

PWM

  • PWM Special event trigger for synchronizing analog-to-digital conversions is not working

SYSRTC

  • SYSRTC with RO clock is not functioning

Power Manager

  • The wakeup sources ULP-SSI, BOD, Comparator, and SysRTC are not working in the Power Manager service

SDK

  • Observed Wi-Fi connection is successful even after deleting the stored network credentials using sl_net_delete_credential and responding with SL_NET_INVALID_CREDENTIAL_TYPE for sl_net_get_credential.
  • Observed sl_net_deinit is not returning any response for both "SL_NET_WIFI_AP_INTERFACE" and "SL_NET_WIFI_CLIENT_INTERFACE" interfaces, which requires to execute deinit code path to RAM in case of common flash.
  • Observed issue when NULL is passed for readfds, writefds, excepfds to socket select. 
  • Enhanced sl_wifi_get_firmware_version() API to provide more details (ROM ID, chip ID, security version, etc) which is not backward compatible with firmwares older than 1711.2.10.1.0.0.4. Firmware binary notation does not include security version number.

Wi-Fi/Network Stack

Wi-Fi STA

  • STA Connection with the WPA3 Hunting and Pecking algorithm takes about 3-4 seconds.
  • Observed BSSID-based connection configuration is not reflecting to make a connection with specific access point.
  • Observed connection failures with some AP's in more channel congestion ~50-60% occupancy open lab environment.
  • Region selection based on country IE in the beacon is not supported
  • Observed auth/assoc timeout is not reflecting as per timeout configuration using sl_si91x_configure_timeout() API 
  • Observed intermittent beacon reception from Access Point ( beacon misses) in an extremely congested environment

Access Point (AP) Mode

  • Scan feature in AP mode not fully functional. 
  • Fixed rate configuration in AP mode using sl_wifi_set_transmit_rate API is not being set as expected. 
  • First few beacons (~ 10) don't include RSN IE

WPA2 Enterprise security (STA)

  • Observed connection issue with configuring certificate key and programming 4096 bit key and SHA384/SHA512 certificates.
  • Observing DUT is throwing 0x1001c when configuring .data.certificate_key as "123456789".
  • Configuration issue to program PAC file for EAP FAST Manual mode.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

Wi-Fi Concurrency (AP + STA in same channel)

  • Observed 3rd party STA association fail with 917 AP while 917 STA mode is connecting/reconnecting to configured 3rd party AP. Reconnect 3rd party STA to 917 AP in such scenarios. 

OFDMA (UL/DL)

  • Less throughput observed in DL-OFDMA with some APs that enabled LDPC.

MUMIMO (DL)

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test. 
  • Observed Performance, Interop issues with MU MIMO with certain APs. 
  • Less throughput observed in MU-MIMO with some APs that enabled LDPC.

TWT

  • Variability with MQTT keep alive interval based on TWT wake up interval.  
  • When sl_wifi_enable_target_wake_time() API is used, occasional MQTT disconnections may be observed if TWT is configured with longer TWT intervals (>30secs) with embedded MQTT + TWT.  As an alternative, it's highly recommended to use sl_wifi_target_wake_time_auto_selection() API, where these dependencies are internally handled.

Wi-Fi STA Rejoin

  • Observed Scanning (probe request) in all channels instead of the channels configured in selective channel(channel_bitmap_2g4) during rejoin process. 

IPv4/IPv6

  • Observed issue with assigning static IP to DUT
  • IP change notification is not indicated to the application. 
  • Observed sl_net_up returning 0x27 error code due to an issue in the handling of IPv6 address. 

BSD Socket API

  • Configuration issue to program MSS (default 1460), TCP retry count (default 10) through setsockopt
  • Every server socket created consumes a socket (maximum of 10 sockets supported) and every subsequent connection to server socket consumes an additional socket (from the same pool of 10 sockets), which limits the number of server connections supported.

SSL Client/Server

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Secure SSL renegotiation is not supported in the Embedded Networking Stack
  • Observed connection failures with ECDSA ciphers.

HTTP Client/ HTTPS Client

  • Observed occasional HTTPS continuous download failures when power save is enabled. Recommended to disable it before performing HTTPS continuous downloads
  • Observed HTTPS post data is failing with error code: BBE2 (HTTP Failed).

SNTP

  • Unable to get SNTP async events when Coex mode and power save are enabled 

Throughputs & Performance

  • Wi-Fi alone throughput is about SDK 3.x (42Mbps). SDK refinements are in progress to further improve Wi-Fi Standalone and Coex Throughputs. 

Secure Over the Air (OTA) Upgrade

  • Observed firmware upgrade failures after multiple iterations.
  • Observed OTA failures with powersave enable, So recommended to disable powersave during OTA. 
  • Observed "0xffffffff" error at the remote end while doing firmware upgrade via TCP server using (featured) example with ubuntu 21.0x. 

Wi-Fi IOT Cloud integration (AWS IOT Core)

  • Observed AWS MQTT keepalive transmission is not happening at expected intervals with power save enabled.

Wi-Fi Interoperability (IOP)

  • Observed disconnections with Amplifi (AFI-INS-R) AP with powersave enable
  • TWT session is failing due to disconnections observed in DUT if rx_latency is set to 55 seconds and receive data is also set to 55 seconds on MI Xiaomi RA72 and Tplink AX53 AP's
  • Observed less throughput(~1Mb) while running TCP RX with Max_PSP powersave with DLink 810 AP
  • Observed interop issue (random disconnections) with few APs (EERO 6+, EERO PRO 6E, Cisco Catalyst 9120AXID)
  • Disconnections observed with Netgear RAX120 AP in WPA3 Security

BLE

GATT Profile

  • HID profile data transfer is not working when power save is enabled in SoC. 

GAP 

  • BLE reconnection is not working in ble_multiconnection_gatt demo when power save is enabled in SoC. 
  • When power save is enabled in the SoC, the DUT hangs with the ble_multiconnection_gatt demo while performing continuous Tx/Rx notifications.
  • When running the ble_central application with power save enabled, it was observed that the BLE connect API is failing because of 0xFFFFFFE2(RSI_ERROR_RESPONSE_TIMEOUT) error.
  • When BLE local name is provided with a 16-byte length, the Set local name API fails with error code: 0x4e66[Invalid Name length].

Advertising Extension

  • When running the ble_ae_central example, observed an application hang issue at the AE Clear Periodic Adv list API. 

DTM/PER

  • Recommend to limit BLE Tx Maximum power to 16 dBm.  Please don't use for 127 power_index for BLE HP release with this release.

IOP

  • BLE connection failure has been observed on a few mobile devices (Samsung S23& Oneplus 9pro) when the Si917 device is configured as central.

Multi-protocol

  • For Coex Scenario Wi-Fi + BLE, BLE Data transfer, MU retries (~50-60%) observed while running DL MU-MIMO test. 
  • Observed Wi-Fi + BLE intermittent connection failures, disconnections, and data transfer stalls in the long run when power save is enabled.
  • Observed "DUT is not disconnecting to the AP when initiating disconnection from EFR connect app screen using wifi_station_ble_provisioning_aws example

System

  • Observed random hang issues with encrypted firmwares on some earlier variant of boards  (Si917-6031A, Si917-4338A) with powersave enable.

Simplicity Studio and Commander 

  • Simplicity commander does not support options under "Debug Lock tools".
  • All projects in the package are compatible with GNU ARM V12.2.1 toolchain

Planned Roadmap Features

SDK

  • WPS 2.0 PIN/PUSH, Network Manager Enhancements
  • MDNS, HTTP Server, Azure MQTT Client, Websockets
  • Matter integration with Embedded TCP/IP stack 
  • Enhanced buffer management, Throughput optimization
  • TLS over LWIP, Network layer applications (MQTT, HTTP, etc.) over LWIP.
  • Debugging utilities, UC Configurator for Wireless configurations

System

  • Secure communication over CPC (UART & SDIO interfaces)

MCU

  • Pin Tool for MCU 
  • Dual Flash: Separate flash for Cortex M4 and Wireless Processor
  • Peripherals: Analog Comparator, DAC, Temp Sensor, Capacitive Touch Sensor, OPAMP, HSPI, GPDMA, QEI, RNG, IR decoder, CRC and BOD
  • Software-configurable MCU application memory options (192 or 256 or 320 kB)
  • RTOS support for MCU Peripheral examples
  • SensorHub: Support for SDC_ADC and CLOUD connectivity
  • SIO support for features Pattern matching, DMA flow control, self-loop mechanism and as a clock qualifier
  • Support for I2S PCM functionality
  • Stacked and external PSRAM: Pseudo Static RAM for storing application data and executing SoC applications. 

Wi-Fi/Network Stack

  • Spatial Re-Use, BSS Max Idle
  • Provisioning using Wi-Fi AP

BLE

  • Support for 8 Peripheral + 2 Central connections 
  • Support for BLE Mesh (4 nodes only) for limited Mesh use case

Limitations and Unsupported Features  

System

  • None

SDK

  • Baremetal mode is not supported.

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported.
  • 40 MHz bandwidth for 2.4 GHz band is not supported.
  • Max 3 SSL sockets in Wi-Fi only mode, 2 SSL Socket in Wi-Fi + BLE based on RAM memory configuration selected. 
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • The number of Non-Transmitting BSSIDs processed is limited by the beacon length that can be processed by the stack (which is 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • Multiprotocol (STA +BLE) + EAP Security modes supported only with Memory configurations EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K.
  • UL MUMIMO is not supported.
  • WPA3 AP supports only H2E algorithm.
  • PMKSA caching is not supported in WPA3 AP mode.
  • Maximum embedded MQTT Publish payload is 1 kbyte.
  • Timeout value for socket select and socket receive calls of less than 1 second is not currently supported.

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections (1 Central and 1 Peripheral) with AE.
  • Advertising Extension feature is not supported in Coexistence.
  • The  ae_central & ae_peripheral applications are not supported with TA_352K_M4_320K RAM configuration.
  • Two BLE connections are not supported with M4 powersave. It only supports a single connection. 
  • Isochronous channels feature is not supported. 
  • Connection subrating feature is not supported. 
  • LE power controller feature is not supported.
  • EATT feature is not supported.
  • Periodic Advertising with a response feature is not supported. 
  • BLE Audio is not supported.
  • The feature of dynamically changing the TX power when extended advertising is active is not supported.

MCU

  • SensorHub supports PS1-power state with ADC sensor. In this mode, other sensors operation is not supported. 

Multi-protocol

  • Wi-Fi AP + BLE currently not supported. 

WiSeConnect3_SDK_3.1.1 SoC Release Notes

Release Details

Item

Details

Release date Dec 13th, 2023
SDK Version 3.1.1
Firmware Version 1711.2.10.0.0.4
Package Name WiSeConnect3_SDK_3.1.1
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
Build Quality GA
  • SiWx917 release consists of two components
    • Wireless Firmware - SiWx917 Firmware Binaries
    • Wiseconnect3 Library - Wiseconnect3 SDK library runs on internal Cortex M4
  • This release is meant only for use with designs based on SiWx917 Silicon
  • The firmware to load in your design are available in the following format:
    • SiWG917-B.2.10.0.0.4.x.rps -  Sutlej B0 Full-featured firmware binary

Supported Setups

  • BRD4002A Wireless pro kit mainboard SI-MB4002A
  • SiWx917 Radio boards
Product Mode Radio Board
Common Flash SiWx917-RB4338A

Features Supported

System

  • Operating Modes

    • Wi-Fi STA (802.11ax, 802.11n)
    • Wi-Fi 802.11n AP
    • Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP
    • Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Security 

    • Secure Boot
    • Secure firmware upgrade over
      • ISP using UART, SPI interfaces
      • Secure OTA 
    • Secure Key storage and HW device identity with PUF
    • Secure Zone 
    • Secure XIP (Execution in place) from flash
    • Secure Attestation
    • Anti Rollback
    • Secure Debug
    • Flash Protection
  • Crypto Support

    • Crypto API's for Hardware Accelerators:
      • Advanced Encryption Standard (AES) 128/256/192
      • Secure Hash Algorithm (SHA) 256/384/512
      • Hash Message Authentication Code (HMAC)
      • Random Number Generator (RNG)
      • SHA3
      • AES-Galois Counter Mode (GCM)/ Cipher based Message Authentication Code (CMAC)
      • ChaCha-poly
      • True Random Number Generator (TRNG)
    • Software Accelerators: RSA, ECC 
    • Integrated with mbed TLS 
    • TRNG, AES, SHA, HMAC, GCM, Chacha-poly, ECDH and AES-CCM hardware crypto engine is integrated with PSA crypto.
  • System Power save

    • Deep Sleep 
      • With RAM retention
      • Without RAM retention
    • Connected Sleep

MCU

  • Memory

    • PSRAM (Alpha)
  • Peripherals

    • HP - ADC, CALENDAR, CONFIG TIMER(CT), EFUSE, EGPIO, GSPI, I2C, I2S, MCPWM, SDIO Secondary, SIO, SSI, SYSRTC, UART, uDMA, USART, WDT
    • ULP - ULP_TIMER, ULP_UART, ULP_I2C, ULP_I2S, ULP_uDMA and ULP_SSI
  • Service

    • Sleep Timer
    • IOSTREAM
    • Power Manager
    • Sensor Hub
    • NVM3
  • SiWx917-PK6030A Pro-Kit Peripheral Support

    • LED
    • Button
    • MEMLCD
    • Joystick
    • RHT Sensor

Wi-Fi

  • Wi-Fi protocols

    • IEEE 802.11 b/g/n/ax (2.4GHz)
  • Access Point (AP) mode

    • 4 Client Support 
    • Wi-Fi Security  
      • WPA2 Personal
      • WPA3 Personal (H2E method only)
      • WPA Mixed mode (WPA/WPA2) 
    • Hidden SSID Mode
    • Auto Channel Selection
    • Scan in AP mode
  • Wi-Fi Scan

    • Selective Scan
    • Active/Passive Scan
  • Wi-Fi STA (Security Modes)

    • Open Mode
    • WPA2 Personal, WPA2 Enhancements
    • WPA3 Personal 
    • Mixed Mode (WPA/WPA2)
    • WPA3 Personal Transition Mode (WPA2/WPA3)
  • WPA2 Enterprise security (STA)

    • Method
      • PEAP/TTLS/TLS 1.0/TLS 1.2/FAST
  • Wi-Fi STA Rejoin

  • Wi-Fi STA Roaming

    • BG Scan
    • OKC (Opportunistic Key caching)
    • PMK (Pairwise Master Key) caching
    • Pre-Authentication
  • Wi-Fi Protocol Power save 

    • Deep sleep (unconnected state)
    • Max PSP
    • Enhanced Max PSP
    • Fast PSP
    • TWT
  • QoS

    • WMM-QoS
  • Wi-Fi 6 Feature

    • MUMIMO (DL)
    • OFDMA (UL/DL)
    • iTWT, TWT I-Frame & TWT Enhancements
    • BSS coloring
    • MBSSID
  • Wi-Fi Concurrency 

    • AP+STA (Same channel)
  • Wi-Fi Band/Channels

    • 2.4GHz CH1-11
    • 2.4GHz CH1-13
    • 2.4GHz CH1-14 (Japan)
  • Known Security vulnerabilities handled

    • WPA2 KRACK Attacks
    • Fragment and Forge Vulnerability

Networking stack

  • Core Networking Features

    • TCP/IP Bypass (LWIP as Hosted stack for reference)
    • IPv4/IPv6/UDP/TCP/ARP/ICMP/ICMPv6
    • SSL client versions TLSV1.0, TLSV1.2, TLSV1.3 
    • SSL server versions TLSV1.0 and TLSV1.2
    • DHCP (Client/Server)/ DHCPv6 Client
  • Advanced Network Features

    • HTTP Client/HTTPS Client//DNS Client/SNTP Client
    • Embedded MQTT/MQTT on host
  • Wi-Fi IoT Cloud Integration

    • AWS IOT Core
  • BSD and IoT sockets application programming interface(API)

BLE

  • GAP(Advertising, Scanning, initiation, Connection and Bonding)
  • Generic Attribute Protocol(GATT)
  • Attribute protocol(ATT)
  • Security
  • LL Privacy 1.2
  • Accept list
  • Directed Advertising
  • Extended Advertising
  • Periodic Advertising
  • Periodic Advertising scanning
  • Extended Advertising scanning
  • Periodic Advertising list
  • LE periodic advertising synchronization
  • LE PHY(1Mbps, 2Mbps) & Coded PHY(125Kbps, 500kbps)
  • Simultaneous scanning on 1Mbps and Coded PHY
  • LE dual role topology
  • LE data packet length extensions(DLE)
  • Asymmetric PHYs
  • LE channel selection algorithm 2 (CSA#2)
  • LE Secure connections
  • Bluetooth 5.4 Qualified(Clerical work pending)

Multi-protocol Mode

  • Wi-Fi STA + BLE

PTA/Coexistence

  • 3 wire coex acting as Wi-Fi with external Bluetooth
  • 3 wire coex acting as Wi-Fi with external Zigbee/OT

Changes and Fixes

System

  • Support for new flash map changes with 'NWP-1.8MB + MCU-2MB'

MCU

  • Enhancements

    • Support for SensorHub Service
    • Support for Power Manager Service
    • Support for Joystick and RHT sensor examples
    • Support for External PSRAM - Alpha*
    • Support for software chip selection in SSI
    • Support for 10-bit addressing mode in I2C
    • Support for interrupt mode and PS1 for ADC sensor
    • Support for PSRAM Half-Sleep
    • Support for GUVA_12D_UV(ADC-based) sensor in sensor hub framework
    • Support for ADC Multichannel
    • Startup file and linker file enhancements
    • Default interrupt priority configuration for all MCU interrupts when using RTOS
  • Fixed Issues

    • Fixed implicit placement of uDMA section in SRAM used for placing uDMA descriptors
    • Fixed NVM3 corruption issue

Wi-Fi

  • Enhancements

    • Folder restructuring, renamed SLC features and components as part of componentization. (Refer Migration Guide)
    • Standardized build parameters, enum, structures, typedef, and API signatures. (Refer Migration Guide)
    • Added support for TA(NWP) buffer configuration in sl_wifi_init.
    • Added support for sl_wifi_device_context_t in sl_wifi_init.
    • Added support for WPA3 personal security (with H2E method only) in AP mode
    • Added support for timeout configuration API 
    • Added support for Server Name Indication (SNI).
    • Added support for Extensible Authentication Protocol (EAP) encrypted certificates.
    • Replaced sl_tls with sl_net credential API.
    • Updated certificate handling APIs.
    • Removed duplicate instances of EXECUTION_FROM_RAM in examples.
    • Updated and standardized README files for featured examples, MQTT, TWT, and more.
    • Generic API reference documentation updation.
  • Fixed Issues

    • Resolved issues with CW modes in RF test example.
    • Fixed the issue where the application hangs issue during SHA operation on larger data exceeding 1400 bytes in TA (NWP).
    • Fixed the issue where DUT sent non-aggregated packets with protected ADDBA response for improving throughput.
    • Fixed the issue where the IOT socket connect/bind failed with -3 error in the CLI demo app.
    • "Failed to keep module in active mode: FFFFFFFF" issue when disabling power save after enabling enhanced max psp power save.

BLE

  • Enhancements

    • Readme files for ble_per and ble_accept_list.
    • BLE API reference documentation with descriptions and navigation links.
    • Added support for BLE data transfer process when TA & M4 power save is enabled.
    • Added support for M4 sleep and wake-up for BLE alone applications.
    • Added support for standby sleep with RAM retention in Wi-Fi + BLE coex mode.
    • Removed support for unused rsi_ble_set_prop_protocol_ble_bandedge_tx_power(), rsi_bt_ber_enable_or_disable(), and rsi_bt_per_cw_mode() APIs. (Refer Migration Guide)
    • Added support for rsi_ble_prepare_write_async, rsi_ble_execute_write_async, and rsi_ble_get_inc_services in gatt_test application.
  • Fixed issues

    • DUT transmitting 240 bytes MTU request packet regardless of programmed MTU length.
    • DUT is unable to transmit complete periodic advertising data.
    • Hang issue when transmitting BLE notification with coded PHY rates of 125kbps and 500kbps.
    • DUT not transmitting BLE scan requests after 20sec when power save is enabled.
    • DUT not transmitting packets continuously over the air in BLE test modes.
    • BLE set BD address API failing with error code 0xfffffffd (Command given in the wrong state).
    • rsi_ble_set_local_att_value() API fails with error code 0xFFFFFFE2 (RSI_ERROR_RESPONSE_TIMEOUT) during BLE notification.
    • BLE per stats cmd API fails with error code 0xFFFFFFE2 (RSI_ERROR_RESPONSE_TIMEOUT).
    • Synchronization issue in the host where the device was not able to transfer BLE notification packets when TA & M4 power save is enabled.
    • BLE scanning stops within ~4-5 minutes when power save is enabled.
    • Hang issues during multiple iterations of BLE connect and disconnect tests with TA and M4 power save enabled.

Multi-protocol

  • Enhancements

    • Increased throughputs in Wi-Fi station + BLE mode upto 30Mbps.
    • Added support for alarm-based power save mode in wlan_station_ble_provisioning_with_aws cloud example application.
    • Increased priority of Wi-Fi handling of data transmission in coex mode.
    • Replaced Printf statements with LOG_PRINT in all Coex example applications.
  • Fixed issues

    • Abrupt termination of HTTP download in the application when power save is enabled.
    • Firmware update fails with 0x7 error code when power save is enabled in wifi_throughput_ble_dual_role application.
    • Handling of PLL value in coex mode.
    • BLE disconnection issue after ~25-30 min while running Wi-Fi HTTP/HTTPs download along with BLE data transfer with power save enabled.

Recommendations

System

  • The current revision of SiWx917 B0 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in SoC mode. 

    • The below configurations are applicable in SoC mode and can be configured based on the application requirement By default EXT_FEAT_480K_M4SS_192K configuration will be selected in SoC mode

      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • SoC mode should not use 672k_M4SS_0K memory configuration.

  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.
  • To get optimal power numbers for launch parts, enable SL_SI91X_ENABLE_LOWPWR_RET_LDO pre-processor define. 
  • With RAM configuration (EXT_FEAT_352K_M4SS_320K), only 352K memory is available to TA to support Wi-Fi + BLE with SSL, Recommended to enable EXT_FEAT_416K_M4SS_256K in Wi-Fi + BLE Multi protocol mode to enable more Network features.

IDE

  • Simplicity Studio. This release is tested with SV5.8.0 version.
  • Refer to the latest version of the SoC "Getting-Started-with-SiWx917" guide for more details

Wi-Fi/Network Stack

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • Aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode. This enables software to aggregate multiple packets to achieve better throughput.
  • TCP retransmission count value is recommended to be 30 or higher so that the TCP does not disconnect while the rejoin happens.
  • To reset TA (NWP), the application needs to call sl_wifi_deinit() followed by sl_wifi_init(). Users must ensure that no execution happens from flash at this point of time. (Refer to example applications) 
  • Users can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature' bit map in opermode for (HTTPS server) supporting 16k record.
  • TWT

    • It is recommended to issue iTWT setup command once IP assignment, TCP connection, application specific socket connections are done.
    • When using sl_wifi_enable_target_wake_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured. It's highly recommended to use sl_wifi_target_wake_time_auto_selection() as an alternative.
    • In case of TWT in coex mode, when using sl_wifi_enable_target_wake_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
    • For iTWT GTK interval in AP should be configured to max possible value or zero. If GTK interval is not configurable on AP side, recommended TWT interval (in case of sl_wifi_enable_target_wake_time API) or RX Latency (in case of sl_wifi_target_wake_time_auto_selection API) is less than 4sec.
    • When sl_wifi_enable_target_wake_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wake interval of less than or equal to 1 min.
    • When using sl_wifi_enable_target_wake_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Disable power save for high throughput applications or use FAST PSP powersave mode as per application requirement.
  • The application needs to ensure that it sets RTC with the correct timestamp when the feature is enabled before establishing the SSL/EAP connection.
  • The minimum timeout value should not be less than 1 second for socket select and socket receive calls. 
  • Embedded MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • Disable power save and suspend any active TWT sessions before triggering HTTP OTAF.
  • Randomize the client port if using rapid connect/disconnect of the MQTT session on the same client port with the power save.

BLE

  • In BLE, the recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

Multi-protocol

  • 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.

Known Issues

Wi-Fi/Network Stack

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Secure SSL renegotiation not supported in Embedded Networking Stack.
  • Every server socket created consumes a socket and every subsequent connection consumes an additional socket.
  • Observed failure with BIT_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384, BIT_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 ciphers
  • Configuration issue to program MSS, TCP retry count 
  • Observed inconsistency with MQTT keep alive when TWT is enabled
  • TWT device (STA) may not go to sleep in between TWT intervals in case of burst data traffic where data transfer happens over multiple TWT service periods.
  • When sl_wifi_enable_target_wake_time() API is used, observed occasional MQTT disconnections with longer TWT intervals (>30secs) with embedded MQTT + TWT.
  • There are performance and IOP issues with MU MIMO.
  • STA Connection with the WPA3 Hunting and Pecking algorithm takes about 3-4 seconds.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.
  • Observed HTTPS continuous download issues with TA Power save
  • Planned performance improvements are in progress to get optimal performance in Wi-Fi/Wi-Fi+BLE 
  • Observed interop issue (connectivity failure) with few AP's(EERO 6+, EERO PRO 6E, Cisco Catalyst 9120AXID) when device reset/reboot happens on active connection. 
  • Unable to get SNTP async events when coex mode and power save are enabled and not getting any response for sl_net_up API for 2nd Iteration
  • Disconnections observed with Netgear RAX120 AP in WPA3 security
  • Observed connection failures with some AP's in more channel congestion ~50-60% occupancy open lab environment. 
  • In AP mode, the first few beacons don't include RSN IE.
  • Issue with fixed rate configuration in AP mode
  • Configuration issue to program PAC file for EAP FAST Manual mode
  • Optional LDPC feature is not enabled, So observed less throughput in DL-OFDMA with some APs.
  • Observed issue with configuring certificate key and programming 4096 bit key and SHA384/SHA512 certificates.
  • Observed DUT is unable to receive data when using wifi6_twt_use_case_demo_soc application with encrypted rps.
  • Observed Wi-Fi connection is successful even after deleting the stored network credentials using sl_net_delete_credential and responding with SL_NET_INVALID_CREDENTIAL_TYPE for sl_net_get_credential.
  • Observed HTTPS post data is failing with error code: BBE2 (HTTP Failed). 
  • Observed BSSID-based connection is not working.
  • Observed DUT is not resuming the data transfer after successful rejoin when DUT is connected to AWS cloud and continuously publishing data with Qos1 priority.
  • Observed "Failed to bring Wi-Fi client interface up: 0x100025(SL_STATUS_SI91X_COMMAND_ISSUED_IN_REJOIN_STATE)" while running HTTP OTAF in the long run.
  • Observed Wi-Fi alone throughput with SDK 3.x(42Mbps) compared with the expected target (50Mbps).
  • Observed auth/assoc timeout is not reflecting as per timeout configuration.
  • Observed sl_net_deinit is not returning any response for both "SL_NET_WIFI_AP_INTERFACE" and "SL_NET_WIFI_CLIENT_INTERFACE" interfaces. 
  • Observed AWS MQTT keepalive transmission is not happening at expected intervals with power save enabled.
  • WoWLAN feature not supported.
  • Removal of wifi_https_ble_dual_role and wifi_station_ble_throughput_app examples application support.

BLE

  • HID profile data transfer is not working when power save is enabled in SoC.
  • BLE reconnection is not working in ble_multiconnection_gatt demo when power save is enabled in SoC. 
  • When power save is enabled in the SoC, the DUT hangs with the ble_multiconnection_gatt demo while performing continuous Tx/Rx notifications.
  • When running the ble_central application with power save enabled, it was observed that the BLE connect API is failing because of 0xFFFFFFE2(RSI_ERROR_RESPONSE_TIMEOUT) error.
  • When running the ble_ae_central example, observed an application hang issue at the AE Clear Periodic Adv list API. 
  • BLE connection failure has been observed on a few mobile devices (Samsung S23& Oneplus 9pro) when the device is configured as central.
  • The maximum power that BLE can support is 16 dBm. It is not permitted for users to program more than 16dBm. 127 power_index is not supported in this release.

Multi-protocol

  • MU retries in DL MUMIMO are more in CoEx.
  • Observed TCP_RX is failing while running WLAN continuous throughput and BLE adv/scan or connection activities in power save mode.
  • Observed TCP socket creation is failing while running TCP Tx data by disabling the WLAN_SYNC_REQ in power save mode.
  • Observed data stalls in the remote machine during continuous TCP TX along with BLE TX in SMP in the long run.
  • Observed DUT hang while doing periodic(every 30s) M4 wakeup, SSL Tx, BLE Tx, and M4 sleep activity in the long run.
  • Observed SSL connection failure while running wifi_ble_power_save application. 
  • Observed "DUT is not disconnecting to the AP when initiating disconnection from EFR connect app screen using wifi_station_ble_provisioning_aws example
  • BLE disconnected with reason 'instant passed'/'Connection timeout' while BLE scan and BLE Tx are executed where Wi-Fi is in idle connection.

System

  • None

MCU

  • SensorHub does not support SPI-based sensors.
  • SensorHub does not support ADC multi-channel.
  • SSI Dual and Quad mode are not functional.
  • I2C High speed and Fastplus mode not working at specifications speed.
  • ULP SSI wakeup source is not working.
  • The wakeup sources BOD, Comparator, and SysRTC are not working in the Power manager service.
  • To use Sleeptimer and NVM3, these components must be added to project slcp before the project is launched in studio.
  • SSI Primary will not be operable till 40 MHz.
  • Flow control is not supported in USART and IOSTREAM applications.
  • In SSI primary mode3(TI) is not working.

Limitations and Unsupported Features

System

  • None

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported.
  • Broadcast TWT is not supported.
  • AMSDU TX is not supported.
  • Fragmentation is not supported.
  • AMSDUs within AMPDU is not supported.
  • Currently, the module does not support Radio Measurement Requests feature of CCX V2
  • 802.11k is not supported
  • 40 MHz bandwidth for 2.4 GHz band is not supported.
  • Max 3 SSL sockets in Wi-Fi only mode, 2 SSL Socket in Wi-Fi + BLE based on RAM memory configuration selected
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • Legacy TA(NWP) LP mode is not supported.
  • In iTWT mode, downlink data traffic should be limited. Disconnections may be observed if AP fails to send all the buffered data in the next TWT Service Period.
  • The number of Non-Transmitting BSSIDs processed is limited by the beacon length that can be processed by the stack (which is 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • CoEx + EAP Security in 352K/320k is not feasible. This issue is observed due to a lack of memory in the 352k/320k Memory Configuration. It is supported with other EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K memory configurations.
  • UL MUMIMO is not supported.
  • The embedded HTTP server is not supported.
  • SDK does not support baremetal mode.
  • WPA3 AP supports only H2E algorithm.
  • PMKSA caching is not supported in WPA3 AP mode.
  • Wi-Fi Mesh not supported
  • Apple HomeKit not supported
  • Cellular coexistence not supported
  • The maximum embedded MQTT Publish payload is 1 kbyte.
  • Timeout value for socket select and socket receive calls of less than 1 second is not currently supported.

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • BLE TX/RX throughput is less when tested with EFM as compared to EFR
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections (1 Central and 1 Peripheral) with AE.
  • Advertising Extension feature is not supported in Coexistence.
  • The  ae_central & ae_peripheral applications are not supported with TA_352K_M4_320K RAM configuration.
  • Two BLE connections are not supported with M4 powersave. It only supports a single connection. 
  • Isochronous channels feature is not supported. 
  • Connection subrating feature is not supported. 
  • LE power controller feature is not supported.
  • EATT feature is not supported.
  • Periodic Advertising with a response feature is not supported. 
  • BLE Audio is not supported.
  • The feature of dynamically changing the TX power when extended advertising is active is not supported.

MCU

  • On BRD4338a board, two I2C instances(I2C1 and I2C2) are using the same GPIOs, so support is not there for using two I2C instances simultaneously.
  • SensorHub supports PS1-power state with ADC sensor. In this mode, other sensors operation is not supported. 
  • PinTool is not supported.
  • RTOS is not enabled for MCU peripheral examples.

Simplicity Studio and Commander

  • Simplicity commander does not support options under "Debug Lock tools".
  • All projects in the package are compatible with GCC 12.2.1 version.

WiSeConnect3_SDK_3.1.0 Release Notes

This SDK package supports SoC Mode and NCP Mode for A0 and B0:

  • In SoC Mode: Customer applications can run on Cortex M4. Wireless, network, and security stacks run on the wireless subsystem.
  • In NCP mode: Wireless, network, and security stacks run on the Wireless subsystem. Customer applications run on the external host MCU.
  • Silicon Labs' SiWx917 includes an ultra-low power Wi-Fi 6 plus Bluetooth Low Energy (BLE) 5.1 wireless subsystem and an integrated micro-controller application subsystem.

Note: Use Simplicity Studio version SV5.7.0.1 onwards

SoC Highlights

  • Operating Modes : Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Wireless Protocols : IEEE 802.11b, 802.11g, 802.11n, 802.11ax, BLE 5.1
  • Multiple Ultra Low Power Modes : Support ultra low power Wi-Fi standby associated current in Wi-Fi 4 mode, Ultra low power Wi-Fi Standby associated current in Wi-Fi 6 mode leveraging TWT, Always on Cloud connected power, BLE connected power, and, deep sleep ULP mode
  • MCU examples : GPIO, I2C, Calendar,  SPI, SSI, SIO, Micro DMA, UART/USART, Watchdog Timer, Timers, Config Timers, ULP (Ultra Low Power) Timers, Sleeptimer, IOSTREAM, NVM3, MEMLCD, SDIO Secondary, PWM, ADC, EFUSE, I2S, PSRAM, ML Blinky, Sensorhub
  • Wi-Fi : 2.4GHz Wi-Fi Support - WPA2/WPA3 Personal, Wi-Fi 6 OFDMA/MU-MIMO Support that enhances network capacity and reduces latency
  • Cloud : Amazon Cloud Connectivity Support, Amazon FreeRTOS
  • BLE : BLE 5.1, BLE dual role (Central and Peripheral Support), Advertising extensions, Data length extensions, LL privacy, BLE whitelisting, and BLE long Range. 
  • Integrated Stacks and Profiles : Wi-Fi Stack, BLE Stack, All GAP and GATT based Profiles & Services are Supported, TCP/IP stack with TLS 1.3, HTTP/HTTPS, DHCP, MQTT Client, DNS client
  • IDE : Simplicity Studio with Windows 10(64-bit), Linux, Mac OS
  • TA/M4 Firmware Update Tool : Simplicity Commander
  • Hardware kits to evaluate SoC Mode :
    • Si-MB4002A Main board
    • SiWx917 Radio boards
RadioBoard Type SiWx917A0 with Board Version SiWx917B0 with Board Version
Common flash Si917-BRD4325A(1.0 /1.1 /1.2) -
Common flash - Si917-BRD4338A(2.0)
Dual flash Si917-BRD4325B(1.0 /1.1 /1.2) -
External PSRAM - Si917-BRD4340A(2.0)

NCP Highlights

  • Host Interface : SPI
  • Operating Modes : Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Wireless Protocols : IEEE 802.11b, 802.11g, 802.11n, 802.11ax, BLE 5.1
  • Multiple Ultra Low Power Modes : Support Ultra low power Wi-Fi Standby associated current in Wi-Fi 4 mode, Ultra low power Wi-Fi Standby associated current in Wi-Fi 6 mode leveraging TWT, Always on Cloud connected power, BLE connected power, and, deep sleep ULP mode.
  • Wi-Fi : 2.4GHz Wi-Fi Support, WPA2/WPA3 Personal, Wi-Fi 6 OFDMA/MU-MIMO Support that enhances network capacity and reduces latency
  • BLE : BLE 5.1, BLE dual role (Central and Peripheral Support), Advertising extensions, Data length extensions, LL privacy, BLE Whitelisting and BLE long Range. 
  • Integrated Stacks and Profiles : Wi-Fi Stack , BLE Stack , All GAP and GATT based Profiles & Services are Supported, TCP/IP stack with TLS 1.3, HTTP/HTTPS, DHCP, MQTT Client, DNS Client.
  • IDE : Simplicity Studio with Windows 10(64-bit)
  • Hardware kits to evaluate NCP Mode
    • Si917 B0 1.2 expansion board BRD8036B
    • Wireless Pro kit Mainboard BRD4002A Rev A06
    • EFR32xG21 2.4 GHz 20 dBm Radio Board (BRD4180B Rev A02)

Release Details

Item Details
Release date Oct 9th, 2023
SDK Version 3.1.0
Firmware Version 1711.2.9.0.0.21
Package Name WiSeConnect3_SDK_3.1.0
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
Build Quality Beta
  • SiWx917 release consists of two components
    • Wireless Firmware - SiWx917 Firmware Binaries
    • Wiseconnect3 Library - Wiseconnect3 SDK library runs on the external host in NCP mode and internal Cortex M4 in SoC Mode.
  • This release is meant only for use with designs based on SiWx917 Silicon
  • The firmware to load in your design are available in the following format:
    • SiWG917-A.2.9.0.0.x.rps - A0 Full-featured firmware binary
    • SiWG917-B.2.9.0.0.x.rps - B0 Full-featured firmware binary

Features Supported

MCU

  • ADC Single Channel, ADC Static Mode, Analog Comparator, Blinky, Bod, CTS, DAC FIFO, DAC Static, GPIO, I2C, I2S, NVM3, OPAMP, PSRAM, PWM, QEI, RTC, SDIO Secondary, SPI Master and Slave, UART, Micro DMA, USART, Watchdog Timer, USART Master and Slave
  • UC Supported Peripherals - GPIO, I2C, Calendar,  SPI, SSI, SIO, Micro DMA, UART/USART, Watchdog Timer, Timers , Config Timers, ULP (Ultra Low Power) Timers, SDIO Secondary, PWM, ADC, EFUSE, I2S, PSRAM, Sleeptimer, IOSTREAM, MEMLCD.
  • ULP (Ultra Low Power) Peripherals - ulp_gpio, ulp_adc ulp_i2c, ulp_i2s, ulp_ir_decoder, ulp_spi, ulp_timer, ulp_uart, ulp_udma

Wi-Fi

  • WPA2/WPA3 Personal, WPS and WPA2-EAP Support for Station Mode
  • TCP/IP stack with IPv4, IPv6, TCP, UDP, TLS, HTTP/HTTPS, DHCPv4, DHCPv6, MQTT Client, DNS Client, SNTP client.
  • Support for SSL client versions TLSV1.0, TLSV1.2, TLSV1.3 and SSL server versions TLSV1.0 and TLSV1.2
  • Wi-Fi STA (802.11n/802.11ax) + 802.11n AP Support
  • HE (802.11ax) and Individual TWT Feature Support
  • Multiple BSSID feature support as an STA
  • Secure OTA support on B0 radio boards.
  • Support for LWIP network stack
  • Support for AWS MQTT library
  • Support for BSD and IoT sockets application programming interface(API)

Bluetooth Low Energy

  • BLE central & peripheral connections are supported.
  • Ultra-low power save is supported.

Power Save

  • The power save profiles supported are Max PSP, enhanced MAX PSP, Fast PSP, and 802.11ax TWT. 

Crypto Support

  • AES, SHA, AES-CCM, HMAC, and TRNG FW Crypto API support added.
  • PSA enabled Mbed TLS support added
  • NVM support is added for key storage
  • Symmetric key storage support added for Volatile and transparent key.
  • TRNG, AES, SHA, and AES-CCM hardware crypto engine is integrated with PSA crypto.

Changes and Fixes

MCU

  • Added Ultra Low Power(ULP) examples support for SSI Master, USART, Micro DMA, Calendar, GPIO, I2C Leader, Timer.

Wi-Fi

  • Added support for Efuse read, User Gain tables, Calibration Software APIs
  • Added support for M4 soft reset
  • Added example support tcp_tx_on_periodic_wakeup_soc, wlan_throughput_psram, twt_use_case_remote_app  
  • Enhancement of SNTP example to support async notification
  • Updation of Readme files to have a unified "Project Environment" section
  • Added support for sl_wifi_enable_target_wake_time() API
  • Added M4 power save support for embedded_mqtt_client_twt and twt_tcp_client, twt_use_case_demo, aws_device_shadow_logging_stats examples
  • Fixed security setting failure to apply properly while enabling the APUT in DUT
  • Removal of file duplicates sl_net_default_values.h
  • Readme enhancement to fix setup diagram images
  • Removal of all UAPSD references
  • RTC timer get and set APIs
  • Added PSRAM board support for applications
  • Added TA and M4 power save for lwip_tcp_client example
  • Updation of wlan_throughput example SI91x asynchronous sockets for high throughputs
  • Added support to handle transmit test opermode
  • Updated print_sl_ipv6_address() utility to print IP address in new format.
  • Added M4 power save support for tcp_tx_on_periodic_wakeup example
  • Added thread-safe support for malloc and free functions
  • Added SNI option for sockets
  • Added support for AP stop feature
  • Fixed issue stability issues in firmware update
  • Added support for WPA3
  • Added API support for configuration of listen interval
  • Added NCP support for AWS MQTT, twt_tcp_client, power_save_deep_sleep, enterprise_client examples
  • Added crypto examples - HMAC, PSA SHA, si91x_psa_asymmetric_key_storage, si91x_psa_symmetric_key_storage, si91x_psa_aes, ECDH, PSA GCM, PSA HMAC.
  • Fixed async event handling in the aws_device_shadow application
  • Updated readme of cli_demo with steps to add new command handlers

BLE

  • Fixed high power numbers issue in BLE PER application with Tx and Rx in SoC mode
  • Added  ble_testmodes demo in SoC & NCP
  • Added gatt_long_read, ble_ae_central and ble_ae_peripheral applications in SoC
  • Renaming of all references of whitelist to acceptlist in all BLE examples
  • Added support for test agent application for BLE commands
  • Added support for rsi_ble_req_hci_raw  command
  • Added support for  352K_320K memory configuration in immediate_alert_client example application

CoEx 

  • Added wifi_station_ble_throughput_app coex application
  • Added studio support and logging stats feature for wifi_station_ble_provisioning_aws_logging_stats application
  • Fixed  BLE notifications issue in wifi_throughput_ble_dual_role application
  • Fixed 0 Mbps data samples in WLAN throughput test in wifi_throughput_ble_dual_role application

System

  • None

Recommendations

System

  • The current revision of SiWx917 B0 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in NCP/SoC mode. The following memory configuration modes are supported.
      • EXT_FEAT_672K_M4SS_0K- This mode configures TA with 672k and M4 with 0K bytes of memory which is applicable only in the case of NCP mode
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement By default EXT_FEAT_352K_M4SS_320K configuration will be selected in SoC mode
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • The currently supported memory configuration for NCP mode is 672K_M4SS_0K.
    • SoC mode should not use 672k_M4SS_0k memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.

IDE

  • Download the latest Simplicity Studio (SV5.7.0.1)
  • Refer to the latest version of the SoC/NCP "Getting-Started-with-SiWx917" guide for more details

Network Stack

  • The recommended embedded MQTT Publish payload is 1 kBytes.

Wi-Fi

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • Aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode. This enables software to aggregate multiple packets to achieve better throughput
  • TCP retransmission count value is recommended to be 30 or higher so that the TCP does not disconnect while the rejoin happens.
  • To restart the module, the application needs to call sl_wifi_deinit() followed by sl_wifi_init().
  • 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.
  • User can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature'bit map in opermode, if HTTPS download is failing after receiving HTTP headers..
  • iTWT setup is recommended after IP assignment/TCP connection/application specific socket connections.
  • When using sl_wifi_enable_target_wakeup_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured.
  • In case of TWT+coex, when using sl_wifi_enable_target_wakeup_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
  • For iTWT GTK Interval Should be kept max possible value or zero. If GTK interval is not configurable, recommended TWT interval (in case of sl_wifi_enable_target_wakeup_time API) or RX Latency (in case of sl_wifi_target_wake_time_auto_selection API) is less than 4sec.
  • Disable Power Save for High Throughput Applications.
  • The application needs to ensure that it sets RTC with the correct timestamp when the feature is enabled before establishing the SSL connection.
  • The timeout value should not be less than 1 second for socket select and socket receive calls. Timeout value of less than 1 second is not currently supported.
  • When sl_wifi_enable_target_wakeup_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wakeup interval of less than or equal to 1 min.
  • Embedded MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • When using sl_wifi_enable_target_wakeup_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.

BLE

  • In BLE, the recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

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.

Known Issues

Network Stack

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • 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.

Wi-Fi

  • TWT device (STA) may not go to sleep in between TWT intervals in case of burst data traffics with data size more than the configured 'average tx throughput', until completion of data transfer. 
  • There are performance and IOP issues with MU MIMO.
  • WPA3 Connection with the Hunting and Pecking algorithm takes about 3-4 seconds.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.
  • Low Wi-Fi+BLE throughput
  • TCP/UDP TX/RX Data stall observed in CoEx scenarios
  • Observed HTTPS Continuous download fails with TA Power save
  • Performance improvements are in progress for lower performance metrics.
  • Observed interop issue (connectivity failure) with few AP's when device reset/reboot happens on active connection.
  • In concurrent mode, AP restart fails after stopping it with ap_stop command. 
  • DUT deep sleep will not work after stopping AP with ap_stop command.
  • Unable to get SNTP async events when coex mode and Power save is enabled
  • Fine Tuning 802.11ax Spectral mask in Progress
  • Fine Tuning 11b mask in Ch11 in progress
  • DUT is unable to connect to the AP with WPA3 security when we enable coex mode (WLAN+BLE) in opermode
  • Socket listen API is failing from the second iteration
  • Disconnections observed with Netgear RAX120 AP in WPA3 security 
  • Observed connection failures with some AP's in more channel congestion open lab environment

BLE

  • M4 Power save with RTOS is not supported for BLE scan and data transfer in SoC Mode.
  • BLE anchor points will experience a miss rate of approximately 10%, when the slave latency is enabled.
  • When power save is enabled, the device stops sending BLE scan requests after 20 seconds.
  • DUT hangs when transmitting BLE notification with codded PHY rates of 125kbps and 500kbps, when DLE is enabled. 
  • DUT is not transmitting packets continuously over the air in BLE test modes.
  • After connecting to the remote device using gatt_test applications, GATT APIs could not be triggered. 
  • DUT hangs during multiple iterations of BLE connect and disconnect tests with TA and M4 power enabled.

Co-Existence

  • Observed HTTP continuous download is not happening in Powersave mode after BLE connection established using wifi_https_ble_dual_role application
  • Observed DUT hang while Wi-Fi UDP Tx and BLE continuous scan run for long time.
  • sl_wifi_init throws insufficient memory(0x2C) error, when low_power_mode feature is enabled in CoEx application with "TA_352K_M4SS_320K" Memory configuration.

System

  • None

MCU

  • Refer to the respective Radio board user guides for specific pinout details. Examples are targeted to a specific version mentioned in the respective readme.
  • Few peripherals like WDT when configured with RO clock is not working as expected. No impact on the feature but the clocks are not accurate.

Limitations and Unsupported Features

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported
  • In AP mode, IPv6 Router Advertisements are not supported. Although STA connected to the APUT can transfer IPv6 data to the peers by using SLAAC for address configuration.
  • When sl_wifi_enable_target_wake_time() API is used, observed occasional MQTT disconnections with longer TWT intervals (>30secs) with embedded MQTT + TWT.
  • AMSDU TX is not supported.
  • Fragmentation is not supported.
  • AMSDUs within AMPDU is not supported.
  • Currently, the module does not support Radio Measurement Requests feature of CCX V2
  • 802.11k is not supported
  • 40 MHz bandwidth for 2.4 GHz band is not supported.
  • 802.11J channel 14 is not supported.
  • MQTT versions 3 and 4 are supported.
  • Maximum of 3 SSL connections are supported in Wi-Fi alone mode.
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • LP mode is not supported.
  • In iTWT mode, downlink data traffic should be limited. Disconnections may be observed if AP fails to send all the buffered data in the next TWT Service Period.
  • Number of MBSSIDs processed is limited by the beacon length that can be processed by the stack (which is limited to 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • In A0 SoC mode, M4 power save will work with 384k TA and 320 M4 memory configuration only. It is not supported for "448K TA and 256k M4" and "512k TA and 192k M4" memory configurations
  • CoEx + EAP Security in 352K/320k is not feasible. This issue is observed due to a lack of memory in the 352k/320k Memory Configuration. It is supported with other EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K memory configurations.
  • UL MUMIMO is not supported.
  • The embedded HTTP server is not supported.
  • Baremetal is not supported
  • Compared to SoC mode, NCP mode has fewer examples, but more will be enabled in upcoming releases.

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • BLE TX/RX throughput is less when tested with EFM as compared to EFR
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections (1 Central and 1 Peripheral) with AE.
  • Advertising Extension feature is not supported in Coexistence.
  • The demo's ae_central & ae_peripheral are not supported with TA_352K_M4_320K RAM configuration. 

MCU

  • ULP Peripherals examples configurations are for RAM-based execution, as flash is powered off in ULP Mode.
  • On 4338a board, two I2C instances(I2C1 and I2C2) are using same GPIOs, so support is not there for using two I2C instances simultaneously.
  • I2C High speed mode not supported.
  • Manual chip select option is not supported when using GSPI and SSI.

Simplicity Studio and Commander

  • Default GDB debug configuration is not supported for SoC projects, work around details provided in "Getting-Started-with-SiWx917"
  • Observing flash download failures(ERROR 108) for a few image sizes
  • While creating project through Simplicity Studio, "copy contents" option not supported.
  • Simplicity commander does not support options under "Debug Lock tools" . 

Terminology

Term Description
New Features These items are new to this release
Changes/Issues Fixed Changes made to existing features found in previous software releases.
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 the 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

Note

  • Change SPI frequency to 12.5Mhz while measuring BLE throughput with EFR32

WiSeConnect3_SDK_3.0.13 Release Notes

This SDK package supports SoC Mode and NCP Mode for A0 and B0:

  • In SoC Mode: Customer Applications can run on Cortex M4. Wireless, network, and security stacks run on the Wireless subsystem.
  • In NCP mode: Wireless, network, and security stacks run on the Wireless subsystem. Customer applications run on the external host MCU.
  • Silicon Labs' SiWx917 includes an ultra-low power Wi-Fi 6 plus Bluetooth Low Energy (BLE) 5.1 wireless subsystem and an integrated micro-controller application subsystem.

Note: Use Simplicity Studio version SV5.7.0.1 onwards

SoC Highlights

  • Operating Modes : Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Wireless Protocols : IEEE 802.11b, 802.11g, 802.11n, 802.11ax, BLE 5.1
  • Multiple Ultra Low Power Modes : Support Ultra low power Wi-Fi Standby associated current in Wi-Fi 4 mode, Ultra low power Wi-Fi Standby associated current in Wi-Fi 6 mode leveraging TWT, Always on Cloud connected power, BLE connected power, and, deep sleep ULP mode
  • MCU examples :  GPIO, I2C, Calendar,  SPI, SSI, SIO, UDMA, UART/USART, WDT, Timers, Config Timers, ULP (Ultra Low Power) Timers, Sleeptimer, IOSTREAM, NVM3, MEMLCD.
  • Wi-Fi : 2.4GHz Wi-Fi Support - WPA2/WPA3 Personal, Wi-Fi 6 OFDMA/MU-MIMO Support that enhances network capacity and reduces latency
  • Cloud : Amazon Cloud Connectivity Support, Amazon FreeRTOS
  • BLE : BLE 5.1, BLE dual role (Central and Peripheral Support)
  • Integrated Stacks and Profiles : Wi-Fi Stack, BLE Stack, and Profiles, TCP/IP stack with TLS 1.3, HTTP/HTTPS, DHCP, MQTT Client, DNS client
  • IDE : Simplicity Studio with Windows 10(64-bit), Linux, Mac OS
  • TA/M4 Firmware Update Tool : Simplicity Commander
  • Hardware kits to evaluate SoC Mode :
    • Si-MB4002A Main board
    • SiWx917 Radio boards
RadioBoard Type SiWx917A0 with Board Version SiWx917B0 with Board Version
Common flash Si917-BRD4325A(1.0 /1.1 /1.2) -
Common flash - Si917-BRD4338A(2.0)
Dual flash Si917-BRD4325B(1.0 /1.1 /1.2) -

NCP Highlights

  • Host Interface : SPI
  • Operating Modes : Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Wireless Protocols : IEEE 802.11b, 802.11g, 802.11n, 802.11ax, BLE 5.1
  • Multiple Ultra Low Power Modes : Support Ultra low power Wi-Fi Standby associated current in Wi-Fi 4 mode, Ultra low power Wi-Fi Standby associated current in Wi-Fi 6 mode leveraging TWT, Always on Cloud connected power, BLE connected power, and, deep sleep ULP mode.
  • Wi-Fi : 2.4GHz Wi-Fi Support, WPA2/WPA3 Personal, Wi-Fi 6 OFDMA/MU-MIMO Support that enhances network capacity and reduces latency
  • BLE : BLE 5.1, BLE dual role (Central and Peripheral Support)
  • Integrated Stacks and Profiles : Wi-Fi Stack , BLE Stack and Profiles, TCP/IP stack with TLS 1.3, HTTP/HTTPS, DHCP, MQTT Client, DNS Client.
  • IDE : Simplicity Studio with Windows 10(64-bit)
  • Hardware kits to evaluate NCP Mode
    • Si917 B0 Single Band Radio Board (BRD4338A)
    • Wireless Pro kit Mainboard BRD4002A Rev A06
    • EFR32xG21 2.4 GHz 20 dBm Radio Board (BRD4180B Rev A02)

Release Details

Item Details
Release date Aug 18th, 2023
SDK Version 3.0.13
Firmware Version 1711.2.9.0.0.19
Package Name WiSeConnect3_SDK_3.0.13
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
Build Quality Beta(NCP)

Updating to this Release

  • SiWx917 release consists of two components
    • Wireless Firmware - SiWx917 Firmware Binaries
    • Wiseconnect3 Library - Wiseconnect3 SDK Library runs on the external host in NCP mode and internal Cortex M4 in SoC Mode.
  • This release is meant only for use with designs based on SiWx917 Silicon
  • The firmware to load in your design are available in the following format:
    • SiWG917-A.2.9.0.0.x.rps - A0 Full-featured firmware binary
    • SiWG917-B.2.9.0.0.x.rps - B0 Full-featured firmware binary

Features Supported

MCU

  • ADC Single Channel, ADC Static Mode, Analog Comparator, Blinky, Bod, CTS, DAC FIFO, DAC Static, GPIO, I2C, I2S, NVM3, OPAMP, PSRAM, PWM, QEI, RTC, SDIO Slave, SPI Master and Slave, UART, UDMA, USART, WDT, USART Master and Slave
  • UC Supported Peripherals - GPIO, I2C, Calendar,  SPI, SSI, SIO, UDMA, UART/USART, WDT, Timers , Config Timers, ULP (Ultra Low Power) Timers, Sleeptimer, IOSTREAM, MEMLCD
  • ULP (Ultra Low Power) Peripherals - ulp_gpio, ulp_adc ulp_i2c, ulp_i2s, ulp_ir_decoder, ulp_spi, ulp_timer, ulp_uart, ulp_udma

Wi-Fi

  • WPA2/WPA3 Personal, WPS and WPA2-EAP Support for Station Mode
  • TCP/IP stack with IPv4, IPv6, TCP, UDP, TLS, HTTP/HTTPS, DHCPv4, DHCPv6, MQTT Client, DNS Client, SNTP client.
  • Support for SSL client versions TLSV1.0, TLSV1.2, TLSV1.3 and SSL server versions TLSV1.0 and TLSV1.2
  • Wi-Fi STA (802.11n/802.11ax) + 802.11n AP Support
  • HE (802.11ax) and Individual TWT Feature Support
  • Multiple BSSID feature support as an STA
  • Secure OTA support on B0 radio boards.
  • Support for LWIP network stack
  • Support for AWS MQTT library
  • Support for BSD and IoT sockets application programming interface(API)

Bluetooth Low Energy

  • BLE central & peripheral connections are supported.
  • Ultra-low power save is supported in Test Mode to support Tx/Rx performance testing

Power Save

  • The power save profiles supported are Max PSP, enhanced MAX PSP, and 802.11ax TWT. 

Changes and Fixes

Wi-Fi

  • NCP support for brd4180b EFR
  • Addition of featured examples wifi_aws_device_shadow_ncp, wifi_ble_per_ncp, wifi_firmware_update_ncp, wifi_powersave_standby_associated_ncp, wifi_wlan_throughput_ncp 
  • Addition of snippet examples wifi_access_point_ncp, wifi_concurrent_mode_ncp, wifi_select_app_ncp, wifi_station_ping_ncp, wifi_lwip_tcp_client_ncp, wifi_sntp_client_ncp
  • Adds M4 power save support for wifi_station_ble_provisioning_aws
  • Asynchronous select support using Si91x sockets APIs
  • Added fixes for WLAN data transfer(TCP Tx/UDP Tx) failures while starting BLE Notification in wifi_throughput_ble_dual_role example
  • Added fixes for socket bind failures in cli_demo while running in multiple iterations 
  • Added fixes for HTTP GET and HTTP POST when the application is run for multiple iterations

BLE

  • Fixes compilation errors of ble_hid_on_gatt application when configured GATT_ROLE as CLIENT
  • Added support for  352K_320K memory configuration in ble_central example application

System

  • None

Recommendations

System

  • The current revision of SiWx917 A0 has:
    • RAM memory of 704k bytes which can be shared between TA and M4 processors in NCP/SoC mode. The following memory configuration modes are supported.
      • EXT_FEAT_704K_M4SS_0K- This mode configures TA with 704k and M4 with 0K bytes of memory which is applicable only in the case of NCP mode
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement By Default EXT_FEAT_384K_M4SS_320K configuration will be selected in SoC mode
      • EXT_FEAT_512K_M4SS_192K - This mode configures TA with 512k and M4 with 192K bytes of memory
      • EXT_FEAT_448K_M4SS_256K - This mode configures TA with 448k and M4 with 256K bytes of memory
      • EXT_FEAT_384K_M4SS_320K - This mode configures TA with 384k and M4 with 320K bytes of memory
    • The currently supported memory configuration for NCP mode is 704K_M4SS_0K.
    • SoC mode should not use 704k_M4SS_0k Memory configuration.
    • In SoC mode, M4 power save will work with 384k TA and 320 M4 memory configuration only. It is not supported for "448K TA and 256k M4" and "512k TA and 192k M4" memory configurations.
  • The current revision of SiWx917 B0 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in NCP/SoC mode. The following memory configuration modes are supported.
      • EXT_FEAT_672K_M4SS_0K- This mode configures TA with 672k and M4 with 0K bytes of memory which is applicable only in the case of NCP mode
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement By Default EXT_FEAT_352K_M4SS_320K configuration will be selected in SoC mode
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • The currently supported memory configuration for NCP mode is 672K_M4SS_0K.
    • SoC mode should not use 672k_M4SS_0k Memory configuration.
    • In SoC mode, M4 power save will work with any memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.

IDE

  • Download the latest Simplicity Studio (SV5.7.0.1)
  • Refer to the latest version of the SoC/NCP "Getting-Started-with-SiWx917" guide for more details

Wi-Fi

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket Operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • Aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode. This enables sw to aggregate multiple packets to achieve better throughput
  • TCP retransmission count value is recommended to be 30 or higher so that the TCP does not disconnect while the rejoin happens.
  • To restart the module, the application needs to call sl_wifi_deinit() followed by sl_wifi_init().
  • 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.
  • User can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature'bit map in opermode, if HTTPS download is failing after receiving HTTP headers..
  • iTWT setup is recommended after IP assignment/TCP connection/application connection.
  • When using sl_wifi_enable_target_wakeup_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured.
  • In case of TWT+coex, when using sl_wifi_enable_target_wakeup_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
  • For iTWT GTK Interval Should be kept max possible value or zero. If GTK interval is not configurable, recommended TWT interval (in case of sl_wifi_enable_target_wakeup_time API) 
  • Disable Power Save for High Throughput Applications.
  • The application needs to ensure that it sets RTC with the 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 of less than 1 second is not currently supported.
  • When sl_wifi_enable_target_wakeup_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wakeup interval of less than or equal to 1 min.
  • MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • When using sl_wifi_enable_target_wakeup_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Secure OTA: Keys need to be programmed before validating Secure OTA

BLE

  • In BLE, recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

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.

Known Issues

Network Stack

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Recommended MQTT Publish payload is 1 kBytes.
  • 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.

Wi-Fi

  • Device with active TWT will not go to sleep when the buffer is full.
  • There are performance and IOP issues with MU MIMO.
  • WPA3 connection takes 2.5 seconds.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.
  • EAP connection with certificates of 4096-bit key length is not supported.
  • Low Wi-Fi+BLE throughput
  • Data stall and disconnection with TCP Tx data transfer when TA power save is enabled
  • TCP/UDP TX/RX Data stall observed in CoEx scenarios
  • HTTPS Continuous download fails with TA Power save
  • Low-performance metrics.
  • Data stall when WLAN TCP data transfer, BLE scanning, BLE advertising, and BLE notification are enabled

BLE

  • BLE Range is less with A0/B0 dual flash Radio boards when compared to A0/B0 common flash Radio boards.
  • BLE applications hang after disconnection due to Disable Power save API failure
  • Observing data stall with TCP Tx/Rx when connecting BLE With wifi_throughput_ble_dual_role application.

System

  • None

MCU

  • Refer the respective Radio board user guides for specific pinout details. Example readme's currently refer to A0 board versions
  • IOSTREAM by default works only with 115200 baud rate. To work with different baud rates , undefine the  USART_UC macro in sl_91x..usart.c.
  • SSI bitrate above 10 Mbps is not working as expected.
  • when using SL DMA, UDMA1 is not working as expected
  • SIO-SPI few channels are not working as expected. (working of MOSI & MISO channel 4 and above is inconsistent) 
  • Few peripherals like WDT when configured with RO clock is not working as expected. No impact on the feature but the clocks are not accurate.

Limitations and Unsupported Features

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported
  • In AP mode, IPv6 Router Advertisements are not supported. Although STA connected to the APUT can transfer IPv6 data to the peers by using SLAAC for address configuration.
  • When sl_wifi_enable_target_wakeup_time() API is used, observed occasional MQTT disconnections with longer TWT intervals (>30secs) with embedded MQTT + TWT.
  • AMSDU TX is not supported.
  • Fragmentation is not supported.
  • AMSDUs 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 2.4 GHz band is not supported.
  • 802.11J channel 14 is not supported.
  • MQTT versions 3 and 4 are supported.
  • Maximum of 3 SSL connections are supported in Wi-Fi alone mode.
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • LP mode is not supported.
  • Fine Tuning 802.11ax Spectral mask in Progress
  • Fine Tuning 11b mask in Ch11 in progress
  • In iTWT mode, downlink data traffic should be limited. Disconnections may be observed if AP fails to send all the buffered data in the next TWT Service Period.
  • Number of MBSSIDs processed is limited by the beacon length that can be processed by the stack (which is limited to 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • In A0 SoC mode, M4 power save will work with 384k TA and 320 M4 memory configuration only. It is not supported for "448K TA and 256k M4" and "512k TA and 192k M4" memory configurations
  • Timeout value should be a minimum 1 second for socket select and socket receive calls. Timeout value less than 1 second is not currently supported.
  • M4 OTA update on dual flash will work for same flash sizes only (internal and External).
  • CoEx + EAP Security in 352K/320k is not feasible. This issue is observed due to a lack of memory in the 352k/320k Memory Configuration. It is supported with other EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K memory configurations.
  • UL MUMIMO is not supported.
  • The embedded HTTP server is not supported.
  • SNI is not supported
  • Baremetal is not supported

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • BLE TX/RX throughput is less when tested with EFM as compared to EFR
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections( 1 Central and 1 Peripheral) with AE.
  • Filtering policy is not supported for Periodic advertising.

MCU

  • ULP Peripherals examples configurations are for RAM-based execution, as flash is powered off in ULP Mode
  • On 4338a board, two I2C instances(I2C1 and I2C2) are using same GPIOs ,so support is not there for using two I2C instances simultaneously
  • I2C Fast and High speed mode not supported
  • when using GSPI and SSI, manual chip select option not supported

Simplicity Studio and Commander

  • Default GDB debug configuration is not supported for SoC projects, work around details provided in "Getting-Started-with-SiWx917"
  • Observing flash download failures(ERROR 108) for a few image sizes
  • While creating project through Simplicity Studio, "copy contents" option not supported.
  • Simplicity commander does not support options under "Debug Lock tools" . 

Terminology

Term Description
New Features These items are new to this release
Changes/Issues Fixed Changes made to existing features found in previous software releases.
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 the 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

Note

  • NA

Wi-Fi SDK v3.0.12

WiSeConnect3_SDK_3.0.12 Release Notes

This SDK package supports SoC Mode and NCP Mode for A0 and B0:

  • In SoC Mode: Customer Applications can run on Cortex M4. Wireless, network, and security stacks run on the Wireless subsystem.
  • In NCP mode: Wireless, network, and security stacks run on the Wireless subsystem. Customer applications run on the external host MCU.
  • Silicon Labs' SiWx917 includes an ultra-low power Wi-Fi 6 plus Bluetooth Low Energy (BLE) 5.1 wireless subsystem and an integrated micro-controller application subsystem.

Note: Use Simplicity Studio version SV5.7.0.1 onwards

SoC Highlights

  • Operating Modes : Wi-Fi STA (802.11ax, 802.11n), Wi-Fi 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + 802.11n AP, Wi-Fi STA (802.11ax, 802.11n) + BLE
  • Wireless Protocols : IEEE 802.11b, 802.11g, 802.11n, 802.11ax, BLE 5.1
  • Multiple Ultra Low Power Modes : Support Ultra low power Wi-Fi Standby associated current in Wi-Fi 4 mode, Ultra low power Wi-Fi Standby associated current in Wi-Fi 6 mode leveraging TWT, Always on Cloud connected power, BLE connected power, and, deep sleep ULP mode
  • MCU examples :  GPIO, I2C, Calendar,  SPI, SSI, SIO, UDMA, UART/USART, WDT, Timers, Config Timers, ULP (Ultra Low Power) Timers, Sleeptimer, IOSTREAM, NVM3, MEMLCD.
  • Wi-Fi : 2.4GHz Wi-Fi Support - WPA2/WPA3 Personal, Wi-Fi 6 OFDMA/MU-MIMO Support that enhances network capacity and reduces latency
  • Cloud : Amazon Cloud Connectivity Support, Amazon FreeRTOS
  • BLE : BLE 5.1, BLE dual role (Central and Peripheral Support)
  • Integrated Stacks and Profiles : Wi-Fi Stack, BLE Stack, and Profiles, TCP/IP stack with TLS 1.3, HTTP/HTTPS, DHCP, MQTT Client, DNS client
  • IDE : Simplicity Studio with Windows 10(64-bit), Linux, Mac OS
  • TA/M4 Firmware Update Tool : Simplicity Commander
  • Hardware kits to evaluate SoC Mode :

o   Si-MB4002A Main board

o   SiWx917 Radio boards

RadioBoard Type SiWx917A0 with Board Version SiWx917B0 with Board Version
Common flash Si917-BRD4325A(1.0 /1.1 /1.2) -
Common flash - Si917-BRD4338A(2.0)
Dual flash Si917-BRD4325B(1.0 /1.1 /1.2) -

Release Details

Item Details
Release date Aug 10th, 2023
SDK Version 3.0.12
Firmware Version 1711.2.9.0.0.19
Package Name WiSeConnect3_SDK_3.0.12
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Wi-Fi STA+BLE, Wi-Fi STA+AP
Build Quality Beta

Updating to this Release

  • SiWx917 release consists of two components
    • Wireless Firmware - SiWx917 Firmware Binaries
    • Wiseconnect3 Library - Wiseconnect3 SDK Library runs on internal Cortex M4 in SoC Mode.
  • This release is meant only for use with designs based on SiWx917 Silicon
  • The firmware to load in your design are available in the following format:
    • SiWG917-A.2.9.0.0.x.rps - A0 Full-featured firmware binary
    • SiWG917-B.2.9.0.0.x.rps - B0 Full-featured firmware binary

Features Supported

MCU

  • ADC Single Channel, ADC Static Mode, Analog Comparator, Blinky, Bod, CTS, DAC FIFO, DAC Static, GPIO, I2C, I2S, NVM3, OPAMP, PSRAM, PWM, QEI, RTC, SDIO Slave, SPI Master and Slave, UART, UDMA, USART, WDT, USART Master and Slave
  • UC Supported Peripherals - GPIO, I2C, Calendar,  SPI, SSI, SIO, UDMA, UART/USART, WDT, Timers , Config Timers, ULP (Ultra Low Power) Timers, Sleeptimer, IOSTREAM, MEMLCD
  • ULP (Ultra Low Power) Peripherals - ulp_gpio, ulp_adc ulp_i2c, ulp_i2s, ulp_ir_decoder, ulp_spi, ulp_timer, ulp_uart, ulp_udma

Wi-Fi

  • WPA2/WPA3 Personal, WPS and WPA2-EAP Support for Station Mode
  • TCP/IP stack with IPv4, IPv6, TCP, UDP, TLS, HTTP/HTTPS, DHCPv4, DHCPv6, MQTT Client, DNS Client, SNTP client.
  • Support for SSL client versions TLSV1.0, TLSV1.2, TLSV1.3 and SSL server versions TLSV1.0 and TLSV1.2
  • Wi-Fi STA (802.11n/802.11ax) + 802.11n AP Support
  • HE (802.11ax) and Individual TWT Feature Support
  • Multiple BSSID feature support as an STA
  • Secure OTA support on B0 radio boards.
  • Support for LWIP network stack
  • Support for AWS MQTT library
  • Support for BSD and IoT sockets application programming interface(API)

Bluetooth Low Energy

  • BLE central & peripheral connections are supported.
  • Ultra-low power save is supported in Test Mode to support Tx/Rx performance testing

Power Save

  • The powersave profiles supported are Max PSP, enhanced MAX PSP, and 802.11ax TWT. 

Changes and Fixes

MCU

  • Added project support for 1.2 dual flash and 2.0 boards
  • SIO related bug fixes reported on SIO-USART and SIO-SPI
  • Updated Readme files to provide pin configuration details
  • WDT Example related bug fix

Wi-Fi

  • TWT power number improvements.
  • Added support for Si91X asynchronous sockets
  • Added support for SNTP documentation
  • Updated documentation for SL_SI91X_EXT_FEAT_XTAL_CLK_ENABLE
  • Replacement of convert_string_to_sl_ipv4_address() with sl_net_inet_addr()
  • Updation of sl_net_interface_t enums
  • Added Frontend switch selection in SRM
  • Added timeout fixes for RF test example
  • Added fixes related to socket bind
  • Bug fixes HTTP/HTTPS file download in COEX mode
  • M4 soft reset support in http_otaf example
  • Bug fixes related to certificate loading in COEX mode
  • Bug fixes related to BLE connection in powersave mode
  • Application bug fixes in wifi_wlan_throughput_v6, ble_multiconnection_gatt example
  • Bug fixes related to Wi-Fi rejoins in powersave mode
  • Stability fixes for M4 sleep
  • Support to SiWx917B0 2.0 radio boards
  • Support for Wi-Fi transmission rate for the given 802.11b, 802.11g, and 802.11n protocols.
  • Renaming of access_point, concurrent_mode, aws_mqtt, powersave_standby_associated, select_app, station_ping, lwip_tcp_client, sntp_client application with _soc suffix
  • Fixes MQTT username and password length checks in requests and asynchronous MQTT requests handling
  • Support for functional OFDMA DL/UL.

BLE

  • Fixes application timeouts in the ble_throughput application
  • Support to BLE PER mode

System

  • None

Recommendations

System

  • The current revision of SiWx917 A0 has:
    • RAM memory of 704k bytes which can be shared between TA and M4 processors in NCP/SoC mode. The following memory configuration modes are supported.
      • EXT_FEAT_704K_M4SS_0K- This mode configures TA with 704k and M4 with 0K bytes of memory which is applicable only in the case of NCP mode
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement By Default EXT_FEAT_384K_M4SS_320K configuration will be selected in SoC mode
      • EXT_FEAT_512K_M4SS_192K - This mode configures TA with 512k and M4 with 192K bytes of memory
      • EXT_FEAT_448K_M4SS_256K - This mode configures TA with 448k and M4 with 256K bytes of memory
      • EXT_FEAT_384K_M4SS_320K - This mode configures TA with 384k and M4 with 320K bytes of memory
    • The currently supported memory configuration for NCP mode is 704K_M4SS_0K.
    • SoC mode should not use 704k_M4SS_0k Memory configuration.
    • In SoC mode, M4 power save will work with 384k TA and 320 M4 memory configuration only. It is not supported for "448K TA and 256k M4" and "512k TA and 192k M4" memory configurations.
  • The current revision of SiWx917 B0 has:
    • RAM memory of 672k bytes which can be shared between TA and M4 processors in NCP/SoC mode. The following memory configuration modes are supported.
      • EXT_FEAT_672K_M4SS_0K- This mode configures TA with 672k and M4 with 0K bytes of memory which is applicable only in the case of NCP mode
    • The below configurations are applicable in SoC mode and can be configured based on the application requirement By Default EXT_FEAT_352K_M4SS_320K configuration will be selected in SoC mode
      • EXT_FEAT_480K_M4SS_192K - This mode configures TA with 480k and M4 with 192K bytes of memory
      • EXT_FEAT_416K_M4SS_256K - This mode configures TA with 416k and M4 with 256K bytes of memory
      • EXT_FEAT_352K_M4SS_320K - This mode configures TA with 352k and M4 with 320K bytes of memory
    • The currently supported memory configuration for NCP mode is 672K_M4SS_0K.
    • SoC mode should not use 672k_M4SS_0k Memory configuration.
    • In SoC mode, M4 power save will work with any memory configuration.
  • Set the recommended Power Save Profile (PSP) type to Enhanced Max PSP.

IDE

  • Download the latest Simplicity Studio (SV5.7.0.1)
  • Refer to the latest version of the SoC "Getting-Started-with-SiWx917" guide for more details

Wi-Fi

  • It is recommended to enable bit 16 of the 'Extended TCP IP Feature' bit map in the opermode command for all Wi-Fi Socket Operations from the host to ensure graceful handling during asynchronous closures from the peer.
  • Aggregation (bit 2 of feature_bit_map) is recommended to be enabled in opermode. This enables sw to aggregate multiple packets to achieve better throughput
  • TCP retransmission count value is recommended to be 30 or higher so that the TCP does not disconnect while the rejoin happens.
  • To restart the module, the application needs to call sl_wifi_deinit() followed by sl_wifi_init().
  • 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.
  • User can enable SL_SI91X_EXT_TCP_IP_SSL_16K_RECORD in 'Extended TCP IP Feature'bit map in opermode, if HTTPS download is failing after receiving HTTP headers..
  • iTWT setup is recommended after IP assignment/TCP connection/application connection.
  • When using sl_wifi_enable_target_wakeup_time API, increase TCP / ARP Timeouts at the remote side depending upon the configured TWT interval configured.
  • In case of TWT+coex, when using sl_wifi_enable_target_wakeup_time API, use TWT wake duration <= 16 ms and TWT wake interval >= 1 sec. If wake duration > 16 ms or TWT wake interval < 1sec, there might be performance issues.
  • For iTWT GTK Interval Should be kept max possible value or zero. If GTK interval is not configurable, recommended TWT interval (in case of sl_wifi_enable_target_wakeup_time API) 
  • Disable Power Save for High Throughput Applications.
  • The application needs to ensure that it sets RTC with the 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 of less than 1 second is not currently supported.
  • When sl_wifi_enable_target_wakeup_time API is used, configuring TWT Wake interval beyond 1 min might lead to disconnections from the AP. Recommended to use TWT wakeup interval of less than or equal to 1 min.
  • MQTT keep alive interval should be either 0 or a value greater than 35 seconds.
  • When using sl_wifi_enable_target_wakeup_time API, it is recommended to set missed_beacon_count of sl_wifi_set_advanced_client_configuration API greater than 2 times of the configured TWT Interval.
  • Secure OTA: Keys need to be programmed before validating Secure OTA

BLE

  • In BLE, recommended range of Connection Interval in
    • Power Save (BLE Only) - 100 ms to 1.28 s.
  • In BLE, during Connection, the configuration of Scan Interval and Scan Window with the same value is not recommended. The suggested ratio of Scan Window to Scan Interval is 3:4.
  • In BLE, if a device is acting as Central, the scan window (in set_scan_params and create_connection commands) must be less than the existing Connection Interval. The suggested ratio of Scan Window to Connection Interval is 2:3.
  • In BLE mode, if scanning and advertising are in progress on the SiWx91x module and it subsequently gets connected and moves to the central role, scanning stops else if it moves to the peripheral role, advertising stops. To further establish a connection to another peripheral device or to a central device, the application should give a command for starting advertising and scanning again.

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.

Known Issues

Network Stack

  • Sometimes during SSL Handshake, ECC curve parameters generated are wrong, resulting in connection failure with BBD2 error. However, this recovers in the next attempt.
  • Recommended MQTT Publish payload is 1 kBytes.
  • 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.

Wi-Fi

  • Device with active TWT will not go to sleep when the buffer is full.
  • There are performance and IOP issues with MU MIMO.
  • WPA3 connection takes 2.5 seconds.
  • Issue observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.
  • EAP connection with certificates of 4096-bit key length is not supported.
  • Low Wi-Fi+BLE throughput
  • Data stall and disconnection with TCP Tx data transfer when TA power save is enabled
  • TCP/UDP TX/RX Data stall observed in CoEx scenarios
  • HTTPS Continuous download fails with TA Power save
  • HTTP get and post are not working from the second iteration i.e., upon WLAN reconnection
  • Low-performance metrics.

BLE

  • BLE Range is less with A0/B0 dual flash Radio boards when compared to A0/B0 common flash Radio boards.
  • Wireless Init failure observed in BLE Central application with (352k,320k) configuration
  • BLE applications hang after disconnection due to Disable Power save API failure

System

  • None

MCU

  • Refer the respective Radio board user guides for specific pinout details. Example readme's currently refer to A0 board versions
  • IOSTREAM by default works only with 115200 baud rate. To work with different baud rates , undefine the  USART_UC macro in sl_91x..usart.c.
  • SSI bitrate above 10 Mbps is not working as expected.
  • when using SL DMA, UDMA1 is not working as expected
  • SIO-SPI few channels are not working as expected. (working of MOSI & MISO channel 4 and above is inconsistent) 
  • Few peripherals like WDT when configured with RO clock is not working as expected. No impact on the feature but the clocks are not accurate.

Limitations and Unsupported Features

Wi-Fi/Network Stack

  • TLS 1.3 Server is not supported
  • In AP mode, IPv6 Router Advertisements are not supported. Although STA connected to the APUT can transfer IPv6 data to the peers by using SLAAC for address configuration.
  • When sl_wifi_enable_target_wakeup_time() API is used, observed occasional MQTT disconnections with longer TWT intervals (>30secs) with embedded MQTT + TWT.
  • AMSDU TX is not supported.
  • Fragmentation is not supported.
  • AMSDUs 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 2.4 GHz band is not supported.
  • 802.11J channel 14 is not supported.
  • MQTT versions 3 and 4 are supported.
  • Maximum of 3 SSL connections are supported in Wi-Fi alone mode.
  • In SSL ECC Curve ID supported is 23. SSL handshake with 3rd party clients depends on the SSL ECC Curve ID.
  • LP mode is not supported.
  • Fine Tuning 802.11ax Spectral mask in Progress
  • Fine Tuning 11b mask in Ch11 in progress
  • In iTWT mode, downlink data traffic should be limited. Disconnections may be observed if AP fails to send all the buffered data in the next TWT Service Period.
  • Number of MBSSIDs processed is limited by the beacon length that can be processed by the stack (which is limited to 1024 bytes). Beacons greater than 1024 Bytes in length will not be processed.
  • In A0 SoC mode, M4 power save will work with 384k TA and 320 M4 memory configuration only. It is not supported for "448K TA and 256k M4" and "512k TA and 192k M4" memory configurations
  • Timeout value should be a minimum 1 second for socket select and socket receive calls. Timeout value less than 1 second is not currently supported.
  • M4 OTA update on dual flash will work for same flash sizes only (internal and External).
  • CoEx + EAP Security in 352K/320k is not feasible. This issue is observed due to a lack of memory in the 352k/320k Memory Configuration. It is supported with other EXT_FEAT_416K_M4SS_256K and EXT_FEAT_480K_M4SS_192K memory configurations.
  • UL MUMIMO is not supported.
  • The embedded HTTP server is not supported.
  • SNI is not supported
  • Baremetal is not supported

BLE

  • For BLE, if the connection is established with a small connection interval (less than 15 ms), simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported.
  • BLE maximum two concurrent connections are supported, which can be either a connection to two peripheral devices, to one central and one peripheral device or two central devices.
  • BLE Slave latency value is valid up to 32 only.
  • BLE TX/RX throughput is less when tested with EFM as compared to EFR
  • Maximum supported AE data length is 200 bytes.
  • Supports only two ADV_EXT sets.
  • Supports only two BLE connections( 1 Central and 1 Peripheral) with AE.
  • Filtering policy is not supported for Periodic advertising.

MCU

  • ULP Peripherals examples configurations are for RAM-based execution, as flash is powered off in ULP Mode
  • On 4338a board, two I2C instances(I2C1 and I2C2) are using same GPIOs ,so support is not there for using two I2C instances simultaneously
  • I2C Fast and High speed mode not supported
  • when using GSPI and SSI, manual chip select option not supported

Simplicity Studio and Commander

  • Default GDB debug configuration is not supported for SoC projects, work around details provided in "Getting-Started-with-SiWx917"
  • Observing flash download failures(ERROR 108) for a few image sizes
  • While creating project through Simplicity Studio, "copy contents" option not supported.
  • Simplicity commander does not support options under "Debug Lock tools" . 

Terminology

Term Description
New Features These items are new to this release
Changes/Issues Fixed Changes made to existing features found in previous software releases.
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 the 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

Note

  • NA

WiSeConnect3_SDK_3.0.10 Release Notes

This SDK package supports SoC Mode only.

  • In SoC Mode: Customer Applications can run on Cortex M4 and Wireless stacks, Networking stacks run on the Wireless subsystem.
  • Silicon Labs SiWx917 includes an ultra-low power Wi-Fi 6 plus Bluetooth Low Energy (BLE) 5.4 wireless subsystem and an integrated micro-controller application subsystem.

Note: The release supports only Simplicity Studio 5.7 & above versions.

Highlights

  • Operating Modes: Wi-Fi STA, Wi-Fi AP, Concurrent (AP + STA), Wi-Fi STA+BLE (CoEx)
  • Wireless Protocols: IEEE 802.11b, 802.11g, 802.11n, 802.11ax, BLE 5.4
  • MCU Peripherals: ADC Static Mode, Analog Comparator, Bod, CTS, DAC FIFO, DAC Static, OPAMP, GPIO, I2C, I2S, PWM, RTC, QEI, SPI, UART, USART, UDMA, WDT
    • ULP (Ultra Low Power) Peripherals: ulp_gpio, ulp_i2c, ulp_i2s, ulp_ir_decoder, ulp_spi, ulp_timer, ulp_uart, ulp_udma
    • UART and I2C Deep Sleep Wakeup Without RAM Retention
  • Multiple Ultra Low Power Modes: Wi-Fi 6 TWT (Target Wake Time) - for improved network efficiency and device battery life
  • Wi-Fi: 2.4GHz Wi-Fi Support - WPA2/WPA3 Personal, Wi-Fi 6 OFDMA/MU-MIMO Support that enhances network capacity and latency
  • Cloud: Amazon Cloud Connectivity Support
  • BLE: BLE 5.4, BLE dual role (Central and Peripheral Support)
  • Integrated Stacks and Profiles: Wi-Fi Stack, BLE Stack and Profiles, TCP/IP stack with TLS 1.3, HTTP/HTTPS, DHCP, MQTT Client, SNTP Client, DNS Client
  • IDE: Simplicity Studio with Windows 10 (64-bit), Linux, MacOS
  • TA/M4 Firmware Update Tool: Simplicity Commander
  • Hardware kits to evaluate SoC Mode: Si917-BRD4325A (Common Flash Radio board), Si917-BRD4325B (Dual Flash Radio board), Si917-BRD4325G (Common Flash Radio board + extended PSRAM)

Release Details

Item Details
Release date July 27th, 2023
SDK Version 3.0.10(Build 1)
Firmware Version 2.9.0.0.15
Package Name WiSeConnect3_SDK_3.0.10
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Concurrent(AP + STA), Wi-Fi STA+BLE(CoEx)
Build Quality pre-beta

Updating to this Release

This release includes the Wireless Library, which operates on the internal Cortex M4 in SoC Mode.

Features and Bug Fixes

  • Added support for command line interface application (cli_demo).
  • IOSTREAM support has been integrated into GSDK 4.3.1.

Known Issues

  • I2C High-Speed mode is not working as expected.
  • SSI bitrate above 10 Mbps is not working as expected.
  • DUT is getting hanged while continuously publishing data in the embedded MQTT application during power save mode.
  • BLE notification and Continuous BG scan are not working as expected.
  • BLE radio's range of 4-5m for BRD4325B A02 boards, .
  • Intermittent Bus thread hang issue with LWIP external stack.
  • The "Browser File Viewer" plugin has issues. It can't render the last image included in the markdown files and has observed issues accessing some hyperlinks.
  • Known issues in ble per and wlan rf features
  • Data rates are not effecting on the dut with 11b, 11g, 11n modes.
  • BLE connection is not happening when power save is enabled in BLE-Central application

SOC

  • In SoC mode, M4 power save will only work with the 384k TA and 320 M4 memory configuration. It is not supported for "448K TA and 256k M4" and "512k TA and 192k M4" memory configurations.

Wi-Fi

  • WPA3 connection takes 2.5 seconds more than WPA2 connection.
  • An issue has been observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

Network Stack

BLE

  • 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.
  • LMP timeout BLE disconnection has been observed with the latest Realme mobile handsets.

Limitations and Unsupported Features

Wi-Fi/Network Stack Limitations

  • Throughput is not on par with WiSeConnect 2 in the present release.
  • A maximum of 3 SSL connections is supported in WiFi alone mode.
  • TWT is not verified in Coex mode.
  • BGscan is not verified with the TWT feature.

SoC Limitations

  • SIO currently supports SPI and UART.
  • Peripherals currently use UDMA CMSIS driver.

BLE Limitations

  • For BLE, simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported if the connection is established with a small connection interval (less than 15 ms).
  • BLE supports a maximum of two concurrent connections, which can be either a connection to two peripheral devices, one central and one peripheral device, or two central devices.
  • The BLE Slave latency value is valid up to 32 only.

Unsupported Features

  • SNI (HTTPS, TLS/SSL).
  • Keep Alive configurability.
  • Console application for customers.
  • Multi-threaded APIs.
  • 917-specific features (debugging utilities).
  • APIs for Crypto Hardware (ECDH, DH, SHA, AES), Calibration software & stats.
  • SoC Support (Hosted mode): support for switching between internal & external stack in SS.
  • Protocols Offload mode: HTTP Server (917 specific), DHCPv6 Server, SNMP, Socket reads up to 64k, POP3, DTLS, mDNS, Web Socket, DNS Server.
  • Power save support (Message-based).
  • PTA Coexistence with other wireless.
  • Baremetal support.
  • Asynchronous socket APIs.
  • NCP support (SPI, SDIO, UART, Linux, 3rd-party hosts).

Terminology

Term Description
New Features These items are new to this release
Changes/Issues Fixed Changes made to existing features found in previous software releases.
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 the 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

WiSeConnect3_SDK_3.0.9 Release Notes

This SDK package supports SoC Mode only.

  • In SoC Mode: Customer Applications can run on Cortex M4 and Wireless stacks and Networking stacks run on the Wireless subsystem.
  • Silicon Labs SiWx917 includes an ultra-low power Wi-Fi 6 plus Bluetooth Low Energy (BLE) 5.1 wireless subsystem and an integrated micro-controller application subsystem.

Note: To run the application, please install the GSDK patch following the instructions below:

  • Install GSDK version 4.3.0.
  • Open your terminal application.
  • Go to your GSDK path and enter the following command: git apply --ignore-whitespace --ignore-space-change "extension/wiseconnect3/utilities/gsdk_service_patch/gsdk_service.patch"

Note: The git apply command needs to be run to apply a GSDK patch not available with the current WiSeConnect 3 release.

  • Now you should be able to build and run Dx sample applications.

Note: The release supports only Simplicity Studio 5.7 & above versions.

SoC Highlights

  • Operating Modes: Wi-Fi STA, Wi-Fi AP, Concurrent (AP + STA), Wi-Fi STA+BLE (CoEx)
  • Wireless Protocols: IEEE 802.11b, 802.11g, 802.11n, 802.11ax, BLE 5.1
  • MCU Peripherals: ADC Static Mode, Analog Comparator, Blinky, Bod, CTS, DAC FIFO, DAC Static, OPAMP, GPIO, I2C, I2S, PWM, RTC, QEI, SPI, UART, USART, UDMA, WDT, Combined Peripheral App
    • ULP (Ultra Low Power) Peripherals: ulp_gpio, ulp_i2c, ulp_i2s, ulp_ir_decoder, ulp_spi, ulp_timer, ulp_uart, ulp_udma
    • UART and I2C Deep Sleep Wakeup Without RAM Retention
  • Multiple Ultra Low Power Modes: Wi-Fi 6 TWT (Target Wake Time) - for improved network efficiency and device battery life
  • Wi-Fi: 2.4GHz Wi-Fi Support - WPA2/WPA3 Personal, Wi-Fi 6 OFDMA/MU-MIMO Support that enhances network capacity and latency
  • Cloud: Amazon Cloud Connectivity Support
  • BLE: BLE 5.1, BLE dual role (Central and Peripheral Support)
  • Integrated Stacks and Profiles: Wi-Fi Stack, BLE Stack and Profiles, TCP/IP stack with TLS 1.3, HTTP/HTTPS, DHCP, MQTT Client, SNTP Client
  • IDE: Simplicity Studio with Windows 10 (64-bit)
  • TA/M4 Firmware Update Tool: Simplicity Commander
  • Hardware kits to evaluate SoC Mode: Si917-BRD4325A (Common flash Radio board), Si917-BRD4325B (Dual flash Radio board), Si917-BRD4325G (Common Flash Radio board + extended PSRAM)

Release Details

Item Details
Release date July 10th, 2023
API Version 3.0.9(Build 1)
Firmware Version 2.9.0.0.8
Package Name WiSeConnect3_SDK_3.0.9
Supported RTOS FreeRTOS
Operating Modes Supported Wi-Fi STA, Wi-Fi AP, Concurrent(AP + STA), Wi-Fi STA+BLE(CoEx)

Updating to this Release

This release includes the Wireless Library, which operates on the internal Cortex M4 in SoC Mode.

Features and Bug Fixes

  • Supported DX Peripherals: Calendar, ULP Timer, GSPI, SSI, GPIO, I2C, Watchdog Timer, DMA, USART, Config Timer, SIO.
  • Supported Services: Sleeptimer, IOStream, NVM3.
  • Added support for IPv6.
  • Added support for FreeRTOS.
  • Added support for LWIP stack.
  • Added support for AWS MQTT library.
  • Added support for EAP-FAST and EAP-PEAP.
  • Added support for 802.11ax protocol & TWT.
  • Added support for TCP, UDP, TLS/SSL sockets.
  • Added support for TA & M4 Powersave profiles.
  • Added Support for Common & dual Flash radio boards.
  • Added support for multi-threaded application development.
  • Added support for WPA2/WPA3 Personal, Enterprise security in station Mode.
  • Added support for BSD and IoT socket application programming interface (API).
  • Added support for Network Application protocol for Offloaded mode (TCP/IP internal stack) with HTTP/HTTPS, DHCP, MQTT Client, DNS Client, SNTP Client.
  • Added support for Bluetooth Low Energy (BLE) central & peripheral connections.
  • Added support for Wireless firmware upgradation (OTA).
  • Added support for Platform-agnostic Wi-Fi, Network APIs.
  • Added API documentation, migration guide, Getting Started Guide.

Known Issues

  • B0 (V2.0) support will be provided in subsequent releases.
  • I2C High-Speed mode is not working as expected.
  • SSI bitrate above 10 Msps is not working as expected.
  • Powersave Deepsleep is not working as expected on Common Flash B0 Board.
  • DUT is getting hanged while continuously publishing data in the embedded MQTT application during power save mode.
  • BLE notification and Continuous BG scan are not working as expected.
  • Ongoing efforts to update the readme file are in progress.
  • The "Browser File Viewer" plugin has issues. It can't render the last image included in the markdown files and has observed issues accessing some hyperlinks.

SOC

  • In SoC mode, M4 power save will only work with the 384k TA and 320 M4 memory configuration. It is not supported for "448K TA and 256k M4" and "512k TA and 192k M4" memory configurations.

Wi-Fi

  • WPA3 connection takes 2.5 seconds more than WPA2 connection.
  • An issue has been observed with WPA2 Enterprise Connectivity using Microsoft RADIUS Server.

Network Stack

BLE

  • 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.
  • LMP timeout BLE disconnection has been observed with the latest Realme mobile handsets.

Limitations and Unsupported Features

Wi-Fi/Network Stack Limitations

  • Throughput is not on par with WiSeConnect 2 in the present release.
  • A maximum of 3 SSL connections is supported in WiFi alone mode.
  • TWT is not verified in Coex mode.
  • BGscan is not verified with the TWT feature.

SoC Limitations

  • SIO currently supports SPI and UART.
  • Peripherals currently use UDMA CMSIS driver.

BLE Limitations

  • For BLE, simultaneous roles (i.e., Central + Scanning and Peripheral + Advertising) are not supported if the connection is established with a small connection interval (less than 15 ms).
  • BLE supports a maximum of two concurrent connections, which can be either a connection to two peripheral devices, one central and one peripheral device, or two central devices.
  • The BLE Slave latency value is valid up to 32 only.

Unsupported Features

  • SNI (HTTPS, TLS/SSL).
  • Keep Alive configurability.
  • Console application for customers.
  • Multi-threading support for relevant APIs.
  • 917-specific features (debugging utilities).
  • APIs for Crypto Hardware (ECDH, DH, SHA, AES), Calibration software & stats.
  • SoC Support (Hosted mode): support for switching between internal & external stack in SS.
  • Protocols Offload mode: HTTP Server (917 specific), DHCPv6 Server, SNMP, Socket reads up to 64k, POP3, DTLS, mDNS, Web Socket, DNS Server.
  • Power save support (Message-based).
  • PTA Coexistence with other wireless.
  • Baremetal support.
  • Asynchronous socket APIs.
  • NCP support (SPI, SDIO, UART, Linux, 3rd-party hosts).

Terminology

Term Description
New Features These items are new to this release
Changes/Issues Fixed Changes made to existing features found in previous software releases.
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 the 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