Bluetooth: host: Document peripheral bt_conn_le_conn_update behavior
Document the behavior of the bt_conn_le_conn_update API when the local device is the peripheral role. Signed-off-by: Joakim Andersson <joakim.andersson@nordicsemi.no>
This commit is contained in:
parent
3d3119b1e7
commit
f2a23ee166
|
@ -395,6 +395,10 @@ int bt_conn_get_remote_info(struct bt_conn *conn,
|
||||||
struct bt_conn_remote_info *remote_info);
|
struct bt_conn_remote_info *remote_info);
|
||||||
|
|
||||||
/** @brief Update the connection parameters.
|
/** @brief Update the connection parameters.
|
||||||
|
*
|
||||||
|
* If the local device is in the peripheral role then updating the connection
|
||||||
|
* parameters will be delayed. This delay can be configured by through the
|
||||||
|
* @option{CONFIG_BT_CONN_PARAM_UPDATE_TIMEOUT} option.
|
||||||
*
|
*
|
||||||
* @param conn Connection object.
|
* @param conn Connection object.
|
||||||
* @param param Updated connection parameters.
|
* @param param Updated connection parameters.
|
||||||
|
|
|
@ -527,9 +527,15 @@ config BT_CONN_PARAM_UPDATE_TIMEOUT
|
||||||
|
|
||||||
help
|
help
|
||||||
The value is a timeout used by peripheral device to wait until it
|
The value is a timeout used by peripheral device to wait until it
|
||||||
starts the connection parameters update procedure to change default
|
starts the first connection parameters update procedure after a
|
||||||
connection parameters. The default value is set to 5s, to comply
|
connection has been established.
|
||||||
with BT protocol specification: Core 4.2 Vol 3, Part C, 9.3.12.2
|
The connection parameters requested will be the parameters set by the
|
||||||
|
application, or the peripheral preferred connection parameters if
|
||||||
|
configured.
|
||||||
|
The default value is set to 5 seconds, to comply with the Bluetooth
|
||||||
|
Core specification: Core 4.2 Vol 3, Part C, 9.3.12.2:
|
||||||
|
"The Peripheral device should not perform a Connection Parameter
|
||||||
|
Update procedure within 5 seconds after establishing a connection."
|
||||||
|
|
||||||
endif # BT_CONN
|
endif # BT_CONN
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue