[PATCH BlueZ 1/5] doc/mgmt: Document Connection Subrate for LE connections and updates

[Kevin Dewald <kevin@simpleble.org>]

With "Bluetooth: MGMT: Send Connection Subrate on LE connection and
update", now in bluetooth-next, the kernel also sends the Connection
Subrate event when an LE connection is established and after each LE
Connection Update, so the connection parameters are known on
controllers without the Shorter Connection Interval feature, and a
failed connection rate change reports the current parameters. Document
this, and the Subrate and Continuation_Number values these events
carry.

Assisted-by: Claude:claude-opus-5.5
---
 doc/mgmt-protocol.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/mgmt-protocol.rst b/doc/mgmt-protocol.rst
index ed2bd3349..bf6a3b200 100644
--- a/doc/mgmt-protocol.rst
+++ b/doc/mgmt-protocol.rst
@@ -5520,6 +5520,11 @@ This event indicates that the connection rate has changed for a device. This
 can be a result of a successful LE Connection Rate Request or a change
 initiated by the remote device.
 
+It is also sent when an LE connection is established and after each LE
+Connection Update, which do not report subrating: the Subrate and
+Continuation_Number parameters then keep the values of the last connection
+rate change, or 1 and 0 if there was none.
+
 Possible values for the Address_Type parameter:
 
 .. csv-table::
@@ -5529,7 +5534,8 @@ Possible values for the Address_Type parameter:
 	0x01, LE Public
 	0x02, LE Random
 
-The Status indicates whether the connection rate change was successful.
+The Status indicates whether the connection rate change was successful. When it
+was not, the other parameters are the current ones of the connection.
 
 The Interval parameter specifies the new connection interval in units of
 0.125 ms.
-- 
2.54.0 (Apple Git-157)