 |
nrfxlib API 2.8.99
|
|
nrfxlib API 2.8.99
|
| uint8_t sdc_hci_cmd_le_conn_update | ( | const sdc_hci_cmd_le_conn_update_t * | p_params | ) |
#include <softdevice_controller/include/sdc_hci_cmd_le.h>
LE Connection Update.
The description below is extracted from Core_v6.0, Vol 4, Part E, Section 7.8.18
The HCI_LE_Connection_Update command is used to change the ACL connection parameters. This command may be issued on both the Central and Peripheral.
The Connection_Interval_Min and Connection_Interval_Max parameters are used to define the minimum and maximum allowed connection interval. The Connection_Interval_Min parameter shall not be greater than the Connection_Interval_Max parameter.
The Max_Latency parameter shall define the maximum allowed Peripheral latency.
The Supervision_Timeout parameter shall define the link supervision timeout for the LE link. The Supervision_Timeout in milliseconds shall be larger than (1 + Max_Latency) × Subrate_Factor × Connection_Interval_Max × 2, where Connection_Interval_Max is given in milliseconds and Subrate_Factor is the current subrate factor of the connection.
The Min_CE_Length and Max_CE_Length are information parameters providing the Controller with a hint about the expected minimum and maximum length of the connection events. The Min_CE_Length shall be less than or equal to the Max_CE_Length.
The actual parameter values selected by the Link Layer may be different from the parameter values provided by the Host through this command.
If this command completes successfully and the connection interval has changed, then the subrating factor shall be set to 1 and the continuation number to 0. In this case, Max_Latency must be interpreted in underlying connection events. Otherwise the subrating factor and continuation number shall be unchanged and Max_Latency must be interpreted in subrated events. If the Host issues this command when one or more CS procedures have been enabled using the HCI_LE_CS_Procedure_Enable command, then the Controller shall return the error code Command Disallowed (0x0C).
If the Host issues this command on a Connection_Handle where the Controller is the Peripheral and either the local or peer Controller does not support the Connection Parameters Request procedure (see [Vol 6] Part B, Section 5.1.7), then the Controller shall return an error which should use the error code Unsupported Feature or Parameter Value (0x11) if the local Controller does not support that procedure and Unsupported Remote Feature (0x1A) if the local Controller supports that procedure but the peer Controller does not.
Event(s) generated (unless masked away): When the Controller receives the HCI_LE_Connection_Update command, the Controller sends the HCI_Command_Status event to the Host. The HCI_LE_Connection_Update_Complete event shall be generated after the connection parameters have been applied by the Controller or if the command subsequently fails.
| [in] | p_params | Input parameters. |
| 0 | if success. |
1.12.0