Callback Framework#

sl_wifi_callback_function_t#

sl_wifi_callback_function_t )(sl_wifi_event_t event, void *data, uint32_t data_length, void *optional_arg)

Generic callback for Wi-Fi group events of type sl_wifi_event_group_t.

This typedef defines a callback function that handles Wi-Fi events of type sl_wifi_event_t. The callback is invoked when a Wi-Fi event occurs, providing the event details and any associated data.

Returns

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

Note

• In case of event failure, the SL_WIFI_FAIL_EVENT_STATUS_INDICATION bit is set in the event parameter. When this bit is set, the data parameter will be of type sl_status_t, and the data_length parameter can be ignored.

sl_wifi_scan_callback_t#

sl_wifi_scan_callback_t )(sl_wifi_event_t event, sl_wifi_scan_result_t *data, uint32_t data_length, void *optional_arg)

Callback for SL_WIFI_SCAN_RESULT_EVENTS group event of type sl_wifi_event_group_t.

This typedef defines a callback function that handles Wi-Fi scan result events of type sl_wifi_event_t. The callback is triggered when a Wi-Fi module tries to scan and receive the response, providing the event details and any associated scan results.

• Wi-Fi module must call sl_wifi_start_scan to receive SL_WIFI_SCAN_RESULT_EVENTS event.

Returns

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

Note

• In case of event failure, SL_WIFI_FAIL_EVENT_STATUS_INDICATION bit is set in the event. When this bit is set, the data parameter will be of type sl_status_t, and the data_length parameter can be ignored.

sl_wifi_stats_callback_t#

sl_wifi_stats_callback_t )(sl_wifi_event_t event, void *data, uint32_t data_length, void *optional_arg)

Callback for SL_WIFI_STATS_RESPONSE_EVENTS group events of type sl_wifi_event_group_t.

This typedef defines a callback function that handles Wi-Fi statistics response events of type sl_wifi_event_t. The callback is invoked when a Wi-Fi statistics response event occurs, providing the event details and any associated data.

Returns

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

Note

• SL_WIFI_STATS_MODULE_STATE_EVENT messages are used to indicate module state to the host. These messages are enabled by setting the 10th bit of the custom feature bitmap in opermode. For the event SL_WIFI_STATS_MODULE_STATE_EVENT response structure refer sl_si91x_module_state_stats_response_t.

  • state_code of this response (1 byte), indicates the state of the module. state_code contains two parts, the upper nibble and lower nibble.

    The upper nibble indicates the state of the rejoin process. The following table documents the possible values of the upper nibble of the state_code.

    Module state code upper nibble	Description
    0x00	Startup (Initial Roam). Indicates the reason for scan triggered(state-I).
    0x10	Beacon Loss (Failover Roam). Indicates the reason for scan triggered(state-I).
    0x20	De-authentication (AP induced Roam / Disconnect from supplicant). Indicates the reason for scan triggered(state-I).
    0x50	Current AP is best. Indicates a state change based on scan result(state-II).
    0x60	Better AP found. Indicates a state change based on scan result(state-II).
    0x70	No AP found. Indicates a state change based on scan result(state-II).
    0x80	Associated. Indicates the connection state change(state – III).
    0x90	Unassociated. Indicates the connection state change(state – III).

• The lower nibble of state_code indicates the reason for a state change. The table below lists the possible values of the lower nibble of the state_code.

  Module state code lower nibble	Description
  0x00	No reason specified.
  0x01	Authentication denial.
  0x02	Association denial.
  0x03	AP not present.
  0x05	WPA2 key exchange failed.

• Module reason code	Description
  0x00	No reason specified.
  0x01	Authentication denial.
  0x02	Association denial.
  0x07	PSK not configured
  0x09	Roaming not enabled
  0x10	Beacon Loss (Failover Roam)
  0x20	De-authentication (AP induced Roam/Deauth from supplicant)

• In case of event failure, the SL_WIFI_FAIL_EVENT_STATUS_INDICATION bit is set in the event parameter. When this bit is set, the data parameter will be of type sl_status_t, and the data_length parameter can be ignored.

sl_wifi_join_callback_t#

sl_wifi_join_callback_t )(sl_wifi_event_t event, char *data, uint32_t data_length, void *optional_arg)

Callback for SL_WIFI_JOIN_EVENTS group events of type sl_wifi_event_group_t.

This typedef defines a callback function that handles Wi-Fi join events of type sl_wifi_event_t. The callback is invoked when a Wi-Fi join event occurs, providing the event details and any associated data.

Returns

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

Note

• This is valid in WiFi client mode only

• In case of event failure, the SL_WIFI_FAIL_EVENT_STATUS_INDICATION bit is set in the event parameter. When this bit is set, the data parameter will be of type sl_status_t, and the data_length parameter can be ignored.

sl_wifi_twt_config_callback_t#

sl_wifi_twt_config_callback_t )(sl_wifi_event_t event, sl_si91x_twt_response_t *data, uint32_t data_length, void *optional_arg)

Callback for SL_WIFI_TWT_RESPONSE_EVENTS group events.

This typedef defines a callback function that handles Wi-Fi Target Wake Time (TWT) configuration response events. The callback is invoked when a TWT response event occurs, providing the event details and any associated data.

Returns

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

Note

