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_v5.4, 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 transmit- ted 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 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 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.

Event(s) generated (unless masked away): When the HCI_LE_Periodic_Advertising_Response_Data command has com- pleted, 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.