Skip to content

Configuration Reference

All firmware configuration lives in firmware/node/include/config.h. This page provides a complete reference for every setting.

ConstantValueDescription
NODE_RECEIVER0Listens for all packets, forwards to USB serial. Never relays.
NODE_TEMPERATURE1Reads TMP102, transmits reports, relays other nodes’ packets.
NODE_PRESSURE2Reads BMP280, transmits reports, relays other nodes’ packets.

Set the active node type with:

#define NODE_TYPE NODE_RECEIVER

All nodes in a network must use identical radio settings.

ConstantDefaultTypeDescription
LORA_FREQUENCY902.25floatCenter frequency in MHz. 902.25 for US, 868.0 for EU.
LORA_BANDWIDTH500.0floatBandwidth in kHz. Options: 7.8, 10.4, 15.6, 20.8, 31.25, 41.7, 62.5, 125.0, 250.0, 500.0.
LORA_SPREADING_FACTOR7intSpreading factor. Range: 7-12. Higher = longer range, slower.
LORA_CODING_RATE5intDenominator of the coding rate fraction (4/x). Range: 5-8. Higher = more error correction.
LORA_SYNC_WORD0x34hexNetwork identifier. Only nodes with matching sync words communicate.
LORA_TX_POWER21intTransmit power in dBm. Range: -9 to 22 for SX1262.
ConstantDefaultUnitDescription
REPORT_INTERVAL_MS5000msInterval between sensor readings and transmissions.
PEER_TIMEOUT_MS15000msReceiver marks a node as offline after this duration of silence.
PEER_PRUNE_INTERVAL_MS5000msHow often the receiver scans for stale peers.
DISPLAY_UPDATE_MS1000msOLED display refresh interval.
ConstantDefaultDescription
MESH_MAX_HOPS3Maximum relay hops before a packet is dropped (TTL).
MESH_SEEN_TABLE_SIZE32Ring buffer size for deduplication. Oldest entries are overwritten.
MESH_RELAY_JITTER_MS200Maximum random delay (ms) before relaying to prevent collisions.
ConstantDefaultDescription
TMP102_ADDRESS0x48I2C address of the TMP102 sensor. Change to 0x49 if ADD0 is tied to VCC.
BMP280_ADDRESS0x76I2C address of the BMP280 sensor. Change to 0x77 if SDO is tied to VCC.

See the Pin Map page for the complete pin assignment table. These should not need to be changed unless you are using a different board.