GAP#

rsi_ble_set_smp_pairing_capabilty_data_t#

typedef struct rsi_ble_set_smp_pairing_capabilty_data rsi_ble_set_smp_pairing_capabilty_data_t

Structure for setting SMP pairing capability data.

rsi_ble_resp_read_phy_t#

typedef struct rsi_ble_resp_read_phy_s rsi_ble_resp_read_phy_t

Structure to hold the response for the BLE read PHY request command.

rsi_ble_read_max_data_length_t#

typedef struct rsi_ble_resp_read_max_data_length_s rsi_ble_read_max_data_length_t

Structure representing the response for reading the maximum data length in BLE.

rsi_ble_set_random_address#

int32_t rsi_ble_set_random_address (void )

Request the local device to set a random address. This is a blocking API.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_set_random_address_with_value#

int32_t rsi_ble_set_random_address_with_value (uint8_t * random_addr)

Request the local device to set a given random address. This is a blocking API.

• Pre-condition:

  • Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_start_advertising#

int32_t rsi_ble_start_advertising (void )

Request the local device to start advertising. This is a blocking API. A received event rsi_ble_on_enhance_connect_t/ rsi_ble_on_connect_t indicates remote device given BLE connect command and got connected.

• Pre-condition: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command 0x4E0C - Command disallowed 0x4046 - Invalid Arguments

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_start_advertising_with_values#

int32_t rsi_ble_start_advertising_with_values (const void * rsi_ble_adv)

Request the local device to start advertising with specified values. This is a blocking API. A received event rsi_ble_on_enhance_connect_t/ rsi_ble_on_connect_t indicates remote device given BLE connect command and got connected.

• Pre-condition: Call sl_wifi_init() before calling this API, this is a blocking API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command 0x4E0C - Command disallowed 0x4046 - Invalid Arguments

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_encrypt#

int32_t rsi_ble_encrypt (const uint8_t * key, const uint8_t * data, uint8_t * resp)

Encrypt the plain text data fed by the user using the key provided, it uses the AES-128 bit block cypher a logo to generate encrypted data, refer to Bluetooth Spec 5.4 for further details.

• Pre-conditions: Call sl_wifi_init() before calling this API, this is a blocking API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_stop_advertising#

int32_t rsi_ble_stop_advertising (void )

Stop advertising, this is a Blocking API.

• Pre-conditions: Call rsi_ble_start_advertising() or rsi_ble_start_advertising_with_values() before calling this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command 0x4E0C - Command disallowed 0x4046 - Invalid Arguments

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_set_advertise_data#

int32_t rsi_ble_set_advertise_data (const uint8_t * data, uint16_t data_len)

Set the advertising data. This is a blocking API.

• Pre-condition: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

• The maximum length of advertising data payload is 31 bytes.

• The basic format of advertising payload record contains length and data.

• Refer to " ADVERTISING AND SCAN RESPONSE DATA FORMAT " in vol 3-part c in core spec 5.4 for the data structure information.

rsi_ble_set_scan_response_data#

int32_t rsi_ble_set_scan_response_data (const uint8_t * data, uint16_t data_len)

Request the local device to set the scan response data, this is a Blocking API.

• Pre-conditions: Call sl_wifi_init() before calling this API, this is a Blocking API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

• Refer to " ADVERTISING AND SCAN RESPONSE DATA FORMAT " in vol 3-part c in core spec 5.4 for the data structure information.

rsi_ble_start_scanning#

int32_t rsi_ble_start_scanning (void )

Start scanning, this is a Blocking API A received event rsi_ble_on_adv_report_event_t indicates advertise report of remote device received.

• Pre-condition: Call sl_wifi_init() before calling this API, this is a Blocking API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command 0x4E0C - Command disallowed 0x4046 - Invalid Arguments

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_start_scanning_with_values#

int32_t rsi_ble_start_scanning_with_values (void * rsi_ble_scan_params)

Start scanning with values. This is a blocking API. A received event rsi_ble_on_adv_report_event_t indicates the advertise report of a remote device received.

• Pre-condition:

  • Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure 0x4E0C - Command disallowed 0x4046 - Invalid Arguments

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_stop_scanning#

