On Wed, 2022-05-04 at 14:09 -0700, Zhengping Jiang wrote: > Bonded flag is used to indicate the link key or ltk of the remote > device has been stored. > > Reviewed-by: Sonny Sasaka <sonnysasaka@xxxxxxxxxxxx> > Reviewed-by: Yun-Hao Chung <howardchung@xxxxxxxxxxxx> > > Signed-off-by: Zhengping Jiang <jiangzp@xxxxxxxxxx> > --- > > Changes in v3: > - Move documentation update to a separate patch > - Add description to bonded and paired > > doc/device-api.txt | 12 +++++++++++- > 1 file changed, 11 insertions(+), 1 deletion(-) > > diff --git a/doc/device-api.txt b/doc/device-api.txt > index 1e8590b27d58..c7e217c07526 100644 > --- a/doc/device-api.txt > +++ b/doc/device-api.txt > @@ -246,7 +246,17 @@ Properties string Address [readonly] > > boolean Paired [readonly] > > - Indicates if the remote device is paired. > + Indicates if the remote device is paired. Pairing is > + the process where devices exchange the information to > + establish an encrypted connection. > + > + boolean Bonded [readonly] > + > + Indicates if the remote device is bonded. Bonded means > + the link key or the ltk from the pairing process has > + been stored. "long-term key (LTK)" Is Paired effectively the same as Bonded for Classic devices? If so, would be great to mention. > + A PropertiesChanged signal indicate changes to this > + status. > > boolean Connected [readonly] >