proxmark3/doc/bt_manual_v10.md

# MANUAL 
### Bluetooth / Battery add-on 'Blue Shark'
_rev. v1.0 (draft)_

### 1.	FEATURES

*	Built-in Bluetooth 2.0 with EDR Bluetooth module, default baud rate 115200.
*	Built-in 400 mAh polymer lithium-ion battery, typical standby time up to 3.5 hours.
*	Additional heat dissipating fins can significantly reduce the temperature when the HF antenna is in operation for a long time.
*	Complete lithium charging management system, seamless switching power supply. Full overcharge and overdischarge protection.
*	Bluetooth has an independent power switch that can be turned on or off.
*	It's compact and easy to carry. The clamp structure is easy to install and replace.


It can easily connect to Bluetooth mobile phone, portable computer, etc. Without USB cable, complicated permissions or driver settings.

Built-in battery can support standalone mode, off-line sniffing, off-line reading & simulation, etc. The temperature of the device is stable.


### 2.	PARAMETER

*	Battery capacity:	400 mAh
*	Standby time:		3.5h @ StandBy; 2.9h @ LF-On; 50min @ HF-On;
*	Charging Current:	200mA (Plug in USB Default Charging)
*	Charging time:		2.5h
*	Num of charges:         400 -> 70% capacity (standard LIPO)
*	Bluetooth power:	4dBm, -85 dBm @ 2Mbps
*	Bluetooth distance:	6m (depending on the environment and device orientation)
*	Size and weight:	54.4mm * 29.4mm * 13.5mm 24g


### 3.	ASSEMBLY STEPS

*	Unplug your Proxmark3 RDV4.0 device from any usb cable.
*	Remove the plastic upper case of Proxmark3 RDV4.0 with opener.
*	Remove temporarily the antenna with a screwdriver to expose the FPC interface.
*	Turn off all power switches, insert the FPC wire into the FPC connector, and lock the FPC connector.
*	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.
*	Assembly finished!

<p align='center'>
<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">
</p>

### 4.	CONNECT WITH BLUETOOTH

#### Windows

#### (1)	Connecting your RDV4.0 with Bluetooth on mobile phone or computer
*	Open Bluetooth and search for a device named PM3_RDV4.0.
*	Enter the paired password 1234 and establish the connection.
*	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.

#### (2)	Fast connection using dedicated USB Bluetooth adapter
*	Install driver:
http://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers  
*	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.
*	The adapter button can be used to delete memory so that other add-on can be searched and connected.
*	After the connection is established, the blue state LED on add-on will turn on solid.
*	look for _CP2104 USB tp UART bridge controller_ under devices in order to get the assigned serial port

#### Linux

#### (1) Connecting rdv4.0 with Bluetooth on Linux computer

1. Find the MAC address of the Bluetooth add-on, named PM3_RDV4.0.
	
```sh
sudo hcitool scan
Scanning ...
  aa:bb:cc:dd:ee:ff PM3_RDV4.0
```

Instead of `aa:bb:cc:dd:ee:ff`, you'll see your MAC address.

2. Bind your BT add-on MAC address to a serial port
```sh
sudo rfcomm bind rfcomm0 aa:bb:cc:dd:ee:ff
```

Replace `aa:bb:cc:dd:ee:ff` by your MAC address.

3. The blue state LED on the add-on will keep blinking after the
connection is established. Only when the Proxmark3 client opens the
`/dev/rfcomm0` port, the blue LED turns on solid, indicating that the
connection is successful.

4. Use Proxmark client on BT-serial port
```sh
./proxmark /dev/rfcomm0
```
The first time, your OS will ask you for pairing. The default PIN is
1234. If PIN is not typed in quickly, the client might timeout. Simply
restart it again after pairing.

#### (2) Fast connection using dedicated USB Bluetooth adapter under Linux

  1. 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.

  2. The adapter button can be used to delete memory so that other add-on
can be searched and connected.

  3. After the connection is established, the blue state LED on add-on will
turn on solid.

  4. a serial port `/dev/ttyUSB0` will be created, use Proxmark3 client on it
```sh
./proxmark /dev/ttyUSB0
```
<p align='center'>
<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>

### 5. Compiling / Flashing 
Please download the latest source code from Rfid Research Group's Github repo:
https://github.com/RfidResearchGroup/proxmark3


### 6.	OTHER NOTES

#### (1)	UART and LED behavior
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. 

The following link has helpful notes on UART usage and baud rates:
https://github.com/RfidResearchGroup/proxmark3/blob/master/doc/uart_notes.md

#### (2)	Disassembly
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.

#### (3)	Battery charging
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. 
The red LED will be extinguished when charging is completed.

#### (4)	Get better signals
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.
	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.