nrfxlib API 0.1.0
|
uint8_t sdc_hci_cmd_le_read_remote_transmit_power_level | ( | const sdc_hci_cmd_le_read_remote_transmit_power_level_t * | p_params | ) |
#include <softdevice_controller/include/sdc_hci_cmd_le.h>
LE Read Remote Transmit Power Level.
The description below is extracted from Core_v5.4, Vol 4, Part E, Section 7.8.118
The HCI_LE_Read_Remote_Transmit_Power_Level command is used to read the transmit power level used by the remote Controller on the ACL connection that is identified by the Connection_Handle parameter and the PHY indicated by the PHY parameter.
The local Controller may use the remote transmit power level value obtained from a prior Power Change Indication or Power Control Request procedure (see [Vol 6] Part B, Section 5.1.17 and [Vol 6] Part B, Section 5.1.18). If the Controller chooses not to use these prior values, or if no prior value is available for one or more of the remote transmit power level, maximum transmit power level, or minimum transmit power level, the local Controller shall initiate a new Power Control Request procedure to obtain the remote transmit power level.
If the Host sets PHY to a value that the Controller does not support, including a value that is reserved for future use, the Controller shall return the error code Unsupported Feature or Parameter Value (0x11).
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 Controller receives the HCI_LE_Read_Remote_Transmit_Power_- Level command, the Controller shall send the HCI_Command_Status event to the Host. When the Controller has determined the remote transmit power, it shall generate an HCI_LE_Transmit_Power_Reporting event with Reason 0x02.
[in] | p_params | Input parameters. |
0 | if success. |