Struct Wspr 

pub struct Wspr;

WSPR-2 (the standard 2-minute slot variant). WSPR-15 differs in slot length and NSPS; a separate ZST can be added later sharing everything except the few timing constants.

Trait Implementations

impl Clone for Wspr

fn clone(&self) -> Wspr

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Wspr

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Wspr

fn default() -> Wspr

Returns the “default value” for a type.

impl FrameLayout for Wspr

const T_SLOT_S: f32 = 120.0

Nominal slot length — the “2” in “WSPR-2”. Matches WSJT-X’s 120-s schedule. The actual frame transmission is ≈ 110.6 s inside this slot.

const TX_START_OFFSET_S: f32 = 1.0

Frame begins ~1 s after the slot boundary (WSJT-X convention).

const N_DATA: u32 = 162

Data symbols carrying FEC-coded payload.

const N_SYNC: u32 = 0

Sync symbols (sum of pattern.len() across SYNC_BLOCKS).

const N_SYMBOLS: u32 = 162

Total channel symbols per frame (= N_DATA + N_SYNC). Excludes any GFSK ramp-up / ramp-down symbols that are a shaping artifact.

const N_RAMP: u32 = 0

Extra symbol slots on each side of the frame reserved for amplitude ramp (FT4 has 1 each side = 2; FT8 has 0 — ramp absorbed into the first/last data symbol envelope). Applied at the transmitter.

const SYNC_MODE: SyncMode

Sync-symbol layout. Most WSJT protocols use SyncMode::Block with dedicated Costas blocks (FT8/FT4/FST4); WSPR uses SyncMode::Interleaved with a per-symbol sync bit. Callers that only support block sync should read SYNC_MODE.blocks() and treat an empty slice as “unsupported”.

const CODEWORD_INTERLEAVE: Option<&'static [u16]> = None

Optional bit interleaver: permutation table such that cw[CODEWORD_INTERLEAVE[j]] is the codeword bit transmitted at channel-bit position j. Length must equal <Self as Protocol>::Fec::N when Some.

impl ModulationParams for Wspr

const NSPS: u32 = 8192

8192 samples at 12 kHz = 0.6827 s per symbol. WSJT-X demodulates at 375 Hz after a 32× decimation (12000/32 = 375), where one symbol is 256 samples; we keep the pipeline-standard 12 kHz convention here.

const GRAY_MAP: &'static [u8]

Gray map for 4-FSK. WSPR tones map naturally (no Gray conversion in the WSJT-X reference), so this is the identity — the data bit just picks the top bit of the tone index.

const NTONES: u32 = 4

Number of FSK tones (M in M-ary FSK).

const BITS_PER_SYMBOL: u32 = 2

Information bits carried per modulated symbol (= log2(NTONES)).

const SYMBOL_DT: f32

Symbol duration in seconds (= NSPS / 12000).

const TONE_SPACING_HZ: f32

Spacing between adjacent tones, in Hz.

const GFSK_BT: f32 = 1.0

Gaussian bandwidth-time product. FT8 = 2.0, FT4 = 1.0, FST4 ≈ 1.0.

const GFSK_HMOD: f32 = 1.0

Modulation index h — the phase increment per symbol is 2π · h. FT8 and FT4 both use 1.0 (orthogonal tones at 1/T spacing).

const NFFT_PER_SYMBOL_FACTOR: u32 = 1

Per-symbol FFT size = NSPS * NFFT_PER_SYMBOL_FACTOR. FT8 = 2 (window is 2·NSPS), FT4 = 4 (window is 4·NSPS) — trade-off between frequency resolution and time localisation.

const NSTEP_PER_SYMBOL: u32 = 16

Coarse-sync time-step = NSPS / NSTEP_PER_SYMBOL. FT8 = 4 (quarter-symbol resolution), FT4 = 1 (symbol-granular).

const NDOWN: u32 = 32

Downsample decimation factor: baseband rate = 12 000 / NDOWN Hz. FT8 = 60 (→200 Hz), FT4 = 18 (→667 Hz). Proportional to tone spacing.

const LLR_SCALE: f32 = 2.83

LLR scale factor applied after standard-deviation normalisation. FT8 uses 2.83 (empirical, from WSJT-X ft8b.f90). Different bits-per-symbol counts may shift the optimum — FT4’s 2-bit LLR dynamics are not identical to FT8’s 3-bit case.

impl Protocol for Wspr

const ID: ProtocolId = ProtocolId::Wspr

Runtime tag used at FFI / WASM boundaries.

type Fec = ConvFano

FEC codec carrying N_DATA * BITS_PER_SYMBOL coded bits.

type Msg = Wspr50Message

Message codec consuming the FEC-decoded information bits.

impl Copy for Wspr