319 lines
8.9 KiB
C++
319 lines
8.9 KiB
C++
/* gprs_coding_scheme.cpp
|
|
*
|
|
* Copyright (C) 2015 by Sysmocom s.f.m.c. GmbH
|
|
* Author: Jacob Erlbeck <jerlbeck@sysmocom.de>
|
|
*
|
|
* 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 2
|
|
* 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, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
|
|
#include "gprs_coding_scheme.h"
|
|
|
|
/*
|
|
* 44.060 Table 8.1.1.1 and Table 8.1.1.2
|
|
* It has 3 level indexing. 0th level is ARQ type
|
|
* 1st level is Original MCS( index 0 corresponds to MCS1 and so on)
|
|
* 2nd level is MS MCS (index 0 corresponds to MCS1 and so on)
|
|
*/
|
|
enum GprsCodingScheme::Scheme GprsCodingScheme::egprs_mcs_retx_tbl[MAX_NUM_ARQ]
|
|
[MAX_NUM_MCS][MAX_NUM_MCS] = {
|
|
{
|
|
{MCS1, MCS1, MCS1, MCS1, MCS1, MCS1, MCS1, MCS1, MCS1},
|
|
{MCS2, MCS2, MCS2, MCS2, MCS2, MCS2, MCS2, MCS2, MCS2},
|
|
{MCS3, MCS3, MCS3, MCS3, MCS3, MCS3, MCS3, MCS3, MCS3},
|
|
{MCS1, MCS1, MCS1, MCS4, MCS4, MCS4, MCS4, MCS4, MCS4},
|
|
{MCS2, MCS2, MCS2, MCS2, MCS5, MCS5, MCS7, MCS7, MCS7},
|
|
{MCS3, MCS3, MCS3, MCS3, MCS3, MCS6, MCS6, MCS6, MCS9},
|
|
{MCS2, MCS2, MCS2, MCS2, MCS5, MCS5, MCS7, MCS7, MCS7},
|
|
{MCS3, MCS3, MCS3, MCS3, MCS3, MCS6, MCS6, MCS8, MCS8},
|
|
{MCS3, MCS3, MCS3, MCS3, MCS3, MCS6, MCS6, MCS6, MCS9}
|
|
},
|
|
{
|
|
{MCS1, MCS1, MCS1, MCS1, MCS1, MCS1, MCS1, MCS1, MCS1},
|
|
{MCS2, MCS2, MCS2, MCS2, MCS2, MCS2, MCS2, MCS2, MCS2},
|
|
{MCS3, MCS3, MCS3, MCS3, MCS3, MCS3, MCS3, MCS3, MCS3},
|
|
{MCS4, MCS4, MCS4, MCS4, MCS4, MCS4, MCS4, MCS4, MCS4},
|
|
{MCS5, MCS5, MCS5, MCS5, MCS5, MCS5, MCS7, MCS7, MCS7},
|
|
{MCS6, MCS6, MCS6, MCS6, MCS6, MCS6, MCS6, MCS6, MCS9},
|
|
{MCS5, MCS5, MCS5, MCS5, MCS5, MCS5, MCS7, MCS7, MCS7},
|
|
{MCS6, MCS6, MCS6, MCS6, MCS6, MCS6, MCS6, MCS8, MCS8},
|
|
{MCS6, MCS6, MCS6, MCS6, MCS6, MCS6, MCS6, MCS6, MCS9}
|
|
}
|
|
};
|
|
|
|
static struct {
|
|
struct {
|
|
uint8_t bytes;
|
|
uint8_t ext_bits;
|
|
uint8_t data_header_bits;
|
|
} uplink, downlink;
|
|
uint8_t data_bytes;
|
|
uint8_t optional_padding_bits;
|
|
const char *name;
|
|
GprsCodingScheme::HeaderType data_hdr;
|
|
GprsCodingScheme::Family family;
|
|
} mcs_info[GprsCodingScheme::NUM_SCHEMES] = {
|
|
{{0, 0}, {0, 0}, 0, 0, "UNKNOWN",
|
|
GprsCodingScheme::HEADER_INVALID, GprsCodingScheme::FAMILY_INVALID},
|
|
{{23, 0}, {23, 0}, 20, 0, "CS-1",
|
|
GprsCodingScheme::HEADER_GPRS_DATA, GprsCodingScheme::FAMILY_INVALID},
|
|
{{33, 7}, {33, 7}, 30, 0, "CS-2",
|
|
GprsCodingScheme::HEADER_GPRS_DATA, GprsCodingScheme::FAMILY_INVALID},
|
|
{{39, 3}, {39, 3}, 36, 0, "CS-3",
|
|
GprsCodingScheme::HEADER_GPRS_DATA, GprsCodingScheme::FAMILY_INVALID},
|
|
{{53, 7}, {53, 7}, 50, 0, "CS-4",
|
|
GprsCodingScheme::HEADER_GPRS_DATA, GprsCodingScheme::FAMILY_INVALID},
|
|
|
|
{{26, 1}, {26, 1}, 22, 0, "MCS-1",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_3, GprsCodingScheme::FAMILY_C},
|
|
{{32, 1}, {32, 1}, 28, 0, "MCS-2",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_3, GprsCodingScheme::FAMILY_B},
|
|
{{41, 1}, {41, 1}, 37, 48, "MCS-3",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_3, GprsCodingScheme::FAMILY_A},
|
|
{{48, 1}, {48, 1}, 44, 0, "MCS-4",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_3, GprsCodingScheme::FAMILY_C},
|
|
|
|
{{60, 7}, {59, 6}, 56, 0, "MCS-5",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_2, GprsCodingScheme::FAMILY_B},
|
|
{{78, 7}, {77, 6}, 74, 48, "MCS-6",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_2, GprsCodingScheme::FAMILY_A},
|
|
{{118, 2}, {117, 4}, 56, 0, "MCS-7",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_1, GprsCodingScheme::FAMILY_B},
|
|
{{142, 2}, {141, 4}, 68, 0, "MCS-8",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_1, GprsCodingScheme::FAMILY_A},
|
|
{{154, 2}, {153, 4}, 74, 0, "MCS-9",
|
|
GprsCodingScheme::HEADER_EGPRS_DATA_TYPE_1, GprsCodingScheme::FAMILY_A},
|
|
};
|
|
|
|
static struct {
|
|
struct {
|
|
uint8_t data_header_bits;
|
|
} uplink, downlink;
|
|
uint8_t data_block_header_bits;
|
|
uint8_t num_blocks;
|
|
const char *name;
|
|
} hdr_type_info[GprsCodingScheme::NUM_HEADER_TYPES] = {
|
|
{{0}, {0}, 0, 0, "INVALID"},
|
|
{{1*8 + 0}, {1*8 + 0}, 0, 0, "CONTROL"},
|
|
{{3*8 + 0}, {3*8 + 0}, 0, 1, "GPRS_DATA"},
|
|
{{5*8 + 6}, {5*8 + 0}, 2, 2, "EGPRS_DATA_TYPE1"},
|
|
{{4*8 + 5}, {3*8 + 4}, 2, 1, "EGPRS_DATA_TYPE2"},
|
|
{{3*8 + 7}, {3*8 + 7}, 2, 1, "EGPRS_DATA_TYPE3"},
|
|
};
|
|
|
|
GprsCodingScheme GprsCodingScheme::getBySizeUL(unsigned size)
|
|
{
|
|
switch (size) {
|
|
case 23: return GprsCodingScheme(CS1);
|
|
case 27: return GprsCodingScheme(MCS1);
|
|
case 33: return GprsCodingScheme(MCS2);
|
|
case 34: return GprsCodingScheme(CS2);
|
|
case 40: return GprsCodingScheme(CS3);
|
|
case 42: return GprsCodingScheme(MCS3);
|
|
case 49: return GprsCodingScheme(MCS4);
|
|
case 54: return GprsCodingScheme(CS4);
|
|
case 61: return GprsCodingScheme(MCS5);
|
|
case 79: return GprsCodingScheme(MCS6);
|
|
case 119: return GprsCodingScheme(MCS7);
|
|
case 143: return GprsCodingScheme(MCS8);
|
|
case 155: return GprsCodingScheme(MCS9);
|
|
}
|
|
|
|
return GprsCodingScheme(UNKNOWN);
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::sizeUL() const
|
|
{
|
|
return mcs_info[m_scheme].uplink.bytes + (spareBitsUL() ? 1 : 0);
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::usedSizeUL() const
|
|
{
|
|
if (mcs_info[m_scheme].data_hdr == HEADER_GPRS_DATA)
|
|
return mcs_info[m_scheme].uplink.bytes;
|
|
else
|
|
return sizeUL();
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::maxBytesUL() const
|
|
{
|
|
return mcs_info[m_scheme].uplink.bytes;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::spareBitsUL() const
|
|
{
|
|
return mcs_info[m_scheme].uplink.ext_bits;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::sizeDL() const
|
|
{
|
|
return mcs_info[m_scheme].downlink.bytes + (spareBitsDL() ? 1 : 0);
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::usedSizeDL() const
|
|
{
|
|
if (mcs_info[m_scheme].data_hdr == HEADER_GPRS_DATA)
|
|
return mcs_info[m_scheme].downlink.bytes;
|
|
else
|
|
return sizeDL();
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::maxBytesDL() const
|
|
{
|
|
return mcs_info[m_scheme].downlink.bytes;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::spareBitsDL() const
|
|
{
|
|
return mcs_info[m_scheme].downlink.ext_bits;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::maxDataBlockBytes() const
|
|
{
|
|
return mcs_info[m_scheme].data_bytes;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::optionalPaddingBits() const
|
|
{
|
|
return mcs_info[m_scheme].optional_padding_bits;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::numDataBlocks() const
|
|
{
|
|
return hdr_type_info[headerTypeData()].num_blocks;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::numDataHeaderBitsUL() const
|
|
{
|
|
return hdr_type_info[headerTypeData()].uplink.data_header_bits;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::numDataHeaderBitsDL() const
|
|
{
|
|
return hdr_type_info[headerTypeData()].downlink.data_header_bits;
|
|
}
|
|
|
|
uint8_t GprsCodingScheme::numDataBlockHeaderBits() const
|
|
{
|
|
return hdr_type_info[headerTypeData()].data_block_header_bits;
|
|
}
|
|
|
|
const char *GprsCodingScheme::name() const
|
|
{
|
|
return mcs_info[m_scheme].name;
|
|
}
|
|
|
|
GprsCodingScheme::HeaderType GprsCodingScheme::headerTypeData() const
|
|
{
|
|
return mcs_info[m_scheme].data_hdr;
|
|
}
|
|
|
|
GprsCodingScheme::Family GprsCodingScheme::family() const
|
|
{
|
|
return mcs_info[m_scheme].family;
|
|
}
|
|
|
|
void GprsCodingScheme::inc(Mode mode)
|
|
{
|
|
if (!isCompatible(mode))
|
|
/* This should not happen. TODO: Use assert? */
|
|
return;
|
|
|
|
Scheme new_cs(Scheme(m_scheme + 1));
|
|
if (!GprsCodingScheme(new_cs).isCompatible(mode))
|
|
/* Clipping, do not change the value */
|
|
return;
|
|
|
|
m_scheme = new_cs;
|
|
}
|
|
|
|
void GprsCodingScheme::dec(Mode mode)
|
|
{
|
|
if (!isCompatible(mode))
|
|
/* This should not happen. TODO: Use assert? */
|
|
return;
|
|
|
|
Scheme new_cs(Scheme(m_scheme - 1));
|
|
if (!GprsCodingScheme(new_cs).isCompatible(mode))
|
|
/* Clipping, do not change the value */
|
|
return;
|
|
|
|
m_scheme = new_cs;
|
|
}
|
|
|
|
void GprsCodingScheme::inc()
|
|
{
|
|
if (isGprs() && m_scheme == CS4)
|
|
return;
|
|
|
|
if (isEgprs() && m_scheme == MCS9)
|
|
return;
|
|
|
|
if (!isValid())
|
|
return;
|
|
|
|
m_scheme = Scheme(m_scheme + 1);
|
|
}
|
|
|
|
void GprsCodingScheme::dec()
|
|
{
|
|
if (isGprs() && m_scheme == CS1)
|
|
return;
|
|
|
|
if (isEgprs() && m_scheme == MCS1)
|
|
return;
|
|
|
|
if (!isValid())
|
|
return;
|
|
|
|
m_scheme = Scheme(m_scheme - 1);
|
|
}
|
|
|
|
const char *GprsCodingScheme::modeName(Mode mode)
|
|
{
|
|
switch (mode) {
|
|
case GPRS: return "GPRS";
|
|
case EGPRS_GMSK: return "EGPRS_GMSK-only";
|
|
case EGPRS: return "EGPRS";
|
|
default: return "???";
|
|
}
|
|
}
|
|
|
|
bool GprsCodingScheme::isFamilyCompatible(GprsCodingScheme o) const
|
|
{
|
|
if (*this == o)
|
|
return true;
|
|
|
|
if (family() == FAMILY_INVALID)
|
|
return false;
|
|
|
|
return family() == o.family();
|
|
}
|
|
|
|
bool GprsCodingScheme::isCombinable(GprsCodingScheme o) const
|
|
{
|
|
return numDataBlocks() == o.numDataBlocks();
|
|
}
|
|
|
|
void GprsCodingScheme::decToSingleBlock(bool *needStuffing)
|
|
{
|
|
switch (m_scheme) {
|
|
case MCS7: *needStuffing = false; m_scheme = MCS5; break;
|
|
case MCS8: *needStuffing = true; m_scheme = MCS6; break;
|
|
case MCS9: *needStuffing = false; m_scheme = MCS6; break;
|
|
default: *needStuffing = false; break;
|
|
}
|
|
}
|