Docs: Update corrections priority menu

nseidle · nseidle · commit affb7980e86e · 2024-08-29T15:19:37.000-06:00
diff --git a/docs/img/Terminal/SparkFun RTK Everywhere - Corrections Priorities Menu.png b/docs/img/Terminal/SparkFun RTK Everywhere - Corrections Priorities Menu.png
diff --git a/docs/menu_corrections_priorities.md b/docs/menu_corrections_priorities.md
@@ -6,21 +6,26 @@ Torch: ![Feature Supported](img/Icons/GreenDot.png) / EVK: ![Feature Supported](
 
 *RTK Corrections Priorities Menu*
 
-To achieve an RTK Fix, SparkFun RTK products must be provided with a correction source. An RTK device can obtain corrections from a variety of sources. Below is the list of possible sources (not all platforms support all sources) and their default priorities:
+To achieve an RTK Fix, SparkFun RTK products must be provided with a correction source. An RTK device can obtain corrections from a variety of sources. Below is the list of possible sources (not all platforms support all sources) and their default priorities. These defaults generally follow the rule that a shorter baseline between Rover and Base leads to more accurate, and therefore more valuable, correction data:
 
-* External Radio
-* ESP-Now
-* LoRa Radio
-* Bluetooth
-* TCP (NTRIP)
-* L-Band
-* IP (PointPerfect/MQTT)
+* External Radio (100m [OSR](https://docs.sparkfun.com/SparkFun_RTK_Everywhere_Firmware/correction_sources/#osr-vs-ssr) Baseline)
+* ESP-Now (100m OSR Baseline)
+* LoRa Radio (1km OSR Baseline)
+* Bluetooth (10+km OSR/SSR Baseline)
+* USB (10+km OSR/SSR Baseline)
+* TCP (NTRIP) (10+km OSR/SSR Baseline)
+* L-Band (100km SSR Baseline)
+* IP (PointPerfect/MQTT) (100+km SSR Baseline)
 
-The *Corrections Priorities* menu allows a user to specify which correction source should be given priority. For example, if corrections are provided through Bluetooth and L-Band simultaneously, the corrections from L-Band will be discarded because the Bluetooth source has a higher priority. This prevents the RTK engine from receiving potentially mixed correction signals.
+The *Corrections Priorities* menu allows a user to specify which correction source should be given priority. For example, if corrections are provided through ESP-NOW and IP PointPerfect simultaneously, the corrections from IP PointPerfect will be discarded because the ESP-NOW source has a higher priority. This prevents the RTK engine from receiving potentially mixed correction signals.
 
 ![RTK Corrections Priorities Menu](<img/Terminal/SparkFun RTK Everywhere - Corrections Priorities Menu.png>)
 
-In the serial terminal menu, pressing a letter will increase or decrease the position of a priority. For example, in the image above, pressing **F** will raise the `L-Band` priority above `TCP (NTRIP)`.
+In the serial terminal menu, pressing a letter will increase or decrease the position of a priority. For example, in the image above, pressing **G** will raise the `L-Band` priority above `TCP (NTRIP)`.
+
+Additionally, this menu gives visibility into which corrections are currently being received and utilized (marked with the *) by the RTK engine.
+
+The *Correction source lifetime in seconds* setting dictates how many seconds an active source must be silent before it is marked as inactive.
 
 In the web config page:
 
diff --git a/docs/menu_radios.md b/docs/menu_radios.md
@@ -1,6 +1,6 @@
 # Radios Menu
 
-The radio menu allows the configuration of various radios that are included with a given RTK platform.
+Pressing 'r' from the main menu will open the Configure Radios menu. This allows a user to configure various radios that are available on a given RTK platform.
 
 ## ESP-NOW
 
@@ -10,11 +10,7 @@ Torch: ![Feature Supported](img/Icons/GreenDot.png) / EVK: ![Feature Supported](
 
 *Radio menu showing ESP-NOW*
 
-Pressing 'r' from the main menu will open the Configure Radios menu. This allows a user to enable or disable the use of the internal ESP-NOW radio.
-
-ESP-NOW is a 2.4GHz protocol that is built into the internal ESP32 microcontroller; the same microcontroller that provides Bluetooth and WiFi. ESP-NOW does not require WiFi or an Access Point. This is most useful for connecting a Base to Rover (or multiple Rovers) without the need for an external radio. Simply turn two SparkFun RTK products on, enable their radios, and data will be passed between units.
-
-Additionally, ESP-NOW supports point-to-multipoint transmissions. This means a Base can transmit to multiple Rovers simultaneously.
+ESP-NOW is a 2.4GHz protocol that is built into the internal ESP32 microcontroller; the same microcontroller that provides Bluetooth and WiFi. ESP-NOW does not require WiFi or an Access Point. This is most useful for connecting a Base to Rover (or multiple Rovers) without the need for an external radio. Simply turn two SparkFun RTK products on, enable their radios, and data will be passed between units. Additionally, ESP-NOW supports point-to-multipoint transmissions. This means a Base can transmit to multiple Rovers simultaneously.
 
 ESP-NOW is a free radio included in every RTK product and works well, but it has a few limitations: 
 
@@ -82,7 +78,7 @@ The RTK Torch has an internal planar 915MHz antenna allowing good reception in h
 
 *1.83 mile (2.95km) range between Base and Rover using LoRa radios*
 
-The 1 Watt power output of the radio allows for long range transmissions when obstacles are fewer. Above is a line-of-sight test using a Base unit with line-of-sight to a near by hill-top approximately (ok, with great accuracy) of 1.83 miles (2.95km).
+The 1 Watt power output of the radio allows for long range transmissions when obstacles are fewer. Above is a line-of-sight test using a Base unit with line-of-sight to a near by hill-top measuring approximately (ok, with great accuracy) 1.83 miles (2.95km) away.
 
 ### Configuration
 
@@ -92,7 +88,7 @@ The 1 Watt power output of the radio allows for long range transmissions when ob
 
 From the radios menu, the LoRa radio can be enabled and configured. 
 
-**Don't see a LoRa menu?** Support was added starting in version v1.4. Please upgrade the [ESP32 firmware](firmware_update_esp32.md) on your device. Additionally, you may need to update the firmware on the [LoRa radio](firmware_update_stm32.md).
+**Don't see a LoRa menu?** Support was added starting in version v1.4. Please upgrade the [ESP32 firmware](firmware_update_esp32.md) on your device. Additionally, you may need to update the firmware on the [LoRa radio firmware](firmware_update_stm32.md).
 
 The *LoRa Coordination Frequency* must be the same between all Base and Rovers. The default is usually sufficient but if other RTK Torches are operating LoRa radios in the area, switching frequencies will allow multiple networks to operate simultaneously.
 
