You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -21,42 +21,42 @@ Are you using [Android](#android) or [iOS](#ios)?
21
21
</figcaption>
22
22
</figure>
23
23
24
-
2.Connect the antenna.
24
+
2.Mount the hardware:
25
25
26
-
- The RTK Postcard has its own [hookup guide](http://docs.sparkfun.com/SparkFun_RTK_Postcard/). At a minimum you will need to attach a L1/L2/L5 GNSS antenna. The screw on [helical](https://www.sparkfun.com/gnss-multi-band-l1-l2-l5-helical-antenna-sma.html) antenna works very well or [UFO](https://www.sparkfun.com/gnss-multi-band-l1-l2-l5-surveying-antenna-tnc-spk6618h.html) with a TNC cable for greater reception but with greater weight will work. Then head outside with a clear view of the sky.
26
+
- For RTK Facet mosaic: Attach the RTK to a 5/8" 11-TPI standard surveying pole or to a [monopole](https://www.sparkfun.com/telescopic-surveying-pole.html) using the included [thread adapter](https://www.sparkfun.com/products/17546) if needed (Figure 1).
27
27
28
-
3. Provide power.
29
-
30
-
- Power the Postcard with USB or (optionally) the [Portability Shield](https://www.sparkfun.com/sparkfun-portability-shield.html) with an attached battery.
28
+
<figure markdown>
29
+
3. Turn on the RTK Facet mosaic device by pressing the Power button for 3 to 4 seconds until the OLED display illuminates.
38
36
39
-
4. From your cell phone, open Bluetooth settings and pair it with a new device. You will see a list of available Bluetooth devices. Select the ‘Postcard Rover-A4D2’. The 'A4D2' is the last four digits of the device's MAC address and will vary depending on the device (Figure 3).
37
+
4. From your cell phone, open Bluetooth settings and pair it with a new device. You will see a list of available Bluetooth devices. Select the ‘Torch Rover-3AF1’. The '3AF1' is the last four digits of the device's MAC address and will vary depending on the device (Figure 3).
40
38
41
39
<figure markdown>
42
-
40
+
43
41
<figcaption markdown>
44
42
Figure 3
45
43
</figcaption>
46
44
</figure>
47
45
48
46
5. Once paired, open SW Maps. Select ‘New Project’ and give your project a name like ‘RTK Project’.
49
47
50
-
6. Press the SW Maps icon in the top left corner of the home screen and select **Bluetooth GNSS**. You should see the ‘Postcard Rover-A4D2’ in the list. Select it. Confirm that the *Instrument Model* is **SparkFun RTK**, then press the ‘Connect’ button in the bottom right corner (Figure 4). SW Maps will show a warning that the instrument height is 0m. That’s ok.
48
+
6. Press the SW Maps icon in the top left corner of the home screen and select **Bluetooth GNSS**. You should see the ‘Torch Rover-3AF1’ in the list. Select it. Confirm that the *Instrument Model* is **SparkFun RTK**, then press the ‘Connect’ button in the bottom right corner (Figure 4). SW Maps will show a warning that the instrument height is 0m. That’s ok.
51
49
52
50
<figure markdown>
53
-
51
+
54
52
<figcaption markdown>
55
53
Figure 4
56
54
</figcaption>
57
55
</figure>
58
56
59
-
7. Make sure the GNSS antenna is outside with a clear view of the sky. GNSS doesn’t work indoors or near windows. Press the SW Maps icon in the top left corner of the home screen and select **GNSS Status**. Within about 30 seconds you should see 10 or more satellites in view (SIV) (Figure 5). More SIV is better. We regularly see 30 or more SIV. The horizontal positional accuracy (HPA) will decrease as more satellites are acquired. The lower the HPA the more accurate your position.
57
+
7. Once connected, you should see the Bluetooth icon on the RTK device OLED display.
58
+
59
+
8. Now put the device outside with a clear view of the sky. GNSS doesn’t work indoors or near windows. Press the SW Maps icon in the top left corner of the home screen and select **GNSS Status**. Within about 30 seconds you should see 10 or more satellites in view (SIV) (Figure 5). More SIV is better. We regularly see 30 or more SIV. The horizontal positional accuracy (HPA) will start at around 10 meters and begin to decrease. The lower the HPA the more accurate your position. This accuracy is around 2m in normal mode.
60
60
61
61
<figure markdown>
62
62
@@ -65,7 +65,7 @@ Are you using [Android](#android) or [iOS](#ios)?
65
65
</figcaption>
66
66
</figure>
67
67
68
-
To improve the accuracy (down to 10mm), you now need to provide the device with corrections. Continue reading the [RTK Crash Course](#rtk-crash-course).
68
+
You can now use your RTK device to measure points with good (meter) accuracy. If you need extreme accuracy (down to 8mm) continue reading the [RTK Crash Course](#rtk-crash-course).
69
69
70
70
## iOS
71
71
@@ -80,58 +80,116 @@ The software options for Apple iOS are much more limited because Apple products
80
80
</figcaption>
81
81
</figure>
82
82
83
-
2.Connect the antenna.
83
+
2.Mount the hardware:
84
84
85
-
- The RTK Postcard has its own [hookup guide](http://docs.sparkfun.com/SparkFun_RTK_Postcard/). At a minimum you will need to attach a L1/L2/L5 GNSS antenna. The screw on [helical](https://www.sparkfun.com/gnss-multi-band-l1-l2-l5-helical-antenna-sma.html) antenna works very well or [UFO](https://www.sparkfun.com/gnss-multi-band-l1-l2-l5-surveying-antenna-tnc-spk6618h.html) with a TNC cable for greater reception but with greater weight will work. Then head outside with a clear view of the sky.
85
+
- For RTK Facet mosaic: Attach the RTK to a 5/8" 11-TPI standard surveying pole or to a [monopole](https://www.sparkfun.com/telescopic-surveying-pole.html) using the included [thread adapter](https://www.sparkfun.com/products/17546) if needed (Figure 1).
86
86
87
-
3. Provide power.
88
-
89
-
- Power the Postcard with USB or (optionally) the Portability Shield with an attached battery.
87
+
<figure markdown>
88
+
3. Turn on the RTK Facet mosaic device by pressing the Power button for 3 to 4 seconds until the OLED display illuminates.
97
95
98
96
4. Open SW Maps. Select ‘New Project’ and give your project a name like ‘RTK Project’.
99
97
100
-
5. Press the SW Maps icon in the top left corner of the home screen and select *Bluetooth GNSS*. You will need to agree to allow a Bluetooth connection. Set the *Instrument Model* to **Generic NMEA (Bluetooth LE)**. Press 'Scan' and your RTK device should appear.
98
+
5. Press the SW Maps icon in the top left corner of the home screen and select Bluetooth GNSS. You will need to agree to allow a Bluetooth connection. Set the *Instrument Model* to **Generic NMEA (Bluetooth LE)**. Press 'Scan' and your RTK device should appear. Select it then press the ‘Connect’ button in the bottom left corner.
99
+
100
+
6. Once connected, you should see the Bluetooth icon on the RTK device OLED display.
101
+
102
+
7. Now put the device outside with a clear view of the sky. GNSS doesn’t work indoors or near windows. Press the SW Maps icon in the top left corner of the home screen and select **GNSS Status**. Within about 30 seconds you should see 10 or more satellites in view (SIV) (Figure 3). More SIV is better. We regularly see 30 or more SIV. The horizontal positional accuracy (HPA) will start at around 10 meters and begin to decrease. The lower the HPA the more accurate your position. This accuracy is around 2m in normal mode.
104
106
<figcaption markdown>
105
107
Figure 3
106
108
</figcaption>
107
109
</figure>
108
110
109
-
6. Select it then press the ‘Connect’ button in the bottom right corner.
111
+
You can now use your RTK device to measure points with good (meter) accuracy. If you need extreme accuracy (down to 8mm) continue reading the [RTK Crash Course](#rtk-crash-course).
112
+
113
+
## RTK Crash Course
114
+
115
+
To get millimeter accuracy we need to provide the RTK unit with correction values. Corrections, often called RTCM, help the RTK unit refine its position calculations. RTCM (Radio Technical Commission for Maritime Services) can be obtained from a variety of sources but they fall into three buckets: Commercial, Public, and Civilian Reference Stations.
116
+
117
+
See [Corrections Sources](correction_sources.md) for a breakdown of the options and the pros and cons of each. For this quickstart, we'll be showing two examples: using PointPerfect for $8 a month (a little less accurate but nation-wide coverage) and PointOne Nav for $50 a month (maximum accuracy, gaps in the coverage area).
118
+
119
+
## PointPerfect Corrections
120
+
121
+
One of the great features of the RTK Torch is that it has the ability to get corrections from PointPerfect over WiFi. No need for NTRIP credentials! [Contact SparkFun](https://www.sparkfun.com/rtk_torch_registration) with your device ID, pay a small monthly fee of $8 per month (as of this writing) and your device will obtain credentials and start receiving corrections anywhere there is coverage.
122
+
123
+
[<figuremarkdown>
124
+
](https://www.u-blox.com/en/pointperfect-service-coverage)
125
+
<figcaptionmarkdown>
126
+
PointPerfect Coverage map including L-Band and IP delivery methods
127
+
</figcaption>
128
+
</figure>
129
+
130
+
The PointPerfect IP service is available for various areas of the globe including the contiguous US, EU, South Korea, as well as parts of Brazil, Australia, and Canada. See the [coverage map](https://www.u-blox.com/en/pointperfect-service-coverage) for specifics; the RTK Torch is compatible with any area that has *IP Coverage* (it is not compatible with L-Band coverage).
131
+
132
+
Steps to use PointPerfect:
133
+
134
+
1.[Register](https://www.sparkfun.com/rtk_torch_registration) the device with SparkFun by entering the device ID (this is the ID seen on the [printed stickers](https://docs.sparkfun.com/SparkFun_RTK_Everywhere_Firmware/menu_pointperfect/#registration) included in the kit). It can take up to two business days for registration to complete.
135
+
136
+
2. Power on the RTK Torch by pressing and holding the power button for around 4 seconds. The device will emit a short beep and illuminate the LEDs.
137
+
138
+
3. Put the RTK Torch into WiFi config mode by double-tapping the power button. You will hear two beeps indicating it is ready to connect to.
139
+
140
+
4. From your phone, connect to the WiFi network *RTK Config*. You should be redirected to the WiFi Config page. If you are not, open a browser (Chrome is preferred) and type **rtk.local** into the address bar.
7. Make sure the GNSS antenna is outside with a clear view of the sky. GNSS doesn’t work indoors or near windows. Press the SW Maps icon in the top left corner of the home screen and select **GNSS Status**. Within about 30 seconds you should see 10 or more satellites in view (SIV) (Figure 5). More SIV is better. We regularly see 30 or more SIV. The horizontal positional accuracy (HPA) will decrease as more satellites are acquired. The lower the HPA the more accurate your position.
149
+
5. Under the *WiFi Configuration* menu, give the device WiFi credentials for your local WiFi. This can be the cellphone hotspot if local WiFi is not available.
119
150
120
151
<figure markdown>
121
-
152
+
122
153
<figcaption markdown>
123
-
Figure 5
154
+
WiFi Menu containing one network
124
155
</figcaption>
125
156
</figure>
126
157
127
-
To improve the accuracy (down to 10mm), you now need to provide the device with corrections. Continue reading the [RTK Crash Course](#rtk-crash-course).
158
+
6. Under the [*PointPerfect Configuration* menu](menu_pointperfect.md), **Enable PointPefect Corrections** and select your **Geographic Region**. If desired, enable **Localized Corrections** and **AssistNow**.
It is important that you set your Geographic Region correctly, via the menu or web config page, as this determines both the IP correction distribution topic and the L-Band frequency (on L-Band-capable products).
130
169
131
-
To get millimeter accuracy we need to provide the RTK unit with correction values. Corrections, often called RTCM, help the RTK unit refine its position calculations. RTCM (Radio Technical Commission for Maritime Services) can be obtained from a variety of sources. See [Corrections Sources](correction_sources.md) for a breakdown of the options and the pros and cons of each. For this quickstart, we'll be showing you how to enable corrections using a monthly service called PointOneNav.
170
+
171
+
7. Click **Save Configuration**. The device will record all settings in a few seconds. Then press **Exit and Reset**. The unit will now reboot.
172
+
173
+
<figure markdown>
174
+
175
+
<figcaption markdown>
176
+
Saving... then All Saved
177
+
</figcaption>
178
+
</figure>
179
+
180
+
After the reboot, the device will connect to WiFi, obtain keys, and begin applying corrections. Assuming you are outside, after a few minutes of receiving PointPerfect corrections to the device, connect to the RTK Torch over SW Maps (or other) and the device will enter RTK Float, then RTK Fix (usually under 3 minutes). You can now take positional readings with millimeter accuracy!
If you decide to use a service that provides NTRIP (as opposed to PointPerfect) we need to feed that data into your SparkFun RTK device. In this example, we will use PointOneNav and SW Maps.
192
+
135
193
1. Create an account on [PointOneNav](https://app.pointonenav.com/trial?src=sparkfun).
136
194
137
195
!!! note
@@ -175,5 +233,5 @@ RTK Fix will be maintained as long as there is a clear view of the sky and corre
175
233
## Common Gotchas
176
234
177
235
- High-precision GNSS works best with a clear view of the sky; it does not work indoors or near a window. GNSS performance is generally *not* affected by clouds or storms. Trees and buildings *can* degrade performance but usually only in very thick canopies or very near tall building walls. GNSS reception is very possible in dense urban centers with skyscrapers but high-precision RTK may be impossible.
178
-
- The location reported by the RTK device is the location of the antenna element. Lat and Long are fairly easy to obtain but if you're capturing altitude be sure to do additional reading on ARPs (antenna reference points) and how to account for the antenna height in your data collection software.
179
-
- An internet connection is required for most types of RTK. RTCM corrections can be transmitted over other types of connections (such as serial telemetry radios). The RTK EVK also supports PointPerfect L-Band geostationary satellite corrections through the built-in NEO-D9S corrections receiver. The L-Band corrections are encrypted and keys are required but, once your unit has them, corrections will be available for up to eight weeks. See [Correction Transport](correction_transport.md) for more details.
236
+
- The location reported by the RTK device is the location of the antenna element; it's *not* the location of the pointy end of the stick. Lat and Long are fairly easy to obtain but if you're capturing altitude be sure to do additional reading on ARPs (antenna reference points) and how to account for the antenna height in your data collection software.
237
+
- An internet connection is required for most types of RTK. RTCM corrections can be transmitted over other types of connections (such as serial telemetry radios). See [Correction Transport](correction_transport.md) for more details.
Copy file name to clipboardExpand all lines: docs/quickstart-torch.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,7 +23,7 @@ Are you using [Android](#android) or [iOS](#ios)?
23
23
24
24
2. Mount the hardware:
25
25
26
-
- For RTK Torch: Attach the Torch to a 5/8" 11-TPI standard surveying pole or to a [monopole](https://www.amazon.com/AmazonBasics-WT1003-67-Inch-Monopod/dp/B00FAYL1YU) using the included [thread adapter](https://www.sparkfun.com/products/17546) (Figure 1).
26
+
- For RTK Torch: Attach the Torch to a 5/8" 11-TPI standard surveying pole or to a [monopole](https://www.sparkfun.com/telescopic-surveying-pole.html) using the included [thread adapter](https://www.sparkfun.com/products/17546) if needed (Figure 1).
27
27
28
28
<figure markdown>
29
29
0 commit comments