Legacy Advertiser#

sl_bt_legacy_advertiser_connection_mode_t#

sl_bt_legacy_advertiser_connection_mode_t

These values define the available connection modes of undirected legacy advertising.

sl_bt_legacy_advertiser_directed_connection_mode_t#

sl_bt_legacy_advertiser_directed_connection_mode_t

These values define the available connection modes of directed legacy advertising.

sl_bt_legacy_advertiser_set_data#

sl_status_t sl_bt_legacy_advertiser_set_data (uint8_t advertising_set, uint8_t type, size_t data_len, const uint8_t *data)

Set user-defined advertising data packet or scan response packet on an advertising set. This overwrites the existing advertising data packet and scan response packet on this advertising set regardless of whether the data was set for the legacy or extended advertising. Maximum 31 bytes of data can be set with this command.

If advertising mode is currently enabled, the new advertising data will be used immediately. Advertising mode can be enabled using command sl_bt_legacy_advertiser_start.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_legacy_advertiser_generate_data#

sl_status_t sl_bt_legacy_advertiser_generate_data (uint8_t advertising_set, uint8_t discover)

Ask the stack to generate the advertising data packet and scan response packet on an advertising set. Alternatively, the user-defined advertising data can be set using the sl_bt_legacy_advertiser_set_data command.

This overwrites the existing advertising data packet and scan response packet on this advertising set regardless of whether the data was set for the legacy or extended advertising.

If advertising mode is currently enabled, the new advertising data will be used immediately. To enable advertising mode, use command sl_bt_legacy_advertiser_start.

The stack generates the advertising data and scan response packet using the following logic.

1. Add a flags field to advertising data.

2. Add a TX power level field to advertising data if the TX power service exists in the local GATT database.

3. Add a peripheral connection interval range field to advertising data if the GAP peripheral preferred connection parameters characteristic exists in the local GATT database.

4. Add a list of 16-bit service UUIDs to advertising data if there are one or more 16-bit service UUIDs to advertise. The list is complete if all advertised 16-bit UUIDs are in advertising data. Otherwise, the list is incomplete.

5. Add a list of 128-bit service UUIDs to advertising data if there are one or more 128-bit service UUIDs to advertise and there is still free space for this field. The list is complete if all advertised 128-bit UUIDs are in advertising data. Otherwise, the list is incomplete. Note that an advertising data packet can contain at most one 128-bit service UUID.

6. Try to add the full local name to advertising data if the device is not in privacy mode. If the full local name does not fit into the remaining free space, the advertised name is a shortened version by cutting off the end if the free space has at least 6 bytes. Otherwise, the local name is added to scan response data.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_legacy_advertiser_start#

sl_status_t sl_bt_legacy_advertiser_start (uint8_t advertising_set, uint8_t connect)

Start undirected legacy advertising on an advertising set with the specified connection mode. Use sl_bt_advertiser_stop to stop the advertising.

Use the sl_bt_legacy_advertiser_set_data or sl_bt_legacy_advertiser_generate_data command to set the advertising data before calling this command. The advertising data is added into the advertising data packet and scan response packet if the connection mode is connectable and/or scannable. The data is only added into the advertising data packet when the connection mode is non-connectable and non-scannable.

The number of concurrent connectable advertisings is limited by the number of connections reserved by the user application (the SL_BT_CONFIG_MAX_CONNECTIONS configuration) and the number reserved by other software components (the SL_BT_COMPONENT_CONNECTIONS configuration). This command fails with the connection limit exceeded error if it may cause the number of connections exceeding the configured value in future. For example, only one connectable advertising can be enabled if the device has (SL_BT_CONFIG_MAX_CONNECTIONS + SL_BT_COMPONENT_CONNECTIONS - 1) connections. This limitation does not apply to non-connectable advertising.

This command fails with the invalid parameter error if non-resolvable random address is used but the connection mode is sl_bt_legacy_advertiser_connectable.

Event sl_bt_evt_connection_opened will be received when a remote device opens a connection to the advertiser on this advertising set. As a result, the advertising stops.

Event sl_bt_evt_advertiser_timeout will be received when the number of advertising events set by sl_bt_advertiser_set_timing command is done and the advertising has stopped.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

Events

• sl_bt_evt_advertiser_timeout - Triggered when the number of advertising events set by sl_bt_advertiser_set_timing command is done and the advertising has stopped.

• sl_bt_evt_connection_opened - Triggered when a remote device opens a connection to the advertiser and the advertising has stopped.

sl_bt_legacy_advertiser_start_directed#

sl_status_t sl_bt_legacy_advertiser_start_directed (uint8_t advertising_set, uint8_t connect, bd_addr peer_addr, uint8_t peer_addr_type)

Start directed legacy advertising on an advertising set with the specified peer target device and connection mode. Use sl_bt_advertiser_stop to stop the advertising.

Directed legacy advertising does not allow any advertising data. When the connection mode is sl_bt_legacy_advertiser_high_duty_directed_connectable, the stack defaults the advertising duration to 0.64 s if the application has not set the parameter. The duration is reduced to 1.28 s if the application has set a larger duration value.

The number of concurrent connectable advertisings is limited by the connection number configuration. See sl_bt_legacy_advertiser_start for more details.

This command fails with the invalid parameter error if non-resolvable random address is set as the advertising address.

Event sl_bt_evt_connection_opened will be received when the target device opens a connection to the advertiser on this advertising set. As a result, the advertising stops.

Event sl_bt_evt_advertiser_timeout will be received when the advertising stops and no Bluetooth connection is opened to it.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

Events

• sl_bt_evt_advertiser_timeout - Triggered when the number of advertising events set by sl_bt_advertiser_set_timing command is done and the advertising has stopped.

• sl_bt_evt_connection_opened - Triggered when a remote device opens a connection to the advertiser and the advertising has stopped.

sl_bt_cmd_legacy_advertiser_set_data_id#

#define sl_bt_cmd_legacy_advertiser_set_data_id

0x00560020

sl_bt_cmd_legacy_advertiser_generate_data_id#

#define sl_bt_cmd_legacy_advertiser_generate_data_id

0x01560020

sl_bt_cmd_legacy_advertiser_start_id#

#define sl_bt_cmd_legacy_advertiser_start_id

0x02560020

sl_bt_cmd_legacy_advertiser_start_directed_id#

#define sl_bt_cmd_legacy_advertiser_start_directed_id

0x03560020

sl_bt_rsp_legacy_advertiser_set_data_id#

#define sl_bt_rsp_legacy_advertiser_set_data_id

0x00560020

sl_bt_rsp_legacy_advertiser_generate_data_id#

#define sl_bt_rsp_legacy_advertiser_generate_data_id

0x01560020

sl_bt_rsp_legacy_advertiser_start_id#

#define sl_bt_rsp_legacy_advertiser_start_id

0x02560020

sl_bt_rsp_legacy_advertiser_start_directed_id#

#define sl_bt_rsp_legacy_advertiser_start_directed_id

0x03560020