int32_t rsi_ble_stop_scanning (void )

Stop scanning. This is a blocking API.

• Pre-conditions:

  • rsi_ble_start_scanning() or rsi_ble_start_scanning_with_values() API needs to be called before this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command 0x4E0C - Command disallowed

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_connect_with_params#

int32_t rsi_ble_connect_with_params (uint8_t remote_dev_addr_type, const int8_t * remote_dev_addr, uint16_t scan_interval, uint16_t scan_window, uint16_t conn_interval_max, uint16_t conn_interval_min, uint16_t conn_latency, uint16_t supervision_tout)

Connect to the remote BLE device with the user configured parameters. This is a blocking API, a received event rsi_ble_on_enhance_connect_t / rsi_ble_on_connect_t indicates that the connection successful and a received event rsi_ble_on_disconnect_t indicates that connection failures have occurred.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • 0x4E0C - Command disallowed

  • 0x4046 - Invalid Arguments

Note

• If a connection can't be established, for example, the remote device has gone out of range, has entered into deep sleep, or is not advertising, the stack will try to connect forever. In this case, the application will not get an event related to the connection request.

• To recover from this situation, the application can implement a timeout and call rsi_ble_connect_cancel() to cancel the connection request. Subsequent calls of this command have to wait for the ongoing command to complete.

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_connect#

int32_t rsi_ble_connect (uint8_t remote_dev_addr_type, const int8_t * remote_dev_addr)

Connect to the remote BLE device. This is a blocking API, a received event rsi_ble_on_enhance_connect_t/ rsi_ble_on_connect_t indicates that the connection successful and a received event rsi_ble_on_disconnect_t indicates that connection failures have occurred.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure 0x4E0C - Command disallowed 0x4046 - Invalid Arguments

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

• If a connection can't be established, for example, the remote device has gone out of range, has entered into deep sleep, or is not advertising,

• The stack will try to connect forever. In this case, the application will not get an event related to the connection request.

• To recover from this situation, the application can implement a timeout and call rsi_ble_connect_cancel() to cancel the connection request.

• Subsequent calls of this command have to wait for the ongoing command to complete.

rsi_ble_enhance_connect_with_params#

int32_t rsi_ble_enhance_connect_with_params (void * ble_enhance_conn_params)

Connect to the remote BLE device with the user configured parameters.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • - 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 - Buffer not available to serve the command 0x4E0C - Command disallowed 0x4046 - Invalid Arguments

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes.

• The following fields are included in the ble_enhance_conn_params parameter structure:

  • dev_addr_type - Address type of the device to connect.

    • 0 - Public Address

    • 1 - Random Address
      

  • dev_addr - Address of the device to connect.
    

  • filter_policy - Policy used to determine whether the filter accept list is used.

    • 0 - Filter accept list is not used to determine which advertiser to connect to.

    • 1 - Filter accept list is used to determine which advertiser to connect to.
      

  • own_addr_type - Own address type

  • le_scan_interval - The time interval from when the Controller started its last LE scan until it begins the subsequent LE scan.

    • Range: 0x0004 to 0x4000

    • Time = le_scan_interval * 0.625 msec

    • Time Range: 2.5 msec to 10 . 24 seconds
      

  • le_scan_window - Amount of time for the duration of the LE scan. This must be less than or equal to le_scan_interval.

    • Range: 0x0004 to 0x4000

    • Time = le_scan_window * 0.625 msec

    • Time Range: 2.5 msec to 10.24 seconds
      

  • conn_interval_min - Minimum value for the connection event interval. This must be greater than or equal to conn_interval_max.

    • Range: 0x0006 to 0x0C80

    • Time = conn_interval_min * 1.25 msec

    • Time Range: 7.5 msec to 4 seconds.

    • 0x0000 - 0x0005 and 0x0C81 - 0xFFFF - Reserved for future use
      

  • conn_interval_max - Maximum value for the connection event interval. This must be greater than or equal to conn_interval_min.

    • Range: 0x0006 to 0x0C80

    • Time = conn_interval_max * 1.25 msec

    • Time Range: 7.5 msec to 4 seconds.

    • 0x0000 - 0x0005 and 0x0C81 - 0xFFFF - Reserved for future use
      

  • conn_latency - Peripheral latency for the connection in number of connection events.

    • Range: 0x0000 to 0x01F4
      

  • supervision_tout - Supervision timeout for the LE Link.

    • Range: 0x000A to 0x0C80

    • Time = N * 10 msec

    • Time Range: 100 msec to 32 seconds

    • 0x0000 - 0x0009 and 0x0C81 - 0xFFFF - Reserved for future use
      

  • min_ce_length - Minimum length of connection event recommended for this LE connection.

    • Range: 0x0000 to 0xFFFF

    • Time = N * 0.625 msec
      

  • max_ce_length - Maximum length of connection event recommended for this LE connection.

    • Range: 0x0000 to 0xFFFF

    • Time = N * 0.625 msec
      

