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