Radio#

sl_wifi_get_max_tx_power#

sl_status_t sl_wifi_get_max_tx_power (sl_wifi_interface_t interface, sl_wifi_max_tx_power_t * max_tx_power)

Get the maximum Wi-Fi transmit power.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

Note

• This function gets the transmit power for a particular radio interface: SL_WIFI_2_4GHZ_INTERFACE.

sl_wifi_set_max_tx_power#

sl_status_t sl_wifi_set_max_tx_power (sl_wifi_interface_t interface, sl_wifi_max_tx_power_t max_tx_power)

Set the maximum Wi-Fi transmit power.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

Note

• This function sets the transmit power for a particular radio interface: SL_WIFI_2_4GHZ_INTERFACE. Eg: Setting transmit power for client interface at 2.4 GHz will also set transmit power of the AP interface at 2.4 GHz.

• The effective transmit power is subject to regional and device limitations. If the specified transmit power exceeds the maximum supported value for that region, the transmission occurs at the maximum supported transmit power.

sl_wifi_set_rts_threshold#

sl_status_t sl_wifi_set_rts_threshold (sl_wifi_interface_t interface, uint16_t rts_threshold)

Set the Request to Send (RTS) threshold for the specified Wi-Fi interface.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_get_rts_threshold#

sl_status_t sl_wifi_get_rts_threshold (sl_wifi_interface_t interface, uint16_t * rts_threshold)

Get the current Request to Send (RTS) threshold for the specified Wi-Fi interface.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_set_mfp#

sl_status_t sl_wifi_set_mfp (sl_wifi_interface_t interface, const sl_wifi_mfp_mode_t config)

Set the Management Frame Protection (MFP) mode for the specified Wi-Fi interface.

Note

• This API needs to be called before sl_wifi_connect

• This API is currently supported only in STA mode.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_get_mfp#

sl_status_t sl_wifi_get_mfp (sl_wifi_interface_t interface, sl_wifi_mfp_mode_t * config)

Get the Management Frame Protection (MFP) mode for the specified Wi-Fi interface.

Note

• This API is currently supported only in STA mode.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_set_antenna#

sl_status_t sl_wifi_set_antenna (sl_wifi_interface_t interface, sl_wifi_antenna_t antenna)

Set the Wi-Fi antenna for an interface.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_get_antenna#

sl_status_t sl_wifi_get_antenna (sl_wifi_interface_t interface, sl_wifi_antenna_t * antenna)

Get the Wi-Fi antenna for an interface.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_get_channel#

sl_status_t sl_wifi_get_channel (sl_wifi_interface_t interface, sl_wifi_channel_t * channel)

Get the current channel for the given Wi-Fi interface.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_set_channel#

sl_status_t sl_wifi_set_channel (sl_wifi_interface_t interface, sl_wifi_channel_t channel)

Set the channel for the given Wi-Fi Access Point interface.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_set_transmit_rate#

sl_status_t sl_wifi_set_transmit_rate (sl_wifi_interface_t interface, sl_wifi_rate_protocol_t rate_protocol, sl_wifi_rate_t mask)

Set the Wi-Fi transmit rate for the given 802.11 protocol on the specified Wi-Fi interface.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

  • In AP mode, this API should be called before sl_net_wifi_ap_up. This configured data rate is passed as part of the AP configuration while bringing up the AP interface.

  • In Wi-Fi client mode, this API should be called after sl_wifi_connect.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

Note

• Only 1 and 2 Mbps rates are allowed in channel 14.

sl_wifi_get_transmit_rate#

sl_status_t sl_wifi_get_transmit_rate (sl_wifi_interface_t interface, sl_wifi_rate_protocol_t * rate_protocol, sl_wifi_rate_t * mask)

Get the Wi-Fi transmit rate for the given 802.11 protocol on the specified Wi-Fi interface.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_set_listen_interval#

sl_status_t sl_wifi_set_listen_interval (sl_wifi_interface_t interface, sl_wifi_listen_interval_t listen_interval)

Set the Wi-Fi client interface listen interval.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

Note

• By default listen interval is set 1000 millisecs. User can call this API to overwrite the value.

• Moving forward, this API will be deprecated. Instead, use the sl_wifi_set_listen_interval_v2 API. This is retained for backward compatibility. Si91X implementation allows this API ONLY to be called before calling sl_wifi_connect(), sl_wifi_start_ap(), sl_wifi_start_wps()

