SPEEDBIRD

SPEEDBIRD Protocol (SBP) — on-air specification, version 2 (draft)#

Status: draft for publication. SBP is an amateur-radio data emission. Under 47 CFR 97.309(a)(4) the technical characteristics of a data code not listed in 97.309(a) must be publicly documented; this file is the seed of that document. Nothing in SBP is encrypted or intended to obscure meaning (97.113(a)(4)); every transmission carries the sender's callsign in a published, unencrypted format (97.119). Reference implementation: speedbird.sbp. Version 2 is not compatible with version 1.

Conventions: bit sequences are MSB-first; integers big-endian; "PRBS(seed)" is the PRBS-15 generator of §2.1. SNR figures are referenced to a 2500 Hz noise bandwidth.

0. Overview#

An SBP session uses three waveform families:

The speed ladder (§6) runs SBP-FST4-120, SBP-FST4-60, SBP-FT8, SBP-FT4, then the OFDM levels. Sessions start with a CALL (falling back to FT4, then FT8, when unanswered). They then go straight to the level the start-up SNR (and the per-peer memory) supports, and keep jumping directly to the level the measured SNR supports. Losses walk them down as far as SBP-FT8 (the SBP-FST4 tiers are reached by measured SNR, by operator choice, or as an emergency option).

1. OFDM profiles#

All profiles are generated at 48 000 samples/s, real audio, for an SSB (USB) or FM voice channel. Carrier k has audio frequency k·fs/N.

profile id N CP carriers audio band spacing symbol data carriers header symbols
HF 0 1024 256 7..63 328–2953 Hz 46.875 Hz 26.667 ms 46 5
VHF-FM 1 1024 128 7..58 328–2719 Hz 46.875 Hz 24.0 ms 42 6
UHF-FM 2 512 16 4..79 375–7406 Hz 93.75 Hz 11.0 ms 62 4

Receiver centre ("mixing") bins: HF 36, VHF-FM 32, UHF-FM 42. These must be even (§1.3).

1.1 Pilots (scattered)#

Symbols after the training symbols are numbered s = 0, 1, … (header, then data). P(s) = {low, high} ∪ {low + (s mod 2)·step/2 + step·j ≤ high}, with step 6 (HF: 11 pilots per symbol). Pilot values are BPSK from PRBS(0x2E4F), symbol s using bits s·|P| … s·|P|+|P|−1 in increasing frequency. All other carriers are data carriers, unless switched off by the carrier mask (§3.2).

1.2 Constellations (unit average power, Gray)#

BPSK 0→+1, 1→−1. QPSK ((1−2b0)+j(1−2b1))/√2. 8PSK position k (angle kπ/4) carries label k XOR (k>>1). 16QAM I from b0b1, Q from b2b3, 00→−3, 01→−1, 11→+1, 10→+3, /√10.

1.3 Burst structure#

PRE: A ×16, −A, ID blocks ×8 | TRAIN | TRAIN | [HDR ×H] | DATA ×S

HF durations: preamble 25 × 10.67 ms = 267 ms; a normal burst lasts 267 ms + (2 + 5 + S) × 26.67 ms + 2.5 ms.

2. Sequences and small codes#

3. PHY header (normal bursts)#

3.1 Fields#

32 information bits followed by a CRC-16 of those 4 bytes:

bits field
31..30 version = 2
29..27 profile id
26..24 modulation: 0 BPSK, 1 QPSK, 2 8PSK, 3 16QAM
23..22 code rate: 0 = 1/2 (L12), 1 = 2/3 (L23), 2 = 3/4 (L34)
21 short-first (codeword 0 is the S12 burst-header block)
20..13 number of long codewords
12..5 carrier mask (§3.2)
4..0 0

The 48 bits are convolutionally encoded (216 bits), zero-padded to H·D slots (D = data carriers per symbol) and XORed with PRBS(0x3F5A). Bit i is placed at p = (67·i) mod (H·D): header symbol p mod H, data carrier p div H.

3.2 Carrier mask#

