PAST Receiver#

PAST Receiver.

Enumerations

enum  

sl_bt_past_receiver_mode_t { sl_bt_past_receiver_mode_ignore = 0x0,

sl_bt_past_receiver_mode_synchronize = 0x1

}

Specifies the mode for receiving synchronization transfers.

Functions

sl_status_t 

sl_bt_past_receiver_set_default_sync_receive_parameters (uint8_t mode, uint16_t skip, uint16_t timeout, uint8_t reporting_mode)

sl_status_t 

sl_bt_past_receiver_set_sync_receive_parameters (uint8_t connection, uint8_t mode, uint16_t skip, uint16_t timeout, uint8_t reporting_mode)

Detailed Description#

PAST Receiver.

Synchronize to periodic advertising trains by receiving Periodic Advertising Synchronization Transfer over a connection.

Enumeration Type Documentation#

◆sl_bt_past_receiver_mode_t#

enum sl_bt_past_receiver_mode_t

Specifies the mode for receiving synchronization transfers.

Enumerator

sl_bt_past_receiver_mode_ignore 

(0x0) No attempt is made to synchronize to a periodic advertising train for which the synchronization information was received. No event will be triggered towards the application.

sl_bt_past_receiver_mode_synchronize 

(0x1) Attempt to synchronize to a periodic advertising train for which the synchronization information was received. When the information is received, an event will be triggered to indicate success or failure and to provide the application with the periodic advertising synchronization handle.

Function Documentation#

◆sl_bt_past_receiver_set_default_sync_receive_parameters()#

sl_status_t sl_bt_past_receiver_set_default_sync_receive_parameters

(

uint8_t 

mode,

uint16_t 

skip,

uint16_t 

timeout,

uint8_t 

reporting_mode

)

Set the default parameters for receiving Periodic Advertising Synchronization Transfers (PAST) over connections. The default parameters will be in effect for all subsequent connections, unless overridden by command sl_bt_past_receiver_set_sync_receive_parameters after the connection is opened.

This command sets parameters that do not limit the synchronization based on the CTE type. If the application includes bluetooth_feature_aoa_receiver or bluetooth_feature_aod_receiver component and wants to specify a particular CTE limitation, the application should use the command sl_bt_cte_receiver_set_default_sync_receive_parameters to set the default parameters.

Parameters

[in]

mode

Enum sl_bt_past_receiver_mode_t. The mode to specify how the Bluetooth stack reacts when synchronization information is received. Values:* sl_bt_past_receiver_mode_ignore (0x0): No attempt is made to synchronize to a periodic advertising train for which the synchronization information was received. No event will be triggered towards the application.

  • sl_bt_past_receiver_mode_synchronize (0x1): Attempt to synchronize to a periodic advertising train for which the synchronization information was received. When the information is received, an event will be triggered to indicate success or failure and to provide the application with the periodic advertising synchronization handle.

Default: sl_bt_past_receiver_mode_ignore (No attempt is made to synchronize) | | [in] | skip | The maximum number of periodic advertising packets that can be skipped after a successful receive.* Range: 0x0000 to 0x01F3

  • Default value: 0 | | [in] | timeout | The maximum permitted time between successful receives. If this time is exceeded, synchronization is lost. Unit: 10 ms.* Range: 0x0A to 0x4000

  • Unit: 10 ms

  • Time range: 100 ms to 163.84 s

  • Default value: 1000 ms | | [in] | reporting_mode | Enum sl_bt_sync_reporting_mode_t. Specifies the initial mode for reporting data received in the periodic advertising train after it has achieved synchronization. Values:* sl_bt_sync_report_none (0x0): Data received in periodic advertising trains is not reported to the application.

  • sl_bt_sync_report_all (0x1): Data received in periodic advertising trains is reported to the application.

Default: sl_bt_sync_report_all (Data received in periodic advertising trains is reported to the application) |

ReturnsSL_STATUS_OK if successful. Error code otherwise. Events

◆sl_bt_past_receiver_set_sync_receive_parameters()#

sl_status_t sl_bt_past_receiver_set_sync_receive_parameters

(

uint8_t 

connection,

uint8_t 

mode,

uint16_t 

skip,

uint16_t 

timeout,

uint8_t 

reporting_mode

)

Set the parameters for receiving Periodic Advertising Synchronization Transfers (PAST) over the specified connection. The parameters do not affect periodic advertising trains that the device has already synchronized to.

This command sets parameters that do not limit the synchronization based on the CTE type. If the application includes bluetooth_feature_aoa_receiver or bluetooth_feature_aod_receiver component and wants to specify a particular CTE limitation, the application should use the command sl_bt_cte_receiver_set_sync_receive_parameters to set the parameters.

Parameters

[in]

connection

Connection handle of the connection used to receive the sync transfer

[in]

mode

Enum sl_bt_past_receiver_mode_t. The mode to specify how the Bluetooth stack reacts when synchronization information is received. Values:* sl_bt_past_receiver_mode_ignore (0x0): No attempt is made to synchronize to a periodic advertising train for which the synchronization information was received. No event will be triggered towards the application.

  • sl_bt_past_receiver_mode_synchronize (0x1): Attempt to synchronize to a periodic advertising train for which the synchronization information was received. When the information is received, an event will be triggered to indicate success or failure and to provide the application with the periodic advertising synchronization handle.

Default: sl_bt_past_receiver_mode_ignore (Do not attempt to synchronize) | | [in] | skip | The maximum number of periodic advertising packets that can be skipped after a successful receive.* Range: 0x0000 to 0x01F3

  • Default value: 0 | | [in] | timeout | The maximum permitted time between successful receives. If this time is exceeded, synchronization is lost. Unit: 10 ms.* Range: 0x0A to 0x4000

  • Unit: 10 ms

  • Time range: 100 ms to 163.84 s

  • Default value: 1000 ms | | [in] | reporting_mode | Enum sl_bt_sync_reporting_mode_t. Specifies the initial mode for reporting data received in the periodic advertising train after it has achieved synchronization. Values:* sl_bt_sync_report_none (0x0): Data received in periodic advertising trains is not reported to the application.

  • sl_bt_sync_report_all (0x1): Data received in periodic advertising trains is reported to the application.

Default: sl_bt_sync_report_all (Data received in periodic advertising trains is reported to the application) |

ReturnsSL_STATUS_OK if successful. Error code otherwise. Events