summaryrefslogtreecommitdiffstats
path: root/contrib/edi/Interleaver.h
blob: 3029d5decadcd7c9228c3866b98ef4f79d3e3f74 (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
/*
   Copyright (C) 2017
   Matthias P. Braendli, matthias.braendli@mpb.li

    http://www.opendigitalradio.org

   EDI output,
   Interleaving of PFT fragments to increase robustness against
   burst packet loss.

   This is possible because EDI has to assume that fragments may reach
   the receiver out of order.

   */
/*
   This file is part of the ODR-mmbTools.

   This program 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.

   This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#pragma once

#include "config.h"
#include <vector>
#include <deque>
#include <stdexcept>
#include <cstdint>
#include "Log.h"
#include "PFT.h"

namespace edi {

class Interleaver {
    public:
        using fragment_vec = std::vector<PFTFragment>;

        /* Configure the interleaver to use latency_frames number of AF
         * packets for interleaving. Total delay through the interleaver
         * will be latency_frames * 24ms
         */
        void SetLatency(size_t latency_frames);

        /* Move the fragments for an AF Packet into the interleaver and
         * return interleaved fragments to be transmitted.
         */
        fragment_vec Interleave(fragment_vec &fragments);

    private:
        size_t m_latency = 0;
        size_t m_fragment_count = 0;
        size_t m_interleave_offset = 0;
        size_t m_stride = 0;

        /* Buffer that accumulates enough fragments to interleave */
        std::deque<fragment_vec> m_buffer;

        /* Buffer that contains fragments that have been interleaved,
         * to avoid that the interleaver output is too bursty
         */
        std::deque<PFTFragment> m_interleaved_fragments;
};

}