The used carriers are divided into 8 equal subbands (subband of carrier u = ⌊8u / n_used⌋). Bit j set switches off the data carriers of subband j for the data symbols of a normal burst. Pilots, TRAIN and header are unaffected. Each data symbol uses the first D′ active data carriers, where D′ = min over both pilot parities. The receiver requests a mask in its burst header (§5.1) when part of the band is jammed.

4. Data symbols#

4.1 Blocks and LDPC codes#

Block information field: long blocks are 128 bytes = [len][payload ≤ 125] [CRC-16 over len+payload][zero pad]; short blocks are 64 bytes (payload ≤ 61). The codes are regular dv = 3 Gallager codes:

code n dc info bits used seed
S12 1032 6 512 0x5B0001
L12 2052 6 1024 0x5B0002
L23 1539 9 1024 0x5B0003
L34 1368 12 1024 0x5B0004

4.2 Repetition, scrambling, interleaving#

Codewords are concatenated (short first), repeated rep times (1 for normal bursts, 2 or 4 for ROBUST), zero-padded to S·B bits (B = D′·bits per symbol) and XORed with PRBS(0x4B6C). Stream bit i goes to data symbol s = i mod S at slot j = ((i div S) + 37·s) mod B; slot j is bit (j mod m) of the label on active data carrier (j div m). ROBUST bursts are always BPSK, rate 1/2, short block + ≤ 3 long blocks, no mask.

4.3 Receiver processing (informative)#

byte field
0 version 2 (high nibble), type (low nibble): 0 UI, 3 DATA, 4 DISC, 5 DISC_ACK
1 flags: 0x01 POLL, 0x02 MORE, 0x04 ACKV
2..11 source callsign, ASCII, space padded
12..21 destination callsign (or CQ/QST/ALL), ASCII
22 session id (1..63)
23..24 ack_next: all data seq < ack_next received
25..32 ack bitmap: bit (63−i) ⇒ seq ack_next+1+i received
33 SNR measured on the addressee's last burst (int8, 0.5 dB units, −128 none)
34 speed level the sender asks the addressee to use (§6)
35 burst counter
36 carrier-mask request (§3.2)
37.. type-specific body (UI: total length u16, CRC-32 u32)

5.2 Data blocks#

[session id][seq u16][payload ≤ 122 B], selective repeat with window 64.

5.3 Stream records#

[0xB7][kind: 1 msg, 2 file, 3 bond][transfer id u16][flags: bit0 zlib][name len][name] [original len u32][wire len u32][CRC-32][wire bytes]. zlib (RFC 1950) is used only when it saves at least ~10 %.

6. Speed ladder and SNR-driven level selection#

Ladder order (most robust first). The code is the level number on the air (4 bits in CONNECT/ACCEPT/REJECT/HDR, byte 34 of the OFDM burst header); codes 9 and 10 were added after codes 0–8, so ladder order ≠ code order. Stations without the CALL extension know codes 0–8 only (§12.5).

code waveform threshold (est. SNR) approx. user rate
10 SBP-FST4-120 (HDR + 1 DATA frame/burst) −27 dB ~0.2 bit/s
9 SBP-FST4-60 (HDR + 1 DATA frame/burst) −24 dB ~0.4 bit/s
0 SBP-FT8 (HDR + 1 DATA frame/burst) −17 dB ~4 bit/s
1 SBP-FT4 (HDR + 3 DATA frames/burst) −14 dB ~7 bit/s
2 OFDM ROBUST-4 (BPSK, rate 1/8) 0 dB ~0.15 kbit/s
3 OFDM ROBUST-2 (BPSK, rate 1/4) 2 dB ~0.3 kbit/s
4 OFDM BPSK 1/2 4 dB ~0.8 kbit/s
5 OFDM QPSK 1/2 8 dB ~1.6 kbit/s
6 OFDM 8PSK 2/3 12 dB ~3.3 kbit/s
7 OFDM 16QAM 2/3 14 dB ~4.4 kbit/s
8 OFDM 16QAM 3/4 18 dB ~4.9 kbit/s (≈2.7 kbit/s net incl. ARQ)

