meshtastic/docs/about/overview/radio-settings.mdx

130 lines
8.3 KiB
Plaintext
Raw Normal View History

2021-04-01 17:34:44 -07:00
---
id: radio-settings
title: Radio Settings
2022-11-07 20:53:52 -08:00
slug: /overview/radio-settings
2021-04-01 17:34:44 -07:00
sidebar_label: Radio Settings
2022-11-07 20:53:52 -08:00
sidebar_position: 1
description: "Maximize your Meshtastic device's potential with detailed radio settings instructions, including frequency bands, data rates, and encryption options."
2021-04-01 17:34:44 -07:00
---
2024-10-28 08:43:03 -07:00
import { FrequencyCalculator } from "/src/components/tools/FrequencyCalculator";
2023-05-12 04:40:11 -07:00
2022-11-07 20:53:52 -08:00
:::info
2022-11-09 00:49:51 -08:00
Meshtastic is **not** LoRaWAN, Helium or TTN (TheThingsNetwork). Meshtastic uses the full spectrum frequency range designated to LoRa technology per region. This allows for several hundred possible frequency channels in the US region alone.
2022-11-07 20:53:52 -08:00
:::
2021-04-01 17:34:44 -07:00
2022-11-09 00:49:51 -08:00
:::info
Power limits will generally be lifted in the software if `is_licensed` is set to `true`. See [HAM Mode](/docs/faq#amateur-radio-ham) for more information.
:::
2021-04-01 17:34:44 -07:00
<div class="no-print">
## Frequency Slot Calculator
2023-05-12 04:40:11 -07:00
<FrequencyCalculator />
</div>
2023-05-12 04:40:11 -07:00
2022-11-07 20:53:52 -08:00
## Europe Frequency Bands
2021-04-01 17:34:44 -07:00
2024-06-07 02:27:15 -07:00
EU countries will generally be covered by the Radio Equipment Directive ([2014/53/EU](http://data.europa.eu/eli/dir/2014/53/2023-10-01)) and subsequent amendments, which is then enacted in local laws. Useful information on this is located [here](https://single-market-economy.ec.europa.eu/single-market/european-standards/harmonised-standards/radio-equipment_en).
The bands below were selected based on the maximum power and the duty cycle available. It may be possible to use other frequency bands for specific applications, but these are not currently supported "out of the box".
2021-04-01 17:34:44 -07:00
### 433 MHz
The maximum power allowed for Europe is +10 dBm ERP ([Effective Radiated Power](https://en.wikipedia.org/wiki/Effective_radiated_power)).
2022-11-08 07:49:05 -08:00
2022-11-07 20:53:52 -08:00
The band range is from 433 to 434 MHz.
2021-04-01 17:34:44 -07:00
There are four frequency 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.
2021-04-01 17:34:44 -07:00
2022-11-09 00:49:51 -08:00
### 868 MHz
2022-11-08 07:49:05 -08:00
2022-11-09 00:49:51 -08:00
The maximum power allowed for Europe is +27 dBm ERP ([Effective Radiated Power](https://en.wikipedia.org/wiki/Effective_radiated_power)).
2021-04-01 17:34:44 -07:00
2024-06-09 13:56:05 -07:00
The band range is from 869.40 to 869.65 MHz. This is less than the 863870 MHz range defined as SRD ([Short Range Devices](https://www.etsi.org/technologies/short-range-devices)) Band, but allows for a higher ERP and a duty cycle of 10%.
2021-04-01 17:34:44 -07:00
2024-04-03 15:30:21 -07:00
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.
2021-04-01 17:34:44 -07:00
2024-06-09 13:56:05 -07:00
It is worth noting that 868 MHz is generally the most popular frequency band for Meshtastic in Europe.
2022-11-07 20:53:52 -08:00
## North America Frequency Bands
2021-04-01 17:34:44 -07:00
2022-11-07 20:53:52 -08:00
### 915 MHz (ISM Band)
2021-04-01 17:34:44 -07:00
2022-11-08 07:49:05 -08:00
The maximum output power for North America is +30 dBm ERP ([Effective Radiated Power](https://en.wikipedia.org/wiki/Effective_radiated_power)).
2022-11-07 20:53:52 -08:00
The band range is from 902 to 928 MHz.
2021-04-01 17:34:44 -07:00
2024-04-03 15:30:21 -07:00
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.
2022-11-07 20:53:52 -08:00
## Data Rates
### Considerations
2024-04-03 15:30:21 -07:00
Various data-rate options are available when configuring a frequency slot and are inversely proportional to the theoretical range of the devices.
2022-11-07 20:53:52 -08:00
- **Spreading Factor (SF)** - How much we "spread" our data over time.
- Each step up in Spreading Factor doubles the airtime to transmit.
2021-04-01 17:34:44 -07:00
- Each step up in Spreading Factor adds about 2.5db extra link budget.
2022-11-07 20:53:52 -08:00
- **Bandwidth** - How big of a slice of the spectrum we use.
2021-04-01 17:34:44 -07:00
- 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 Oscillator.
2022-11-07 20:53:52 -08:00
- **Coding Rate** - How much redundancy we encode to resist noise.
- Increasing coding rate increases reliability while decreasing data-rate.
2021-04-01 17:34:44 -07:00
- 4/5 - 1.25x overhead
- 4/6 - 1.5x overhead
- 4/7 - 1.75x overhead
- 4/8 - 2x overhead
### Presets
2021-04-01 17:34:44 -07:00
We have eight LoRa radio presets. These are the most common settings and have been proven to work well:
2021-04-01 17:34:44 -07:00
2024-09-07 13:17:13 -07:00
| Channel setting | Alt Channel Name | Data-Rate | SF / Symbols | Coding Rate | Bandwidth | Link Budget |
2024-10-28 08:43:03 -07:00
| :--------------------: | :--------------: | :--------: | :----------: | :---------: | :-------: | :---------: |
2024-09-07 13:17:13 -07:00
| Short Range / Turbo | Short Turbo | 21.88 kbps | 7 / 128 | 4/5 | 500[^1] | 140dB |
| Short Range / Fast | Short Fast | 10.94 kbps | 7 / 128 | 4/5 | 250 | 143dB |
| Short Range / Slow | Short Slow | 6.25 kbps | 8 / 256 | 4/5 | 250 | 145.5dB |
| Medium Range / Fast | Medium Fast | 3.52 kbps | 9 / 512 | 4/5 | 250 | 148dB |
| Medium Range / Slow | Medium Slow | 1.95 kbps | 10 / 1024 | 4/5 | 250 | 150.5dB |
| Long Range / Fast | Long Fast | 1.07 kbps | 11 / 2048 | 4/5 | 250 | 153dB |
| Long Range / Moderate | Long Moderate | 0.34 kbps | 11 / 2048 | 4/8 | 125 | 156dB |
| Long Range / Slow | Long Slow | 0.18 kbps | 12 / 4096 | 4/8 | 125 | 158.5dB |
| Very Long Range / Slow | Very Long Slow | 0.09 kbps | 12 / 4096 | 4/8 | 62.5 | 161.5dB |
2022-11-07 20:53:52 -08:00
:::note
The link budget used by these calculations assumes a transmit power of 22dBm and an antenna with 0dB gain. Adjust your link budget assumptions based on your actual devices. Data-rate in this table is the theoretical max but doesn't account for packet headers, hops and re-transmissions. Calculations based on data from the official [Semtech LoRa calculator](https://www.semtech.com/design-support/lora-calculator).
2022-11-07 20:53:52 -08:00
:::
2021-04-01 17:34:44 -07:00
![link budget vs data rate plot](/img/about/link-budget-vs-data-rate.webp)
2021-04-01 17:34:44 -07:00
### Custom Settings
2023-06-22 16:02:19 -07:00
Custom settings can be applied by using [supported software](/docs/software).
2021-04-01 17:34:44 -07:00
After applying the settings, you will need to restart the device. After your device is restarted, it will generate a new crypto key and you will need to share the newly generated QR Code or URL to all your other devices.
Some example settings:
2022-03-08 23:51:46 -08:00
| Data-rate | SF / Symbols | Coding Rate | Bandwidth | Link Budget | Note |
2023-01-19 05:01:57 -08:00
| :--------: | :----------: | :---------: | :-------: | :---------: | :----------------------------------------------------------------------- |
| 37.50 kbps | 6 / 64 | 4/5 | 500 | 129dB | Fastest possible speed |
| 3.125 kbps | 8 / 256 | 4/5 | 125 | 143dB | |
| 1.953 kbps | 8 / 256 | 4/8 | 125 | 143dB | |
| 1.343 kbps | 11 / 2048 | 4/8 | 500 | 145dB | |
| 1.099 kbps | 9 / 512 | 4/8 | 125 | 146dB | |
| 0.814 kbps | 10 / 1024 | 4/6 | 125 | 149dB | |
| 0.610 kbps | 10 / 1024 | 4/8 | 125 | 149dB | |
| 0.488 kbps | 11 / 2048 | 4/6 | 125 | 152dB | |
| 0.073 kbps | 12 / 4096 | 4/5 | 31 | 160dB | Twice the range and/or coverage of "Long Slow", low resilience to noise |
| 0.046 kbps | 12 / 4096 | 4/8 | 31 | 160dB | Twice the range and/or coverage of "Long Slow", high resilience to noise |
2021-04-01 17:34:44 -07:00
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.
2024-10-28 08:43:03 -07:00
These frequency slot settings may not have been tested. Use at your own discretion. Share on the [Meshtastic Discussions page](https://github.com/orgs/meshtastic/discussions) with your successes or failure.
2021-04-01 17:34:44 -07:00
## Cryptography
2024-10-28 08:43:03 -07:00
The pre-shared key (PSK) used by the devices can be an AES128 or AES256 sequence. Alternatively, encryption can be turned off, which may be useful if you are operating under a Ham Radio license.
2024-09-07 13:17:13 -07:00
2024-10-28 08:43:03 -07:00
[^1]: Short Turbo is the fastest preset and the only one with 500kHz bandwidth. It is not legal to use in all regions due to this wider bandwidth.