debugger: add the wiki text to setup TRK on Linux/Bluetooth

1 files changed, 22 insertions, 0 deletions

diff --git a/tests/manual/trk/README b/tests/manual/trk/README
index e925e06510..c6ce19808e 100644
--- a/tests/manual/trk/README
+++ b/tests/manual/trk/README
@@ -19,3 +19,25 @@ To do:
 - setting breakpoints by filename:line
 - signaling of stopped/single step end. SIGTRAP? SIGSTOP?
 - run it against the red brick
+
+
+Setting up TRK on Linux with Bluetooth 
+
+Enter the following commands in a terminal (all as root, adjust device
+permissions as required to work as user):
+
+
+sdptool add SP         # announce Serial Port Profile via Service Discovery Protocol
+sudo mknod /dev/rfcomm0 c 216 0 # Creates a Bluetooth Serial Device
+sudo chmod ugo+rw /dev/rfcomm0  # Give permissions)
+
+rfcomm listen /dev/rfcomm0 1 $PWD/trklauncher -v -f {}
+
+#This should print the Trk/CPU versions. The option -f tells the command to
+#disable the serial frames message encapsulation for BlueTooth.
+
+#The same with the debug adapter:
+
+rfcomm listen /dev/rfcomm0 1 $PWD/run.pl  -af -av -w {}
+
+#Important options: -w wait for adapter, -af omit serial frame.