rsi_ble_connect_cancel#

int32_t rsi_ble_connect_cancel (const int8_t * remote_dev_address)

Cancel the connection to the remote BLE device. This is a blocking API, A received event rsi_ble_on_disconnect_t indicates disconnect complete.

• Pre-conditions: rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • 0x4E0C - Command disallowed

  • 0x4046 - Invalid Arguments

  • 0x4E02 - Unknown Connection Identifier

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_disconnect#

int32_t rsi_ble_disconnect (const int8_t * remote_dev_address)

Disconnect with the remote BLE device. This is a blocking API.

• Pre-conditions: rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned: 0 - Success Non-Zero Value - Failure 0x4E0C - Command disallowed 0x4D05 - BLE socket not available 0x4E62 - Invalid Parameters 0x4D04- BLE not connected

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_get_device_state#

int32_t rsi_ble_get_device_state (uint8_t * resp)

Get the local device state. This is a blocking API. The state value is filled in "resp".

• Pre-conditions:

  • Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_set_smp_pairing_cap_data#

int32_t rsi_ble_set_smp_pairing_cap_data (rsi_ble_set_smp_pairing_capabilty_data_t * smp_pair_cap_data)

Set the SMP Pairing Capability of local device. This is a blocking API.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_set_local_irk_value#

int32_t rsi_ble_set_local_irk_value (const uint8_t * l_irk)

Set the IRK value to the local device. This is a blocking API.

• Pre-conditions:

  • Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_conn_param_resp#

int32_t rsi_ble_conn_param_resp (const uint8_t * remote_dev_address, uint8_t status)

Give the response for the remote device connection parameter request. This is a blocking API. A received event rsi_ble_on_conn_update_complete_t indicates connection update procedure is successful.

• Pre-conditions: rsi_ble_connect() API needs to be called before this API. rsi_ble_on_remote_conn_params_request_event should be called by the application.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • 0x4E0C - Command disallowed

  • 0x4046 - Invalid Arguments

  • 0x4E02 - Unknown Connection Identifier

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_smp_pair_request#

int32_t rsi_ble_smp_pair_request (uint8_t * remote_dev_address, uint8_t io_capability, uint8_t mitm_req)

Request the SMP pairing process with the remote device. This is a blocking API.

• A received event rsi_ble_on_smp_request_t indicated remote device is given Security Request and need to respond back with rsi_ble_smp_pair_request

• A received event rsi_ble_on_smp_response_t indicated remote device is given SMP Pair Request and need to respond back with rsi_ble_smp_pair_response

• A received event rsi_ble_on_smp_failed_t indicated SMP procedure have failed

  • Pre-conditions:

    • rsi_ble_connect() API needs to be called before this API.

• 0x00 - Display Only

• 0x01 - Display Yes/No

• 0x02 - Keyboard Only

• 0x03 - No Input No Output Returns

  • The following values are returned:

• 0 - Success

• Non-Zero Value - Failure

• If the return value is less than 0

• -4 - Buffer not available to serve the command

• 0x4D05 BLE socket not available

• 0x4E62 Invalid Parameters

• 0x4D04 BLE not connected Note

  • Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_smp_pair_failed#

int32_t rsi_ble_smp_pair_failed (uint8_t * remote_dev_address, uint8_t reason)

Send SMP pairing failure reason to the remote device.

• Pre-conditions: rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

rsi_ble_ltk_req_reply#

