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:
- SBP-CALL (§12): a 1.79 s, 2.25 kHz wide BPSK-OFDM burst with a fast repeated-block preamble that carries one 77-bit SBP-FT control word. It is the default start frame (CONNECT/ACCEPT/REJECT/PING/…): quick connects instead of multi-second FT-style frames.
- SBP-FT (§8): FT8/FT4-style GFSK frames with SBP's own sync arrays, scrambling and CRC variant. Used as the weak-signal start-up fallbacks and as speed levels (payload in 6-byte fragments). The ultra-weak SBP-FST4-60/-120 tiers (§12.4) and the SBP-FST4W-120 beacon (§12.6) are long single-copy members of this family.
- SBP-OFDM (§1–4): OFDM bursts with LDPC codes, from a rate-1/8 repetition mode to 16QAM rate 3/4.
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
- A: a periodic block of N/2 samples (HF: 512 = 10.67 ms) carrying QPSK from PRBS(0x5100) on the even carriers of the band, with amplitude √(n_used / (4·n_even)) so that its mean power equals that of the OFDM symbols. 16 repetitions give a long, CFO-tolerant (±47 Hz) autocorrelation preamble. The −A block marks timing.
- ID blocks: 8 blocks of ±A carrying the burst type as a codeword of the (8,4) first-order Reed–Muller code. Codeword m, bit j = m0 ⊕ (m1∧j0) ⊕ (m2∧j1) ⊕ (m3∧j2), with bit 1 sent as −A. id 0 = normal burst (with header); id 1..8 = ROBUST burst: rep = 4 if id ≥ 5 else 2, n_long = (id−1) mod 4.
- TRAIN ×2: identical full symbols (with CP), QPSK from PRBS(0x0A5B) on every carrier. Used for the channel, per-carrier noise and fine timing.
- HDR (normal bursts only, H = ⌈216 / data carriers⌉ symbols): §3.
- DATA: §4.
- The first and last 2.5 ms are raised-cosine ramps; the burst ends with a 2.5 ms cyclic postfix. The transmitter normalises the peak level; optional clip-and-filter PAPR reduction is allowed.
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#
- PRBS-15: state s = seed; each step b = ((s>>14)⊕(s>>13))∧1; s = ((s<<1)|b)∧0x7FFF; output b.
- CRC-16: CCITT-FALSE (poly 0x1021, init 0xFFFF); check value 0x29B1.
- xorshift32 permutation: p = [0..n−1]; x = seed; for i = n−1…1: x ^= x<<13; x ^= x>>17; x ^= x<<5 (mod 2³²); swap p[i], p[x mod (i+1)].
- Header code: K = 7, rate 1/4 convolutional code, generators 0o171, 0o133, 0o165, 0o117. Register r = (bit<<6)|state; outputs are parity(r ∧ g); 6 zero tail bits.
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 |
- Parity-check matrix: band 0 row r has ones at columns r·dc…r·dc+dc−1. Band t ∈ {1, 2} row r has ones at π_t[r·dc…], where π_t = xorshift32(n, seed+t).
- Encoding: systematic with respect to the reduced row-echelon form of H (left-to-right scan). Information bits go in the first non-pivot columns; the remaining non-pivot columns are 0.
- Validity: a block is accepted only if H·c = 0 and the CRC matches.
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)#
- Noise floor: a minimum-statistics noise + interference floor per carrier (Hann-windowed, ~8 s).
- Whitening: a whitening/notch FIR derived from that floor, changed only between bursts.
- Detection: an inverse-floor-weighted frequency-domain autocorrelation over the 16 A blocks, minus a slow mean so that stationary tones cancel.
- Validation: the preamble must look like a smooth channel and spread over many carriers.
- Timing and ID: timing from the −A flip; ID by soft RM decoding against the averaged A blocks; fine timing from the TRAIN delay profile.
- LLRs: per-carrier noise variances, so jammed carriers act as erasures.
5. OFDM link frames#
5.1 Burst header (short block of every OFDM link burst)#
| 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#
- Effective SNR: 2^mean(log₂(1+SINR_k)) − 1 over the carriers in use (those left by the requested mask, for maskable levels).
- Run-time margin:
snr_margin_db(default 2 dB). - Start-up margin:
startup_margin_db(default 3 dB), applied to the SBP-FT-measured SNR. -
Learned margin: +1 dB per failed jump to that level (
jump_margin_db), decaying 1 dB per 180 s. -
Start: both stations start at the highest enabled level whose threshold + start-up margin fits min(SNR of the CONNECT as measured by the responder, SNR of the ACCEPT as measured by the initiator). This is never below ROBUST-4 unless that SNR is ≥ 6 dB under ROBUST-4's threshold, and never below the SBP-FT/FST tier the CONNECT arrived in (it got through). A CALL's SNR is measured in-band and needs no interference correction. Peer memory (§6.3) can lower it further, never raise it.
- Enabled levels: every station has a set of enabled levels (§6.4a). "The highest level that fits" always means the highest enabled one; when none fits, the most robust enabled level. A session uses the intersection of both stations' sets once the peer's CAPS frame (§12.5) is known; until then (and always with a station without the CALL extension) the peer is assumed to know codes 0–8.
- Receiver (each burst):
- estimate = min(effective SNR of the last 2 bursts);
- target = the highest enabled level whose threshold + run-time margin + learned margin fits the estimate (never an SBP-FT tier unless the estimate is ≥ 6 dB under ROBUST-4's threshold; an SBP-FST4 tier only when the estimate was measured on a GFSK frame, i.e. the peer is in an FT/FST tier);
- hysteresis and dwell (GFSK tiers): climbing out of an SBP-FT/FST tier
needs
hysteresis_db(2 dB) more and at leastdwell_bursts(2) bursts at it, so a link does not flap between e.g. SBP-FT8 and SBP-FST4-60; - the level it requests in its next ACK header (OFDM BH byte 34 or SBP-FT HDR level) is the target for a clean burst — a direct jump up or down; min(target, level − 1) on a NAK (more than 25 % of blocks lost); min(target, level) otherwise.
- Failed jump: when the first burst at a level the receiver jumped to fails (NAK at the receiver, or no answer at the sender):
- both drop back to the last good level;
- levels above it are blocked for
holdoff(15 s); - that level's learned margin is raised. This is the anti-flap mechanism.
- Losses (no answer, sender side): one level down, two after two
consecutive losses; SBP-FT4 after 3 losses at the lowest OFDM level or 40 s
with nothing heard; SBP-FT8 after 2 losses in SBP-FT4; SBP-FST4-60 after 2
losses in SBP-FT8 only with
emergency_ultra; "re-acquiring" after max(120 s, 5 burst cycles) without anything getting through at the floor; then the transfer fails after max(180 s, 6 cycles) with "link lost". Disabled levels are skipped (the next enabled one below is used). - Slower-tier announcement: before a sender drops from an SBP-FT tier into an SBP-FST4 tier on losses it sends, at the current tier, a HDR+POLL frame followed by a TIER frame (§12.5) naming the new level, so the peer is searching that tier when the first 60/120 s frame arrives.
- A peer burst carrying POLL means our last answer was lost: its level request is stale and may only lower our level, and our own level drops one step, but not below the lowest OFDM level (only losses lead into SBP-FT).
- Undecodable bursts: a burst received during a session whose header cannot be decoded only updates the carrier-mask request; its SNR is not used.
- Start-up correction: the start-up SNR is corrected for the receiver's measured in-band interference profile, because the SBP-FT copies sit at the band edges. A partly jammed band therefore starts robust, and jumps up once the mask is established.
- Receivers demodulate every tier all the time.
6.3 Per-peer link memory#
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)#
start_protocol:auto|call|ft4|ft8|fst4-60|fst4-120.- auto: from what is known about the peer (peer memory, frames heard from it
in the last hour, or an external SNR hint such as NodeDB/beacons): SNR ≥
−10 dB → CALL; −17…−10 → FT4; −21…−17 → FT8; below → SBP-FST4-60 (and
SBP-FST4-120 below −27 dB) when those levels are enabled. With no
information: CALL. On silence the CONNECT walks down CALL ×2 → FT4 ×2 →
FT8 ×2 (
call_tries= 2 per tier), then SBP-FST4-60 ×1 only withemergency_ultra. - Retries wait 0–3 s at random; the station with the lower callsign (which yields to the other's CONNECT, §6.2) also waits one CONNECT transmission longer, so two stations calling each other do not collide forever.
- Replies to an SBP-FT/FST burst are held until its announced frames are
decoded or
end + search hop + 1 shas passed; the sender's answer wait is frame + 2 × search hop + 1 s + slack (both sides search late by up to one hop: 0.5 s CALL, 1 s FT4, 2 s FT8, 15 s FST4-60, 30 s FST4-120). - call: as auto without information. ft4: FT4 ×2, then FT8 (the pre-CALL behaviour). ft8: FT8 only ("weak signal"). fst4-60 / fst4-120: that tier (FST4-60 ×2 then FST4-120).
levels(enabled set),min_level,max_level,fixed_level(pins one level, no adaptation),adapt(SNR jumps and loss step-downs on/off),use_peer_memory,emergency_ultra.- Per transfer / per probe overrides: a
levelpins the session it opens (its allowed set becomes that one level); aprotocoloverrides the start protocol. Connect strings carry them aslevel=andstart=(sbp:///K4MFC-6?freq=7105&level=QPSK12&start=ft8). - Negotiation: the CAPS frame (§12.5) carries the enabled set; both sides request only levels in the intersection. A station that did not send CAPS is a "caller wins" peer: we request only codes 0–8 from it, and if it asks us for a level we have disabled we transmit at the next lower enabled one (receivers always demodulate every level, so this never desynchronises).
6.4 Calling channel → data channel QSY#
- Channel plan: a band has one calling channel and an ordered list of data channels. Index 0 = the calling channel; index i ≥ 1 = calling frequency + offset[i−1] (HF: multiples of 3.0 kHz). The plan is identical on both ends by convention.
- CONNECT: a station with a plan sends CONNECT with purpose 3, followed in the same transmission by a CHAN frame: an SBP-FT DATA frame with frag = 30, seq = 0, and payload = up to 6 data-channel indices, least busy first.
- ACCEPT: the responder answers ACCEPT followed by a CHAN frame (frag 30, seq 1) whose first payload byte is the chosen index:
- the first offered channel that it also considers clear;
- else its own least-busy clear channel;
- else 0 (stay on calling).
- Occupancy: an EMA (0.7/0.3) of busy/clear observations from monitoring, fading over ~10 min. A channel counts as clear below 0.5.
- The QSY:
- the responder retunes as soon as its ACCEPT is on the air; the initiator retunes when it decodes the choice. If the choice frame is lost, the initiator stays on calling and the responder falls back (below);
- neither transmits for
qsy_settle_s(1.5 s) after retuning; - the session continues on the data channel at the agreed start level.
- Fallback to calling:
- if nothing from the peer is heard on the data channel within settle + tx delay + 2 × 8 s + 2 × reply slack + turnaround (≈ 23 s with defaults);
- on the first unanswered burst there (initiator);
- if the peer goes quiet there for
qsy_lost_s(45 s). - After disconnect: both stations return to the calling channel, after any final DISC_ACK has been sent on the data channel.
- What stays on calling: PING/TRACE without a session and UI broadcasts are only sent from the calling channel.
- With CALL start the CONNECT [CAPS] [CHAN] and ACCEPT [CAPS] [CHAN] frames are CALL frames, sent back to back (1.79 s each). The channel choice is always the last frame of the ACCEPT transmission (the initiator retunes on it).
- Identification: CHAN frames always follow a callsign-bearing CONNECT or ACCEPT frame in the same transmission.
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.
- SBP-FT, 50 % frame decode, AWGN: FT8-style ≈ −18 dB; FT4-style ≈ −13.5 dB; FT2 variant ≈ −10.5 dB. That is about 1.5 dB behind single-copy FT8/FT4 with the same demodulator: the price of frequency diversity.
- SBP-CALL, SBP-FST4: see §12.3 and §12.4.
| 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) |
- Bit coding: the 77 payload bits are XORed with PRBS(0x2B1D)[0:77]. The CRC-14 (FT8 polynomial, computed over the XORed bits) is XORed with 0x15A5 before LDPC(174,91) encoding.
- Frequency diversity: every frame is sent on two audio frequencies at once, tone 0 at 450 Hz and at 2550 Hz. Receivers combine the copies' LLRs.
- Unslotted: frames may start at any time. Receivers search a sliding window (frame + hop, hop 1 s for FT4 and 2 s for FT8).
- Frequencies: SBP-FT frames are sent on the SBP channel, never on FT8/FT4 calling frequencies.
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) |
- src: the sender's base callsign packed exactly like FT8's 28-bit standard callsign (c28), followed by a 4-bit SSID (0–15). This is the station identification; standard callsigns only.
- dst: the 22-bit FT8 hash (ihashcall) of "BASE/SSID".
- CONNECT arg: max level 4 | profile 2 | proposed start level 4 (0xF = none; max hops for PING/TRACE) | purpose 3 (0 connect, 1 PING, 2 TRACE, 3 connect + data-channel offer, §6.4) | weak-signal 1.
- ACCEPT arg: SNR+32 (6 bits, dB) | start level 4 | max level 4.
- REJECT arg: reason 4 (1 busy, 2 PONG, 3 TRACE-R) | SNR+32 6 bits (dB, measured on the request) | level 4.
- HDR: cumulative ack (8 bits of the block sequence), the level requested for the addressee's transmissions, and the number of DATA frames that follow in this transmission.
- DATA: fragment
fragof blockseq(6 bytes each;lastmarks the final fragment).
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.
- No session with the target (connectionless; a CALL frame, then — if no
reply — SBP-FT4 for stations without the CALL extension; FT8 with
weak-signal; or the tier the auto start protocol picks for the peer's known
SNR; or the
protocolgiven with the request): - request = a CONNECT frame with purpose 1 (PING) or 2 (TRACE), the request id in the sid field and max hops in the proposal field;
- reply (in the request's tier) = a REJECT frame with reason PONG or TRACE-R, the SNR measured on the request and the level (the request's tier level; for CALL the level that SNR supports), followed for TRACE-R by one DATA frame per hop (frag = 31, seq = hop index, last on the final hop);
- hop entry (6 bytes) = callsign as c28 + 4-bit SSID (32 bits), rx SNR int8 (dB), level u8;
- the requester sends one such probe at a time; a probe to a station while we are in a session with someone else waits for that session to end.
- Session with the target active: the request rides inside the session
as a stream record of kind 4 (ctrl):
op u8 (1 PING, 2 PONG, 3 TRACE, 4 TRACE-R) | request id u16 | max hops u8 | n hops u8 | n × (callsign 10 ASCII, snr int8, level u8). The responder appends itself to the hop list and returns the record with op PONG/TRACE-R. Records go through the session's ARQ, so neither the transfer nor the level ladder is disturbed. - Multi-hop: today there are no relays, so a trace returns one hop. A future relay appends its own hop entry and forwards, so the list grows toward the target (≤ 8 entries).
- Identification: every request and reply carries the sender's callsign (FT c28 or the OFDM BH).
11. Identification and Part 97 notes#
- Every OFDM burst carries both callsigns in ASCII (BH bytes 2–21).
- Every SBP-FT/CALL/FST transmission carries the sender's callsign in the published FT8 c28 packing (CALL and FST4 frames carry exactly the SBP-FT 77-bit words; CAPS/TIER/CHAN/DATA frames only follow a callsign frame in the same transmission; a beacon is a callsign frame).
- FEC, the fixed public PRBS scramblers and zlib are the only transformations. There is no encryption and no key material.
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)#
- Window = frame + 0.5 s hop + 0.5 s, searched every 0.5 s.
- Stage 1 (cheap, always): 21.33 ms grid blocks → FFT → per-bin whitening (median power over the window, so carriers and tones are equalised) × conj(A) → 128-point IFFT (cyclic cross-correlation, 2-sample lag resolution) → 8-block coherent Doppler FFT (32 bins, CFO range ±23 Hz). Threshold 15 (normalised, noise ≈ Exp(1)); up to 3 candidates per window.
- Stage 2 per candidate: fine CFO (±1.2 Hz search over 7 blocks), frame position from the −A pair, fine timing from the earliest path above 25 % of the strongest in the delay profile (FFT window 0.5 ms into the CP), residual CFO from the pilots, then a bank of channel estimators (static over the frame with ±10 or ±3 carrier smoothing, 6- and 3-symbol time tracking), each refined once decision-directed from extrinsic soft symbols. LLRs 4·Re(y·Ĥ*)/σ² are summed over the copies of each bit; LDPC (sum-product, 30 iterations) + CRC; the first estimator that passes wins.
- SNR (reported, and used for the start level): data-aided after decoding (re-encoded codeword as reference, 9×5 smoothed channel), mean signal over mean noise across the 96 carriers, referred to 2500 Hz, like the SBP-FT tiers' SNR.
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:
- CAPS (frag 29): payload = enabled-level mask u16 (bit c = level code c) | flags u8 (bit 0: CALL-aware, bit 1: SBP-FST4 tiers enabled) | 3 zero bytes. Sent right after the CONNECT (before any CHAN frame) when the CONNECT goes out in a CALL/FST tier or to a station known to be CALL-aware; the CONNECT then has purpose 5 (connect + CAPS) or 6 (connect + CAPS + channel offer). The responder answers with ACCEPT CAPS [CHAN]. Purpose 4 is a beacon (§12.6).
- TIER (frag 28): payload byte 0 = the level code the sender switches to.
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