• In case of event failure, the SL_WIFI_FAIL_EVENT_STATUS_INDICATION bit is set in the event parameter. When this bit is set, the data parameter will be of type sl_status_t, and the data_length parameter can be ignored.

sl_wifi_transceiver_callback_t#

sl_wifi_transceiver_callback_t )(sl_wifi_event_t event, void *data, uint32_t data_length, void *optional_arg)

Callback for SL_WIFI_TRANSCEIVER_EVENTS group events.

This typedef defines a callback function that handles Wi-Fi transceiver events. The callback is invoked when a transceiver event occurs, providing the event details and any associated data.

Returns

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

Note

• This API is only supported in Wi-Fi Transceiver opermode (7).

• In case of event failure, the SL_WIFI_FAIL_EVENT_STATUS_INDICATION bit is set in the event parameter. When this bit is set, the data parameter will be of type sl_status_t, and the data_length parameter can be ignored.

sl_wifi_set_callback#

sl_status_t sl_wifi_set_callback (sl_wifi_event_group_t group, sl_wifi_callback_function_t function, void * optional_arg)

Register a callback for a selected event group.

All the individual Wi-Fi events related to specific group would be triggered via this group callback.

This function allows the user to register a callback function for a specific group of Wi-Fi events sl_wifi_event_group_t. When any event within the specified group occurs, the registered callback function will be invoked, providing the event details and any associated data.

• Pre-conditions:

  • The Wi-Fi module must be initialized by calling sl_wifi_init before this API can be used.

Returns

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

Note

• Callbacks can be set only for event groups defined in sl_wifi_event_group_t, not for individual events defined in sl_wifi_event_t.

sl_wifi_default_event_handler#

sl_status_t sl_wifi_default_event_handler (sl_wifi_event_t event, sl_wifi_buffer_t * buffer)

Default Wi-Fi event handler to be passed to sl_wifi_init.

This event handler would dispatch all the Wi-Fi events and invoke respective Wi-Fi group event.

This function serves as the default event handler for Wi-Fi events. When passed to the sl_wifi_init function, it would handle incoming Wi-Fi events by dispatching them to the appropriate group event functions.

Returns

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

Note

• Passing the event handler is optional. User can implement their own event dispatching handler if they prefer.

sl_wifi_set_scan_callback#

static sl_status_t sl_wifi_set_scan_callback (sl_wifi_scan_callback_t function, void * optional_arg)

Register a callback for the SL_WIFI_SCAN_RESULT_EVENTS group event from sl_wifi_event_group_t.

This function allows the user to register a callback function for the SL_WIFI_SCAN_RESULT_EVENTS group. When any event within this group occurs, the registered callback function would be invoked, providing the event details and any associated data.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

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

Note

• All the individual Wi-Fi events related to this group would be triggered via this callback.

sl_wifi_set_join_callback#

static sl_status_t sl_wifi_set_join_callback (sl_wifi_join_callback_t function, void * optional_arg)

Register a callback for SL_WIFI_JOIN_EVENTS group event from sl_wifi_event_group_t.

This function allows the user to register a callback function for the SL_WIFI_JOIN_EVENTS group. When any event within this group occurs, the registered callback function would be invoked, providing the event details and any associated data.

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

Returns

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

Note

• All the individual Wi-Fi events related to this group will be triggered via this callback.

sl_wifi_set_twt_config_callback#

static sl_status_t sl_wifi_set_twt_config_callback (sl_wifi_twt_config_callback_t function, void * optional_arg)

Register a callback for SL_WIFI_TWT_RESPONSE_EVENTS group event from sl_wifi_event_group_t.

This function allows the user to register a callback function for the SL_WIFI_TWT_RESPONSE_EVENTS group. When any event within this group occurs, the registered callback function will be invoked, providing the event details and any associated data.

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

Returns

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

Note

• All the individual Wi-Fi events related to this group would be triggered via this callback.

sl_wifi_set_stats_callback#

static sl_status_t sl_wifi_set_stats_callback (sl_wifi_stats_callback_t function, void * optional_arg)

Register a callback for SL_WIFI_STATS_RESPONSE_EVENTS group event from sl_wifi_event_group_t.

This function allows the user to register a callback function for the SL_WIFI_STATS_RESPONSE_EVENTS group. When any event within this group occurs, the registered callback function would be invoked, providing the event details and any associated data.

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

Returns

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

Note

• All the individual Wi-Fi events related to this group would be triggered via this callback.

sl_wifi_set_transceiver_callback#

static sl_status_t sl_wifi_set_transceiver_callback (sl_wifi_transceiver_callback_t function, void * optional_arg)

Register a callback for SL_WIFI_TRANSCEIVER_EVENTS group event of tye sl_wifi_event_group_t.

This function allows the user to register a callback function for the SL_WIFI_TRANSCEIVER_EVENTS group. When any event within this group occurs, the registered callback function would be invoked, providing the event details and any associated data.

• Pre-conditions:

  • sl_wifi_init should be called before this API.

Returns

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

Note

• All the individual Wi-Fi events related to this group will be triggered via this callback.

SL_WIFI_CHECK_IF_EVENT_FAILED#

#define SL_WIFI_CHECK_IF_EVENT_FAILED

(event)

Generic macro for callback functions to check if the event has failed.