Skip to content

Commit c3b885b

Browse files
committed
Update docs
1 parent 52b5bc7 commit c3b885b

File tree

2 files changed

+22
-12
lines changed

2 files changed

+22
-12
lines changed

docs/connecting_bluetooth.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Surveyor: ![Feature Supported](https://raw.githubusercontent.com/sparkfun/SparkFun_RTK_Firmware/main/docs/img/GreenDot.png) / Express: ![Feature Supported](https://raw.githubusercontent.com/sparkfun/SparkFun_RTK_Firmware/main/docs/img/GreenDot.png) / Express Plus: ![Feature Supported](https://raw.githubusercontent.com/sparkfun/SparkFun_RTK_Firmware/main/docs/img/GreenDot.png) / Facet: ![Feature Supported](https://raw.githubusercontent.com/sparkfun/SparkFun_RTK_Firmware/main/docs/img/GreenDot.png) / Facet L-Band: ![Feature Supported](https://raw.githubusercontent.com/sparkfun/SparkFun_RTK_Firmware/main/docs/img/GreenDot.png)
44

5-
The RTK products transmit full NMEA sentences over Bluetooth serial port profile (SPP) at 4Hz and 115200bps. This means that nearly any GIS application that can receive NMEA data over serial port (almost all do) can be used with the RTK Express. As long as your device can open a serial port over Bluetooth (also known as SPP) your device can retrieve industry standard NMEA positional data. The following steps show how to use SW Maps but the same steps can be followed to connect any serial port based GIS application.
5+
SparkFun RTK products transmit full NMEA sentences over Bluetooth serial port profile (SPP) at 4Hz and 115200bps. This means that nearly any GIS application that can receive NMEA data over serial port (almost all do) can be used with the RTK Express. As long as your device can open a serial port over Bluetooth (also known as SPP) your device can retrieve industry standard NMEA positional data. The following steps show how to connect an external tablet, or cell phone to the RTK device so the any serial port based GIS application can be used.
66

77
## Android
88

docs/gis_software.md

Lines changed: 21 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,27 +4,29 @@ Surveyor: ![Feature Supported](https://raw.githubusercontent.com/sparkfun/SparkF
44

55
While we recommend SW Maps for Android, there are a variety of 3rd party apps available for GIS and surveying. We will cover a few examples below that should give you an idea of how to get the incoming NMEA data over Bluetooth into the software of your choice.
66

7-
Note: SparkFun is a hardware company; we don't use GIS software for our primary job. While we've stumbled our way through these software packages, we assume you, the professional will know how to use the software once it's clear how to get data from the RTK device into the GIS product.
7+
Note: SparkFun is a hardware company; we don't use GIS software for our primary job. We will demonstrate the settings needed to connect to the software, after that we assume you, the professional will know how to use the software once it's clear how to get data from the RTK device into the GIS product.
88

99
## SW Maps
1010

11+
The best mobile app that we’ve found is the powerful, free, and easy to use *[SW Maps](https://play.google.com/store/apps/details?id=np.com.softwel.swmaps)* by Softwel. You’ll need an Android phone or tablet with Bluetooth. What makes SW Maps truly powerful is its built-in NTRIP client. This is a fancy way of saying that we’ll be showing you how to get RTCM correction data over the cellular network.
12+
1113
![List of BT Devices in SW Maps](img/SparkFun%20RTK%20SWMaps%20Bluetooth%20Connect.png)
1214

1315
*List of available Bluetooth devices*
1416

15-
The best mobile app that we’ve found is the powerful, free, and easy to use *[SW Maps](https://play.google.com/store/apps/details?id=np.com.softwel.swmaps)* by Softwel. You’ll need an Android phone or tablet with Bluetooth. What makes SW Maps truly powerful is its built-in NTRIP client. This is a fancy way of saying that we’ll be showing you how to get RTCM correction data over the cellular network.
17+
From SW Map's main menu, select *Bluetooth GNSS*. This will display a list of available Bluetooth devices. Select the Rover or Base you just paired with. If your are taking height measurements (altitude) in addition to position (lat/long) be sure to enter the height of your antenna off the ground including any [ARP offsets](https://geodesy.noaa.gov/ANTCAL/FAQ.xhtml#faq4) of your antenna (should be printed on the side).
18+
19+
Click on 'CONNECT' to open a Bluetooth connection. Assuming this process takes a few seconds, you should immediately have a location fix.
1620

1721
![SW Maps with RTK Fix](img/SparkFun%20RTK%20SWMaps%20GNSS%20Status.png)
1822

1923
*SW Maps with RTK Fix*
2024

21-
From SW Map's main menu, select *Bluetooth GNSS*. This will display a list of available Bluetooth devices. Select the Rover or Base you just paired with. If your are taking height measurements (altitude) in addition to position (lat/long) be sure to enter the height of your antenna off the ground including any [ARP offsets](https://geodesy.noaa.gov/ANTCAL/FAQ.xhtml#faq4) of your antenna (should be printed on the side).
22-
23-
Click on 'CONNECT' to open a Bluetooth connection. Assuming this process takes a few seconds, you should immediately have a location fix.
25+
You can open the GNSS Status sub menu to view the current data.
2426

2527
### NTRIP Client
2628

27-
If you’re using a serial radio to connect a Base to a Rover for your correction data, you can skip this part.
29+
If you’re using a serial radio to connect a Base to a Rover for your correction data, or if you're using the RTK Facet L-Band with built-in corrections, you can skip this part.
2830

2931
We need to send RTCM correction data from the phone back to the RTK device so that it can improve its fix accuracy. This is the amazing power of the SparkFun RTK products and SW Maps. Your phone can be the radio link! From the main SW Maps menu select NTRIP Client. Not there? Be sure the 'SparkFun RTK' instrument was automatically selected connecting. Disconnect and change the instrument to 'SparkFun RTK' to enable the NTRIP Connection option.
3032

@@ -48,7 +50,7 @@ Once you have a full RTK fix you'll notice the location bubble in SW Maps turns
4850

4951
Note: The company behind SurvPC, Carlson Software, is rather hostile to competitors of their $18,000 devices, so be warned.
5052

51-
Be sure your device is paired over Bluetooth.
53+
Be sure your device is [paired over Bluetooth](https://sparkfun.github.io/SparkFun_RTK_Firmware/connecting_bluetooth/#windows).
5254

5355
![Equip Sub Menu](img/SurvPC/SparkFun%20RTK%20Software%20-%20SurvPC%20Equip%20Menu.jpg)
5456

@@ -57,7 +59,6 @@ Be sure your device is paired over Bluetooth.
5759
Select the *Equip* sub menu then `GPS Rover`
5860

5961
![Select NMEA GPS Receiver](img/SurvPC/SparkFun%20RTK%20Software%20-%20SurvPC%20Rover%20NMEA.jpg)
60-
Install SurvPC and open the Equip menu.
6162

6263
*Select NMEA GPS Receiver*
6364

@@ -97,7 +98,9 @@ You will be shown a list of devices that have been paired. Select the RTK device
9798

9899
*Connect to Device*
99100

100-
Click the `Connect Bluetooth` button, shown in red in the top right corner. The software will begin a connection to the RTK device. You'll see the MAC address on the RTK device change to the Bluetooth icon indicating its connected. If it detects NMEA, it will report a successful connection.
101+
Click the `Connect Bluetooth` button, shown in red in the top right corner. The software will begin a connection to the RTK device. You'll see the MAC address on the RTK device change to the Bluetooth icon indicating its connected.
102+
103+
If SurvPC detects NMEA, it will report a successful connection.
101104

102105
![Receiver Submenu](img/SurvPC/SparkFun%20RTK%20Software%20-%20SurvPC%20Rover%20Receiver.jpg)
103106

@@ -107,15 +110,22 @@ You are welcome to enter the ARP (antenna reference point) and surveying stick l
107110

108111
**NTRIP Client**
109112

110-
Note: If you are using the RTK Facet L-Band you do not need to setup NTRIP; the device generates its own correction data. But if L-Band corrections are not available, the device can still achieve RTK fixes using corrections over an NTRIP Client connection.
113+
Note: If you are using a radio to connect Base to Rover, or if you are using the RTK Facet L-Band you do not need to setup NTRIP; the device will achieve RTK fixes and output extremely accurate location data by itself. But if L-Band corrections are not available, or you are not using a radio link, the NTRIP Client can provide corrections to this Rover.
111114

112115
![RTK Submenu](img/SurvPC/SparkFun%20RTK%20Software%20-%20SurvPC%20NTRIP%20Client.jpg)
113116

114117
*RTK Submenu*
115118

116119
If you selected 'DGPS' as the Model type, the RTK submenu will be shown. This is where you give the details about your NTRIP Caster such as your mount point, user name/pw, etc. For more information about creating your own NTRIP mount point please see [Creating a Permanent Base](https://sparkfun.github.io/SparkFun_RTK_Firmware/permanent_base/)
117120

118-
Once everything is conncted up, click the Green check in the top right corner.
121+
122+
Enter your NTRIP Caster credentials and click connect. You will see bytes begin to transfer from your phone to the RTK Express. Within a few seconds the RTK Express will go from ~300mm accuracy to 14mm. Pretty nifty, no?
123+
124+
What's an NTRIP Caster? In a nut shell it's a server that is sending out correction data every second. There are thousands of sites around the globe that calculate the perturbations in the ionosphere and troposphere that decrease the accuracy of GNSS accuracy. Once the inaccuracies are known, correction values are encoded into data packets in the RTCM format. You, the user, don't need to know how to decode or deal with RTCM, you simply need to get RTCM from a source within 10km of your location into the RTK Express. The NTRIP client logs into the server (also known as the NTRIP caster) and grabs that data, every second, and sends it over Bluetooth to the RTK Express.
125+
126+
Don't have access to an NTRIP Caster? You can use a 2nd RTK product in operating in Base mode to provide the correction data. Checkout [Creating a Permanent Base](https://sparkfun.github.io/SparkFun_RTK_Firmware/permanent_base/). If you're the DIY sort, you can create your own low cost base station using an ESP32 and a ZED-F9P breakout board. Checkout [How to Build a DIY GNSS Reference Station](https://learn.sparkfun.com/tutorials/how-to-build-a-diy-gnss-reference-station). If you'd just like a service, [Syklark](https://www.swiftnav.com/skylark) provides RTCM coverage for $49 a month (as of writing) and is extremely easy to setup and use. Remember, you can always use a 2nd RTK device in *Base* mode to provide RTCM correction data but it will less accurate than a fixed position caster.
127+
128+
Once everything is connected up, click the Green check in the top right corner.
119129

120130
![Storing Points](img/SurvPC/SparkFun%20RTK%20Software%20-%20SurvPC%20Survey.jpg)
121131

0 commit comments

Comments
 (0)