64 lines
2.8 KiB
Markdown
64 lines
2.8 KiB
Markdown
# Timing Instrumentation
|
|
|
|
All values measured on the DUT with `esp_timer_get_time()` (monotonic
|
|
microseconds), from `captures/2026-09-01T10-34-24-hil` (1200 s run, 72
|
|
repeats, 214 RX candidates, repeat delay set to 200 ms).
|
|
|
|
## Measured
|
|
|
|
| Quantity | min | median | max | n |
|
|
|---|---|---|---|---|
|
|
| RxDone -> reconstructed end of frame ("deaf tail") | 9 360 us | 12 240 us | 17 120 us | 214 |
|
|
| TX airtime (SetTx to TxDone) | 10 421 us | 13 422 us | 14 560 us | 72 |
|
|
| Programmed repeat delay (frame end -> TX start) | 200 001 us | 200 001 us | 200 008 us | 72 |
|
|
| Repeated frame length (over-the-air bytes) | 63 | 100 | 113 | 72 |
|
|
|
|
Independent confirmation from the SDR side (raw IQ, same run): observed
|
|
burst duration differs from the computed airtime by 0.2-1.5 ms
|
|
(median 1.2 ms), and firmware TX events align to observed RF within
|
|
0-3.1 ms (median 2.4 ms).
|
|
|
|
## Derived
|
|
|
|
```
|
|
repeat delay accuracy : +1 us to +8 us against a 200 ms setting
|
|
(jitter well under 10 us)
|
|
RX deaf time per repeat : ~225.7 ms median
|
|
= 12.2 ms deaf tail
|
|
+ 200.0 ms programmed delay
|
|
+ 13.4 ms TX airtime
|
|
```
|
|
|
|
The programmed delay dominates by design; it exists to make SDR
|
|
correlation possible during development.
|
|
|
|
## The 12 ms deaf tail
|
|
|
|
The SX1262's GFSK packet engine cannot express Wireless M-Bus length
|
|
semantics (format A carries per-block CRCs that the L-field excludes), so
|
|
RX uses a fixed 255-byte capture and the firmware truncates in software
|
|
using the L-field formulas. Consequences:
|
|
|
|
- RxDone fires `(255 - frame_bytes) * 80 us` after the frame really ended;
|
|
the firmware subtracts this to recover the true end-of-frame timestamp,
|
|
which is what the repeat delay is measured from.
|
|
- During that tail the receiver is not re-armed for sync search, costing
|
|
9.4-17.1 ms of receive availability per detected frame -- including for
|
|
false syncs from the deliberately short 8-bit preamble detector.
|
|
|
|
Optimisation candidate (not implemented): poll `GetRxBufferStatus` after
|
|
`SyncWordValid`, read the L-field as soon as it lands, then stop RX early
|
|
once the computed frame length has been received. That would cut the tail
|
|
to roughly the frame's own airtime and materially raise the duty cycle of
|
|
a production repeater.
|
|
|
|
## Relevance to the production gateway
|
|
|
|
- A production repeater using randomized 5-25 s delays will have a very
|
|
different deaf-time profile; the 200 ms figure here is a development
|
|
artefact, not a design target (see docs/STANDARDS_GAPS.md).
|
|
- The fixed-255 tail is an SX1262 packet-engine limitation, so it applies
|
|
to any SX126x-based design. Budget for it, or implement early-stop RX.
|
|
- Repeat-delay accuracy of a few microseconds shows the ESP32-S3 side has
|
|
ample timing margin; timing precision will not be the constraint.
|