doc/bt_manual_v10.md

   1 # MANUAL Bluetooth / Battery add-on 'Blue Shark'
   2 <a id="top"></a>
   3 _rev. v1.1_
   4
   5 ## Table of Contents
   6
   7   * [1. FEATURES](#1-features)
   8   * [2. PARAMETERS](#2-parameters)
   9   * [3. ASSEMBLY STEPS](#3-assembly-steps)
  10   * [4. COMPILATION / FLASHING](#4-compilation--flashing)
  11      * [4.1 From Source](#41-from-source)
  12      * [4.2 Homebrew (macOS)](#42-homebrew-macos)
  13   * [5. CONNECT WITH BLUETOOTH](#5-connect-with-bluetooth)
  14      * [5.1 Windows](#51-windows)
  15         * [5.1.1 Connecting your RDV4.0 with Bluetooth on mobile phone or computer](#511-connecting-your-rdv40-with-bluetooth-on-mobile-phone-or-computer)
  16         * [5.1.2 Fast connection using dedicated USB Bluetooth adapter under Windows](#512-fast-connection-using-dedicated-usb-bluetooth-adapter-under-windows)
  17      * [5.2 Linux](#52-linux)
  18         * [5.2.1 Connecting rdv4.0 with Bluetooth on Linux computer via native Bluetooth support in the client](#521-connecting-rdv40-with-bluetooth-on-linux-computer-via-native-bluetooth-support-in-the-client)
  19         * [5.2.2 Fast connection using dedicated USB Bluetooth adapter under Linux](#522-fast-connection-using-dedicated-usb-bluetooth-adapter-under-linux)
  20         * [5.2.3 (deprecated) Connecting rdv4.0 with Bluetooth on Linux computer via rfcomm](#523-deprecated-connecting-rdv40-with-bluetooth-on-linux-computer-via-rfcomm)
  21      * [5.3 MacOS](#53-macos)
  22         * [5.3.1 Connecting rdv4.0 with Bluetooth on MacOS](#531-connecting-rdv40-with-bluetooth-on-macos)
  23      * [5.4 Android](#54-android)
  24         * [5.4.1 Fast connection using dedicated Bluetooth (HC-06 Master   CP2102) adapter under Android with Termux](#541-fast-connection-using-dedicated-bluetooth-hc-06-master--cp2102-adapter-under-android-with-termux)
  25   * [6. OTHER NOTES](#6-other-notes)
  26      * [6.1 Default settings](#61-default-settings)
  27      * [6.2 UART and LED behavior](#62-uart-and-led-behavior)
  28      * [6.3 Disassembly](#63-disassembly)
  29      * [6.4 Battery charging](#64-battery-charging)
  30      * [6.5 Get better signals](#65-get-better-signals)
  31
  32 ## 1. FEATURES
  33 ^[Top](#top)
  34
  35 * Built-in Bluetooth 2.0 with EDR Bluetooth module, default baud rate 115200.
  36 * Built-in 400 mAh polymer lithium-ion battery, typical standby time up to 3.5 hours.
  37 * Additional heat dissipating fins can significantly reduce the temperature when the HF antenna is in operation for a long time.
  38 * Complete lithium charging management system, seamless switching power supply. Full overcharge and overdischarge protection.
  39 * Bluetooth has an independent power switch that can be turned on or off.
  40 * It's compact and easy to carry. The clamp structure is easy to install and replace.
  41
  42
  43 It can easily connect to Bluetooth mobile phone, portable computer, etc. Without USB cable, complicated permissions or driver settings.
  44
  45 Built-in battery can support standalone mode, off-line sniffing, off-line reading & simulation, etc. The temperature of the device is stable.
  46
  47
  48 ## 2. PARAMETERS
  49 ^[Top](#top)
  50
  51 * Battery capacity:   400 mAh
  52 * Standby time:       3.5h @ StandBy; 2.9h @ LF-On; 50min @ HF-On;
  53 * Charging Current:   200mA (Plug in USB Default Charging)
  54 * Charging time:      2.5h
  55 * Num of charges:     400 -> 70% capacity (standard LIPO)
  56 * Bluetooth power:    4dBm, -85 dBm @ 2Mbps
  57 * Bluetooth distance: 6m (depending on the environment and device orientation)
  58 * Size and weight:    54.4mm * 29.4mm * 13.5mm 24g
  59
  60
  61 ## 3. ASSEMBLY STEPS
  62 ^[Top](#top)
  63
  64 * Unplug your Proxmark3 RDV4.0 device from any usb cable.
  65 * Remove the plastic upper case of Proxmark3 RDV4.0 with opener.
  66 * Remove temporarily the antenna with a H5 (Hex/Allen) screwdriver to expose the FPC interface.<p>
  67   <img src="https://sneaktechnology.com/wp-content/uploads/2019/06/FPC-Interface.png" alt="Image of blue shark add-on fpc interface" width="300"></p>
  68 * Turn off all power switches, insert the FPC wire into the FPC connector, and lock the FPC connector.<p>
  69   <img src="https://sneaktechnology.com/wp-content/uploads/2019/06/FPC-Connected.png" alt="Image of blue shark add-on fpc wire" width="300"></p>
  70 * Tear off the blue film of heat conductive double-sided tape. Align the add-on to the hole positions and gently insert it into the case.<p>
  71   <img src="https://sneaktechnology.com/wp-content/uploads/2019/06/Blue-Film.png" alt="Image of blue shark add-on blue film location" width="300"></p>
  72 * Assembly finished!
  73
  74 <p align='center'>
  75 <img src="http://www.icedev.se/proxmark3/blueshark/addon_open_1.jpg" alt="Image of blue shark add-on open fit" width="300"><img src="http://www.icedev.se/proxmark3/blueshark/addon_fitted_1.jpg" alt="Image of blue shark add-on fitted" width="300">
  76 </p>
  77
  78 ## 4. COMPILATION / FLASHING
  79 ^[Top](#top)
  80
  81 #### 4.1 From Source
  82 ^[Top](#top)
  83
  84 Please download the latest source code from Rfid Research Group's Github repo:
  85 https://github.com/RfidResearchGroup/proxmark3
  86
  87 To compile the client and firmware with FPC support, the easiest way is to
  88
  89 1. Copy the sample file:  `Makefile.platform.sample`  ⇒   `Makefile.platform`
  90     * `cp Makefile.platform.sample Makefile.platform`
  91 2. Edit `Makefile.platform`,  uncomment the line `#PLATFORM_EXTRAS=BTADDON` by removing the `#`
  92 3. Recompile the project:
  93    * `make clean; make -j`
  94 4. Flash the firmware
  95    * `./pm3-flash-fullimage`
  96
  97 You are now ready to run the client with the serial port you got from your BT device on your laptop etc.
  98 See instructions below.
  99
 100 #### 4.2 Homebrew (macOS)
 101 ^[Top](#top)
 102
 103 From the [homebrew-proxmark3 readme](https://github.com/RfidResearchGroup/homebrew-proxmark3)
 104
 105 1. `brew tap rfidresearchgroup/proxmark3`
 106 2. `brew install --with-blueshark proxmark3`
 107
 108
 109 ## 5. CONNECT WITH BLUETOOTH
 110 ^[Top](#top)
 111
 112 You can have both USB cable connect and BT active at the same time and connect to either serial port.
 113 You can also switch serial port from inside the proxmark3 client using the new command `hw connect`.
 114
 115 ### 5.1 Windows
 116 ^[Top](#top)
 117
 118 #### 5.1.1 Connecting your RDV4.0 with Bluetooth on mobile phone or computer
 119 ^[Top](#top)
 120
 121 * Open Bluetooth and search for a device named PM3_RDV4.0.
 122 * Enter the paired password 1234 and establish the connection.
 123 * The blue state LED on the add-on will keep blinking after the connection is established. Only when the mobile phone or computer opens the correct COM port, the blue LED turns on solid, indicating that the connection is successful.
 124
 125 * First time you do this you might need to go into Bluetooth more settings and add a outgoing com port. If so, follow these steps below.
 126
 127 * First open your bluetooth settings,  click on "more options".
 128 <p align='center'>
 129 <img src="http://www.icedev.se/proxmark3/blueshark/bt_more_options.png" alt="Image of bluetooth more options popup" width="300">
 130 </p>
 131 * Go to second tab and view the list of current bluetooth comports. If you don't have an outgoing com port setup, click 'add'
 132 <p align='center'>
 133 <img src="http://www.icedev.se/proxmark3/blueshark/bt_com_ports.png" alt="Image of current bluetooth comports" width="300">
 134 </p>
 135 * Select `outgoing comport` and select the Proxmark3 RDV4.0 device. Click `OK` when done.
 136 <p align='center'>
 137 <img src="http://www.icedev.se/proxmark3/blueshark/bt_add_comport.png" alt="Image of adding outgoing comport" width="300">
 138 </p>
 139 * Verify that you now have a outgoing comport. Remember this com port when you want to use your Proxmark3.
 140 <p align='center'>
 141 <img src="http://www.icedev.se/proxmark3/blueshark/bt_done.png" alt="Image of ok bluetooth outgoing comport" width="300">
 142 </p>
 143 * done!
 144
 145 #### 5.1.2 Fast connection using dedicated USB Bluetooth adapter under Windows
 146 ^[Top](#top)
 147
 148 <p align='center'>
 149 <img src="http://www.icedev.se/proxmark3/blueshark/addon_hc06_dongle_1.jpg" alt="Image of blue shark add-on HC-06 white dongle" width="300"></p>
 150
 151 * Install driver:
 152 http://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers
 153 * Insert the adapter into the USB port. The adapter will search automatically and establish the connection. The adapter will remember the device that was first connected and after that the same device will be connected.
 154 * The adapter button can be used to delete memory so that other add-on can be searched and connected.<p align='center'>
 155     <img src="https://sneaktechnology.com/wp-content/uploads/2019/06/Button.png" alt="Image of blue shark add-on HC-06 white dongle button" width="200">
 156 * After the connection is established, the blue state LED on add-on will turn on solid.
 157 * look for _CP2104 USB tp UART bridge controller_ under devices in order to get the assigned serial port
 158
 159 ### 5.2 Linux
 160 ^[Top](#top)
 161
 162 #### 5.2.1 Connecting rdv4.0 with Bluetooth on Linux computer via native Bluetooth support in the client
 163 ^[Top](#top)
 164
 165 This requires to have compiled the client with Bluetooth support.
 166
 167 Be sure your user has permissions to use Bluetooth
 168
 169   * On most distributions, you've to be part of group `bluetooth`: `sudo adduser $USER bluetooth` then log out and log in
 170   * else, run the following commands as root : `sudo ...`
 171
 172 1. Find the MAC address of the Bluetooth add-on, named PM3_RDV4.0.
 173
 174 ```sh
 175 hcitool scan
 176 Scanning ...
 177   aa:bb:cc:dd:ee:ff PM3_RDV4.0
 178 ```
 179
 180 Instead of `aa:bb:cc:dd:ee:ff`, you'll see your MAC address.
 181
 182 If you don't have `hcitool`, you can use `bluetoothctl` and `scan on` as shown in next section.
 183
 184 2. Use Proxmark client with Bluetooth MAC address as bt:<mac>
 185
 186 ```sh
 187 ./proxmark3 -p bt:aa:bb:cc:dd:ee:ff
 188 ```
 189 The first time, your OS will ask you for pairing. The default PIN is
 190 1234. If PIN is not typed in quickly, the client might timeout. Simply
 191 restart it again after pairing.
 192
 193 If your OS doesn't prompt you for pairing, you can do it in command line, e.g. (again, replace with your addon MAC address):
 194
 195 ```sh
 196 bluetoothctl
 197 [bluetooth]# pairable on
 198 [bluetooth]# scan on
 199 Discovery started
 200 ...
 201 [CHG] Device aa:bb:cc:dd:ee:ff Name: PM3_RDV4.0
 202 [bluetooth]# trust aa:bb:cc:dd:ee:ff
 203 [bluetooth]# pair aa:bb:cc:dd:ee:ff
 204 [agent] Enter PIN code: 1234
 205 [bluetooth]# quit
 206 ```
 207
 208 #### 5.2.2 Fast connection using dedicated USB Bluetooth adapter under Linux
 209 ^[Top](#top)
 210
 211 <p align='center'>
 212 <img src="http://www.icedev.se/proxmark3/blueshark/addon_hc06_dongle_1.jpg" alt="Image of blue shark add-on HC-06 white dongle" width="300"></p>
 213
 214   1. Insert the adapter into the USB port. The adapter will search
 215 automatically and establish the connection. The adapter will remember
 216 the device that was first connected and after that the same device will
 217 be connected.
 218
 219   2. The adapter button can be used to delete memory so that other add-on
 220 can be searched and connected.<p align='center'>
 221      <img src="https://sneaktechnology.com/wp-content/uploads/2019/06/Button.png" alt="Image of blue shark add-on HC-06 white dongle button" width="200">
 222 </p>
 223
 224   3. After the connection is established, the blue state LED on add-on will
 225 turn on solid.
 226
 227   4. a serial port `/dev/ttyUSB0` will be created, use Proxmark3 client on it
 228 ```sh
 229 ./proxmark3 -p /dev/ttyUSB0
 230 ```
 231
 232 #### 5.2.3 (deprecated) Connecting rdv4.0 with Bluetooth on Linux computer via rfcomm
 233 ^[Top](#top)
 234
 235 rfcomm is a deprecated tool which might be unavailable in your Linux distribution.
 236
 237 1. Find the MAC address of the Bluetooth add-on, named PM3_RDV4.0.
 238
 239 ```sh
 240 hcitool scan
 241 Scanning ...
 242   aa:bb:cc:dd:ee:ff PM3_RDV4.0
 243 ```
 244
 245 Instead of `aa:bb:cc:dd:ee:ff`, you'll see your MAC address.
 246
 247 2. Bind your BT add-on MAC address to a serial port
 248 ```sh
 249 sudo rfcomm bind rfcomm0 aa:bb:cc:dd:ee:ff
 250 ```
 251
 252 Replace `aa:bb:cc:dd:ee:ff` by your MAC address.
 253
 254 3. The blue state LED on the add-on will keep blinking after the
 255 connection is established. Only when the Proxmark3 client opens the
 256 `/dev/rfcomm0` port, the blue LED turns on solid, indicating that the
 257 connection is successful.
 258
 259 4. Use Proxmark client on BT-serial port
 260 ```sh
 261 ./proxmark3 -p /dev/rfcomm0
 262 ```
 263
 264 See instructions above (method 1) for initial pairing.
 265
 266 ### 5.3 MacOS
 267 ^[Top](#top)
 268
 269 #### 5.3.1 Connecting rdv4.0 with Bluetooth on MacOS
 270 ^[Top](#top)
 271
 272 With MacOS Mojave 10.14.5 you could experience some continuously disconnecting and difficult to reconnect the device at the system wakeup, to avoid this problem do a PRAM reset before to add your Proxmark3 RDV4 Blue Shark:
 273
 274   1. Open a Terminal and execute this command: sudo rm -R /Library/Preferences/com.apple.Bluetooth.plist.
 275   2. Shut down your Mac.
 276   3. Then turn it on and immediately press and hold these four keys together: Option, Command, P, and R.
 277   4. You can release the keys after about 20 seconds, during which your Mac might appear to restart.
 278
 279 After reboot you can go ahead to pairing your Proxmark3 RDV4 Blue Shark:
 280
 281   5. Make sure the Blue Shark BT switch is turned ON
 282   6. On your Mac, choose Apple menu -> System Preferences, then click Bluetooth.
 283   7. Select the device in the list, then click Connect and add the 1234 pwd.
 284   8. A serial port like `/dev/tty.PM3_RDV40-DevB` will be created, use Proxmark3 client on it
 285
 286 ```sh
 287 ./proxmark3 -p /dev/tty.PM3_RDV40-DevB
 288 ```
 289 ### 5.4 Android
 290 ^[Top](#top)
 291
 292 #### 5.4.1 Fast connection using dedicated Bluetooth (HC-06 Master + CP2102) adapter under Android with Termux
 293 ^[Top](#top)
 294
 295   1. Make sure you already followed this tutorial https://github.com/RfidResearchGroup/proxmark3/blob/master/doc/termux_notes.md#setup and have Termux with an running Proxmark3 client ready. You need additional the `cp210x` serial usb driver enabled and working, like the `USB_ACM` driver to communicate wireless.
 296   2. Insert the Bluetooth adapter with an fitting USB-C/Micro-USB converter into your Android USB port and a serial port `/dev/ttyUSB0` will be created. To see if it's working, run `tsudo ls /dev/ttyU*` and it should list `/dev/ttyUSB0`.
 297   3. The adapter will search automatically and establish the connection to BlueShark. The adapter will remember the device that was first connected and after that the same device will be connected. After the connection is established, the blue state LED on add-on will turn on solid.
 298   4. If you see this, congratulations, you can run your Proxmark3 client in Termux with `tsudo proxmark3/client/proxmark3 -p /dev/ttyUSB0`
 299
 300 ## 6. OTHER NOTES
 301 ^[Top](#top)
 302
 303 ### 6.1 Default settings
 304 ^[Top](#top)
 305
 306 Settings of the Blue Shark add-on and of the white dongle:
 307
 308 1. Serial: `115200 8N1`
 309 2. Name:  `PM3_RDV4.0`
 310 3. Pin: `1234`
 311
 312 If you bought your Bluetooth adapter dongle somewhere else, make sure to set the baud rate to 115200 `AT+BAUD8`, the name `AT+NAMEPM3_RDV4.0` and PIN `AT+PIN1234` correctly.
 313
 314 ### 6.2 UART and LED behavior
 315 ^[Top](#top)
 316
 317 Bluetooth is connected to Proxmark3 RDV4.0 via UART. The USB and UART interfaces of RDV4.0 can coexist without conflict, and no special switching is required.
 318
 319 The following link has helpful notes on UART usage and baud rates:
 320 https://github.com/RfidResearchGroup/proxmark3/blob/master/doc/uart_notes.md
 321
 322 ### 6.3 Disassembly
 323 ^[Top](#top)
 324
 325 There is a heat conductive double-sided tape inside the add-on, which has strong adhesive force. Therefore, if add-on needs to be removed, it needs to be pulled out from the heat sink end with greater efforts. Each disassembly will reduce the viscidity of double-sided tape. When double-sided tape is well protected, it will not affect the second use. Thermal conductivity will be slightly worse and will therefore have a direct impact on the thermal performance of the heat sink.
 326
 327 ### 6.4 Battery charging
 328 ^[Top](#top)
 329
 330 The battery charging circuit is turned on by default. Any time a USB cable is inserted, the battery will be automatically charged. The red LED will remain bright when charging.
 331 The red LED will be extinguished when charging is completed.
 332
 333 ### 6.5 Get better signals
 334 ^[Top](#top)
 335
 336 For the better heat dissipation, we have used a cast metal enclosure for the add-on. As a result Bluetooth wireless signals are sacrificed. For example, if the back of add-on is facing the Bluetooth host, the signal is very bad and the distance will be reduced. The best signal strength can be obtained when the front glass faces the Bluetooth host.
 337 If the Proxmark3 is not responding, it may be due to a poor Bluetooth connection. To improve performance, try repositioning the Proxmark3 so the glass face is directed toward the host.
 338