Hi Bastien, On Wed, May 4, 2022 at 2:37 PM Bastien Nocera <hadess@xxxxxxxxxx> wrote: > > 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. There are some rare occasion where the link-keys cannot be persisted/stored (e.g. debug keys), but in the other hand Bonded would always means Paired, perhaps this is useful if you want to persist some device information at upper layers otherwise I can't think of any other use of Bonded over Paired. > > + A PropertiesChanged signal indicate changes to this > > + status. > > > > boolean Connected [readonly] > > > -- Luiz Augusto von Dentz
