Skip to content

Commit 9bd1f26

Browse files
committed
Add localized distribution
1 parent 6fb9c89 commit 9bd1f26

6 files changed

+40
-8
lines changed
77.3 KB
Loading
359 KB
Loading
4.94 KB
Loading
5.04 KB
Loading

docs/menu_pointperfect.md

Lines changed: 39 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,32 @@ PointPerfect has the following benefits and challenges:
2828

2929
PointPerfect corrections are obtained by two methods:
3030

31-
* **L-Band**: Corrections are transmitted from a geosynchronous satellite. Coverage areas are limited to the US contiguous 48 states and the EU. This delivery method requires special equipment (see the [RTK Facet L-Band](https://www.sparkfun.com/products/20000) for more information). No cellular or internet connection is required.
31+
* **L-Band**: Corrections are transmitted from a geosynchronous satellite. Coverage areas are limited to the US contiguous 48 states and the EU. This delivery method requires special equipment (see the [RTK EVK](https://www.sparkfun.com/products/24342) for more information). No cellular or internet connection is required.
3232

3333
* **IP**: Corrections are transmitted over the internet. The RTK device will need access to a WiFi or Ethernet network. For WiFi, this is most commonly a hotspot on a cell phone so this delivery method is generally confined to areas with cellular and/or other WiFi coverage.
3434

35+
## Localized Corrections
36+
37+
The u-blox PointPerfect Localized correction service via MQTT (IP) offers quick delivery of high precision accuracy by providing your device only the SPARTN corrections applicable to your location. This feature offers several advantages over the traditional continental streams, including significantly reduced bandwidth requirements and seamless transition between regions.
38+
39+
* **Reduced bandwidth requirements:** PointPerfect Localized can reduce bandwidth requirements by up to 80%. This is a significant advantage for applications sensitive to bandwidth constraints, such as those that operate in remote areas or use low-power devices.
40+
41+
* **Retained Privacy:** PointPerfect Localized retains user privacy by not sending the device's precise location to the service to receive correction data. This is done by using a general node-based location system.
42+
43+
PointPerfect Localized works by dividing the coverage area into a grid of tiles. Each tile contains a set of nodes that are relevant to a user located within that tile. Unlike the continental level approach where a device subscribes to the continental level topic, in the localized approach a device subscribes to the localized node topic based on its location. This ensures that the device receives only the correction data that is relevant to its location, greatly reducing the required bandwidth.
44+
45+
![Comparison of PointPerfect Localized node density](<img/WiFi Config/SparkFun RTK PointPerfect Config.png>)
46+
47+
*Comparison of PointPerfect Localized node density*
48+
49+
The above image shows the Localized tiles for Level 2 (250 x 250km sparse, ~90-100km separation) vs. Level 5 (250 x 250km high density, ~30km separation).
50+
51+
Localized distribution can be enabled via the serial menu (PointPerfect menu - option 'p'), or the web config page. On serial, option '4' will enable or disable localized distribution; option '5' selects the tile level.
52+
53+
![PointPerfect Menu](<img/Terminal/SparkFun RTK Everywhere - PointPerfect Menu.png>)
54+
55+
*Configuring PointPerfect settings over serial*
56+
3557
## Registration
3658

3759
![Three stickers showing Device ID and QR code to registration page](<img/Torch/SparkFun RTK Torch - Device ID Stickers.png>)
@@ -68,18 +90,24 @@ On devices that have a display, the unit will display various prompts to aid the
6890

6991
The *Days until keys expire* inform the user how many days the unit has until it needs to connect to WiFi to obtain new keys.
7092

71-
* **1** - Disable the use of PointPerfect corrections.
93+
* **1** - Enable / disable the use of PointPerfect corrections.
94+
95+
* **2** - Enable / disable the automatic attempts at WiFi connections when key expiry is less than 28 days.
7296

73-
* **2** - Disable the automatic attempts at WiFi connections when key expiry is less than 28 days.
97+
* **3** - Trigger an immediate attempt to connect over WiFi / Ethernet and provision the device (if no keys are available) or update the keys (if provisioning has already been completed). Depending on which RTK product you have and which interfaces are connected, it may be necessary to exit the menus for the provisioning / update to take place.
7498

75-
* **3** - Trigger an immediate attempt to connect over WiFi and provision the device (if no keys are available) or update the keys (if provisioning has already been completed).
99+
* **4** - Enable / disable [localized distribution](#localized-corrections)
76100

77-
* **4** - Display the Device ID. This is needed when a SparkFun RTK device needs to be added to the PointPerfect system. This is needed when first registering the device, or modifying a subscription. [Go here for RTK Torch](https://www.sparkfun.com/rtk_torch_registration) to enable or renew your subscription. [Go here for RTK EVK](https://www.sparkfun.com/rtk_evk_registration) subscriptions.
101+
* **5** - When localized distribution is enabled, option 5 can be used to select the tile level. The default is Level 5 - 250 x 250km tiles, high density.
78102

79103
* **c** - Clear the current keys.
80104

105+
* **i** - Display the Device ID. This is needed when a SparkFun RTK device needs to be added to the PointPerfect system. This is needed when first registering the device, or modifying a subscription. [Go here for RTK Torch](https://www.sparkfun.com/rtk_torch_registration) to enable or renew your subscription. [Go here for RTK EVK](https://www.sparkfun.com/rtk_evk_registration) subscriptions.
106+
81107
* **k** - Bring up the Manual Key Entry menu.
82108

109+
* **g** - Set the Geographic Region. The default is US; but EU, Australia, Korea and Japan can also be selected. This is an important setting since it sets both the IP distribution topic (MQTT, IP) and the L-Band frequency (RTK EVK).
110+
83111
## Obtaining the Device ID
84112

85113
The device ID is unique to each RTK device and must be entered by SparkFun into the PointPerfect network.
@@ -92,7 +120,7 @@ The device ID is unique to each RTK device and must be entered by SparkFun into
92120

93121
*Device ID within the WiFi Config page*
94122

95-
This ID can be obtained by using option **4** from the *PointPerfect* menu or by opening the PointPerfect section within the [WiFi Config](https://docs.sparkfun.com/SparkFun_RTK_Everywhere_Firmware/configure_with_wifi/) interface in the PointPerfect Configuration section.
123+
This ID can be obtained by using option **i** from the *PointPerfect* menu or by opening the PointPerfect section within the [WiFi Config](https://docs.sparkfun.com/SparkFun_RTK_Everywhere_Firmware/configure_with_wifi/) interface in the PointPerfect Configuration section.
96124

97125
## Manual Key Entry
98126

@@ -110,6 +138,10 @@ Option '1' will allow a user to enter their Device Profile Token. This is the to
110138

111139
*Three-pronged satellite dish indicating L-Band reception*
112140

141+
![Three-pronged satellite dish indicating L-Band reception on EVK](img/Displays/SparkFun_RTK_EVK_LBand_Indicator.png)
142+
143+
*Three-pronged satellite dish indicating L-Band reception on EVK*
144+
113145
On devices that have a display, upon successful reception and decryption of PointPerfect corrections delivered over L-Band, the satellite dish icon will increase to a three-pronged icon. As the unit's fix increases the cross-hair will indicate a basic 3D solution, a double blinking cross-hair will indicate a floating RTK solution, and a solid double cross-hair will indicate a fixed RTK solution.
114146

115147
## Error Messages
@@ -132,7 +164,7 @@ This message is seen whenever the PointPerfect service is not aware of the given
132164

133165
This device has been deactivated. Please contact [email protected] to renew the PointPerfect subscription. Please reference device ID: [device ID]
134166

135-
This message is seen whenever the device's subscription has lapsed. Please use the [subscription form](https://www.sparkfun.com/pointperfect) or contact [email protected] with your device ID (see [Obtaining the Device ID](menu_pointperfect.md#obtaining-the-device-id) above).
167+
This message is seen whenever the device's subscription has lapsed. [Go here for RTK Torch](https://www.sparkfun.com/rtk_torch_registration) subscriptions. [Go here for RTK EVK](https://www.sparkfun.com/rtk_evk_registration) subscriptions. Alternatively contact [email protected] with your device ID (see [Obtaining the Device ID](menu_pointperfect.md#obtaining-the-device-id) above).
136168

137169
### HTTP response error -11 - Read Timeout
138170

docs/quickstart-evk.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -148,7 +148,7 @@ Steps to use PointPerfect:
148148

149149
*WiFi Menu containing one network*
150150

151-
5. Under the *PointPerfect Configuration* menu, **Enable PointPefect Corrections** and select your **Geographic Region**. If desired, enable **Localized Corrections** and **AssistNow**.
151+
5. Under the [*PointPerfect Configuration* menu](menu_pointperfect.md), **Enable PointPefect Corrections** and select your **Geographic Region**. If desired, enable **Localized Corrections** and **AssistNow**.
152152

153153
![PointPerfect Configuration Menu](<img/WiFi Config/SparkFun RTK PointPerfect Config.png>)
154154

0 commit comments

Comments
 (0)