int32_t rsi_ble_ltk_req_reply (uint8_t * remote_dev_address, uint8_t reply_type, const uint8_t * ltk)

Send the local long term key of its associated local EDIV and local Rand. This is a blocking API.

• A received event rsi_ble_on_encrypt_started_t indicated encrypted event is received from module

• A received event rsi_ble_on_smp_failed_t indicated SMP procedure have failed Returns

  • The following values are returned:

• 0 - Success

• Non-Zero Value - Failure

• If the return value is less than 0

• -4 - Buffer not available to serve the command

• 0x4D05 BLE socket not available

• 0x4E62 Invalid Parameters

• 0x4D04 BLE not connected Note

  • Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_smp_pair_response#

int32_t rsi_ble_smp_pair_response (uint8_t * remote_dev_address, uint8_t io_capability, uint8_t mitm_req)

Send SMP pairing response during the process of pairing with the remote device. This is a blocking API.

• A received event rsi_ble_on_smp_passkey_t indicated Legacy SMP passkey is received and need to respond back with rsi_ble_smp_passkey()

• A received event rsi_ble_on_sc_passkey_t indicated BLE SC passkey is received and need to respond back with rsi_ble_smp_passkey()

• A received event rsi_ble_on_smp_passkey_display_t indicates SMP passkey display is received from the module

• A received event rsi_ble_on_smp_failed_t indicated SMP Failed event is received

  • Pre-condition: rsi_ble_connect() API needs to be called before this API.

  Returns

  • The following values are returned:

    • 0 - Success

    • Non-Zero Value - Failure

    • If the return value is less than 0

    • -4 - Buffer not available to serve the command

    • 0x4D05 BLE socket not available

    • 0x4E62 Invalid Parameters

    • 0x4D04 BLE not connected

  Note

  • Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_smp_passkey#

int32_t rsi_ble_smp_passkey (uint8_t * remote_dev_address, uint32_t passkey)

Send SMP passkey during SMP pairing process with the remote device. This is a Blocking API A received event rsi_ble_on_encrypt_started_t indicated encrypted event is received from module A received event rsi_ble_on_le_security_keys_t indicates exchange of security keys completed after encryption A received event rsi_ble_on_smp_failed_t indicated SMP procedure have failed.

• Pre-conditions: Call rsi_ble_smp_pair_request and rsi_ble_smp_pair_response before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

  • 0x4D05 BLE socket not available

  • 0x4E62 Invalid Parameters

  • 0x4D04 BLE not connected

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_get_le_ping_timeout#

int32_t rsi_ble_get_le_ping_timeout (uint8_t * remote_dev_address, uint16_t * time_out)

Get the timeout value of the LE ping. This is a blocking API.

• Pre-conditions: rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

  • 0x4D05 BLE socket not available

  • 0x4E62 Invalid Parameters

  • 0x4D04 BLE not connected

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

• Currently Get ping is not supported.

rsi_ble_set_le_ping_timeout#

int32_t rsi_ble_set_le_ping_timeout (uint8_t * remote_dev_address, uint16_t time_out)

Set the timeout value of the LE ping. This is a blocking API. A received event of rsi_ble_on_le_ping_payload_timeout_t indicates LE ping payload timeout expired.

• Pre-conditions:

  • rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

  • 0x4D05 BLE socket not available

  • 0x4E62 Invalid Parameters

  • 0x4D04 BLE not connected

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_clear_acceptlist#

int32_t rsi_ble_clear_acceptlist (void )

Clear all the BD address present in accept list. This is a blocking API.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_addto_acceptlist#

int32_t rsi_ble_addto_acceptlist (const int8_t * dev_address, uint8_t dev_addr_type)

Add BD address to accept list. This is a blocking API.

• Pre-conditions:

  • Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

Note

• Maximum number of device address that firmware can store is 10. Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_deletefrom_acceptlist#

int32_t rsi_ble_deletefrom_acceptlist (const int8_t * dev_address, uint8_t dev_addr_type)

Delete particular BD address from accept list. This is a blocking API.

• Pre-conditions:

  • rsi_ble_addto_acceptlist() API needs to be called before this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_resolvlist#

