summaryrefslogtreecommitdiffstats
path: root/src/dabOutput/metadata.h
blob: ed16de599dd0e865953dd0dc0972225148c1e88b (plain)
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
/*
   Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009 Her Majesty the Queen in
   Right of Canada (Communications Research Center Canada)

   Copyright (C) 2017
   Matthias P. Braendli, matthias.braendli@mpb.li

    http://www.opendigitalradio.org

   The metadata support for the outputs.
*/
/*
   This file is part of ODR-DabMux.

   ODR-DabMux is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as
   published by the Free Software Foundation, either version 3 of the
   License, or (at your option) any later version.

   ODR-DabMux is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with ODR-DabMux.  If not, see <http://www.gnu.org/licenses/>.
   */

#pragma once
#include "Log.h"

/* Some outputs support additional metadata to be carried
 * next to the main ETI stream. This metadata always has the
 * following format:
 *   Field:  | id | len      | value               |
 *   Length:   1    2          depending on id
 *
 * Multi-byte values are transmitted in network byte order.
 */

enum class output_metadata_id_e {
    // Contains no value, can be used to group fields
    separation_marker = 0,

    // TAI-UTC offset, value is int16_t.
    utc_offset = 1,

    /* EDI Time is the number of SI seconds since 2000-01-01 T 00:00:00 UTC.
     * value is an uint32_t */
    edi_time = 2,

    /* The DLFC field from the EDI TAG deti. value is uint16_t */
    dlfc = 3,
};

struct OutputMetadata {
    virtual output_metadata_id_e getId(void) const = 0;
    virtual size_t getLength(void) const = 0;

    /* Write the value in the metadata format to the buffer.
     * Returns number of bytes written. The buffer buf needs
     * to be large enough to contain the value;
     */
    virtual size_t write(uint8_t *buf) = 0;
};

struct OutputMetadataSeparation : public OutputMetadata {
    explicit OutputMetadataSeparation() {}
    output_metadata_id_e getId(void) const { return output_metadata_id_e::separation_marker; }
    virtual size_t getLength(void) const { return 3; }
    virtual size_t write(uint8_t *buf);
};


struct OutputMetadataUTCO : public OutputMetadata {
    explicit OutputMetadataUTCO(int16_t utco) : utco(utco) {}
    output_metadata_id_e getId(void) const { return output_metadata_id_e::utc_offset; }
    virtual size_t getLength(void) const { return 5; }
    virtual size_t write(uint8_t *buf);

    int16_t utco;
};

struct OutputMetadataEDITime : public OutputMetadata {
    explicit OutputMetadataEDITime(uint32_t seconds) : seconds(seconds) {}
    output_metadata_id_e getId(void) const { return output_metadata_id_e::edi_time; }
    virtual size_t getLength(void) const { return 7; }
    virtual size_t write(uint8_t *buf);

    uint32_t seconds;

};

struct OutputMetadataDLFC : public OutputMetadata {
    explicit OutputMetadataDLFC(uint16_t dlfc) : dlfc(dlfc) {}
    output_metadata_id_e getId(void) const { return output_metadata_id_e::dlfc; }
    virtual size_t getLength(void) const { return 5; }
    virtual size_t write(uint8_t *buf);

    uint16_t dlfc;

};