summaryrefslogtreecommitdiffstats
path: root/src/fig/FIG.h
blob: 318b788216f10d7f18c73ff4675534706bff81ba (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
/*
   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"

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 0;        // 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;
    }
}

class IFIG
{
    public:
        virtual size_t 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();
        }

};

#endif // __FIG_H_