int32_t rsi_ble_resolvlist (uint8_t process_type, uint8_t remote_dev_addr_type, uint8_t * remote_dev_address, const uint8_t * peer_irk, const uint8_t * local_irk)

Resolvlist API used for multiple purposes based on the process type. It will be used to add/remove/clear a device to/from the list. This is a blocking API.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_get_resolving_list_size#

int32_t rsi_ble_get_resolving_list_size (uint8_t * resp)

Request to get resolving list size. This is a blocking API.

• Pre-conditions:

  • Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 : Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_set_addr_resolution_enable#

int32_t rsi_ble_set_addr_resolution_enable (uint8_t enable, uint16_t tout)

Request to enable address resolution, and to set resolvable private address timeout. This is a blocking API.

• Pre-conditions:

  • Call sl_wifi_init() before calling this API.

• 0 - disables address resolution Returns

  • The following values are returned:

    • 0 - Success

    • Non-Zero Value - Failure

    • If the return value is less than 0

    • -4 : Buffer not available to serve the command

rsi_ble_set_privacy_mode#

int32_t rsi_ble_set_privacy_mode (uint8_t remote_dev_addr_type, uint8_t * remote_dev_address, uint8_t privacy_mode)

Request to set privacy mode for particular device, this is a Blocking API.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned: 0 - Success Non-Zero Value - Failure If the return value is less than 0 -4 : Buffer not available to serve the command

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_readphy#

int32_t rsi_ble_readphy (const int8_t * remote_dev_address, rsi_ble_resp_read_phy_t * resp)

Reads the TX and RX PHY rates of the Connection. This is a blocking API.

• Pre-conditions: rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned: 0 - Success Non-Zero Value - Failure

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_setphy#

int32_t rsi_ble_setphy (const int8_t * remote_dev_address, uint8_t tx_phy, uint8_t rx_phy, uint16_t coded_phy)

Set TX and RX PHY. This is a blocking API. A received event rsi_ble_on_phy_update_complete_t indicates PHY rate update complete.

• Pre-conditions: rsi_ble_connect() API needs to be called before this API.

• 1 = Host prefers that S=2 coding be used when transmitting on the LE Coded PHY

• 2 = Host prefers that S=8 coding be used when transmitting on the LE Coded PHY

• 3 = Reserved for future use Returns

  • The following values are returned: 0 - Success Non-Zero Value - Failure 0x4D05 BLE socket not available 0x4E62 Invalid Parameters 0x4D04 BLE not connected

  Note

  • Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_conn_params_update#

int32_t rsi_ble_conn_params_update (const uint8_t * remote_dev_address, uint16_t min_int, uint16_t max_int, uint16_t latency, uint16_t timeout)

Requests the connection parameters change with the remote device, When the Silicon Labs device acts as a central, this API is used to update the connection parameters. When the Silicon Labs device acts as a peripheral, this API is used to request the central to initiate the connection update procedure. This is a blocking API. A received event rsi_ble_on_conn_update_complete_t indicates connection parameters update complete.

• Pre-conditions: rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • 0x4D05 BLE socket not available

  • 0x4E62 Invalid Parameters

  • 0x4D04 BLE not connected

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes.

• min_int and max_int values ranges from 6 to 3200 (Time = N * 1.25 ms, Time Range: 7.5 ms to 4 s) latency : If latency value is greater than 32 ,Limiting the peripheral latency value to 32 Max supported peripheral latency is 32 when Device is in peripheral Role.

rsi_ble_set_data_len#

int32_t rsi_ble_set_data_len (uint8_t * remote_dev_address, uint16_t tx_octets, uint16_t tx_time)

Sets the TX octets and the TX time of specified link (remote device connection), this is a Blocking API. A received event rsi_ble_on_data_length_update_t indicates data length update complete.

• Pre-conditions:

  • rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned:

  • 0 - LE_Set_Data_Length command succeeded.

  • Non-Zero Value - Failure

  • 0x4D05 BLE socket not available

  • 0x4E62 Invalid Parameters

  • 0x4D04 BLE not connected

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_read_max_data_len#

int32_t rsi_ble_read_max_data_len (rsi_ble_read_max_data_length_t * blereaddatalen)

