 |
nrfxlib API 3.3.99
|
|
nrfxlib API 3.3.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.3, Vol 4, Part E, Section 7.8.18
This 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 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.
Errors:
See Section 4.5.2 for a list of error types and descriptions.
Type Condition Error code
MC One or more CS procedures are enabled. Command Disallowed
(0x0C)
M The Controller is the Peripheral and the local Controller does not Unsupported Feature
support the Connection Parameters Request procedure (see [Vol 6] or Parameter Value
Part B, Section 5.1.7). (0x11)
M The Controller is the Peripheral and the local Controller supports Unsupported Remote
the Connection Parameters Request procedure but the peer Feature (0x1A)
Controller does not.
R Max_CE_Length is less than Min_CE_Length Invalid HCI Command
Parameters (0x12)
MC A Connection Rate Request procedure or a Connection Rate Update Command Disallowed
procedure is in progress. (0x0C)
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