sl_wifi_set_listen_interval_v2#

sl_status_t sl_wifi_set_listen_interval_v2 (sl_wifi_interface_t interface, sl_wifi_listen_interval_v2_t listen_interval)

Set the Wi-Fi client interface listen interval and listen interval multiplier.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

Note

• By default listen interval is set 1000 millisecs and listen interval multiplier is set to 1. User can call this API to overwrite the values for listen interval and listen interval multiplier. Recommended max value for listen_interval_multiplier is 10. Higher value may cause interop issues. Si91X implementation allows this API ONLY to be called before calling sl_wifi_connect(), sl_wifi_start_ap(), sl_wifi_start_wps()

sl_wifi_get_listen_interval#

sl_status_t sl_wifi_get_listen_interval (sl_wifi_interface_t interface, sl_wifi_listen_interval_t * listen_interval)

Get the Wi-Fi client listen interval.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

Note

• By default, the listen interval is set to 1000 millisecs.

• Moving forward, this API will be deprecated. Instead, use the sl_wifi_get_listen_interval_v2 API. This is retained for backward compatibility.

sl_wifi_get_listen_interval_v2#

sl_status_t sl_wifi_get_listen_interval_v2 (sl_wifi_interface_t interface, sl_wifi_listen_interval_v2_t * listen_interval)

Get the Wi-Fi client listen interval and listen interval multiplier.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

Note

• By default, the listen interval is set to 1000 millisecs and listen interval multiplier is set to 1.

sl_wifi_update_gain_table#

sl_status_t sl_wifi_update_gain_table (uint8_t band, uint8_t bandwidth, const uint8_t * payload, uint16_t payload_length)

Assign the user configurable channel gain table entries in different regions to the module from the user.

This function overwrites the default gain tables present in the firmware. Customers can load gain tables for 2.4 GHz-20 MHz. This is a blocking API.

Returns

• sl_status_t. See Status Codes and Additional Status Codes for details..

• Pre-conditions: sl_wifi_init should be called before this API.

Note

• This API is deprecated and retained only for backward compatibility. Instead, use the sl_wifi_update_su_gain_table API. For IC parts: This function is applicable in Transmit test mode (SL_WIFI_TRANSMIT_TEST_MODE) and end-to-end modes. Use this function only in devices for which you have completed FCC, CE (ETSI), MIC (TELEC), KC (KCC) certification with your own antenna. Silicon Labs disclaims any liability for non-compliant use of this function that could breach those or any other regulatory certifications. To enforce regulatory transmit power limits (FCC, CE (ETSI), MIC (TELEC), KC (KCC)):

  • Load the region-specific maximum power values at every boot using the sl_wifi_update_gain_table() API.

  • Because the firmware does not retain this information in flash memory, the application must invoke this API at every startup.

  • The provided region-based user gain table is copied into the firmware’s region-based table.

  • The device then uses this table to cap transmit power and ensure compliance with the allowed limits. Below are the default gain tables:

  • Si917 IC (SiWx917Mxxxxx) OPNs:
    Number of regions: 4

    Region	Number of channels	Channel	11b	11g	11n	11ax
    FCC	0xB
    		1	33	24	21	20
    		2	34	28	28	24
    		3	40	30	32	30
    		4	40	33	36	31
    		5	40	35	36	32
    		6	40	35	36	31
    		7	40	34	36	30
    		8	38	32	36	32
    		9	38	34	34	28
    		10	34	30	30	22
    		11	34	24	22	20
    ETSI	0x11
    		255	36	36	36	24
    TELEC	0x24
    		2	34	28	32	24
    		10	34	36	36	24
    		13	34	26	24	24
    		14	36	0	0	0
    KCC	0x11
    		255	36	36	36	36

For module parts: This function is applicable in Transmit test mode only. This API will return SL_STATUS_SI91X_FEATURE_NOT_AVAILABLE unless the module is set in SL_SI91X_TRANSMIT_TEST_MODE. On boot, Worldsafe gain entries are applied by default. These values are derived by taking the minimum gains across all supported regional regulatory limit tables to ensure global compliance. During AP association, the device may automatically switch to region-specific transmit power limits based on the AP's Country IE. If the AP does not include a Country IE, the device continues to operate using the Worldsafe region settings. FCC, ISED, and NCC share a common set of gain entries. CE (ETSI), UKCA, ACMA, and RSM also share a common set of gain entries. Below are the default gain tables:

