 |
nrfxlib API 3.3.99
|
|
nrfxlib API 3.3.99
|
| 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_v6.3, Vol 4, Part E, Section 7.8.118
This 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.
Errors:
See Section 4.5.2 for a list of error types and descriptions.
Type Condition Error code
MC PHY specifies a value that the Controller does not support, Unsupported Feature or
including a value that is reserved for future use. Parameter Value (0x11)
MC Connection_Handle does not identify a current ACL. 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. |
1.12.0