Micron Document
gornodeconf — RNode Hardware & Firmware Manager

T383838gornodeconf is the complete Go utility for inspecting, configuring, provisioning, backing up, and flashing LoRa RNode hardware over USB serial connections.


Supported Platforms

T383838gornodeconf live serial workflows are supported on:
Linux (e.g. T383838/dev/ttyUSB0, T383838/dev/ttyACM0)
macOS / Darwin (e.g. T383838/dev/cu.usbserial-*, T383838/dev/cu.usbmodem*)
FreeBSD (e.g. T383838/dev/cuaU0)

(Note: Windows is intentionally unsupported for direct serial hardware workflows due to driver variations).


Common Workflow

1. Inspect Device

Check the connected RNode's current EEPROM status, product code, model, and firmware hash:

T282828
gornodeconf -i /dev/ttyUSB0
gornodeconf --public /dev/ttyUSB0
gornodeconf --get-firmware-hash /dev/ttyUSB0

2. Generate Local Signing Material

Before bootstrapping or signing firmware on fresh devices, generate local signing keys:

T282828
gornodeconf --key
gornodeconf --public

This creates T383838signing.key and T383838device.key under T383838~/.config/rnodeconf/firmware/.

3. Back Up Device EEPROM

Always take an EEPROM backup before making modifications:

T282828
gornodeconf --eeprom-backup /dev/ttyUSB0
gornodeconf --eeprom-dump /dev/ttyUSB0

Timestamped EEPROM binaries are saved under T383838~/.config/rnodeconf/eeprom/.

4. Bootstrap Fresh Hardware

To provision a newly assembled board or unconfigured ESP32/SX1262 LoRa module:

T282828
gornodeconf --rom --product 03 --model a4 --hwrev 5 /dev/ttyUSB0

This writes the cryptographic EEPROM signature and assigns a hardware serial number.

5. Flash Firmware

To flash the official RNode firmware image:

T282828
gornodeconf --flash /dev/ttyUSB0

To update firmware on an existing provisioned device:

T282828
gornodeconf --update /dev/ttyUSB0


Device Recovery

If a device is corrupted or locked:

T282828
# Unlock a write-protected ROM
gornodeconf --unlock-rom /dev/ttyUSB0

# Wipe EEPROM back to factory state
gornodeconf --eeprom-wipe /dev/ttyUSB0

Last updated: 1789516822

This page's visits
c7d0e7bbd883e595f53e14fa6986188c:/page/hit-counter.wasmage=docs/tools/gornodeconf.mu}
Total page views
c7d0e7bbd883e595f53e14fa6986188c:/page/hit-counter.wasm}