• Si917 Module (SiWx917Yxxxxxx) OPNs:
  Number of regions: 6

  Region	Number of channels	Channel	11b	11g	11n	11ax
  FCC	0x29
  		1	30	20	20	18
  		2	36	26	26	22
  		3	40	30	30	26
  		4	40	36	36	32
  		7	40	40	40	36
  		8	40	36	34	36
  		9	40	34	32	28
  		10	36	30	28	20
  		11	30	20	18	16
  ETSI	0x11
  		255	24	28	28	14
  TELEC	0x24
  		1	28	28	26	16
  		12	28	36	36	16
  		13	28	26	26	16
  		14	28	0	0	0
  KCC	0x11
  		255	36	36	36	36
  WORLDSAFE	0x24
  		1	24	20	20	14
  		2	24	26	26	14
  		10	24	28	28	14
  		11	24	20	18	14
  SRRC	0x24
  		1	26	20	20	14
  		2	26	26	26	14
  		10	26	30	30	14
  		13	26	20	20	14

sl_wifi_update_su_gain_table#

sl_status_t sl_wifi_update_su_gain_table (uint8_t band, uint8_t bandwidth, const uint8_t * payload, uint16_t payload_length, uint8_t x_offset, uint8_t y_offset)

Assign the user configurable channel gain table entries in different regions to the module from the user including 11ax SU and 11ax TB.

This function overwrites the default gain tables present in the firmware. Customers can load gain tables for 2.4 GHz-20 MHz. This is a blocking API.

Returns

• sl_status_t. See Status Codes and Additional Status Codes for details.

• Pre-conditions: sl_wifi_init should be called before this API.

Note

• For IC parts: This function is applicable in Transmit test mode (SL_WIFI_TRANSMIT_TEST_MODE) and end-to-end modes. Use this function only in devices for which you have completed FCC, CE (ETSI), MIC (TELEC), KC (KCC) certification with your own antenna. Silicon Labs disclaims any liability for non-compliant use of this function that could breach those or any other regulatory certifications. To enforce regulatory transmit power limits (FCC, CE (ETSI), MIC (TELEC), KC (KCC)):

  • Load the region-specific maximum power values at every boot by using the sl_wifi_update_su_gain_table() API.

  • Because the firmware does not retain this information in flash memory, the application must invoke this API at every startup.

  • The provided region-based user gain table is copied into the firmware’s region-based table.

  • The device then uses this table to cap transmit power and ensure compliance with the allowed limits. Below are the default gain tables:

  • Si917 IC (SiWx917Mxxxxx) OPNs:
    Number of regions: 4

    Region	Number of channels	Channel	11b	11g	11n	11ax(SU)	11ax(TB)
    FCC	0xB
    		1	32	22	22	20	14
    		2	32	26	26	24	20
    		3	34	28	28	26	30
    		4	36	34	32	30	32
    		5	36	34	34	32	32
    		6	36	36	36	34	34
    		7	36	34	34	32	28
    		8	36	32	32	30	28
    		9	36	30	30	28	28
    		10	32	28	28	24	14
    		11	32	22	22	20	14
    ETSI	0x11
    		255	34	36	36	36	24
    TELEC	0x22
    		13	34	38	36	36	24
    		14	38	0	0	0	0
    WORLDSAFE	0x25
    		1	32	22	22	20	14
    		2	32	26	26	24	20
    		11	32	22	22	20	14
    		13	34	36	36	36	24
    		14	38	0	0	0	0

For module parts: This function is applicable in Transmit test mode only. This API will return SL_STATUS_SI91X_FEATURE_NOT_AVAILABLE unless the module is set in SL_SI91X_TRANSMIT_TEST_MODE. On boot, Worldsafe gain entries are applied by default. These values are derived by taking the minimum gains across all supported regional regulatory limit tables to ensure global compliance. During AP association, the device may automatically switch to region-specific transmit power limits based on the AP's Country IE. If the AP does not include a Country IE, the device continues to operate using the Worldsafe region settings. FCC, ISED, and NCC share a common set of gain entries. CE (ETSI), UKCA, ACMA, and RSM also share a common set of gain entries.

Below are the default gain tables:

