Skip to content

Commit 212baf8

Browse files
committed
Adding docs for Bluetooth Echo Mode
1 parent 434fbd7 commit 212baf8

8 files changed

+60
-0
lines changed

docs/configure_with_bluetooth.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# Configure with Bluetooth
2+
3+
Surveyor: ![Feature Supported](img/GreenDot.png) / Express: ![Feature Supported](img/GreenDot.png) / Express Plus: ![Feature Supported](img/GreenDot.png) / Facet: ![Feature Supported](img/GreenDot.png) / Facet L-Band: ![Feature Supported](img/GreenDot.png)
4+
5+
![Configuration menu open over Bluetooth](img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Config%20Menu.png)
6+
7+
*Configuration menu via Bluetooth*
8+
9+
Starting with firmware v2.7, Bluetooth-based configuration is supported. For more information about updating the firmware on your device, please see [Updating RTK Firmware](https://sparkfun.github.io/SparkFun_RTK_Firmware/firmware_update/).
10+
11+
The RTK device will be a discoverable Bluetooth device (both BT SPP and BLE are supported). For information about Bluetooth pairing, please see [Connecting Bluetooth](/docs/connecting_bluetooth.md).
12+
13+
## Entering Bluetooth Echo Mode
14+
15+
![Entering the BEM escape characters](img/Bluetooth/SparkFun%20RTK%20BEM%20-%20EscapeCharacters.png)
16+
17+
Once connected, the RTK device will report a large amount of NMEA data over the link. To enter Bluetooth Echo Mode send the characters +++.
18+
19+
**Note:** There must be a 2 second gap between any serial sent from a phone to the RTK device, and any escape characters. In almost all cases this is not a problem. Just be sure it's been 2 seconds since an NTRIP source has been turned off and attempting to enter Bluetooth Echo Mode.
20+
21+
![The GNSS message menu over BEM](img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Config%20Menu.png)
22+
23+
*The GNSS Messages menu shown over Bluetooth Echo Mode*
24+
25+
Once in Bluetooth Echo Mode, any character sent from the RTK unit will be shown in the Bluetooth app, and any character sent from the connected device (cell phone, laptop, etc) will be received by the RTK device. This allows the opening of the config menu as well as the viewing of all regular system output.
26+
27+
For more information about the Serial Config menu please see [Configure with Serial](/docs/configure_with_serial.md).
28+
29+
![System output over Bluetooth](img/Bluetooth/SparkFun%20RTK%20BEM%20-%20System%20Output.png)
30+
31+
*Exit from the Serial Config Menu*
32+
33+
Bluetooth can also be used to view system status and output. Simply exit the config menu using option 'x' and the system output can be seen.
34+
35+
## Exit Bluetooth Echo Mode
36+
37+
To exit Bluetooth Echo Mode simply disconnect Bluetooth. In the Bluetooth Serial Terminal app, this is done by pressing the 'two plugs' icon in the upper right corner.
38+
39+
![Exiting Bluetooth Echo Mode](img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Exit%20BEM.png)
40+
41+
*Menu option 'b' for exiting Bluetooth Echo Mode*
42+
43+
Alternatively, if you wish to stay connected over Bluetooth but need to exit Bluetooth Echo Mode, use the 'b' menu option from the main menu.
44+
45+
## Serial Bluetooth Terminal Settings
46+
47+
Here we provide some settings recommendations to make the terminal navigation of the RTK device a bit easier.
48+
49+
![Disable Time stamps](img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Settings%20Terminal.png)
50+
51+
*Terminal Settings with Timestamps disabled*
52+
53+
Disable timestamps to make the window a bit wider, allowing the display of longer menu items without wrapping.
54+
55+
![Clear on send](img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Settings.png)
56+
57+
*Clear on send and echo off*
58+
59+
Clearing the input box when sending is very handy as well as turning off local echo.
57.6 KB
Loading
140 KB
Loading
58.2 KB
Loading
35.3 KB
Loading
29.5 KB
Loading
72 KB
Loading

mkdocs.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,7 @@ nav:
8282
- displays.md
8383
- system_configuration.md
8484
- configure_with_wifi.md
85+
- configure_with_bluetooth.md
8586
- configure_with_serial.md
8687
- configure_with_settings_file.md
8788
- configure_ucenter.md

0 commit comments

Comments
 (0)