docs: dev-board requirements from experience

This commit is contained in:
Lars Nolden
2026-09-01 11:21:23 +02:00
parent 70762362a4
commit ac0a75a546
+35
View File
@@ -28,3 +28,38 @@ pin list: devboard_signals.csv.
- RF test connector (u.FL tap or directional coupler) for conducted - RF test connector (u.FL tap or directional coupler) for conducted
measurements instead of over-the-air-only verification. measurements instead of over-the-air-only verification.
- ESP32 BOOT/RESET buttons brought to a header for automated strapping. - ESP32 BOOT/RESET buttons brought to a header for automated strapping.
## Added after the RF experiment
Signals and facilities that specifically proved their worth (or whose
absence cost time) during this bring-up:
- **SX1262 sync-word register readback as a health probe.** The single most
valuable diagnostic added: a radio that lost its configuration still
reports a plausible chip mode while being deaf. On the dev board, keep
SPI accessible so this can also be verified externally with a logic
analyzer.
"I needed this because a silently unconfigured radio is indistinguishable
from a quiet RF environment."
- **A second, independent RF observer that is not a cheap USB dongle.** The
RTL-SDR drifted ~17 dB, died mid-stream without exiting, and eventually
de-enumerated. Most of the debugging time in this experiment went into
distinguishing observer faults from DUT faults. The instrumented dev
board should include either an on-board receive path that can be
cross-checked, or a documented conducted-measurement port.
- **RF test/attenuation port (u.FL tap or directional coupler).** Our
transmission reached the observer up to ~36 dB stronger than real meter
traffic and drove it into compression, which cannot be fixed in software.
A conducted tap with a fixed attenuator would have removed an entire
class of ambiguity.
"I needed this because over-the-air-only verification conflates
transmitter behaviour with receiver overload."
- **Radio power-rail current sense.** Would have answered "is the PA
actually active?" immediately instead of inferring it from decodes.
- **Always-on log UART independent of native USB.** The ESP32-S3 USB
identity changes between the application and the ROM bootloader, and the
early-boot window is invisible; a dedicated UART would have shown the
first `radio_init` result without a reboot-and-capture dance.
- **FEM CSD brought out to a header.** It doubles as the board-revision
detect (pull level) and is the single control that decides whether the
receiver has ~41 dB of front-end gain or not.