reads the maximum supported values of TX octets, TX time, RX octets and Rx time. This is a blocking API.

• Pre-conditions:

  • rsi_ble_connect() API needs to be called before this API.

Returns

• The following values are returned:

  • 0 - command success

  • Non-Zero Value - Failure

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

rsi_ble_accept_list_using_adv_data#

int32_t rsi_ble_accept_list_using_adv_data (uint8_t enable, uint8_t data_compare_index, uint8_t len_for_compare_data, const uint8_t * payload)

Give vendor-specific command to set the acceptlist feature based on the advertisers advertising payload, this is a Blocking API.

• Pre-conditions: Call sl_wifi_init() before calling this API.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

  • 0x4E62 Invalid Parameters

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes .

BT_LE_ADPacketExtract#

void BT_LE_ADPacketExtract (uint8_t * remote_name, const uint8_t * pbuf, uint8_t buf_len)

Used to extract remote Bluetooth device name from the received advertising report.

• Pre-conditions: Call sl_wifi_init() before calling this API.

rsi_ble_start_encryption#

int32_t rsi_ble_start_encryption (uint8_t * remote_dev_address, uint16_t ediv, const uint8_t * rand, const uint8_t * ltk)

Start the encryption process with the remote device. This is a blocking API. A received event rsi_ble_on_encrypt_started_t indicated encrypted event is received from module. A received event rsi_ble_on_le_security_keys_t indicates exchange of security keys completed after encryption. A received event rsi_ble_on_smp_failed_t indicated SMP procedure have failed.

• Pre-conditions:

  • Encryption enabled event should come before calling this API for second time SMP connection.

Returns

• The following values are returned:

  • 0 - Success

  • Non-Zero Value - Failure

  • If the return value is less than 0

  • -4 - Buffer not available to serve the command

  • 0x4D05 BLE socket not available

  • 0x4E62 Invalid Parameters

  • 0x4D04 BLE not connected

Note

• Refer to the Status Codes section for the above error codes at wiseconnect-status-codes.

rsi_ble_get_max_adv_data_len#

int32_t rsi_ble_get_max_adv_data_len (uint8_t * resp)

Get maximum advertising data length.

Returns

• The following values are returned:

  • 0 = success

• The following values are returned:

  • !0 = failure

Note

• This function requests the controller to return the maximum supported advertising data length.

rsi_ble_get_max_no_of_supp_adv_sets#

int32_t rsi_ble_get_max_no_of_supp_adv_sets (uint8_t * resp)

Get maximum number of advertising sets.

Returns

• The following values are returned: 0 = success

• The following values are returned: !0 = failure

Note

• This function requests the controller to return the maximum number of supporting advertising sets.

• The number of supported advertising sets can be configured through the operating modes.

rsi_ble_set_ae_set_random_address#

rsi_ble_set_ae_set_random_address (uint8_t handle, const uint8_t * rand_addr)

Update AE random address.

Returns

• The following values are returned:

  • 0 = success

• The following values are returned:

  • !0 = failure

rsi_ble_set_ae_data#

int32_t rsi_ble_set_ae_data (void * ble_ae_data)

Set the AE advertising data.

Returns

• The following values are returned: 0 = success

• The following values are returned: !0 = failure

Note

• This function sets the AE advertiser data used in advertising PDUs.

• Refer to Bluetooth specification 5.4 for possible combinations in which ae_adv/scanresp data can be set.

rsi_ble_set_ae_params#

int32_t rsi_ble_set_ae_params (void * ble_ae_params, int8_t * sel_tx_pwr)

Set the AE advertising parameters.

Returns

• The following values are returned: 0 = success

• The following values are returned: !0 = failure

rsi_ble_start_ae_advertising#

int32_t rsi_ble_start_ae_advertising (void * adv_enable)

Enable or disable AE advertising.

Returns

• The following values are returned: 0 = success

• The following values are returned: !0 = failure

rsi_ble_app_adv_set_clear_or_remove#

int32_t rsi_ble_app_adv_set_clear_or_remove (uint8_t type, uint8_t handle)

request the local device to clear or remove the advertising sets based on the type specified This function requests the local device to clear or remove an advertising set from the controller based on the type specified

Returns

