rds-rs 1.0.4

A Library for Decoding RDS/RBDS data
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

use crate::alt_freq_decoder::AfDecoder;
use crate::alt_freq_table::AfTable;
use crate::oda::OdaEntry;
use crate::ps::PsData;
use crate::ptyn::PtynData;
use crate::radiotext::RtData;
use crate::types::{
    Clock, Content, DiCodes, EwsData, Pin, ProgramInformation, ProgramType, SlcData, TdcData,
    TrafficCodes, ValidFields,
};
use heapless::LinearMap;

#[derive(Default, Clone, PartialEq)]
pub struct NetworkInfo {
    /// Program Item Number Code
    pub pin: Pin,
    /// Program Type (PTY)
    pub program_type: ProgramType,
    /// Traffic Program / Announcement codes.
    pub traffic: TrafficCodes,
    /// Program Service name (8 bytes, not null-terminated)
    pub ps: PsData,
}

/// Container for all decoded RDS data.
///
/// This struct is populated by the `Decoder`, which is passed many blocks
/// of raw RDS data to decode. Depending what information is broadcast
/// and passed to the decoder, some of the fields in this struct will contain
/// valid data. The `valid` field is a bitmask that should be used first before
/// dereferencing any members of this struct.
#[derive(Default, Clone, PartialEq)]
pub struct RdsData {
    /// Program Identification Code
    pub program_information: ProgramInformation,

    /// Tuned network (TN) info.
    pub tn: NetworkInfo,

    /// Other network (ON) info.
    pub on: NetworkInfo,

    /// Music/Speech flag.
    pub content: Content,

    /// Radiotext
    pub rt: RtData,

    /// Clock time
    pub clock: Clock,

    /// Slow labelling codes
    pub slc: SlcData,

    /// Program Type Name (extended PTY)
    pub ptyn: PtynData,

    /// Active Open Data Applications
    pub oda: LinearMap<u16, OdaEntry, 10>,

    /// Transparent Data Channels
    pub tdc: TdcData,

    /// Emergency Warning System
    pub ews: EwsData,

    pub did_pty: DiCodes,

    pub alt_freqs: AfTable, // Alternative frequency table from group 0A.
    pub alt_freq_decoder: AfDecoder,

    pub on_freqs: AfTable, // Other network AFs. See RBDS spec. sect. 3.2.1.6.6.
    pub on_freq_decoder: AfDecoder,

    pub map_freqs: AfTable, // Mapped AFs. See RBDS spec. sect. 3.1.5.19 and 3.2.1.6.6.

    /// Bitmask of which fields are valid
    pub valid: ValidFields,
}