◆ sdc_hci_cmd_le_set_connless_cte_transmit_enable()

uint8_t sdc_hci_cmd_le_set_connless_cte_transmit_enable ( const sdc_hci_cmd_le_set_connless_cte_transmit_enable_t * p_params )

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Set Connectionless CTE Transmit Enable.

The description below is extracted from Core_v6.3, Vol 4, Part E, Section 7.8.81

This command is used to request that the Controller enables or disables the use of Constant Tone Extensions in any periodic advertising on the advertising set identified by Advertising_Handle.

In order to start sending periodic advertisements containing a Constant Tone Extension, the Host must also enable periodic advertising using the HCI_LE_Set_Periodic_Advertising_Enable command (see Section 7.8.63).

Note: Periodic advertising can only be enabled when advertising is enabled on the same advertising set, but can continue after advertising has been disabled.

Once enabled, the Controller shall continue advertising with Constant Tone Extensions until either one of the following occurs:

• The Host issues an HCI_LE_Set_Connectionless_CTE_Transmit_Enable command with CTE_Enable set to 0x00 (disabling Constant Tone Extensions but allowing periodic advertising to continue). • The Host issues an HCI_LE_Set_Periodic_Advertising_Enable command (see Section 7.8.63) with Enable set to 0x00 (disabling periodic advertising). If periodic advertising is re-enabled then it shall continue to contain Constant Tone Extensions.

The Host may issue this command when advertising or periodic advertising is enabled in the advertising set.

Errors:

See Section 4.5.2 for a list of error types and descriptions.

Type   Condition                                                         Error code
MC     The HCI_LE_Set_Periodic_Advertising_Parameters command has not    Command Disallowed
       been issued for the advertising set.                              (0x0C)
MC     The HCI_LE_Set_Connectionless_CTE_Transmit_Parameters command     Command Disallowed
       has not been issued for the advertising set.                      (0x0C)
MC     The periodic advertising is on a PHY that does not allow          Command Disallowed
       Constant Tone Extensions.                                         (0x0C)
MC     Advertising_Handle does not identify an existing handle.          Unknown Advertising
                                                                         Identifier (0x42)

Event(s) generated (unless masked away):

When the HCI_LE_Set_Connectionless_CTE_Transmit_Enable command has completed, an HCI_Command_Complete event shall be generated.

Parameters

[in] p_params Input parameters.

Return values

0	if success.

Returns: Returns value between 0x01-0xFF in case of error. See Vol 2, Part D, Error for a list of error codes and descriptions.