meshtastic/docs/configuration/device-config/lora.mdx

131 lines
4.8 KiB
Plaintext
Raw Normal View History

2022-06-24 19:42:37 -07:00
---
id: lora
title: LoRa Configuration
2022-11-02 11:46:54 -07:00
slug: /settings/config/lora
2022-06-24 19:42:37 -07:00
sidebar_label: LoRa
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import LoRaRegions from '../../blocks/_lora-regions.mdx';
2022-06-24 19:42:37 -07:00
2022-11-09 01:50:40 -08:00
The LoRa config options are: Region, Modem Preset, Max Hops, Transmit Power, Bandwidth, Spread Factor, Coding Rate, Frequency Offset, Transmit Enabled, Channel Number and Ignore Incoming Array. LoRa config uses an admin message sending a `Config.LoRa` protobuf.
2022-06-24 19:42:37 -07:00
## LoRa Config Values
:::note
2022-08-18 07:34:39 -07:00
You must set your device's `lora.region` setting. This will ensure that you are operating within the legal limits for your area.
2022-06-24 19:42:37 -07:00
:::
### Region
2022-11-09 01:50:40 -08:00
Sets the region for your node. Default is `unset`. As long as this is not set, the node screen will display a message and not transmit any packets.
2022-06-24 19:42:37 -07:00
<LoRaRegions />
2022-06-24 19:42:37 -07:00
### Modem Preset
2022-11-09 01:50:40 -08:00
Use a sensible default for the modem. Default is `unset` which equates to `LONG_FAST`. Also 'Use Presets' has to be defined, which is the default. If 'Use Presets' is not defined, the modem will be configured manually with Bandwidth, Spread Factor, and Coding Rate.
2022-06-24 19:42:37 -07:00
### Max Hops
2022-11-09 01:50:40 -08:00
Maximum number of hops. This can't be greater than 7. Default is 3 which should be fine for most applications. _**Really, 3 is fine.**_
2022-06-24 19:42:37 -07:00
2022-06-29 08:55:33 -07:00
### Transmit Power
2022-10-05 06:25:07 -07:00
If zero then, use default max legal continuous power (i.e. something that won't burn out the radio hardware)
2022-06-29 08:55:33 -07:00
In most cases you should use zero here. Units are in dBm.
### Bandwidth
Bandwidth in MHz
2022-11-09 01:50:40 -08:00
Certain bandwidth numbers are 'special' and will be converted by the device firmware to the appropriate floating point value: 31 -> 31.25MHz
2022-06-29 08:55:33 -07:00
2022-10-22 09:50:38 -07:00
### Spread Factor
2022-06-29 08:55:33 -07:00
A number from 7 to 12. Indicates the number of chirps per symbol as 1<<spread_factor.
### Coding Rate
The denominator of the coding rate. ie for 4/5, the value is 5. 4/8 the value is 8.
2022-06-29 08:55:33 -07:00
### Frequency Offset
This parameter is for advanced users with advanced test equipment, we do not recommend most users use it.
A frequency offset that is added to to the calculated band center frequency. Used to correct for crystal calibration errors.
2022-10-22 09:50:38 -07:00
### Transmit Enabled
2022-06-29 08:55:33 -07:00
2022-09-22 18:51:41 -07:00
Allows you to enable and disable transmit (TX) from the LoRa radio. Useful for hot-swapping antennas and other tests.
2022-06-29 08:55:33 -07:00
2022-11-09 01:50:40 -08:00
Defaults to true
### Channel Number
This is controlling the actual hardware frequency the radio is transmitting on. A channel number between 1 and NUM_CHANNELS (whatever the max is in the current region). If this is ZERO/UNSET then the rule is "use the old channel name hash based algorithm to derive the channel number".
2022-06-29 08:55:33 -07:00
### Ignore Incoming Array
2022-10-05 06:25:07 -07:00
For testing it is useful sometimes to force a node to never listen to particular other nodes (simulating radio out of range). All nodenums listed in the ignore_incoming array will have packets they send dropped on receive (by router.cpp)
2022-06-24 19:42:37 -07:00
2023-01-04 08:05:39 -08:00
### Override Duty Cycle Limit
2023-01-05 08:32:08 -08:00
Setting this option to 'true' means the device will ignore the hourly duty cycle limit in Europe. This means that you might violate regulations if the device transmits too much. By default, this option is set to 'false,' which means the device will stop sending data when it reaches the hourly limit and will start again when it is allowed to do so.
2023-01-04 08:05:39 -08:00
2022-06-24 19:42:37 -07:00
## LoRa Config Client Availability
<Tabs
groupId="settings"
defaultValue="apple"
2022-06-24 19:42:37 -07:00
values={[
{label: 'Android', value: 'android'},
{label: 'Apple', value: 'apple'},
2022-06-29 08:55:33 -07:00
{label: 'CLI', value: 'cli'},
2022-06-24 19:42:37 -07:00
{label: 'Flasher', value: 'flasher'},
{label: 'Web', value: 'web'},
]}>
<TabItem value="android">
:::info
2022-12-04 13:07:48 -08:00
LoRa Config options such as Region, Modem Preset, and Hop Limit can be configured on Android.
1. Open the Meshtastic App
2. Navigate to: **Vertical Ellipsis (3 dots top right) > Device Settings > LoRa Config**
2022-06-24 19:42:37 -07:00
:::
</TabItem>
<TabItem value="apple">
:::info
Configuration of Region, Modem Preset and Hop Limit is available on iOS, iPadOS and macOS at Settings > Radio Configuration > LoRa.
:::
</TabItem>
<TabItem value="cli">
2022-10-05 06:25:07 -07:00
LoRa config commands are available in the python CLI. Example commands are below:
2022-06-24 19:42:37 -07:00
| Setting | Acceptable Values | Default |
| :----------: | :---------------------------------------------------------------------------: | :---------------: |
| lora.modem_preset | `LONG_FAST`, `LONG_SLOW`, `VERY_LONG_SLOW`, `MEDIUM_SLOW`, `MEDIUM_FAST`, `SHORT_SLOW`, `SHORT_FAST` | `LONG_FAST` |
2022-11-09 01:50:40 -08:00
| lora.region | `UNSET`, `US`, `EU_433`, `EU_868`, `CN`, `JP`, `ANZ`, `KR`, `TW`, `RU` ,`IN`, `NZ_865`, `TH`, `LORA_24` | `UNSET` |
2022-09-12 12:08:49 -07:00
| lora.hop_limit | `1`,`2`,`3`,`4`,`5`,`6`,`7` | `3` |
2023-01-03 08:04:03 -08:00
| lora.override_duty_cycle | `false`, `true` | `false` |
2022-06-24 19:42:37 -07:00
</TabItem>
<TabItem value="flasher">
:::info
2022-11-02 11:46:54 -07:00
No LoRa config options are available in the Flasher.
2022-06-24 19:42:37 -07:00
:::
</TabItem>
<TabItem value="web">
:::info
2022-11-02 11:46:54 -07:00
All LoRa config options are available in the Web UI.
2022-06-24 19:42:37 -07:00
:::
2022-10-22 09:50:38 -07:00
2022-06-24 19:42:37 -07:00
</TabItem>
</Tabs>