sdc_hci_cmd_le_set_periodic_adv_response_data()

uint8_t sdc_hci_cmd_le_set_periodic_adv_response_data	(	const sdc_hci_cmd_le_set_periodic_adv_response_data_t *	p_params,
		sdc_hci_cmd_le_set_periodic_adv_response_data_return_t *	p_return )

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Set Periodic Advertising Response Data.

The description below is extracted from Core_v6.0, Vol 4, Part E, Section 7.8.126

The HCI_LE_Set_Periodic_Advertising_Response_Data command is used by the Host to set the data for a response slot in a specific subevent of the PAwR identified by the Sync_Handle. The data for a response slot shall be transmitted only once.

The Request_Event parameter identifies the periodic advertising event in which the periodic advertising packet that the Host is responding to was received.

The Request_Subevent parameter identifies the subevent in which the periodic advertising packet that the Host is responding to was received.

The Response_Subevent parameter identifies the subevent that the response shall be sent in.

The Response_Slot parameter identifies the response slot in the subevent identified by the Response_Subevent parameter in which this response data is to be transmitted.

The Response_Data_Length specifies the length of the Response_Data that is significant.

The Response_Data contains the advertising data to be transmitted in the response slot. If the Response_Data_Length is greater than the maximum that the Controller can transmit within the response slot, then the Response_Data shall be discarded and the Controller shall return the error code Packet Too Long (0x45). If the periodic advertising train is on the LE Coded PHY, then the S=8 coding shall be assumed.

If the response slot identified by the Response_Slot parameter has passed by the time this command is received by the Controller, the Controller shall return the error code Too Late (0x46) and discard the Response_Data parameter. If Response_Subevent exceeds numSubevents of the periodic advertising train, or the Controller is not synchronized with the subevent, then the Controller should return the error code Command Disallowed (0x0C).

Event(s) generated (unless masked away): When the HCI_LE_Periodic_Advertising_Response_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.