sdc_hci_cmd_le_set_periodic_adv_subevent_data()

uint8_t sdc_hci_cmd_le_set_periodic_adv_subevent_data	(	const sdc_hci_cmd_le_set_periodic_adv_subevent_data_t *	p_params,
		sdc_hci_cmd_le_set_periodic_adv_subevent_data_return_t *	p_return
	)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Set Periodic Advertising Subevent Data.

The description below is extracted from Core_v5.4, Vol 4, Part E, Section 7.8.125

The HCI_LE_Set_Periodic_Advertising_Subevent_Data command is used by the Host to set the data for one or more subevents of PAwR in reply to an HCI_LE_Periodic_Advertising_Subevent_Data_Request event. The data for a subevent shall be transmitted only once.

The Advertising_Handle parameter identifies the advertising set whose peri- odic advertising subevent data is being set. If the corresponding advertising set does not already exist, then the Controller shall return the error code Unknown Advertising Identifier (0x42).

The Num_Subevents parameter is the number of subevent data contained in the parameter arrays.

The Subevent arrayed parameter identifies the subevent of the PAwR that is being set. If the Host provides a subevent value that is outside of the range of subevents requested using the HCI_LE_Periodic_Advertising_Subevent_- Data_Request event, then the Controller shall return the error code Command Disallowed (0x0C).

The Response_Slot_Start and Response_Slot_Count arrayed parameters identify the starting response slot and the number of response slots that are expected to be used in this subevent.

The Subevent_Data_Length arrayed parameter determines the length of the Subevent_Data that is significant.

The Subevent_Data arrayed parameter contains the advertising data to be transmitted in the subevent of the advertising set. If the combined data length is greater than the maximum that the Controller can transmit within the current subevent interval, then all data shall be discarded and the Controller shall return the error code Packet Too Long (0x45). If advertising on the LE Coded PHY, then the S=8 coding shall be assumed unless the current advertising parameters require the use of S=2 for an advertising physical channel, in which case the S=2 coding shall be assumed for that advertising physical channel. If the Subevent_Data cannot be transmitted because, for example, the subev- ent where this data would have been sent has already passed or is too early, then the Controller shall return the error code Too Late (0x46) or Too Early (0x47) and discard the data.

Event(s) generated (unless masked away): When the HCI_LE_Set_Periodic_Advertising_Subevent_Data command has completed, an HCI_Command_Complete event shall be generated.

Parameters

[in]	p_params	Input parameters.
[out]	p_return	Extra return 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.