main.cpp: fixed the “only sends once” bug by replacing last_tx_second with a UTC minute key, so Bob/CY/DAN can send once per active peer every minute at their scheduled second.
TBeamSupremeLoRaInterface.cpp: added RSSI/SNR to receive-side PHY logging, including accepted frames, malformed frames, and simulated PHY drops.
main.cpp: added RSSI/SNR to RX ANNOUNCE and inbound RX LINK establishment logs.
README.md: added updated RSSI/SNR examples and a table for RNSLINKREQ, RNSPROOF_DELAY, RNSPROOF, RNSLRRTT, RNSLINKRX, and RNSDEC.

2026-06-03 20:04:54 -07:00

5.1 KiB

Raw Blame History

Introduction

Exercise 205 builds on Exercise 204 established identities and LoRa Link traffic. It keeps the same identity, announce, RTC/GPS, OLED, and machine-parseable TX/RX event style, but changes the link policy for longer multi-unit field runs.

All seven units, AMY through GUY, are supported. Every unit runs in transport mode and every unit attempts to open a Link to any other unit that announces.

Behavior

The announce protocol is intentionally the same as the last Exercise 204 protocol:

startup announce: immediate
second announce:  ANNOUNCEMENT_2 seconds after startup, default 300
repeat announce:  ANNOUNCEMENT_REPEAT seconds after that, default 3600

There is no simulated BOB/CY physical block in this exercise. SIM_PHY_ENVELOPE remains enabled so log records can report the physical sender slot, but SIM_PHY_BLOCK_BOB_CY=0 for every environment.

Exercise 205 does not intentionally tear down Links after a message count. A Link is reused while it remains active. The app-level stale threshold is 12 hours. If a Link becomes stale or closes, the unit clears local state and attempts to recreate the outbound Link.

Each unit sends one Link message per active peer per minute at its allocated second:

AMY: 04  BOB: 08  CY: 12  DAN: 16
ED:  20  FLO: 24  GUY: 28

The message payload uses board IDs and includes an iteration counter:

BOB says Hi to CY iter=0

The outbound Link retry budget is:

retry interval: 60 seconds
failure window: 3 minutes
max attempts:   3

After three failed attempts within the window, the peer is marked failed and no more Link requests are sent to that peer until another announce for that peer is received. A fresh announce resets the retry budget and starts over.

Clock Gate

The unit checks the RTC and /ex205/clock.txt on the SD card. If the saved discipline marker is less than 24 hours old according to the RTC, LoRa/microReticulum starts immediately. If not, the OLED shows Take outside and serial prints gps_gate ... until GPS UTC/fix is available.

Log Events

Substantive events retain the Exercise 204 style so multi-unit log parsing can correlate TX and RX:

TX ANNOUNCE: Bob
RX PHY: phy=2 len=... RSSI=-73.5 SNR=9.2 frames=...
RX ANNOUNCE: label=Cy hash=<destination hash> phy=Cy(2) RSSI=-73.5 SNR=9.2
TX LINKREQUEST: opening link to Cy slot=19 attempt=1/3
LINK ACTIVE: initiator link established to Cy hash=<link hash>
RX LINK: inbound link established hash=<link hash> phy=Bob(1) RSSI=-74.0 SNR=8.8
TX LINK: BOB says Hi to CY iter=0 via=outbound hash=<link hash> status=2
RX LINK: CY says Hi to BOB iter=0 | phy=Cy(2) RSSI=... SNR=...
LINK RETRY: no establishment after 60000 ms; retrying Cy attempts=1/3
LINK FAILED: peer=Cy attempts=3 window_ms=... waiting_for_announce=1
LINK RETRY RESET: fresh announce from Cy

RX PHY is emitted once per accepted LoRa frame before Reticulum decrypts or routes it. It is the broadest signal-strength record and includes frames that become announces, link setup packets, encrypted Link payloads, keepalives, or proofs. RX PHY BAD and SIM PHY DROP also include RSSI/SNR when malformed or intentionally blocked frames are seen.

The following RNS... prefixes are generated by the linked microReticulum tree when Arduino link instrumentation is enabled:

Prefix	Source	Meaning
`RNSLINKREQ`	`microReticulum/src/Link.cpp`	Incoming Link request validation accepted; shows the new link ID, owner destination, hops, status, initiator flag, interface, and whether the app has a link-established callback.
`RNSPROOF_DELAY`	`microReticulum/src/Link.cpp`	Link proof send path is applying the configured proof delay before transmitting the proof packet.
`RNSPROOF`	`microReticulum/src/Link.cpp` and transport proof probes	Link proof validation and proof forwarding diagnostics, including signature validity, state transitions, interface checks, and exceptions.
`RNSLRRTT`	`microReticulum/src/Link.cpp`	Link request round-trip-time packet handling. This is part of Link establishment and marks decrypt, active, and owner callback events.
`RNSLINKRX`	`microReticulum/src/Link.cpp`	Link-associated packet receive path. It logs packet context, decrypt success, app packet callback entry/return, no-callback cases, and LRRTT dispatch.
`RNSDEC`	`microReticulum/src/Link.cpp`	Link encryption/decryption token diagnostics, including encrypt attempts, decrypt attempts, and decrypt failure class.

Reticulum library logging is set to warning level in this exercise. Heap, path-store, entries, and byte-count diagnostics are intentionally suppressed so serial logs remain focused on field-test results.

Build, Upload, And Monitor

source /home/jlpoole/rnsenv/bin/activate
cd /usr/local/src/microreticulum/microReticulumTbeam

pio run -d exercises/205_sustained_link -e amy -e bob -e cy -e dan -e ed -e flo -e guy

for env in amy bob cy dan ed flo guy
do
  pio run -d exercises/205_sustained_link -e "${env}" -t upload
done

Monitor one unit:

pio device monitor -d exercises/205_sustained_link -e bob

5.1 KiB Raw Blame History