Skip to main content

Channel Settings

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#

SettingAcceptable ValuesDefault
downlink_enabledtrue, falsefalse
idinteger0
modem_configBw125Cr45Sf128, Bw500Cr45Sf128, Bw31_25Cr48Sf512, Bw125Cr48Sf4096TODO
namestring""
psk0, 1, 2, 3, 4, 5, 6, 7, 8, 91
regionUnset, US, EU433, EU865, CN, JP, ANZ, KR, TW, RUUnset
uplink_enabledtrue, falsefalse

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#

SettingNameBandwidthCoding RateSpread FactorSpeed
Bw125Cr45Sf128Medium125 kHz4/57 = 128chips/symbol5.469 kbps
Bw500Cr45Sf128ShortFast500 kHz4/57 = 128chips/symbol21.875 kbps
Bw31_25Cr48Sf512LongAlt31.25 kHz4/89 = 512chips/symbol275 bps
Bw125Cr48Sf4096LongSlow125 kHz4/812 = 4096chips/symbol183 bps

name#

psk#

SettingBehavior
0Disable Encryption
1Default Encryption
2-10Default Encryption, except with 1-9 added to the last byte
SettingBehavior
noneDisable Encryption
defaultDefault Encryption
randomTODO

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.

NameCenter FrequencySpacingNumber of ChannelsPower Limit
US903.082.16130
EU433433.1750.280
EU865865.20.3100
CN470.02.0200
JP920.00.51013
ANZ916.00.5200
KR921.90.280
TW923.00.2100
RU868.90.2220
Unset903.082.16130
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#

Set channel ID
meshtastic --ch-set id 1234
note

The channel id must be an integer.

Set Channel Name#

Set channel name
meshtastic --ch-set name MyChannel
Set channel name with spaces
meshtastic --ch-set name "My Channel"
note

A channel id must be set in order to name a channel.

Set Encryption#

Set psk
meshtastic --ch-set psk default
note

See psk for details.

Set Modem#

Set Modem - LongSlow
meshtastic --ch-set modem_config Bw125Cr48Sf4096
note

See modem_config for details. For advanced modem configuration, see Channel Settings - Advanced.

Set Region#

Set Region
meshtastic --set region Unset