6.1 Calibration#

Threshold = the receiver's estimated effective SNR (capacity-equivalent over the carriers in use, 2500 Hz reference, burst by burst) above which a burst decodes ≥ 90 % of its blocks on ITU-R F.1487 "moderate" (2 paths, 1 ms, 0.5 Hz) through the 16 kHz radio path with ±20 Hz CFO and ±50 ppm clock. 140–400 bursts per level.

In true channel SNR (90 % of all blocks, including missed detections), the same points are about 6, 6, 6, 10, 14, 18 and 22 dB for levels 2–8. The estimate reads ~2 dB below the true SNR on fading channels, because it is a minimum over the burst.

6.2 Selection rules#

For each (my call, peer call, profile, band) a station keeps a small JSON record: * level: last good level (last_good, last_good_name); * SNR: received and peer-reported, each as EMA/last/min (snr_rx, snr_tx); * time: wall-clock (t); * margins: failed jumps per level (fail); * context: mask, profile, band.

It is updated during the session (at most every 10 s) and at the end.

On the next connection: * Fresh (< 15 min): start at min(remembered level, SNR start level), with the remembered per-level margins. * Stale (15 min – 6 h): one level below the remembered one, still capped by the start-up SNR. * Older: ignored.

The initiator proposes its remembered level in CONNECT (§8.1). The responder answers ACCEPT with min(proposal, its own memory/SNR start), and the initiator then also caps by the ACCEPT SNR.

6.4a Operator settings (per radio)#

6.4 Calling channel → data channel QSY#

7. Measured performance#

Simulated, through the 16 kHz radio path with ±20 Hz CFO and ±50 ppm clock unless noted. Full tables are in the implementation report.

start tier frame 50 % AWGN 50 % CCIR poor
SBP-CALL 1.79 s −12.4 dB ≈ −10 dB
SBP-FT4 5.04 s ≈ −13.5 dB —
SBP-FT8 12.64 s ≈ −18 dB —
SBP-FST4-60 56.9 s ≈ −26.2 dB ≈ −22 dB on "moderate"; not "poor" (§12.4)
SBP-FST4-120 113.8 s ≈ −28.5 dB n/a
* OFDM levels: decode at their thresholds on ITU-R F.1487 "moderate"
and "poor".
* Interference: ROBUST and masked levels decode through a continuous
OFDM-like interferer at +40 dB over 800–2200 Hz.

8. SBP-FT frames#

FT8/FT4-style 8-GFSK / 4-GFSK frames built from the FT8/FT4 protocol components (LDPC(174,91), GFSK shaping, symbol and Gray mappings), with SBP's own constants so that no SBP-FT frame is ever decoded as FT8/FT4 by WSJT-X (verified with jt9 -8 / jt9 -5):

tier tones baud symbols frame sync arrays at
SBP-FT8 8 6.25 79 12.64 s 0, 36, 72: Costas (0,1,6,3,5,4,2)
SBP-FT4 4 20.83 105 (incl. 2 ramp) 5.04 s 1, 34, 67, 100: (0,2,3,1) (1,3,2,0) (2,0,1,3) (3,1,0,2)

8.1 77-bit payloads#

type (3 bits) layout
0 CONNECT, 1 ACCEPT, 2 REJECT, 6 DISC, 7 DISC_ACK type3, src32, dst22, sid6, arg14
3 HDR, 4 HDR+POLL type3, src32, dst22, sid6, ack8, level4, nfollow2
5 DATA type3, sid6, seq8, frag5, last1, nbytes3, payload48, 0₃ (frag 30: channel offer/choice §6.4; frag 31: hop entry §10)

Every SBP-FT transmission begins with a frame carrying src (CONNECT, ACCEPT, REJECT, HDR, DISC, DISC_ACK). DATA frames only ever follow a HDR in the same transmission.

9. Bonding (multi-radio)#

