Skip to content

Commit 4b4ab4e

Browse files
committed
Update Bluetooth configuration docs
1 parent f588456 commit 4b4ab4e

File tree

3 files changed

+36
-12
lines changed

3 files changed

+36
-12
lines changed

docs/configure_with_bluetooth.md

Lines changed: 28 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,20 +19,35 @@ Compatibility Icons
1919
</div>
2020

2121
<figure markdown>
22-
![Configuration menu open over Bluetooth](./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Config%20Menu.png)
22+
23+
![Configuration menu open over Bluetooth](<./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Config%20Menu.png>)
2324
<figcaption markdown>
2425
Configuration menu via Bluetooth
2526
</figcaption>
2627
</figure>
2728

2829
Bluetooth-based configuration provides a quick and easy way to navigate the serial menus as if you were connected over a USB cable. For regular users, this is often the preferred configuration method.
2930

30-
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](connecting_bluetooth.md).
31+
By default, the RTK device will broadcast over BLE and Bluetooth SPP simultaneously. Because BLE does not require pairing, it is what is recommended to connect to out of simplicity. For information about Bluetooth pairing, please see [Connecting Bluetooth](connecting_bluetooth.md).
32+
33+
## Terminal Apps
34+
35+
<figure markdown>
36+
37+
![BLESerial nRF for iOS](<./img/Bluetooth/SparkFun RTK BLE Config on iOS.png>)
38+
<figcaption markdown>
39+
40+
[BLESerial nRF](https://apps.apple.com/us/app/bleserial-nrf/id1632235163) for iOS and [Bluetooth Serial Terminal](https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal&hl=en_US) for Android
41+
</figcaption>
42+
</figure>
43+
44+
For configuration of an RTK device over Bluetooth we recommend [Bluetooth Serial Terminal](https://play.google.com/store/apps/details?id=de.kai_morich.serial_bluetooth_terminal&hl=en_US) for Android (free as of writing) and [BLESerial nRF](https://apps.apple.com/us/app/bleserial-nrf/id1632235163) for iOS (free as of writing). BLESerial nRF can only be used over BLE.
3145

3246
## Entering Bluetooth Echo Mode
3347

3448
<figure markdown>
35-
![Entering the BEM escape characters](./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20EscapeCharacters.png)
49+
50+
![Entering the BEM escape characters](<./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20EscapeCharacters.png>)
3651
<figcaption markdown>
3752
Send the `+++` characters to enter Bluetooth Echo Mode
3853
</figcaption>
@@ -44,7 +59,8 @@ Once connected, the RTK device will report a large amount of NMEA data over the
4459
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.
4560

4661
<figure markdown>
47-
![The GNSS message menu over BEM](./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Config%20Menu.png)
62+
63+
![The GNSS message menu over BEM](<./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Config%20Menu.png>)
4864
<figcaption markdown>
4965
The GNSS Messages menu shown over Bluetooth Echo Mode
5066
</figcaption>
@@ -55,7 +71,8 @@ Once in Bluetooth Echo Mode, any character sent from the RTK unit will be shown
5571
For more information about the Serial Config menu please see [Configure with Serial](configure_with_serial.md).
5672

5773
<figure markdown>
58-
![System output over Bluetooth](./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20System%20Output.png)
74+
75+
![System output over Bluetooth](<./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20System%20Output.png>)
5976
<figcaption markdown>
6077
Exit from the Serial Config Menu
6178
</figcaption>
@@ -68,7 +85,8 @@ Bluetooth can also be used to view system status and output. Simply exit the con
6885
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.
6986

7087
<figure markdown>
71-
![Exiting Bluetooth Echo Mode](./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Exit%20BEM.png)
88+
89+
![Exiting Bluetooth Echo Mode](<./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Exit%20BEM.png>)
7290
<figcaption markdown>
7391
Menu option 'b' for exiting Bluetooth Echo Mode
7492
</figcaption>
@@ -81,7 +99,8 @@ Alternatively, if you wish to stay connected over Bluetooth but need to exit Blu
8199
Here we provide some settings recommendations to make the terminal navigation of the RTK device a bit easier.
82100

83101
<figure markdown>
84-
![Disable Time stamps](./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Settings%20Terminal.png)
102+
103+
![Disable Time stamps](<./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Settings%20Terminal.png>)
85104
<figcaption markdown>
86105
Terminal Settings with Timestamps disabled
87106
</figcaption>
@@ -90,7 +109,8 @@ Terminal Settings with Timestamps disabled
90109
Disable timestamps to make the window a bit wider, allowing the display of longer menu items without wrapping.
91110

92111
<figure markdown>
93-
![Clear on send](./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Settings.png)
112+
113+
![Clear on send](<./img/Bluetooth/SparkFun%20RTK%20BEM%20-%20Settings.png>)
94114
<figcaption markdown>
95115
Clear on send and echo off
96116
</figcaption>
Loading

docs/menu_ports.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -77,15 +77,19 @@ Most applications do not need to plug anything into the **DATA** port. Most user
7777

7878
<figure markdown>
7979

80-
![RADIO and DATA ports on the RTK Postacrd](<./img/Postcard/SparkFun RTK PostCard Ports.png>)
80+
![RADIO and DATA ports on the RTK Postcard](<./img/Postcard/SparkFun RTK PostCard Ports.png>)
8181
<figcaption markdown>
82-
RADIO and DATA ports on the RTK Postacrd
82+
RADIO and DATA ports on the RTK Postcard
8383
</figcaption>
8484
</figure>
8585

86+
<figure markdown>
8687

87-
88-
![alt text](<img/Postcard/SparkFun RTK PostCard USB Channels.png>)
88+
![Dual serial ports show in Device Manager](<./img/Postcard/SparkFun RTK PostCard USB Channels.png>)
89+
<figcaption markdown>
90+
Dual serial ports show in Device Manager
91+
</figcaption>
92+
</figure>
8993

9094
The DATA port on the RTK Postcard is the USB C connector. This connection creates two serial ports. **SERIAL-A** is used for [Serial Configuration](configure_with_serial.md). **SERIAL-B** is connected to the DATA port of the LG290P to receive NMEA and other data directly. The DATA port is also used for [updating the firmware](firmware_update_lg290p.md) on the LG290P.
9195

0 commit comments

Comments
 (0)