Skip to main content

Channel Settings - Advanced

warning

These settings are for advanced users only. If you don't know what you are doing you could damage your radio or break local radio laws. Proceed with caution.

Overview​

Most users should not need to change these settings. The default modem_config settings should work just fine.

Settings​

SettingAcceptable ValuesDefault
bandwidth10.4, 15.6, 20.8, 31.25, 41.7, 62.5, 125, 250, 500125
channel_numDepends on RegionRegion Channel Number Default
coding_rate5, 6, 7, 85
frequency_offsetreal numbers0
spread_factor7, 8, 9, 10, 11, 127
tx_power0, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, (dBm)0

bandwidth​

Total amount of spectrum used for the transmission.

Set Bandwidth​

meshtastic --ch-set bandwidth 125 --ch-index 0

channel_num​

An abstraction that maps to a specific center frequency used for transmission.

Set Channel Number​

info

Configuring this setting is not yet available for the selected platform. If this is incorrect please update the documentation for this page.

coding_rate​

The amount of forward error correction applied to allow for us to automatically repair errors in the data transmission.

Set Coding Rate​

meshtastic --ch-set coding_rate 8 --ch-index 0

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.

Configure frequency_offset​

info

Configuring this setting is not yet available for the selected platform. If this is incorrect please update the documentation for this page.

spread_factor​

LoRa is a spread spectrum technology. spread_factor is how much the signal is spread over the spectrum. SF8 = 2^8 or spread 256 times. SF12 = 2^12 or spread 4096 times.

Set Spread Factor​

meshtastic --ch-set spread_factor 12 --ch-index 0

tx_power​

Configured transmit power out of the LoRa radio, measured in dBM. Setting this to 0 will use the device default which is the max legal continuous power for your region.

caution

Ensure that you are not exceeding your country's regulations.

Country regulation - antenna gain = tx_power max setting

Set TX Power​

Set Default
meshtastic --ch-set tx_power 0 --ch-index 0
Set to 2dBM
meshtastic --ch-set tx_power 2 --ch-index 0