Skip to content

Commit 7b8d298

Browse files
committed
Docs: Add QuickCapture iOS
1 parent a4c6f64 commit 7b8d298

19 files changed

+73
-4
lines changed

docs/connecting_bluetooth.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -96,8 +96,6 @@ If necessary, you can open a terminal connection to one of the COM ports. Becaus
9696

9797
## Apple iOS
9898

99-
Please see the [Apple iOS](gis_software.md#apple-ios) example of connecting to SW Maps.
99+
Please see [iOS GIS Software](docs/gis_software_ios.md) for information about how to connect to individual GIS apps. Some require a BLE connection and some require a WiFi hotspot connection.
100100

101-
Apple products do not support Bluetooth SPP. That's ok! The SparkFun RTK devices support Bluetooth Low Energy (BLE) which does work with iOS.
102-
103-
More information is available on the [System Menu](menu_system.md) for switching between Bluetooth SPP and BLE.
101+
More information is available on the [System Menu](menu_system.md) for switching between Bluetooth SPP and BLE.

docs/gis_software_ios.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,69 @@ There are a variety of 3rd party apps available for GIS and surveying for [Andro
66

77
The software options for Apple iOS are much more limited because Apple products do not support Bluetooth SPP. That's ok! The SparkFun RTK products support additional connection options including TCP and Bluetooth Low Energy (BLE).
88

9+
## ArcGIS QuickCapture
10+
11+
![ArcGIS QuickCapture splash screen](<img/QuickCapture/SparkFun RTK QuickCapture - Main Window.png>)
12+
13+
[ArcGIS QuickCapture](https://apps.apple.com/us/app/arcgis-quickcapture/id1451433781) is a popular offering from Esri that works well with SparkFun RTK products.
14+
15+
ArcGIS QuickCapture connects to the RTK device over TCP. In other words, the RTK device needs to be connected to the same WiFi network as the device running QuickCapture. Generally, this is an iPhone or iPad operating as a hotspot.
16+
17+
**Note:** The iOS hotspot defaults to 5.5GHz. This must be changed to 2.4GHz. Please see [Hotspot Settings](gis_software_ios.md/#hotspot-settings).
18+
19+
![WiFi network setup via Web Config](<img/ArcGIS/SparkFun RTK - ArcGIS WiFi Hotspot Web Config.png>)
20+
21+
![Adding WiFi network to settings](<img/ArcGIS/SparkFun RTK - ArcGIS WiFi Hotspot.png>)
22+
23+
The RTK device must use WiFi to connect to the iPhone or iPad. In the above image, the device will attempt to connect to *iPhone* (a cell phone hotspot) when WiFi is needed.
24+
25+
![TCP Server Enabled on port 2948](<img/ArcGIS/SparkFun RTK - ArcGIS TCP Config.png>)
26+
27+
28+
Next, the RTK device must be configured as a *TCP Server*. The default port of 2948 works well. See [TCP/UDP Menu](menu_tcp_udp.md) for more information.
29+
30+
![RTK device showing IP address](<img/QuickCapture/iOS/SparkFun RTK QuickCapture iOS - IP Address.png>)
31+
32+
Once the RTK device connects to the WiFi hotspot, its IP address can be found in the [System Menu](menu_system.md). This is the number that needs to be entered into QuickCapture. You can now proceed to the QuickCapture app to set up the software connection.
33+
34+
![Main screen](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - Main Screen.png>)
35+
36+
From the main screen, press the hamburger icon in the top left corner.
37+
38+
![Settings button](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - Settings Menu.png>)
39+
40+
Press the **Settings** button.
41+
42+
![Location Provider button](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - Settings Menu Location Provider.png>)
43+
44+
Select the **Location Provider** option.
45+
46+
Select **Via Network**.
47+
48+
![TCP Network Information](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - TCP Settings.png>)
49+
50+
Enter the IP address and port previously obtained from the RTK device and click **ADD**.
51+
52+
![List of providers showing TCP connection](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - TCP Added.png>)
53+
54+
That provider should now be shown connected.
55+
56+
![Browse project button](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - Main Add Project.png>)
57+
58+
From the main screen, click on the plus in the lower left corner and then **BROWSE PROJECTS**.
59+
60+
![List of projects](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - Add Project.png>)
61+
62+
For this example, add the BioBlitz project.
63+
64+
![GPS Accuracy and map in BioBlitz project](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - BioBlitz Project.png>)
65+
66+
Above, we can see the GPS accuracy is better than 1ft. Click on the map icon in the top right corner.
67+
68+
![QuickCapture map](<img/QuickCapture/iOS/SparkFun RTK QuickCapture - Map.png>)
69+
70+
From the map view, we can see our location with very high accuracy. We can now begin gathering point information with millimeter accuracy.
71+
972
## ArcGIS Survey123
1073

1174
![ArcGIS Survey123 Home Screen](<img/ArcGIS/SparkFun RTK - ArcGIS Main Screen.png>)
@@ -91,6 +154,14 @@ The SparkFun RTK device's data should now be seen. Click on the *Map* icon to re
91154

92155
Returning to the map view, we can now begin gathering point information with millimeter accuracy.
93156

157+
## Hotspot Settings
158+
159+
Apple released an iOS update in mid 2024 that changed the default hotspot frequency to 5.5GHz. The RTK product line uses 2.4GHz for WiFi and will not be able to communicate at this frequency. This can be fix by opening *Settings* then **Personal Hotspot**.
160+
161+
![iOS Hotspot settings](<img/iOS/SparkFun RTK iOS - Hotspot Settings.png>)
162+
163+
Be sure to enable *Maximize Compatibility*. This will force the hotspot to use 2.4GHz.
164+
94165
## QField
95166

96167
![Opening page of QField](<img/QField/SparkFun RTK QField - Opening Page.png>)

docs/image.png

105 KB
Loading
-1.82 KB
Loading
68.3 KB
Loading
53.5 KB
Loading
43.3 KB
Loading
39 KB
Loading
75 KB
Loading
22.8 KB
Loading

0 commit comments

Comments
 (0)