summaryrefslogtreecommitdiffstats
path: root/src/fig/FIG.h
blob: 6bcb42b5c2e4c1cf90175ec12391b9bbcd55b3e4 (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
104
105
106
107
108
109
110
111
112
113
/*
   Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
   2011, 2012 Her Majesty the Queen in Right of Canada (Communications
   Research Center Canada)

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

   */
/*
   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/>.
*/

#ifndef __FIG_H_
#define __FIG_H_

#include <boost/shared_ptr.hpp>
#include "MuxElements.h"

namespace FIC {

class FIGRuntimeInformation {
    public:
        FIGRuntimeInformation(boost::shared_ptr<dabEnsemble> e) :
            currentFrame(0),
            ensemble(e),
            factumAnalyzer(false) {}

        unsigned long currentFrame;
        boost::shared_ptr<dabEnsemble> ensemble;
        bool factumAnalyzer;
};

// Recommended FIG rates according to ETSI TR 101 496-2 Table 3.6.1
enum class FIG_rate {
    FIG0_0, /* Special repetition rate for FIG0/0, EN 300 401 Clause 6.4
        In any 96 ms period, the FIG 0/0 should be transmitted in a fixed time
        position. In transmission mode I, this should be the first FIB (of the three)
        associated with the first CIF (of the four) in the transmission frame (see
        clause 5.1). In transmission modes II and III, this should be the first FIB of
        every fourth transmission frame. In transmission mode IV, this should be the
        first FIB (of the three) associated with the first CIF (of the two) in every
        alternate transmission frame (see clause 5.1). */
    A, // at least 10 times per second
    B, // once per second
    C, // once every 10 seconds
    D, // less than once every 10 seconds
    E, // all in two minutes
};

/* Helper function to calculate the deadline for the next transmission, in milliseconds */
inline int rate_increment_ms(FIG_rate rate)
{
    switch (rate) {
        case FIG_rate::FIG0_0:    return 96;        // Is a special case
        case FIG_rate::A:         return 100;
        case FIG_rate::B:         return 1000;
        case FIG_rate::C:         return 10000;
        case FIG_rate::D:         return 30000;
        case FIG_rate::E:         return 120000;
    }
    return 1000; //some default value, shouldn't be used
}

/* The fill function of each FIG shall return a status telling
 * the carousel how many bytes have been written, and if the complete
 * set of information from that FIG was transmitted.
 */
struct FillStatus
{
    FillStatus() :
        num_bytes_written(0),
        complete_fig_transmitted(false) {}
    size_t num_bytes_written;
    bool   complete_fig_transmitted;
};

class IFIG
{
    public:
        virtual FillStatus fill(uint8_t *buf, size_t max_size) = 0;

        virtual FIG_rate repetition_rate(void) = 0;

        virtual const int figtype(void) const = 0;
        virtual const int figextension(void) const = 0;

        virtual const std::string name(void) const
        {
            std::stringstream ss;
            ss << figtype() << "/" << figextension();
            return ss.str();
        }

};

} // namespace FIC

#endif // __FIG_H_