orion-sdr 0.0.20

DSP/SDR block library targeting HF-to-UHF, satellites, and Python bindings. Roadmap inside.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130


use crate::modulate::{Ft8Mod, Ft8Frame};
use crate::demodulate::Ft8Demod;
use crate::modulate::ft8::{FT8_DATA_SYMS, FT8_TONES};
use crate::codec::ft8::{Ft8Codec, Ft8Bits};
use crate::sync::ft8_sync;
use super::{make_ft8_test_buffer};

#[test]
fn roundtrip_ft8_noiseless() {
    let mut tones = [0u8; FT8_DATA_SYMS];
    for (i, t) in tones.iter_mut().enumerate() {
        *t = (i % FT8_TONES) as u8;
    }
    let frame_in = Ft8Frame::new(tones);

    let tx = Ft8Mod::new(12_000.0, 1_000.0, 0.0, 1.0);
    let iq = tx.modulate(&frame_in);

    let rx = Ft8Demod::new(12_000.0, 1_000.0);
    let frame_out = rx.demodulate(&iq).expect("FT8 demodulate returned None");

    assert_eq!(frame_in, frame_out, "FT8 noiseless roundtrip failed");
}

#[test]
fn roundtrip_ft8_all_tones() {
    let frame_in = Ft8Frame::new([7u8; FT8_DATA_SYMS]);
    let tx = Ft8Mod::new(12_000.0, 100.0, 0.0, 1.0);
    let iq = tx.modulate(&frame_in);
    let rx = Ft8Demod::new(12_000.0, 100.0);
    let frame_out = rx.demodulate(&iq).expect("FT8 all-7 demodulate failed");
    assert_eq!(frame_in, frame_out, "FT8 all-tone-7 roundtrip failed");
}

#[test]
fn roundtrip_ft8_codec_noiseless() {
    let payload: Ft8Bits = [0xDE, 0xAD, 0xBE, 0xEF, 0xCA, 0xFE, 0x01, 0x23, 0x45, 0x60];
    let frame = Ft8Codec::encode(&payload);

    let tx = Ft8Mod::new(12_000.0, 1_000.0, 0.0, 1.0);
    let iq = tx.modulate(&frame);

    let rx = Ft8Demod::new(12_000.0, 1_000.0);
    let frame_out = rx.demodulate(&iq).expect("FT8 demodulate returned None");

    let decoded = Ft8Codec::decode_hard(&frame_out)
        .expect("FT8 codec decode failed (noiseless)");
    assert_eq!(payload, decoded, "FT8 full-stack codec roundtrip failed");
}

#[test]
fn roundtrip_ft8_codec_zeros() {
    let payload: Ft8Bits = [0u8; 10];
    let frame = Ft8Codec::encode(&payload);
    let iq = Ft8Mod::new(12_000.0, 500.0, 0.0, 1.0).modulate(&frame);
    let frame_out = Ft8Demod::new(12_000.0, 500.0).demodulate(&iq).unwrap();
    let decoded = Ft8Codec::decode_hard(&frame_out).expect("FT8 codec decode failed (zeros)");
    assert_eq!(payload, decoded);
}

#[test]
fn sync_ft8_noiseless_aligned() {
    let base_hz = 1_000.0_f32;
    let (buf, payload) = make_ft8_test_buffer(0, base_hz, 0.0);

    let results = ft8_sync(
        &buf,
        12_000.0,
        base_hz - 6.25,
        base_hz + 50.0 + 6.25,
        0,
        0,
        5,
    );

    assert!(!results.is_empty(), "FT8 sync returned no candidates");
    let best = &results[0];
    let decoded = Ft8Codec::decode_soft(&best.llr)
        .expect("FT8 sync+decode_soft failed (noiseless, aligned)");
    assert_eq!(payload, decoded, "FT8 sync noiseless aligned: payload mismatch");
}

#[test]
fn sync_ft8_noiseless_time_offset() {
    use crate::modulate::ft8::FT8_SAMPLES_PER_SYM;

    let base_hz = 800.0_f32;
    let offset = 3 * FT8_SAMPLES_PER_SYM;
    let (buf, payload) = make_ft8_test_buffer(offset, base_hz, 0.0);

    let results = ft8_sync(
        &buf,
        12_000.0,
        base_hz - 6.25,
        base_hz + 50.0 + 6.25,
        0,
        5,
        5,
    );

    assert!(!results.is_empty(), "FT8 sync (time offset) returned no candidates");
    let best = &results[0];
    let decoded = Ft8Codec::decode_soft(&best.llr)
        .expect("FT8 sync+decode_soft failed (noiseless, time offset)");
    assert_eq!(payload, decoded, "FT8 sync noiseless time-offset: payload mismatch");
}

#[test]
fn sync_ft8_noisy_high_snr() {
    let base_hz = 1_200.0_f32;
    let noise_power = 0.005_f32;
    let (buf, payload) = make_ft8_test_buffer(0, base_hz, noise_power);

    let results = ft8_sync(
        &buf,
        12_000.0,
        base_hz - 6.25,
        base_hz + 50.0 + 6.25,
        0,
        0,
        5,
    );

    assert!(!results.is_empty(), "FT8 sync (high SNR) returned no candidates");
    let best = &results[0];
    let decoded = Ft8Codec::decode_soft(&best.llr)
        .expect("FT8 sync+decode_soft failed (high SNR)");
    assert_eq!(payload, decoded, "FT8 sync high-SNR: payload mismatch");
}