Lora Config


from protobuf message Config.LoRaConfig


  • Config_LoRaConfig


bandwidth: number

Bandwidth in MHz Certain bandwidth numbers are 'special' and will be converted to the appropriate floating point value: 31 -> 31.25MHz


from protobuf field: uint32 bandwidth = 3;

channelNum: number

This is controlling the actual hardware frequency the radio is transmitting on. Most users should never need to be exposed to this field/concept. A channel number between 1 and NUM_CHANNELS (whatever the max is in the current region). If ZERO then the rule is "use the old channel name hash based algorithm to derive the channel number") If using the hash algorithm the channel number will be: hash(channel_name) % NUM_CHANNELS (Where num channels depends on the regulatory region).


from protobuf field: uint32 channel_num = 11;

codingRate: number

The denominator of the coding rate. ie for 4/5, the value is 5. 4/8 the value is 8.


from protobuf field: uint32 coding_rate = 5;

frequencyOffset: number

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.


from protobuf field: float frequency_offset = 6;

hopLimit: number

Maximum number of hops. This can't be greater than 7. Default of 3


from protobuf field: uint32 hop_limit = 8;

ignoreIncoming: number[]

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 ignore_incoming will have packets they send droped on receive (by router.cpp)


from protobuf field: repeated uint32 ignore_incoming = 103;

Either modem_config or bandwidth/spreading/coding will be specified - NOT BOTH. As a heuristic: If bandwidth is specified, do not use modem_config. Because protobufs take ZERO space when the value is zero this works out nicely. This value is replaced by bandwidth/spread_factor/coding_rate. If you'd like to experiment with other options add them to MeshRadio.cpp in the device code.


from protobuf field: Config.LoRaConfig.ModemPreset modem_preset = 2;

The region code for the radio (US, CN, EU433, etc...)


from protobuf field: Config.LoRaConfig.RegionCode region = 7;

spreadFactor: number

A number from 7 to 12. Indicates number of chirps per symbol as 1<<spread_factor.


from protobuf field: uint32 spread_factor = 4;

txEnabled: boolean

Disable TX from the LoRa radio. Useful for hot-swapping antennas and other tests. Defaults to false


from protobuf field: bool tx_enabled = 9;

txPower: number

If zero then, use default max legal continuous power (ie. something that won't burn out the radio hardware) In most cases you should use zero here. Units are in dBm.


from protobuf field: int32 tx_power = 10;

usePreset: boolean

When enabled, the modem_preset fields will be adheared to, else the bandwidth/spread_factor/coding_rate will be taked from their respective manually defined fields


from protobuf field: bool use_preset = 1;

Generated using TypeDoc