• Si917 Module (SiWx917Yxxxxxx) OPNs:
  Number of regions: 6

  Region	Number of channels	Channel	11b	11g	11n	11ax(SU)	11ax(TB)
  FCC	0x29
  		1	30	20	20	18	18
  		2	36	26	26	22	22
  		3	40	30	30	26	26
  		4	40	36	36	32	32
  		7	40	40	40	36	36
  		8	40	36	34	36	36
  		9	40	34	32	28	28
  		10	36	30	28	20	20
  		11	30	20	18	16	16
  ETSI	0x11
  		255	24	28	28	14	14
  TELEC	0x24
  		1	28	28	26	16	16
  		12	28	36	36	16	16
  		13	28	26	26	16	16
  		14	28	0	0	0	0
  KCC	0x11
  		255	36	36	36	36	36
  WORLDSAFE	0x24
  		1	24	20	20	14	14
  		2	24	26	26	14	14
  		10	24	28	28	14	14
  		11	24	20	18	14	14
  SRRC	0x24
  		1	26	20	20	14	14
  		2	26	26	26	14	14
  		10	26	30	30	14	14
  		13	26	20	20	14	14

sl_wifi_set_11ax_config#

sl_status_t sl_wifi_set_11ax_config (uint8_t guard_interval)

Configure the 11ax params.

This is a blocking API.

• Pre-conditions:

  • This API should be called before sl_wifi_connect

Returns

• sl_status_t. See https://docs.silabs.com/gecko-platform/latest/platform-common/status for details.

sl_wifi_transmit_test_start#

sl_status_t sl_wifi_transmit_test_start (sl_wifi_interface_t interface, const sl_wifi_transmitter_test_info_t * tx_test_info)

Start the transmit test.

This function starts the transmit test using the provided configuration.

This is a blocking API.

This API is relevant in PER mode

• -Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See [Status Codes] (https://docs.silabs.com/gecko-platform/latest/platform-common/status) and [Additional Status Codes] (../wiseconnect-api-reference-guide-err-codes/sl-additional-status-errors) for details.

Note

• Before starting Continuous Wave mode, user must start Continuous mode with power and channel values that are intended to be used in Continuous Wave mode i.e.
  

  • Start Continuous mode with intended power value and channel values - Pass any valid values for rate and length.

  • Stop Continuous mode

  • Start Continuous Wave mode

• If user wants to switch continuous wave mode, first need to stop the per mode and again need to give continuous wave mode which user wants to switch.

sl_wifi_transmit_test_stop#

sl_status_t sl_wifi_transmit_test_stop (sl_wifi_interface_t interface)

Stop the transmit test.

This function stops the ongoing transmit test on the Si91x device.

This is a blocking API.

This API is relevant in PER mode.

• -Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See [Status Codes] (https://docs.silabs.com/gecko-platform/latest/platform-common/status) and [Additional Status Codes] (../wiseconnect-api-reference-guide-err-codes/sl-additional-status-errors) for details.

Note

• User should configure a minimum delay (approx. 10 milliseconds) before and after sl_wifi_transmit_test_start API to observe a stable output at requested dBm level.

sl_wifi_frequency_offset#

sl_status_t sl_wifi_frequency_offset (sl_wifi_interface_t interface, const sl_wifi_freq_offset_t * frequency_calibration)

Provide feedback of frequency error in KHz.

This function provides feedback of the frequency error in KHz. The frequency error is specified using the sl_wifi_freq_offset_t structure.

This is a blocking API.

• -Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

• sl_status_t. See [Status Codes] (https://docs.silabs.com/gecko-platform/latest/platform-common/status) and [Additional Status Codes] (../wiseconnect-api-reference-guide-err-codes/sl-additional-status-errors) for details.

sl_wifi_dpd_calibration#

sl_status_t sl_wifi_dpd_calibration (sl_wifi_interface_t interface, const sl_wifi_dpd_calib_data_t * dpd_calib_data)

Update Flash/EFuse DPD data.

This function updates the Flash/EFuse DPD (Digital Pre-Distortion) data using the provided DPD calibration data.

This is a blocking API.

• -Pre-conditions:

  • sl_wifi_init and sl_wifi_transmit_test_start should be called before this API.

Returns

• sl_status_t. See [Status Codes] (https://docs.silabs.com/gecko-platform/latest/platform-common/status) and [Additional Status Codes] (../wiseconnect-api-reference-guide-err-codes/sl-additional-status-errors) for details.

Note

• In FCC-certified modules, this API will trigger an error SL_STATUS_SI91X_FEATURE_NOT_AVAILABLE if used, except when in SL_WIFI_TRANSMIT_TEST_MODE mode.