7.5 KiB
| id | title | sidebar_label |
|---|---|---|
| channel | Channel Settings | Channel |
import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';
Overview
Channel settings are an integral part of the way your devices communicate across the mesh. If you have mismatched channel settings, your radios will be unable to communicate with one another.
Settings
| Setting | Acceptable Values | Default |
|---|---|---|
| downlink_enabled | true, false |
false |
| id | integer |
0 |
| modem_config | Bw125Cr45Sf128, Bw500Cr45Sf128, Bw31_25Cr48Sf512, Bw125Cr48Sf4096 |
TODO |
| name | string |
"" |
| psk | 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 |
1 |
| region | Unset, US, EU433, EU865, CN, JP, ANZ, KR, TW, RU |
Unset |
| uplink_enabled | true, false |
false |
downlink_enabled
If true, messages seen on the internet will be forwarded to the local mesh through a gateway node. See MQTT settings for more details.
:::caution This is in active development and not ready for casual users. Testing only. :::
id
modem_config
| Setting | Name | Bandwidth | Coding Rate | Spread Factor | Speed |
|---|---|---|---|---|---|
Bw125Cr45Sf128 |
Medium | 125 kHz | 4/5 | 7 = 128chips/symbol | 5.469 kbps |
Bw500Cr45Sf128 |
ShortFast | 500 kHz | 4/5 | 7 = 128chips/symbol | 21.875 kbps |
Bw31_25Cr48Sf512 |
LongAlt | 31.25 kHz | 4/8 | 9 = 512chips/symbol | 275 bps |
Bw125Cr48Sf4096 |
LongSlow | 125 kHz | 4/8 | 12 = 4096chips/symbol | 183 bps |
name
psk
| Setting | Behavior |
|---|---|
0 |
Disable Encryption |
1 |
Default Encryption |
2-10 |
Default Encryption, except with 1-9 added to the last byte |
| Setting | Behavior |
|---|---|
none |
Disable Encryption |
default |
Default Encryption |
random |
TODO |
region
The region variable sets which region your radio is configured to work in. It is important to ensure that you've set it to the correct region. If left Unset, it will default to US settings.
| Name | Center Frequency | Spacing | Number of Channels | Power Limit |
|---|---|---|---|---|
| US | 903.08 | 2.16 | 13 | 0 |
| EU433 | 433.175 | 0.2 | 8 | 0 |
| EU865 | 865.2 | 0.3 | 10 | 0 |
| CN | 470.0 | 2.0 | 20 | 0 |
| JP | 920.0 | 0.5 | 10 | 13 |
| ANZ | 916.0 | 0.5 | 20 | 0 |
| KR | 921.9 | 0.2 | 8 | 0 |
| TW | 923.0 | 0.2 | 10 | 0 |
| RU | 868.9 | 0.2 | 2 | 20 |
| Unset | 903.08 | 2.16 | 13 | 0 |
| :::note | ||||
For more details about region settings, you can see the source code here |
||||
| ::: |
uplink_enabled
If true, messages on the mesh will be sent to the public internet by any gateway node. See MQTT settings for more details.
Examples
Set Channel ID
<Tabs groupId="settings" defaultValue="cli" values={[ {label: 'CLI', value: 'cli'}, {label: 'Android', value: 'android'}, ]}>
meshtastic --ch-set id 1234 --ch-index 0
TODO
:::note
The channel id must be an integer.
:::
Set Channel Name
<Tabs groupId="settings" defaultValue="cli" values={[ {label: 'CLI', value: 'cli'}, {label: 'Android', value: 'android'}, ]}>
meshtastic --ch-set name MyChannel --ch-index 0
meshtastic --ch-set name "My Channel" --ch-index 0
TODO
:::note
A channel id must be set in order to name a channel.
:::
Set Encryption
<Tabs groupId="settings" defaultValue="cli" values={[ {label: 'CLI', value: 'cli'}, {label: 'Android', value: 'android'}, ]}>
meshtastic --ch-set psk default --ch-index 0
TODO
:::note
See psk for details.
:::
Set Modem
<Tabs groupId="settings" defaultValue="cli" values={[ {label: 'CLI', value: 'cli'}, {label: 'Android', value: 'android'}, ]}>
meshtastic --ch-set modem_config Bw125Cr48Sf4096 --ch-index 0
TODO
:::note
See modem_config for details. For advanced modem configuration, see Channel Settings - Advanced.
:::
Set Region
<Tabs groupId="settings" defaultValue="cli" values={[ {label: 'CLI', value: 'cli'}, {label: 'Android', value: 'android'}, ]}>
meshtastic --set region Unset
TODO