From d92e916e5178fe2b1c379f1e7b2a6fc058b2294b Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Wed, 5 Jul 2023 14:01:30 -0700 Subject: [PATCH 1/4] position updates and corrections --- docs/configuration/device-config/position.mdx | 56 ++++++++++++------- 1 file changed, 35 insertions(+), 21 deletions(-) diff --git a/docs/configuration/device-config/position.mdx b/docs/configuration/device-config/position.mdx index c4f4ac5a..95403b31 100644 --- a/docs/configuration/device-config/position.mdx +++ b/docs/configuration/device-config/position.mdx @@ -8,31 +8,31 @@ sidebar_label: Position import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; -The position config options are: GPS Enabled, GPS Update Interval, GPS Attempt Time, Fixed Position, Smart Broadcast, Broadcast Interval and Position Packet Flags. Position config uses an admin message sending a `Config.Position` protobuf. +The position config options are: GPS Enabled, GPS Update Interval, GPS Attempt Time, Fixed Position, Smart Broadcast, Smart Broadcast Minimum Distance, Smart Broadcast Minimum Interval, Broadcast Interval, Position Packet Flags, and GPS RX/TX Pins. Position config uses an admin message sending a `Config.Position` protobuf. Position data from GPS is provided by either the radio or your paired phone. Position data is not required to use Meshtastic but time calculations require at least one device on the mesh have either a GPS or internet connection for time. ## Position Config Values -### GPS Disabled +### GPS Enabled Acceptable values: `true` or `false` -Defaults to false. Should the device GPS be disabled for this node? +Defaults to true. Enables GPS on the node. ### GPS Update Interval -How often should we try to get GPS position (in seconds), or zero for the default of once every 30 seconds, or a very large value (maxint) to update only once at boot. +How often we should try to get GPS position (in seconds), or zero for the default of once every 2 minutes, or a very large value (maxint) to update only once at boot. ### GPS Attempt Time -How long should we try to get our position during each GPS update interval attempt? (in seconds) Or if zero, use the default of 30 seconds. +How long should we try to get our position during each GPS update interval attempt? (in seconds) Or if zero, use the default of 15 minutes. ### Fixed Position Acceptable values: `true` or `false` -Off by default +True by default If set, this node is at a fixed position. The device will generate GPS updates at the regular GPS update interval, but use whatever the last lat/lon/alt it saved for the node. The lat/lon/alt can be set by an internal GPS or with the help of the mobile device's GPS. @@ -40,7 +40,7 @@ If set, this node is at a fixed position. The device will generate GPS updates a Acceptable values: `true` or `false` -On by default +True by default Smart broadcast will send out your position at an increased frequency only if your location has changed enough for a position update to be useful. @@ -48,17 +48,29 @@ Smart broadcast complements broadcast interval (doesn't override that setting) b Smart broadcast will calculate an ideal position update interval based on the data rate of your selected channel configuration. +### Smart Broadcast Minimum Distance + +Default of `0` is 100 meters + +The minimum distance in meters traveled (since the last send) before we can send a position to the mesh if smart broadcast is enabled. + +### Smart Broadcast Minimum Interval + +Default of `0` is 30 seconds + +The minimum number of seconds (since the last send) before we can send a position to the mesh if smart broadcast is enabled. + ### Broadcast Interval Default of `0` is 15 minutes -If smart broadcast is of we should send our position this often (but only if it has changed significantly) +If smart broadcast is off we should send our position this often (but only if it has changed significantly) -The GPS updates will be sent out every Broadcast Interval, with either the actual GPS location, or an empty location if no GPS fix was achieved. This defaults to broadcast every 15 minutes. +The GPS updates will be sent out every Broadcast Interval, with either the actual GPS location, or an empty location if no GPS fix was achieved. ### Position Flags -Bit field of boolean configuration options for POSITION messages (bitwise OR of PositionFlags) +Defines which options are sent in POSITION messages. Values are stored as a bit field of boolean configuration options (bitwise OR of PositionFlags). | Value | Description | | :----------------: | :--------------------------------------------------------------: | @@ -116,17 +128,19 @@ All Position config commands are available in the python CLI. Example commands a ::: -| Setting | Acceptable Values | Default | -| :---------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------: | -| position.gps_enabled | `true`, `false` | `true` | -| position.gps_update_interval | `integer` (seconds) | Default `0` is 30 Seconds | -| position.gps_attempt_time | `integer` (seconds) | Default of `0` is 30 Seconds | -| position.fixed_position | `true`, `false` | `false` | -| position.position_broadcast_smart_enabled | `true`, `false` | `true` | -| position.position_broadcast_secs | `integer` (seconds) | Default of `0` is 15 Minutes | -| position.flags | `UNSET`, `ALTITUDE`, `ALTITUDE_MSL`, `GEOIDAL_SEPARATION`, `DOP`, `HVDOP`, `PDOP`, `SATINVIEW`, `SEQ_NO`, `TIMESTAMP`, `HEADING`, `SPEED` | `UNSET` | -| position.rx_gpio | `integer` (0-39) | `UNSET` | -| position.tx_gpio | `integer` (0-34) | `UNSET` | +| Setting | Acceptable Values | Default | +| :------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------: | +| position.gps_enabled | `true`, `false` | `true` | +| position.gps_update_interval | `integer` (seconds) | Default `0` is 2 Minutes | +| position.gps_attempt_time | `integer` (seconds) | Default of `0` is 15 Minutes | +| position.fixed_position | `true`, `false` | `false` | +| position.position_broadcast_smart_enabled | `true`, `false` | `true` | +| position.broadcast_smart_minimum_distance | `integer` (meters) | Default of `0` is 100 Meters | +|position.broadcast_smart_minimum_interval_secs| `integer` (seconds) | Default of `0` is 15 Minutes | +| position.position_broadcast_secs | `integer` (seconds) | Default of `0` is 30 Seconds | +| position.flags | `UNSET`, `ALTITUDE`, `ALTITUDE_MSL`, `GEOIDAL_SEPARATION`, `DOP`, `HVDOP`, `PDOP`, `SATINVIEW`, `SEQ_NO`, `TIMESTAMP`, `HEADING`, `SPEED` | `UNSET` | +| position.rx_gpio | `integer` (0-39) | `UNSET` | +| position.tx_gpio | `integer` (0-34) | `UNSET` | :::tip From bef945f1856824ba195a426d4f703e0c2eb429cd Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Wed, 5 Jul 2023 16:19:37 -0700 Subject: [PATCH 2/4] add ina address to summary --- docs/configuration/device-config/power.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/device-config/power.mdx b/docs/configuration/device-config/power.mdx index a84b092f..1b0d3cdc 100644 --- a/docs/configuration/device-config/power.mdx +++ b/docs/configuration/device-config/power.mdx @@ -13,7 +13,7 @@ import calculateADC from "/src/utils/calculateADC"; Power settings are advanced configuration, most users should choose a role under [Device Config](/docs/settings/config/device) to manage power for their device and shouldn't ever need to adjust these settings. ::: -The power config options are: Power Saving, Shutdown after losing power, ADC Multiplier Override, Wait Bluetooth Interval, Mesh Super Deep Sleep Timeout, Super Deep Sleep Interval, Light Sleep Interval, and Minimum Wake Interval. Power config uses an admin message sending a `Config.Power` protobuf. +The power config options are: Power Saving, Shutdown after losing power, ADC Multiplier Override, Wait Bluetooth Interval, Mesh Super Deep Sleep Timeout, Super Deep Sleep Interval, Light Sleep Interval, Minimum Wake Interval, and Device Battery INA2xx Address. Power config uses an admin message sending a `Config.Power` protobuf. :::info ADC Multiplier, Super Deep Sleep, and Light Sleep settings only apply to ESP32-based boards. These settings will have no effect on nRF52 modules. From 2013a4f90894f61fb9a8334a680468d5559b924c Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Wed, 5 Jul 2023 21:30:06 -0700 Subject: [PATCH 3/4] update apple config options --- docs/configuration/device-config/user.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/configuration/device-config/user.mdx b/docs/configuration/device-config/user.mdx index 81c43b90..d83a2600 100644 --- a/docs/configuration/device-config/user.mdx +++ b/docs/configuration/device-config/user.mdx @@ -51,7 +51,7 @@ values={[ :::info -User Config options are available for Android. +All User config options are available for Android. 1. Open the Meshtastic App 2. Navigate to: **Vertical Ellipsis (3 dots top right) > Radio Configuration > User** @@ -63,7 +63,7 @@ User Config options are available for Android. :::info -`ShortName` and `LongName` User config options are available on iOS, iPadOS and macOS at `Settings > Radio Configuration > User`. +All User config options are available on iOS, iPadOS and macOS at `Settings > Radio Configuration > User`. ::: From a549cc0b796fe2bb9a7e32971e3946d05d19a7bf Mon Sep 17 00:00:00 2001 From: pdxlocations Date: Wed, 5 Jul 2023 22:10:45 -0700 Subject: [PATCH 4/4] fix cli ls_secs default value --- docs/configuration/device-config/power.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/device-config/power.mdx b/docs/configuration/device-config/power.mdx index a84b092f..7f70959c 100644 --- a/docs/configuration/device-config/power.mdx +++ b/docs/configuration/device-config/power.mdx @@ -176,7 +176,7 @@ All Power config options are available in the python CLI. | power.wait_bluetooth_secs | `integer` (seconds) | Default of `0` is 1 minute | | power.mesh_sds_timeout_secs | `integer` (seconds) | Default of `0` is 2 hours | | power.sds_secs | `integer` (seconds) | Default of `0` is 1 year | -| power.ls_secs | `integer` (seconds) | Default of `0` is 1 hour | +| power.ls_secs | `integer` (seconds) | Default of `0` is 5 minutes | | power.min_wake_secs | `integer` (seconds) | Default of `0` is 10 seconds | | power.device_battery_ina_address | `integer` (I2C address as decimal) | Default of `0` is no address set |