summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJoão Paulo Rechi Vita <jprvita@openbossa.org>2012-02-27 17:36:43 -0300
committerJoão Paulo Rechi Vita <jprvita@openbossa.org>2012-02-27 17:40:09 -0300
commitd1a1df1e2e441ff9175a7255060971157f795897 (patch)
tree2bc336aa6e5b8af51b122a40fcd88b4a9e6fa091
parente1bd6bc0d9e0dfb87492c629c21f0451b363fc06 (diff)
downloadbluez-le-docs-d1a1df1e2e441ff9175a7255060971157f795897.tar.gz
bluez-le-docs-d1a1df1e2e441ff9175a7255060971157f795897.tar.xz
bluez-le-docs-d1a1df1e2e441ff9175a7255060971157f795897.zip
howto: improve explanation of simple-agent
-rw-r--r--howto.tex14
1 files changed, 8 insertions, 6 deletions
diff --git a/howto.tex b/howto.tex
index afd8a42..5142ccc 100644
--- a/howto.tex
+++ b/howto.tex
@@ -353,8 +353,8 @@ Without any parameter \verb|btmgmt find| will perform interleaved discovery:
\subsubsection{Pairing}
The \verb|simple-agent| is a script that acts as an UI agent for Bluetooth
-adapters. If you want to pair with a Bluetooth device without using the {\em
-gnome-bluetooth} agent, for example, then this is right tool for that.
+adapters, handling \verb|bluetoothd| requests for UI actions, like presenting a
+PIN prompt and similar operations.
Registering an agent to handle incoming pairing requests, on {\em hciX} ({\em
hciX} should be changed with the correct adapter name):
@@ -364,10 +364,12 @@ $ simple-agent hciX
\end{verbatim}
If it all works, the message {\em Agent registered} will be printed on the
-console. Pairing can now be started on the remote device and the script will
-ask for the PIN code. After entering it followed by Enter, if no error occurs,
-the device will be paired with the adapter it is handling. After that
-\verb|simple-agent| can be interrupted with Ctrl-C.
+console. Note that the agent doesn't set the adapter as {\em Discoverable} or
+{\em Connectable}, this should be done via the MGMT interface.
+
+Pairing can now be started on the remote device and \verb|simple-agent| will
+ask for the PIN code, if needed. After entering it followed by Enter, if no
+error occurs, the device will be paired with the adapter it is handling.
To start pairing with a specific device: