Periodic Advertiser#

sl_bt_periodic_advertiser_set_data#

sl_status_t sl_bt_periodic_advertiser_set_data (uint8_t advertising_set, size_t data_len, const uint8_t * data)

Set the data for periodic advertising on an advertising set. Maximum 254 bytes of data can be set with this command. For setting longer advertising data, use command sl_bt_periodic_advertiser_set_long_data.

If the periodic advertising is currently enabled, the new advertising data will be used immediately. Periodic advertising can be enabled using the command sl_bt_periodic_advertiser_start.

The invalid parameter error will be returned if the data is too long to fit into the advertisement.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_periodic_advertiser_set_long_data#

sl_status_t sl_bt_periodic_advertiser_set_long_data (uint8_t advertising_set)

Set data for periodic advertising on an advertising set. Data currently in the system data buffer will be extracted as the advertising data. The buffer will be emptied after this command regardless of the completion status.

Prior to calling this command, add data to the buffer with one or multiple calls to sl_bt_system_data_buffer_write.

Maximum 1650 bytes of data can be set for periodic advertising. Advertising parameters may limit the amount of data that can be sent.

See sl_bt_periodic_advertiser_set_data for more details.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_periodic_advertiser_start#

sl_status_t sl_bt_periodic_advertiser_start (uint8_t advertising_set, uint16_t interval_min, uint16_t interval_max, uint32_t flags)

Start periodic advertising on an advertising set.

According to the Bluetooth Core specification, periodic advertising PDUs cannot be transmitted until at least one extended advertising event has been completed. If the application needs exact control over the extended advertising data and parameters, use the Advertiser class to configure the parameters of the advertising set and the Extended Advertiser class to set or generate the desired extended advertising data payload. If the application does not configure the parameters or set the data, the default parameters and empty advertising data are used for the extended advertising.

If the application has not already started extended advertising and the flag SL_BT_PERIODIC_ADVERTISER_AUTO_START_EXTENDED_ADVERTISING is set in flags, the stack will automatically start extended advertising with the parameters and extended advertising data currently configured to the advertising set. The application may stop the automatically started extended advertising using the sl_bt_advertiser_stop command.

If the application has not already started extended advertising and the flag SL_BT_PERIODIC_ADVERTISER_AUTO_START_EXTENDED_ADVERTISING is not set in flags, the stack will momentarily start extended advertising with the parameters and extended advertising data currently configured to the advertising set. Unless the application starts extended advertising before the first extended advertising event has completed, the stack will automatically stop the momentary extended advertising after the first extended advertising event.

Periodic advertising PDUs are transmitted on the secondary PHY configured for the advertising set with the sl_bt_extended_advertiser_set_phy command.

Use sl_bt_periodic_advertiser_stop command to stop the periodic advertising.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_periodic_advertiser_stop#

sl_status_t sl_bt_periodic_advertiser_stop (uint8_t advertising_set)

Stop the periodic advertising on an advertising set. Counterpart to sl_bt_periodic_advertiser_start.

This command does not affect the enable state of the legacy or extended advertising on the advertising set, i.e., the legacy or extended advertising is not stopped.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_cmd_periodic_advertiser_set_data_id#

#define sl_bt_cmd_periodic_advertiser_set_data_id

0x00580020

sl_bt_cmd_periodic_advertiser_set_long_data_id#

#define sl_bt_cmd_periodic_advertiser_set_long_data_id

0x01580020

sl_bt_cmd_periodic_advertiser_start_id#

#define sl_bt_cmd_periodic_advertiser_start_id

0x02580020

sl_bt_cmd_periodic_advertiser_stop_id#

#define sl_bt_cmd_periodic_advertiser_stop_id

0x03580020

sl_bt_rsp_periodic_advertiser_set_data_id#

#define sl_bt_rsp_periodic_advertiser_set_data_id

0x00580020

sl_bt_rsp_periodic_advertiser_set_long_data_id#

#define sl_bt_rsp_periodic_advertiser_set_long_data_id

0x01580020

sl_bt_rsp_periodic_advertiser_start_id#

#define sl_bt_rsp_periodic_advertiser_start_id

0x02580020

sl_bt_rsp_periodic_advertiser_stop_id#

#define sl_bt_rsp_periodic_advertiser_stop_id

0x03580020