From 51ab3c975f846a5b25dbfd1d078d881a1a713535 Mon Sep 17 00:00:00 2001 From: Bastien Nocera Date: Wed, 25 May 2011 16:30:09 +0100 Subject: [PATCH] doc: Add mention of the 6-digit padding problem Passkeys used for Secure Simple pairing should always appear zero-padded in the end-user display, as per specification (5.4 ASSOCIATION MODELS in BLUETOOTH SPECIFICATION Version 2.1 + EDR [vol 1]) --- doc/agent-api.txt | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/agent-api.txt b/doc/agent-api.txt index 0c84e1cca..fca28752a 100644 --- a/doc/agent-api.txt +++ b/doc/agent-api.txt @@ -63,6 +63,10 @@ Methods void Release() During the pairing process this method might be called multiple times to update the entered value. + Note that the passkey will always be a 6-digit number, + so the display should be zero-padded at the start if + the value contains less than 6 digits. + void RequestConfirmation(object device, uint32 passkey) This method gets called when the service daemon @@ -71,6 +75,10 @@ Methods void Release() To confirm the value it should return an empty reply or an error in case the passkey is invalid. + Note that the passkey will always be a 6-digit number, + so the display should be zero-padded at the start if + the value contains less than 6 digits. + Possible errors: org.bluez.Error.Rejected org.bluez.Error.Canceled -- 2.47.3