Power and Performance#

sl_wifi_set_performance_profile#

sl_status_t sl_wifi_set_performance_profile (const sl_wifi_performance_profile_t * profile)

Set Wi-Fi performance profile.

• 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

• For SI91x chips Enhanced MAX PSP is supported when profile is set to ASSOCIATED_POWER_SAVE_LOW_LATENCY and SL_WIFI_ENABLE_ENHANCED_MAX_PSP bit is enabled in config feature bitmap

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

• For POWER_SAVE_PROFILE with DEEP_SLEEP_WITHOUT_RAM_RETENTION, call sl_net_deinit before calling sl_net_init.

• To configure listen_interval in sl_wifi_performance_profile_t, set the SL_WIFI_JOIN_FEAT_PS_CMD_LISTEN_INTERVAL_VALID flag using sl_wifi_set_join_configuration() before connecting to the AP. Without this flag, the listen_interval value is ignored.

• The listen interval configured through sl_wifi_set_performance_profile() must not be greater than the listen interval set using sl_wifi_set_listen_interval_v2(). The default listen interval configured in the WiSeConnect SDK is 1000 ms, which is the listen interval used when associating with the AP unless sl_wifi_set_listen_interval_v2() sets a different value.

• For more details about connected and non-connected mode, see https://www.silabs.com/documents/public/application-notes/an1430-siwx917-soc-low-power.pdf.

sl_wifi_set_performance_profile_v2#

sl_status_t sl_wifi_set_performance_profile_v2 (const sl_wifi_performance_profile_v2_t * profile)

Set Wi-Fi performance profile.

• 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

• For SI91x chips Enhanced MAX PSP is supported when profile is set to ASSOCIATED_POWER_SAVE_LOW_LATENCY and SL_WIFI_ENABLE_ENHANCED_MAX_PSP bit is enabled in config feature bitmap

• This v2 API is defined due to a new configuration member beacon_miss_ignore_limit added to the structure sl_wifi_performance_profile_v2_t. Default value for beacon_miss_ignore_limit is 1. Recommended max value is 10. Higher value may cause interop issues.

• For POWER_SAVE_PROFILE with DEEP_SLEEP_WITHOUT_RAM_RETENTION, call sl_net_deinit before calling sl_net_init.

• To configure listen_interval in sl_wifi_performance_profile_v2_t, the SL_WIFI_JOIN_FEAT_PS_CMD_LISTEN_INTERVAL_VALID flag must be set using sl_wifi_set_join_configuration() before connecting to the AP. Without this flag, the listen_interval value is ignored.

• The listen interval configured through sl_wifi_set_performance_profile_v2() must not be greater than the listen interval set using sl_wifi_set_listen_interval_v2(). The default listen interval configured in the WiSeConnect SDK is 1000 ms. This interval is used when associating with the AP unless a different value is set by sl_wifi_set_listen_interval_v2().

• For more details about connected and non-connected mode, see https://www.silabs.com/documents/public/application-notes/an1430-siwx917-soc-low-power.pdf.

sl_wifi_get_performance_profile#

sl_status_t sl_wifi_get_performance_profile (sl_wifi_performance_profile_t * profile)

Get Wi-Fi performance profile.

• 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

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

sl_wifi_get_performance_profile_v2#

sl_status_t sl_wifi_get_performance_profile_v2 (sl_wifi_performance_profile_v2_t * profile)

Get Wi-Fi performance profile.

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