From 5661e5dad6cddc867f361250fdd14ecbc2a335b9 Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Tue, 2 Feb 2021 22:43:24 -0800 Subject: [PATCH 1/9] Update radio-settings.md --- docs/radio-settings.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index 7af9d79e0..76060b351 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -33,9 +33,9 @@ Channel zero starts at 903.08 MHz center frequency. Various data-rates are selectable when configuring a channel and are inversely proportional to the theoretical range of the devices: -| Channel setting | Data-rate | -|----------------------------|----------------------| -| Short range (but fast) | 21.875 kbps | -| Medium range (but fast) | 5.469 kbps | -| Long range (but slower) | 0.275 kbps | -| Very long range (but slow) | 0.183 kbps (default) | +| Channel setting | Alt Channel Name | Data-rate | SF | Symbols | Coding Rate | Bandwidth | +|----------------------------|------------------|----------------------|--------------|-------------------------| +| Short range (but fast) | Short Fast | 21.875 kbps | 7 | 128 | 4/5 | 125 | +| Medium range (but fast) | Medium | 5.469 kbps | 7 | 512 | 4/5 | 500 | +| Long range (but slower) | Long Alt | 0.275 kbps | 9 | 512 | 4/8 | 31 | +| Very long range (but slow) | Long Slow | 0.183 kbps (default) | 12 | 4096 | 4/8 | 125 | From 8a68ae0d044511f4236c631507d2954ba2f5168c Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Tue, 2 Feb 2021 22:47:16 -0800 Subject: [PATCH 2/9] Update radio-settings.md --- docs/radio-settings.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index 76060b351..5c94fe9cf 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -39,3 +39,7 @@ Various data-rates are selectable when configuring a channel and are inversely p | Medium range (but fast) | Medium | 5.469 kbps | 7 | 512 | 4/5 | 500 | | Long range (but slower) | Long Alt | 0.275 kbps | 9 | 512 | 4/8 | 31 | | Very long range (but slow) | Long Slow | 0.183 kbps (default) | 12 | 4096 | 4/8 | 125 | + +Other radio settings can be configured by using the Python API. An easy calculator of other bit rates is: + +https://unsigned.io/understanding-lora-parameters/ \ No newline at end of file From 0c6c189028c72e789f744f65d6b32f99b4626cf5 Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Tue, 2 Feb 2021 23:01:05 -0800 Subject: [PATCH 3/9] Update to radio-settings.md --- docs/radio-settings.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index 5c94fe9cf..ad90b9fd0 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -33,13 +33,14 @@ Channel zero starts at 903.08 MHz center frequency. Various data-rates are selectable when configuring a channel and are inversely proportional to the theoretical range of the devices: -| Channel setting | Alt Channel Name | Data-rate | SF | Symbols | Coding Rate | Bandwidth | -|----------------------------|------------------|----------------------|--------------|-------------------------| -| Short range (but fast) | Short Fast | 21.875 kbps | 7 | 128 | 4/5 | 125 | -| Medium range (but fast) | Medium | 5.469 kbps | 7 | 512 | 4/5 | 500 | -| Long range (but slower) | Long Alt | 0.275 kbps | 9 | 512 | 4/8 | 31 | -| Very long range (but slow) | Long Slow | 0.183 kbps (default) | 12 | 4096 | 4/8 | 125 | +| Channel setting | Alt Channel Name | Data-rate | SF / Symbols | Coding Rate | Bandwidth | +|:---------------------------|:-----------------|:---------------------|:-------------|:------------|:----------| +| Short range (but fast) | Short Fast | 21.875 kbps | 7 / 128 | 4/5 | 125 | +| Medium range (but fast) | Medium | 5.469 kbps | 7 / 512 | 4/5 | 500 | +| Long range (but slower) | Long Alt | 0.275 kbps | 9 / 512 | 4/8 | 31 | +| Very long range (but slow) | Long Slow | 0.183 kbps (default) | 12 / 4096 | 4/8 | 125 | Other radio settings can be configured by using the Python API. An easy calculator of other bit rates is: -https://unsigned.io/understanding-lora-parameters/ \ No newline at end of file +[Lora Parameters](https://unsigned.io/understanding-lora-parameters/) + From 324627482aba9ac85551286be18e3fa7e34d3b1c Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Tue, 2 Feb 2021 23:57:25 -0800 Subject: [PATCH 4/9] Update radio-settings.md --- docs/radio-settings.md | 39 +++++++++++++++++++++++++++++++++++++-- 1 file changed, 37 insertions(+), 2 deletions(-) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index ad90b9fd0..9968ee27e 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -31,7 +31,23 @@ Channel zero starts at 903.08 MHz center frequency. ## Data-rates -Various data-rates are selectable when configuring a channel and are inversely proportional to the theoretical range of the devices: +Various data-rates are selectable when configuring a channel and are inversely proportional to the theoretical range of the devices. + +Considerations: + +* Spreading Factor +* * Each step up in Spreading Factor dobules the airtime to transmit. +* * Each step up in Spreading Factor adds about 2.5db extra link budget. +* Bandwidth +* * Each doubling of the bandwidth is almost 3db less link budget. +* Coding Rate +* * Increasing coding rate increases reliability while decrasing data-rate. +* * 4/5 - 1.25x overhead +* * 4/6 - 1.5x overhead +* * 4/7 - 1.75x overhead +* * 4/8 - 2x overhead + +Predefined Channels: | Channel setting | Alt Channel Name | Data-rate | SF / Symbols | Coding Rate | Bandwidth | |:---------------------------|:-----------------|:---------------------|:-------------|:------------|:----------| @@ -40,7 +56,26 @@ Various data-rates are selectable when configuring a channel and are inversely p | Long range (but slower) | Long Alt | 0.275 kbps | 9 / 512 | 4/8 | 31 | | Very long range (but slow) | Long Slow | 0.183 kbps (default) | 12 / 4096 | 4/8 | 125 | -Other radio settings can be configured by using the Python API. An easy calculator of other bit rates is: +Other settings can be set by using the Python API. + +> meshtastic --set spread_factor 10 --set coding_rate 8 --bandwidth 125 + +Some example settings: + +| Data-rate | SF / Symbols | Coding Rate | Bandwidth | Note | +|:---------------------|:-------------|:------------|:----------|:-----| +| 3.125 kbps | 8 / 256 | 4/5 | 125 | | +| 1.953 kbps | 8 / 256 | 4/8 | 125 | | +| 1.343 kbps | 11 / 2048 | 4/8 | 512 | | +| 1.099 kbps | 9 / 512 | 4/8 | 125 | | +| 0.814 kbps | 10 / 1024 | 4/6 | 125 | | +| 0.610 kbps | 10 / 1024 | 4/8 | 125 | | +| 0.488 kbps | 11 / 2048 | 4/6 | 125 | | +| 0.336 kbps | 11 / 2048 | 4/8 | 125 | | +| 0.092 kbps | 12 / 4096 | 4/8 | 62 | | +| 0.046 kbps | 12 / 4096 | 4/8 | 31 | Twice the range of "Long Slow" | + +An easy calculator of other bit rates is: [Lora Parameters](https://unsigned.io/understanding-lora-parameters/) From 6d66a53f8d3811b5523dc81d6162cf6e487b27f0 Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Tue, 2 Feb 2021 23:59:34 -0800 Subject: [PATCH 5/9] Another update to radio-settings.md --- docs/radio-settings.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index 9968ee27e..73aba91ff 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -31,6 +31,8 @@ Channel zero starts at 903.08 MHz center frequency. ## Data-rates +### About + Various data-rates are selectable when configuring a channel and are inversely proportional to the theoretical range of the devices. Considerations: @@ -47,6 +49,9 @@ Considerations: * * 4/7 - 1.75x overhead * * 4/8 - 2x overhead + +### Pre-Defined + Predefined Channels: | Channel setting | Alt Channel Name | Data-rate | SF / Symbols | Coding Rate | Bandwidth | @@ -56,6 +61,8 @@ Predefined Channels: | Long range (but slower) | Long Alt | 0.275 kbps | 9 / 512 | 4/8 | 31 | | Very long range (but slow) | Long Slow | 0.183 kbps (default) | 12 / 4096 | 4/8 | 125 | +### Custom Settings + Other settings can be set by using the Python API. > meshtastic --set spread_factor 10 --set coding_rate 8 --bandwidth 125 @@ -75,7 +82,4 @@ Some example settings: | 0.092 kbps | 12 / 4096 | 4/8 | 62 | | | 0.046 kbps | 12 / 4096 | 4/8 | 31 | Twice the range of "Long Slow" | -An easy calculator of other bit rates is: - -[Lora Parameters](https://unsigned.io/understanding-lora-parameters/) From 9c60a7966fb9e254978690959555f69bf78ef37e Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Wed, 3 Feb 2021 00:01:52 -0800 Subject: [PATCH 6/9] Update radio-settings.md --- docs/radio-settings.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index 73aba91ff..4a3f615e0 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -52,7 +52,7 @@ Considerations: ### Pre-Defined -Predefined Channels: +We have four predefined channels. These are the most common settings and have been proven to work well: | Channel setting | Alt Channel Name | Data-rate | SF / Symbols | Coding Rate | Bandwidth | |:---------------------------|:-----------------|:---------------------|:-------------|:------------|:----------| @@ -63,7 +63,7 @@ Predefined Channels: ### Custom Settings -Other settings can be set by using the Python API. +You may want to select other channels for your usage. The other settings can be set by using the Python API. > meshtastic --set spread_factor 10 --set coding_rate 8 --bandwidth 125 From b901f8d9ae3dec67ae0623ad106b20df245bdd14 Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Wed, 3 Feb 2021 00:15:41 -0800 Subject: [PATCH 7/9] Update to radio-settings.md --- docs/radio-settings.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index 4a3f615e0..e6b148cc1 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -37,12 +37,12 @@ Various data-rates are selectable when configuring a channel and are inversely p Considerations: -* Spreading Factor +* Spreading Factor - How much we "spread" our data over time. * * Each step up in Spreading Factor dobules the airtime to transmit. * * Each step up in Spreading Factor adds about 2.5db extra link budget. -* Bandwidth +* Bandwidth - How big of a slice of the spectrum we use. * * Each doubling of the bandwidth is almost 3db less link budget. -* Coding Rate +* Coding Rate - How much redundency we encode to resist noise. * * Increasing coding rate increases reliability while decrasing data-rate. * * 4/5 - 1.25x overhead * * 4/6 - 1.5x overhead From 45c17659ccd5add061853ec7c38dbc7d4668c7a2 Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Wed, 3 Feb 2021 01:04:23 -0800 Subject: [PATCH 8/9] radio-settings.md - add note about TCXO stability --- docs/radio-settings.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index e6b148cc1..027b9638f 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -42,6 +42,7 @@ Considerations: * * Each step up in Spreading Factor adds about 2.5db extra link budget. * Bandwidth - How big of a slice of the spectrum we use. * * Each doubling of the bandwidth is almost 3db less link budget. +* * Bandwidths less than 31 may be unstable unless you have a high quality Crystal Ossilator. * Coding Rate - How much redundency we encode to resist noise. * * Increasing coding rate increases reliability while decrasing data-rate. * * 4/5 - 1.25x overhead From 0fa654e53ad97cd68e38a7ce28e20971fa304a9e Mon Sep 17 00:00:00 2001 From: Jm Casler Date: Wed, 3 Feb 2021 07:01:35 -0800 Subject: [PATCH 9/9] update radio-settings.md --- docs/radio-settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/radio-settings.md b/docs/radio-settings.md index 027b9638f..e45ea387c 100644 --- a/docs/radio-settings.md +++ b/docs/radio-settings.md @@ -66,7 +66,7 @@ We have four predefined channels. These are the most common settings and have be You may want to select other channels for your usage. The other settings can be set by using the Python API. -> meshtastic --set spread_factor 10 --set coding_rate 8 --bandwidth 125 +> meshtastic --setchan spread_factor 10 --setchan coding_rate 8 --setchan bandwidth 125 Some example settings: