nrfxlib API 3.3.99
Loading...
Searching...
No Matches

◆ sdc_hci_cmd_le_set_connless_cte_transmit_params()

uint8_t sdc_hci_cmd_le_set_connless_cte_transmit_params ( const sdc_hci_cmd_le_set_connless_cte_transmit_params_t * p_params)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Set Connectionless CTE Transmit Parameters.

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

This command is used to set the type, length, and antenna switching pattern for the transmission of Constant Tone Extensions in any periodic advertising on the advertising set identified by the Advertising_Handle parameter.

The CTE_Count parameter specifies how many packets with a Constant Tone Extension are to be transmitted in each periodic advertising event. If the number of packets that would otherwise be transmitted is less than this, the Controller shall transmit sufficient AUX_CHAIN_IND PDUs with no AdvData to make up the number. However, if a change in circumstances since this command was issued means that the Controller can no longer schedule all of these packets, it should transmit as many as possible.

The Switching_Pattern_Length and Antenna_IDs[i] parameters are only used when transmitting an AoD Constant Tone Extension and shall be ignored if CTE_Type specifies an AoA Constant Tone Extension.

Errors:

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

Type   Condition                                                              Error code
MC     Constant Tone Extensions have been enabled in the advertising set.     Command
                                                                              Disallowed (0x0C)
MC     CTE_Length is greater than the maximum length of Constant Tone         Unsupported
       Extension supported.                                                   Feature or
                                                                              Parameter Value
                                                                              (0x11)
MC     CTE_Type is not supported.                                             Unsupported
                                                                              Feature or
                                                                              Parameter Value
                                                                              (0x11)
MC     The Controller is unable to schedule CTE_Count packets in each         Unsupported
       event.                                                                 Feature or
                                                                              Parameter Value
                                                                              (0x11)
MC     Advertising_Handle does not identify an existing handle.               Unknown
                                                                              Advertising
                                                                              Identifier (0x42)
MC     Switching_Pattern_Length is greater than the maximum length            Unsupported
       supported.                                                             Feature or
                                                                              Parameter Value
                                                                              (0x11)
MC     Any of the Antenna_IDs[i] values does not identify an antenna in the   Unsupported
       device’s antenna array (some Controllers might be unable to            Feature or
       determine which values do or do not identify an antenna).              Parameter Value
                                                                              (0x11)

Event(s) generated (unless masked away):

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

Parameters
[in]p_paramsInput parameters.
Return values
0if 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.