A transfer can be striped across several SBP sessions on different radios/frequencies. Each chunk travels as a stream record of kind 3 (bond) with the header "SBB1" | bond id u32 | index u32 | count u32 | total length u32 | CRC-32 u32 | kind u8 | name len u8 | name, followed by the data. Chunks are reassembled by (peer base call, bond id) and verified with the CRC-32.

10. PING and TRACE#

ping(to) and trace(to, max_hops). Requests are answered automatically, with at most one reply per peer per 10 s.

11. Identification and Part 97 notes#

12. SBP-CALL start frame, ultra-weak tiers, capabilities and beacons#

12.1 SBP-CALL frame#

A CALL frame is a short, full-band burst that carries one 77-bit SBP-FT word (§8.1) with exactly the SBP-FT coding: 77 bits XOR PRBS(0x2B1D)[0:77], CRC-14 (FT8 polynomial, over the XORed bits) XOR 0x15A5, LDPC(174,91). It is derived from SBP's own OFDM numerology (§1, HF profile ×½ carrier spacing); it shares no preamble, sequence, carrier layout or symbol rate with any other HF modem, and it fails FT8/FT4 decoding like every SBP-FT frame.

|<-------- preamble 256 ms -------->|<------------ 32 data symbols, 1536 ms ------------>|
| A | A | A | A | A | A | A | A | A | A |-A |-A | CP|sym 0| CP|sym 1| ...  | CP|sym 31| post |
 21.33 ms each (no CP)                  48 ms each (5.33 ms CP + 42.67 ms)       2.5 ms
total 1.7945 s;  occupied 445–2672 Hz (≈ 2.25 kHz)

Numbers (48 000 samples/s; the receiver works at 12 000 samples/s, ÷4):

item value
carrier grid Δf = 48 000 / 2048 = 23.4375 Hz
data symbol FFT 2048 + CP 256 samples = 48 ms (20.83 symbols/s)
data/pilot carriers k = 19 … 114 (96 carriers, 445.3–2671.9 Hz)
preamble block A 1024 samples (21.33 ms) = carriers k = 20, 22, …, 114 (48) of the same grid; QPSK ((1−2b₀)+j(1−2b₁))/√2 from PRBS(0x6C41), 2 bits per carrier in increasing frequency; amplitude ×1/√2 so its mean power equals a data symbol's
preamble A ×10, then −A ×2 (12 blocks, 256 ms)
pilots data symbol s: carriers u = (3s mod 8) + 8m, m = 0…11 (u = k − 19); BPSK from PRBS(0x3A97), 12 bits per symbol
data carriers the other 84 per symbol, increasing frequency, index j = 0…83
slot map 32 × 84 = 2688 slots; slot i → symbol s = i mod 32, data carrier j = (37·⌊i/32⌋ + 11·s) mod 84
bits slot i carries codeword bit (i mod 174) XOR PRBS(0x51E3)[i], BPSK 0 → +1 (each coded bit 15–16 times, over 16 different symbols and the whole band)
ramps 2.5 ms raised cosine at both ends, cyclic postfix of 2.5 ms
PAPR clip-and-filter allowed (reference: clip at 6 dB over RMS, out-of-band removed, 2 passes; ≈ 8.2 dB after filtering)

Several CALL frames of one transmission (e.g. CONNECT + CHAN + CAPS) follow each other back to back. Frames are unslotted.

12.2 Receiver (informative)#

12.3 Measured performance (simulated)#

Through channel.simulate: SSB filter, CFO uniform ±15 Hz, clock 20 ppm, clip-and-filter at 6 dB, SNR referenced to the mean power of the clipped burst in 2500 Hz. Frame decode rates:

SNR (dB) AWGN ITU-R F.1487 moderate CCIR/ITU poor (2 ms, 1 Hz)
−4 98 %
−6 100 % 96 %
−8 100 % 96 %
−10 70 % 56 %
−11 92 %
−12 62 %
−13 28 %
−14 0 %

