Skip to content

Commit ef9b57b

Browse files
committed
Docs: Add mock location
1 parent 352a81b commit ef9b57b

5 files changed

+29
-0
lines changed

docs/connecting_bluetooth.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,35 @@ When powered on, the RTK product will broadcast itself as either '[Platform] Rov
2222

2323
**Note:** For devices with a built-in display, *B022* is the last four digits of your unit's MAC address and will be unique to the device in front of you. This is helpful in case there are multiple RTK devices within Bluetooth range.
2424

25+
### Enable Mock Location
26+
27+
Most GIS applications will gracefully handle the Bluetooth connection to the RTK device and provide an NTRIP Client for getting the RTCM corrections so this section can be skipped. If, in the rare case, a GIS app does not allow NTRIP corrections, Mock Locations can be enabled under Android. Then a data provide like Lefebure or GNSS Master can be used to act as a middle-man.
28+
29+
Before proceeding, it is recommended to have the mock location provider app already installed. So if you haven't already, consider installing Lefebure, GNSS Master, etc.
30+
31+
To enable **Mock Locations**, *Developer Mode* in Android must be enabled. It is best to google the [most recent procedure for this](https://www.google.com/search?q=how+to+allow+mock+location+on+android) but the following procedure should work:
32+
33+
1) Open Android settings ![alt text](<img/MockLocation/SparkFun RTK Mock Location - Settings.png>)
34+
2) Open *About phone*
35+
36+
![Build Number box](<img/MockLocation/SparkFun RTK Mock Location - Build Number.png>)
37+
38+
3) Scroll to the bottom and click on *Build number* five or more times. The device will prompt as more taps are required.
39+
40+
Once Developer Mode is enabled:
41+
42+
1) Open Android settings ![alt text](<img/MockLocation/SparkFun RTK Mock Location - Settings.png>)
43+
2) Open *System*
44+
45+
![Develop options menu](<img/MockLocation/SparkFun RTK Mock Location - Developer Options.png>)
46+
47+
3) Open *Developer options*
48+
49+
![Mock Location button](<img/MockLocation/SparkFun RTK Mock Location - Select Mock Location App.png>)
50+
51+
4) Scroll all the way to the bottom of a very long list of developer options.
52+
5) Select the app to use for Mock Location. This is usually Lefebure or GNSS Master but can be tailored as needed.
53+
2554
## Windows
2655

2756
Open settings and navigate to Bluetooth. Click **Add device**.
57.6 KB
Loading
48.8 KB
Loading
70 KB
Loading
6.9 KB
Loading

0 commit comments

Comments
 (0)