• 0 = success
  !0 = failure
  

rsi_ble_app_set_periodic_ae_params#

int32_t rsi_ble_app_set_periodic_ae_params (void * periodic_adv_params)

Set periodic advertising parameters.

Returns

• The following values are returned: 0 = success

• The following values are returned: !0 = failure

rsi_ble_app_set_periodic_ae_enable#

int32_t rsi_ble_app_set_periodic_ae_enable (uint8_t enable, uint8_t handle)

Enable periodic advertising.

Returns

• The following values are returned: 0 = success: !0 = failure

Note

• This function requests the controller to enable or disable periodic advertising for the specified advertising set.

rsi_ble_ae_set_scan_params#

int32_t rsi_ble_ae_set_scan_params (void * ae_scan_params)

Set AE scan parameters.

Returns

• The following values are returned: 0 = success

• The following values are returned: !0 = failure

Note

• This function sets the extended scan parameters to be used on the physical advertising channels.

rsi_ble_ae_set_scan_enable#

int32_t rsi_ble_ae_set_scan_enable (void * ae_scan_enable)

request the local device to enable scanning for both legacy and extended advertising PDUs

Returns

• 0 = success
  !0 = failure
  

rsi_ble_ae_set_periodic_sync#

int32_t rsi_ble_ae_set_periodic_sync (uint8_t type, void * periodic_sync_data)

Synchronize with a periodic advertising train from an advertiser and begin receiving periodic advertising packets.

Returns

• The following values are returned: 0 = success 0x4E42 = unknown advertising identifier 0x4E0C = command not permitted

Note

• The operation is either started, cancelled or terminated depending on the type parameter.

• "Sync Terminate" to be used when synchronization has already been established, and operation needs to be stopped. "Sync Cancel" to be used when synchronization is still in progress, and process is no longer intended to be completed.

rsi_ble_ae_dev_to_periodic_list#

int32_t rsi_ble_ae_dev_to_periodic_list (void * dev_to_list)

Manage a device in the periodic advertiser list This function adds a device to periodic advertiser list stored in the controller.

Returns

• The following values are returned: 0 = success !0 = failure

rsi_ble_ae_read_periodic_adv_list_size#

int32_t rsi_ble_ae_read_periodic_adv_list_size (uint8_t * resp)

Get periodic advertiser list size.

Returns

• The following values are returned: 0 = success

• The following values are returned: !0 = failure

rsi_ble_extended_connect_with_params#

int32_t rsi_ble_extended_connect_with_params (void * ext_create_conn)

This function is used to create an ACL connection, with the local device in the central role, to a connectable advertiser.

Returns

• int32_t

  • 0 : Success.

  • !0 : Failure (an error code indicating the reason for failure).

Note

• This function establishes a BLE connection with a remote advertiser, utilizing extended connection parameters for enhanced flexibility. The local device operates in the Central role. Key fields in the structure include:

• initiator_filter_policy: Determines the use of the Filter Accept List:

  • 0x00: Do not use the Filter Accept List; connect to the specified peer address.

  • 0x01: Use the Filter Accept List; ignore the peer address.

• own_addr_type: Specifies the local device's address type:

  • 0x00: Public Device Address.

  • 0x01: Random Device Address.

  • 0x02: Resolvable Private Address (local IRK).

  • 0x03: Resolvable Private Address (local IRK or random address).

• remote_addr_type: Specifies the peer's address type:

  • 0x00: Public Device Address or Public Identity Address.

  • 0x01: Random Device Address or Random (static) Identity Address.

• remote_addr: The peer's address (Public, Random Static, Non-Resolvable Private, or Resolvable Private).

• init_phys: Indicates the PHY(s) for initiating connections:

  • Bit 0: LE 1M PHY.

  • Bit 1: LE 2M PHY.

  • Bit 2: LE Coded PHY.

• init_params: Array of structures contains initiation parameters for each PHY.

rsi_ble_read_transmit_power#

int32_t rsi_ble_read_transmit_power (void * resp)

Get supported transmit power range.

Returns

• The following values are returned: 0 = success

• The following values are returned: !0 = failure

Note

• This function requests the controller to return the minimum and maximum supported transmit power based on the country region.