50 % points: AWGN −12.4 dB, moderate ≈ −10.6 dB, poor ≈ −10 dB. Detection alone succeeds in > 90 % of frames at −12 dB (the LDPC limit with ideal channel knowledge is ≈ −13.2 dB). On noise: 0 false decodes in 6000 windows (≈ 50 min); ≈ 9.5 % of windows yield a detection candidate that the LDPC/CRC then rejects. CPU (one numpy thread, 16 kHz input incl. resampling): SBP-CALL 2.2 % of one core, against SBP-FT4 2.8 %, SBP-FT8 2.5 %; SBP-FST4-60 ≈ 1.0 %, SBP-FST4-120 ≈ 0.8–1.5 % (only searched while enabled and idle/in an ultra-weak session), SBP-FST4W 0.23 %. The receive buffer is a 9.3 MB ring (≈ 145 s at 16 kHz) per input rate.

12.4 Ultra-weak tiers SBP-FST4-60 / SBP-FST4-120#

SBP-FT family members (§8) with one copy only (no frequency diversity), tone 0 at 1500 Hz, 8-GFSK (BT 2), 79 symbols, sync array (3,4,1,0,6,2,5) at symbols 0, 36, 72, Gray map and data layout as SBP-FT8:

tier nsps @12 kHz baud spacing frame 50 % AWGN ~90 % receiver hop
SBP-FST4-60 8640 1.389 1.389 Hz 56.88 s −26.2 dB −24 dB 15 s
SBP-FST4-120 17280 0.694 0.694 Hz 113.76 s −28.5 dB −27 dB 30 s

AWGN with ±3 Hz CFO and 20 ppm clock. The limit is non-coherent 8-FSK with LDPC(174,91): with ideal sync the decode rate is the same, so the targets of −27/−28 dB (60 s) and −30/−31 dB (120 s) would need coherent multi-symbol detection or a lower-rate code (not done). On ITU-R F.1487 "moderate" (0.5 Hz Doppler) SBP-FST4-60 still decodes 8/8 frames at −20 dB and 0/8 at −24 dB (50 % ≈ −22 dB); like FST4, the tiers do not survive Doppler spreads comparable to their tone spacing ("poor", 1 Hz; FST4-120 with 0.69 Hz tones is for quiet paths). Decode rates (AWGN): FST4-60 −24 dB 16/16, −26 dB 9/16, −27 dB 0/16; FST4-120 −27 dB 12/12, −29 dB 4/12, −30 dB 1/12. They carry the same frame types as SBP-FT8 (HDR + 1 DATA per burst); ARQ waits and the floor/re-acquire timers scale with the frame length. jt9 -7 (FST4) and -W (FST4W) do not decode them.

12.5 Capabilities (CAPS) and tier announcement (TIER) frames#

Both are SBP-FT DATA words with seq = 255 — outside every ARQ window, so a station without this extension ignores them — sent after a callsign frame:

12.6 Beacons#

A beacon is a CONNECT-layout word with purpose 4 (arg = 4 << 1); the 22-bit dst field carries grid15 (FT8 4-character grid packing, ≥ 32400 = none) and power7 (dBm, 127 = unknown), sid = 6 bits of beacon info. It can be sent as SBP-CALL, SBP-FT8 or SBP-FST4W-120 (beacon-only tier: as SBP-FST4-120 but sync array (4,5,2,1,3,6,0), UTC-slotted: the frame starts 1 s after an even UTC minute and ends 114.8 s into the slot; receivers search once per slot). A beacon never creates a session. SBP-FST4W-120 decodes 8/8 at −27 dB, 3/8 at −29 dB, 0/8 at −30 dB (AWGN; 50 % ≈ −28.7 dB).

12.7 Mesh HELLO#

SBP mesh HELLO/LSA beacons stay OFDM UI broadcasts (BPSK ½, typically 1–2 s): their neighbour lists do not fit a 77-bit word, and at the SNRs where a mesh neighbour is useful (≥ 0 dB) the OFDM UI burst is as short as a CALL. The compact §12.6 beacon (call, grid, power) is available for presence only.

Source: speedbird-linux/speedbird-sbp-spec.md