orion-sdr 0.0.44

DSP/SDR block library targeting HF-to-EHF, 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

// Copyright (c) 2026 G & R Associates LLC
// SPDX-License-Identifier: MIT OR Apache-2.0

use super::tables::{Table, charn, nchar};

/// Encode a free-text string (up to 13 chars, base-42 alphabet) into 9 bytes (71 bits).
/// Returns None if any character is not in the FULL table or the string is too long.
pub fn encode_free_text(text: &str) -> Option<[u8; 9]> {
    if text.len() > 13 {
        return None;
    }

    let mut b71 = [0u8; 9];

    // Pad text to 13 characters with spaces
    let mut chars = Vec::with_capacity(13);
    for c in text.chars() {
        chars.push(c);
    }
    while chars.len() < 13 {
        chars.push(' ');
    }

    for &c in &chars {
        let cid = nchar(c, Table::Full)? as u16;
        // b71 = b71 * 42 + cid  (big-endian multiply-and-add across 9 bytes)
        let mut rem = cid;
        for i in (0..9usize).rev() {
            rem += b71[i] as u16 * 42;
            b71[i] = (rem & 0xFF) as u8;
            rem >>= 8;
        }
    }

    Some(b71)
}

/// Decode 9 bytes (71 bits big-endian) back into a free-text string (up to 13 chars).
pub fn decode_free_text(b71: &[u8; 9]) -> String {
    let mut b = *b71;
    let mut chars = [' '; 13];

    for i in (0..13usize).rev() {
        // Divide the big-endian 9-byte integer by 42, get remainder
        let mut rem: u16 = 0;
        for byte in &mut b {
            rem = (rem << 8) | *byte as u16;
            *byte = (rem / 42) as u8;
            rem %= 42;
        }
        chars[i] = charn(rem as u8, Table::Full);
    }

    let s: String = chars.iter().collect();
    s.trim_end_matches(' ').to_string()
}