sdc_hci_cmd_le_set_transmit_power_reporting_enable()

uint8_t sdc_hci_cmd_le_set_transmit_power_reporting_enable	(	const sdc_hci_cmd_le_set_transmit_power_reporting_enable_t *	p_params,
		sdc_hci_cmd_le_set_transmit_power_reporting_enable_return_t *	p_return
	)

#include <softdevice_controller/include/sdc_hci_cmd_le.h>

LE Set Transmit Power Reporting Enable.

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

The HCI_LE_Set_Transmit_Power_Reporting_Enable command is used to enable or disable the reporting to the local Host of transmit power level changes in the local and remote Controllers for the ACL connection identified by the Connection_Handle parameter.

If the Remote_Enable parameter is set to 0x01 and no prior LE Power Control Request procedure has been initiated on the ACL connection, then the Control- ler shall initiate a new LE Power Control Request procedure on that ACL.

Reporting is disabled when the connection is first created.

If the Connection_Handle parameter does not identify a current ACL connection, the Controller shall return the error code Unknown Connection Identifier (0x02).

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

When local reporting is enabled, the Controller shall generate an HCI_LE_- Transmit_Power_Reporting event with Reason 0x00 each time the local transmit power level is changed.

When remote reporting is enabled, the Controller shall generate an HCI_LE_- Transmit_Power_Reporting event with Reason 0x01 each time it becomes aware that the remote transmit power level has changed.

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.