From edf9ae69d278b231d2d72c11ae5a83c1759dc256 Mon Sep 17 00:00:00 2001 From: Nestpebble <116762865+Nestpebble@users.noreply.github.com> Date: Tue, 2 Apr 2024 01:11:21 +0100 Subject: [PATCH 1/6] Update usage.mdx Updated with an explanation that a channel can be adjusted, and the position precision is in there and can be adjusted as well. Also included an info box with the precision levels explained. --- docs/software/android/usage.mdx | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/software/android/usage.mdx b/docs/software/android/usage.mdx index 76379c60..cdd37117 100644 --- a/docs/software/android/usage.mdx +++ b/docs/software/android/usage.mdx @@ -101,6 +101,22 @@ You can test changing channels with the QR code shown below. ![Meshtastic Default Channel](/img/android/default-channel.webp) +### Adjust a channel + +You can change the following settings by tapping on the name of an existing channel: +1. MQTT Uplink +2. MQTT Downlink +3. Position sharing precision level + +:::note +The precision levels currently used in the app correspond to the following values: +- HIGH_PRECISION (32), full precision +- MED_PRECISION (16), around ±350 meters +- LOW_PRECISION (11), around ±11 kilometers +- DISABLED (0), location data is never sent over the given channel + +::: + ### Send a message [![Messages](/img/android/android-messages-sm.webp)](/img/android/android-messages.webp) From 91e98caeb987c7097666f139dc8e808b57e6bfaf Mon Sep 17 00:00:00 2001 From: Mantas Date: Wed, 3 Apr 2024 21:15:14 +0300 Subject: [PATCH 2/6] Add Lithuanian Facebook group (#1168) --- docs/community/local-groups.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/community/local-groups.mdx b/docs/community/local-groups.mdx index b19a2156..e885d0d7 100644 --- a/docs/community/local-groups.mdx +++ b/docs/community/local-groups.mdx @@ -55,6 +55,9 @@ us on [Discord](https://discord.com/invite/ktMAKGBnBs) to add your group. ### Texas - [Austin Mesh](https://austinmesh.org/) +## Lithuania +- [Meshtastic Lietuva](https://www.facebook.com/groups/1122509422249414) + ## Poland - [Meshtastic Poland Matrix Space](https://matrix.to/#/#meshtasticpl:matrix.org) From 68fd07468f8020a1dd8c84ae43cc16a517d88d3e Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Wed, 3 Apr 2024 12:32:09 -0700 Subject: [PATCH 3/6] Update contributing.mdx --- docs/about/contributing.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/about/contributing.mdx b/docs/about/contributing.mdx index 574e08e0..ac007c14 100644 --- a/docs/about/contributing.mdx +++ b/docs/about/contributing.mdx @@ -82,4 +82,6 @@ We're deeply thankful for the backing from the Open Collective, Open Source Coll - **DigitalOcean**: Champions of open source, DigitalOcean supports Meshtastic through credits, which significantly aid our development, infrastructure, and testing efforts. This contribution is part of their commitment to fostering innovation and collaboration within the open source ecosystem. +![This project is supported by DigitalOcean](https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/PoweredByDO/DO_Powered_by_Badge_blue.svg "This project is supported by DigitalOcean") + - **Vercel**: By covering our hosting costs, Vercel directly contributes to Meshtastic's growth, enhancing our web scalability and presence. Their sponsorship is crucial for our continued development and focus on creating a robust platform for decentralized communication. From 2b19d3d5532ae92133cb793ca9e00fd3c67ebc3f Mon Sep 17 00:00:00 2001 From: Tommy Ekstrand Date: Wed, 3 Apr 2024 14:53:44 -0500 Subject: [PATCH 4/6] add page descriptions for all docs under antennas (#1170) --- docs/hardware/antennas/antenna-report.mdx | 3 ++- docs/hardware/antennas/index.mdx | 1 + docs/hardware/antennas/resources.mdx | 1 + docs/hardware/antennas/testing.mdx | 1 + 4 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/hardware/antennas/antenna-report.mdx b/docs/hardware/antennas/antenna-report.mdx index c6900392..fafe7f89 100644 --- a/docs/hardware/antennas/antenna-report.mdx +++ b/docs/hardware/antennas/antenna-report.mdx @@ -1,6 +1,7 @@ --- id: antenna-reports title: LoRa Antenna Testing Reports +description: Community created Antenna Testing Reports for Meshtastic radios sidebar_label: Testing Reports sidebar_position: 2 --- @@ -11,4 +12,4 @@ The Meshtastic Antenna Reports repository started as a project by [RicInNewMexic These users have gone through the effort of testing and providing their opinions on whether specific antennas perform optimally with Meshtastic devices. -If you wish to contribute a testing report or evaluation, please review the contribution guidelines in the [Meshtastic Antenna Reports](https://github.com/meshtastic/antenna-reports) Github repository. \ No newline at end of file +If you wish to contribute a testing report or evaluation, please review the contribution guidelines in the [Meshtastic Antenna Reports](https://github.com/meshtastic/antenna-reports) Github repository. diff --git a/docs/hardware/antennas/index.mdx b/docs/hardware/antennas/index.mdx index 45d7711a..23215540 100644 --- a/docs/hardware/antennas/index.mdx +++ b/docs/hardware/antennas/index.mdx @@ -1,6 +1,7 @@ --- id: antennas title: LoRa Antennas +description: Community favorites, testing teports, general considerations, and other resources for antennas for Meshtastic devices sidebar_label: Antennas sidebar_position: 2 --- diff --git a/docs/hardware/antennas/resources.mdx b/docs/hardware/antennas/resources.mdx index 33c4e98e..5f41caa1 100644 --- a/docs/hardware/antennas/resources.mdx +++ b/docs/hardware/antennas/resources.mdx @@ -1,6 +1,7 @@ --- id: resources title: LoRa Antenna Resources +description: Resources for creating coverage maps, RF calculations, and antenna designs for Meshtastic sidebar_label: Resources sidebar_position: 4 --- diff --git a/docs/hardware/antennas/testing.mdx b/docs/hardware/antennas/testing.mdx index da8d3d68..39ec6f8b 100644 --- a/docs/hardware/antennas/testing.mdx +++ b/docs/hardware/antennas/testing.mdx @@ -1,6 +1,7 @@ --- id: antenna-testing title: Antenna Testing +description: Explore Meshtastic antenna testing to improve device range. Learn simple to advanced techniques for selecting the right antenna, ensuring effective and cost-efficient communication. sidebar_label: Testing sidebar_position: 1 --- From f7f36a91fc9fb2fe9ed850ad54bb1d52454bb843 Mon Sep 17 00:00:00 2001 From: rcarteraz Date: Wed, 3 Apr 2024 15:30:21 -0700 Subject: [PATCH 5/6] More missed channel mentions --- docs/about/overview/radio-settings.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/about/overview/radio-settings.mdx b/docs/about/overview/radio-settings.mdx index b7154346..2556e510 100644 --- a/docs/about/overview/radio-settings.mdx +++ b/docs/about/overview/radio-settings.mdx @@ -31,7 +31,7 @@ The maximum power allowed for Europe is +10 dBm ERP ([Effective Radiated Power]( The band range is from 433 to 434 MHz. -There are four channels defined with the standard radio preset `LongFast`. After factory reset the radio will be set to channel 4 with a center frequency of 433.875 MHz. +There are four frequendy slots defined with the standard radio preset `LongFast`. After factory reset the radio will be set to frequency slot 4 with a center frequency of 433.875 MHz. ### 868 MHz @@ -39,7 +39,7 @@ The maximum power allowed for Europe is +27 dBm ERP ([Effective Radiated Power]( The band range is from 869.40 to 869.65 MHz. This is less than the 863–870 MHz range defined as SRD Band, but allows for a higher ERP and a duty cycle of 10%. -There is one channel defined with the standard radio preset `LongFast`. After factory reset the radio will be set to channel 1 with a center frequency of 869.525 MHz. +There is one frequency slot defined with the standard radio preset `LongFast`. After factory reset the radio will be set to frequency slot 1 with a center frequency of 869.525 MHz. ## North America Frequency Bands @@ -49,13 +49,13 @@ The maximum output power for North America is +30 dBm ERP ([Effective Radiated P The band range is from 902 to 928 MHz. -There are 104 channels defined with the standard radio preset `LongFast`. After factory reset the radio will be set to channel 20 with a center frequency of 906.875 MHz. +There are 104 frequency slots defined with the standard radio preset `LongFast`. After factory reset the radio will be set to frequency slot 20 with a center frequency of 906.875 MHz. ## Data Rates ### Considerations -Various data-rate options are available when configuring a channel and are inversely proportional to the theoretical range of the devices. +Various data-rate options are available when configuring a frequency slot and are inversely proportional to the theoretical range of the devices. - **Spreading Factor (SF)** - How much we "spread" our data over time. - Each step up in Spreading Factor doubles the airtime to transmit. @@ -112,7 +112,7 @@ Some example settings: The link budget used by these calculations assumes a transmit power of 17dBm and an antenna with 0dB gain. Adjust your link budget assumptions based on your actual devices. -These channel settings may not have been tested. Use at your own discretion. Share on https://meshtastic.discourse.group with your successes or failure. +These frequency slot settings may not have been tested. Use at your own discretion. Share on https://meshtastic.discourse.group with your successes or failure. ## Cryptography From eaf0a453ba0da7bdb328c7eb2ca0e16d16d9b1c6 Mon Sep 17 00:00:00 2001 From: Nestpebble <116762865+Nestpebble@users.noreply.github.com> Date: Wed, 3 Apr 2024 23:34:28 +0100 Subject: [PATCH 6/6] Update usage.mdx Adjusted based on @rcarteraz comment here: https://github.com/meshtastic/meshtastic/pull/1166#discussion_r1549925115 --- docs/software/android/usage.mdx | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/software/android/usage.mdx b/docs/software/android/usage.mdx index cdd37117..f6e6940c 100644 --- a/docs/software/android/usage.mdx +++ b/docs/software/android/usage.mdx @@ -106,17 +106,15 @@ You can test changing channels with the QR code shown below. You can change the following settings by tapping on the name of an existing channel: 1. MQTT Uplink 2. MQTT Downlink -3. Position sharing precision level +3. Position precision value -:::note +#### Position Precision The precision levels currently used in the app correspond to the following values: - HIGH_PRECISION (32), full precision - MED_PRECISION (16), around ±350 meters - LOW_PRECISION (11), around ±11 kilometers - DISABLED (0), location data is never sent over the given channel -::: - ### Send a message [![Messages](/img/android/android-messages-sm.webp)](/img/android/android-messages.webp)