dvbdescriptors.cpp

Go to the documentation of this file.

// For windows, force the second argument of `iconv' to non-const.
#define WINICONV_CONST
 
// C headers
#include <iconv.h>
#include <unistd.h>
#include <algorithm>
#include <cerrno>
 
// Qt headers
#include <QCoreApplication>
 
// MythTV headers
#include "dvbdescriptors.h"
#include "iso6937tables.h"
#include "freesat_huffman.h"
#include "libmythbase/mythlogging.h"
#include "libmythbase/programinfo.h"
 
// Decode a text string according to
//   Draft ETSI EN 300 468 V1.16.1 (2019-05)
//   Digital Video Broadcasting (DVB);
//   Specification for Service Information (SI) in DVB systems
//   Annex A (normative): Coding of text characters
 
static QString decode_iso6937(const unsigned char *buf, uint length)
{
    // ISO/IEC 6937 to unicode (UCS2) convertor...
    // This is a composed encoding - accent first then plain character
    QString result = "";
    ushort ch = 0x20;
    for (uint i = 0; (i < length) && buf[i]; i++)
    {
        if (ch == 0xFFFF)
        {
            // Process second byte of two byte character
            const iso6937table * foo = iso6937table_secondary[buf[i-1]];
            ch = (*foo)[buf[i]];
            if (ch == 0xFFFF)
            {
                // If no valid code found in secondary table,
                // reprocess this second byte as first byte.
                ch = iso6937table_base[buf[i]];
                if (ch == 0xFFFF)
                    continue; // process second byte
            }
        }
        else
        {
            // Process first character of two possible characters.
            // double byte characters have a sentinel (0xffff) in this table.
            ch = iso6937table_base[buf[i]];
            if (ch == 0xFFFF)
                continue; // process second byte
 
        }
        result += QChar(ch);
    }
    return result;
}
 
// Set up a context for iconv, and call it repeatedly until finished.
// The iconv function stops whenever an unknown character is seen in
// the input stream. Handle inserting a � character and continuing, so
// that the resulting output is the same as QTextCodec::toUnicode.
static QString iconv_helper(int which, char *buf, size_t length)
{
    QString codec = QString("iso-8859-%1").arg(which);
    iconv_t conv = iconv_open("utf-16", qPrintable(codec));
    if (conv == (iconv_t) -1)
        return "";
 
    // Allocate room for the output, including space for the Byte
    // Order Mark.
    size_t outmaxlen = length * 2 + 2;
    QByteArray outbytes;
    outbytes.resize(outmaxlen);
    char *outp = outbytes.data();
    size_t outremain = outmaxlen;
 
    // Conversion loop
    while (length > 0)
    {
        size_t ret = iconv(conv, &buf, &length, &outp, &outremain);
        if (ret == size_t(-1))
        {
            if (errno == EILSEQ)
            {
                buf++; length -= 1;
                // Invalid Unicode character. Stuff a U+FFFD �
                // replacement character into the output like Qt.
                // Need to check the Byte Order Mark U+FEFF set by
                // iconv and match the ordering being used. (This
                // doesn't necessarily follow HAVE_BIGENDIAN.)
                if (outbytes[0] == static_cast<char>(0xFE))
                {   // Big endian
                    *outp++ = 0xFF; *outp++ = 0xFD;
                }
                else
                {
                    *outp++ = 0xFD; *outp++ = 0xFF;
                }
                outremain -= 2;
            }
            else
            {
                // Invalid or incomplete multibyte character in
                // input. Should never happen when converting from
                // iso-8859.
                length = 0;
            }
        }
    }
 
    // Remove the Byte Order Mark for compatability with
    // QTextCodec::toUnicode. Do not replace the ::fromUtf16 call with
    // the faster QString constructor, as the latter doesn't read the
    // BOM and convert the string to host byte order.
    QString result =
        QString::fromUtf16(reinterpret_cast<char16_t*>(outbytes.data()),
                           (outmaxlen-outremain)/2);
 
    iconv_close(conv);
    return result;
}
 
static QString decode_text(const unsigned char *buf, uint length);
 
// Decode a text string according to ETSI EN 300 468 Annex A
QString dvb_decode_text(const unsigned char *src, uint raw_length,
                        const enc_override &encoding_override)
{
    if (!raw_length)
        return "";
 
    if (src[0] == 0x1f)
        return freesat_huffman_to_string(src, raw_length);
 
    /* UCS-2 aka ISO/IEC 10646-1 Basic Multilingual Plane */
    if (src[0] == 0x11)
    {
        size_t length = (raw_length - 1) / 2;
        auto *to = new QChar[length];
        for (size_t i=0; i<length; i++)
            to[i] = QChar((src[1 + i*2] << 8) + src[1 + i*2 + 1]);
        QString to2(to, length);
        delete [] to;
        return to2;
    }
 
    if (((0x11 < src[0]) && (src[0] < 0x15)) ||
        ((0x15 < src[0]) && (src[0] < 0x1f)))
    {
        // TODO: Handle multi-byte encodings
        LOG(VB_SIPARSER, LOG_ERR,
            "dvb_decode_text: Multi-byte coded text is not yet supported.");
        return "";
    }
 
    // UTF-8 encoding of ISO/IEC 10646
    if (src[0] == 0x15)
    {
        return decode_text(src, raw_length);
    }
 
    // if a override encoding is specified and the default ISO 6937 encoding
    // would be used copy the override encoding in front of the text
    auto *dst = new unsigned char[raw_length + encoding_override.size()];
 
    uint length = 0;
    if (!encoding_override.empty() && (src[0] >= 0x20)) {
        std::copy(encoding_override.cbegin(), encoding_override.cend(), dst);
        length = encoding_override.size();
    }
 
    // Strip formatting characters
    for (uint i = 0; i < raw_length; i++)
    {
        if ((src[i] < 0x80) || (src[i] > 0x9F))
        {
            dst[length++] = src[i];
        // replace CR/LF with a space
        }
        else if (src[i] == 0x8A)
        {
            dst[length++] = 0x20;
        }
    }
 
    // Exit on empty string, sans formatting.
 
    QString sStr = (!length) ? "" : decode_text(dst, length);
 
    delete [] dst;
 
    return sStr;
}
 
static QString decode_text(const unsigned char *buf, uint length)
{
    // Decode using the correct text codec
    if (buf[0] >= 0x20)
    {
        return decode_iso6937(buf, length);
    }
    if ((buf[0] >= 0x01) && (buf[0] <= 0x0B))
    {
        return iconv_helper(4 + buf[0], (char*)(buf + 1), length - 1);
    }
    if ((buf[0] == 0x10) && (length >= 3))
    {
        // If the first byte of the text field has a value "0x10"
        // then the following two bytes carry a 16-bit value (uimsbf) N
        // to indicate that the remaining data of the text field is
        // coded using the character code table specified by
        // ISO Standard 8859, parts 1 to 9
 
        uint code = buf[1] << 8 | buf[2];
        if (code <= 15)
            return iconv_helper(code, (char*)(buf + 3), length - 3);
        return QString::fromLocal8Bit((char*)(buf + 3), length - 3);
    }
    if (buf[0] == 0x15) // Already Unicode
    {
        return QString::fromUtf8((char*)(buf + 1), length - 1);
    }
 
    // Unknown/invalid encoding - assume local8Bit
    return QString::fromLocal8Bit((char*)(buf + 1), length - 1);
}
 
 
QString dvb_decode_short_name(const unsigned char *src, uint raw_length)
{
    if (raw_length > 50)
    {
        LOG(VB_SIPARSER, LOG_WARNING,
            QString("dvb_decode_short_name: name is %1 chars "
                    "long. Unlikely to be a short name.")
                .arg(raw_length));
        return "";
    }
 
    if (((0x10 < src[0]) && (src[0] < 0x15)) ||
        ((0x15 < src[0]) && (src[0] < 0x20)))
    {
        // TODO: Handle multi-byte encodings
        LOG(VB_SIPARSER, LOG_ERR, "dvb_decode_short_name: "
                         "Multi-byte coded text is not yet supported.");
        return "";
    }
 
    auto *dst = new unsigned char[raw_length];
    uint length = 0;
 
    // check for emphasis control codes
    for (uint i = 0; i < raw_length; i++)
    {
        if (src[i] == 0x86)
        {
            while ((++i < raw_length) && (src[i] != 0x87))
            {
                if ((src[i] < 0x80) || (src[i] > 0x9F))
                {
                    dst[length++] = src[i];
                }
                // replace CR/LF with a space
                else if (src[i] == 0x8A)
                {
                    dst[length++] = 0x20;
                }
            }
        }
    }
 
    QString sStr = (!length) ? dvb_decode_text(src, raw_length)
                             : decode_text(dst, length);
 
    delete [] dst;
 
    return sStr;
}
 
QMutex             ContentDescriptor::s_categoryLock;
QMap<uint,QString> ContentDescriptor::s_categoryDesc;
volatile bool      ContentDescriptor::s_categoryDescExists = false;
 
ProgramInfo::CategoryType ContentDescriptor::GetMythCategory(uint i) const
{
    if (0x1 == Nibble1(i))
        return ProgramInfo::kCategoryMovie;
    if (0x4 == Nibble1(i))
        return ProgramInfo::kCategorySports;
    return ProgramInfo::kCategoryTVShow;
}
 
const std::array<const std::string,14> linkage_types
{
    "Reserved(0x00)",
    "Information Service",
    "EPG Service",
    "CA Replacement Service",
    "TS Containing Complete Network/Bouquet SI",
    "Service Replacement Service",
    "Data Broadcast Service",
    "RCS Map",
    "Mobile Hand-Over",
    "System Software Update Service",
    "TS Containing SSU, BAT or NIT",
    "IP/MAC Notification Service",
    "TS Containing INT, BAT or NIT",
    "Event Linkage",
};
 
 
QString LinkageDescriptor::LinkageTypeString(void) const
{
    if (LinkageType() < linkage_types.size())
        return QString::fromStdString(linkage_types[LinkageType()]);
    if ((LinkageType() <= 0x7f) || (LinkageType() == 0xff))
        return QString("Reserved(0x%1)").arg(LinkageType(),2,16,QChar('0'));
    return QString("User Defined(0x%1)").arg(LinkageType(),2,16,QChar('0'));
}
 
QString LinkageDescriptor::MobileHandOverTypeString(void) const
{
    if (kHandOverIdentical == MobileHandOverType())
        return "Hand-Over to an Identical Service";
    if (kHandOverLocalVariation == MobileHandOverType())
        return "Hand-Over to a Local Variation";
    if (kHandOverAssociatedService == MobileHandOverType())
        return "Hand-over to an Associated Service";
    return "Reserved";
}
 
QString ContentDescriptor::GetDescription(uint i) const
{
    if (!s_categoryDescExists)
        Init();
 
    QMutexLocker locker(&s_categoryLock);
 
    // Try to get detailed description
    QMap<uint,QString>::const_iterator it = s_categoryDesc.constFind(Nibble(i));
    if (it != s_categoryDesc.constEnd())
        return *it;
 
    // Fall back to category description
    it = s_categoryDesc.constFind(Nibble1(i)<<4);
    if (it != s_categoryDesc.constEnd())
        return *it;
 
    // Found nothing? Just return empty string.
    return "";
}
 
QString ContentDescriptor::toString() const
{
    QString tmp("ContentDescriptor: ");
    for (uint i = 0; i < Count(); i++)
        tmp += myth_category_type_to_string(GetMythCategory(i)) + " : " + GetDescription(i) + ", ";
    return tmp;
}
 
void ContentDescriptor::Init(void)
{
    QMutexLocker locker(&s_categoryLock);
 
    if (s_categoryDescExists)
        return;
 
    //: %1 is the main category, %2 is the subcategory
    QString subCatStr = QCoreApplication::translate("(Categories)",
        "%1 - %2", "Category with subcategory display");
 
    s_categoryDesc[0x10] = QCoreApplication::translate("(Categories)", "Movie");
    s_categoryDesc[0x11] = subCatStr
        .arg(QCoreApplication::translate("(Categories)", "Movie"),
             QCoreApplication::translate("(Categories)", "Detective/Thriller"));
    s_categoryDesc[0x12] = subCatStr
        .arg(QCoreApplication::translate("(Categories)", "Movie"),
             QCoreApplication::translate("(Categories)",
                                         "Adventure/Western/War"));
    s_categoryDesc[0x13] = subCatStr
        .arg(QCoreApplication::translate("(Categories)", "Movie"),
             QCoreApplication::translate("(Categories)",
                                         "Science Fiction/Fantasy/Horror"));
    s_categoryDesc[0x14] = subCatStr
        .arg(QCoreApplication::translate("(Categories)", "Movie"),
             QCoreApplication::translate("(Categories)", "Comedy"));
    s_categoryDesc[0x15] = subCatStr
        .arg(QCoreApplication::translate("(Categories)", "Movie"),
             QCoreApplication::translate("(Categories)",
                                         "Soap/Melodrama/Folkloric"));
    s_categoryDesc[0x16] = subCatStr
        .arg(QCoreApplication::translate("(Categories)", "Movie"),
             QCoreApplication::translate("(Categories)", "Romance"));
    s_categoryDesc[0x17] = subCatStr
        .arg(QCoreApplication::translate("(Categories)","Movie"),
             QCoreApplication::translate("(Categories)",
            "Serious/Classical/Religious/Historical Movie/Drama"));
    s_categoryDesc[0x18] = subCatStr
        .arg(QCoreApplication::translate("(Categories)","Movie"),
             QCoreApplication::translate("(Categories)", "Adult",
                                         "Adult Movie"));
 
    s_categoryDesc[0x20] = QCoreApplication::translate("(Categories)", "News");
    s_categoryDesc[0x21] = QCoreApplication::translate("(Categories)",
                                                       "News/Weather Report");
    s_categoryDesc[0x22] = QCoreApplication::translate("(Categories)",
                                                       "News Magazine");
    s_categoryDesc[0x23] = QCoreApplication::translate("(Categories)",
                                                       "Documentary");
    s_categoryDesc[0x24] = QCoreApplication::translate("(Categories)",
                                                       "Intelligent Programs");
 
    s_categoryDesc[0x30] = QCoreApplication::translate("(Categories)",
                                                       "Entertainment");
    s_categoryDesc[0x31] = QCoreApplication::translate("(Categories)",
                                                       "Game Show");
    s_categoryDesc[0x32] = QCoreApplication::translate("(Categories)",
                                                       "Variety Show");
    s_categoryDesc[0x33] = QCoreApplication::translate("(Categories)",
                                                       "Talk Show");
 
    s_categoryDesc[0x40] = QCoreApplication::translate("(Categories)",
                                                       "Sports");
    s_categoryDesc[0x41] = QCoreApplication::translate("(Categories)",
                                                       "Special Events (World Cup, World Series, etc)");
    s_categoryDesc[0x42] = QCoreApplication::translate("(Categories)",
                                                       "Sports Magazines");
    s_categoryDesc[0x43] = QCoreApplication::translate("(Categories)",
                                                       "Football (Soccer)");
    s_categoryDesc[0x44] = QCoreApplication::translate("(Categories)",
                                                       "Tennis/Squash");
    s_categoryDesc[0x45] = QCoreApplication::translate("(Categories)",
                                                       "Misc. Team Sports");
    // not football/soccer
    s_categoryDesc[0x46] = QCoreApplication::translate("(Categories)",
                                                       "Athletics");
    s_categoryDesc[0x47] = QCoreApplication::translate("(Categories)",
                                                       "Motor Sport");
    s_categoryDesc[0x48] = QCoreApplication::translate("(Categories)",
                                                       "Water Sport");
    s_categoryDesc[0x49] = QCoreApplication::translate("(Categories)",
                                                       "Winter Sports");
    s_categoryDesc[0x4A] = QCoreApplication::translate("(Categories)",
                                                       "Equestrian");
    s_categoryDesc[0x4B] = QCoreApplication::translate("(Categories)",
                                                     "Martial Sports");
 
    s_categoryDesc[0x50] = QCoreApplication::translate("(Categories)", "Kids");
    s_categoryDesc[0x51] = QCoreApplication::translate("(Categories)",
                             "Pre-School Children's Programs");
    s_categoryDesc[0x52] = QCoreApplication::translate("(Categories)",
                             "Entertainment Programs for 6 to 14");
    s_categoryDesc[0x53] = QCoreApplication::translate("(Categories)",
                             "Entertainment Programs for 10 to 16");
    s_categoryDesc[0x54] = QCoreApplication::translate("(Categories)",
                             "Informational/Educational");
    s_categoryDesc[0x55] = QCoreApplication::translate("(Categories)",
                                                       "Cartoons/Puppets");
 
    s_categoryDesc[0x60] = QCoreApplication::translate("(Categories)",
                                                       "Music/Ballet/Dance");
    s_categoryDesc[0x61] = QCoreApplication::translate("(Categories)",
                                                       "Rock/Pop");
    s_categoryDesc[0x62] = QCoreApplication::translate("(Categories)",
                                                       "Classical Music");
    s_categoryDesc[0x63] = QCoreApplication::translate("(Categories)",
                                                       "Folk Music");
    s_categoryDesc[0x64] = QCoreApplication::translate("(Categories)",
                                                       "Jazz");
    s_categoryDesc[0x65] = QCoreApplication::translate("(Categories)",
                                                       "Musical/Opera");
    s_categoryDesc[0x66] = QCoreApplication::translate("(Categories)",
                                                       "Ballet");
 
    s_categoryDesc[0x70] = QCoreApplication::translate("(Categories)",
                                                       "Arts/Culture");
    s_categoryDesc[0x71] = QCoreApplication::translate("(Categories)",
                                                       "Performing Arts");
    s_categoryDesc[0x72] = QCoreApplication::translate("(Categories)",
                                                       "Fine Arts");
    s_categoryDesc[0x73] = QCoreApplication::translate("(Categories)",
                                                       "Religion");
    s_categoryDesc[0x74] = QCoreApplication::translate("(Categories)",
                                                       "Popular Culture/Traditional Arts");
    s_categoryDesc[0x75] = QCoreApplication::translate("(Categories)",
                                                       "Literature");
    s_categoryDesc[0x76] = QCoreApplication::translate("(Categories)",
                                                       "Film/Cinema");
    s_categoryDesc[0x77] = QCoreApplication::translate("(Categories)",
                                                       "Experimental Film/Video");
    s_categoryDesc[0x78] = QCoreApplication::translate("(Categories)",
                                                       "Broadcasting/Press");
    s_categoryDesc[0x79] = QCoreApplication::translate("(Categories)",
                                                       "New Media");
    s_categoryDesc[0x7A] = QCoreApplication::translate("(Categories)",
                                                       "Arts/Culture Magazines");
    s_categoryDesc[0x7B] = QCoreApplication::translate("(Categories)", "Fashion");
 
    s_categoryDesc[0x80] = QCoreApplication::translate("(Categories)",
                             "Social/Political/Economics");
    s_categoryDesc[0x81] = QCoreApplication::translate("(Categories)",
                             "Magazines/Reports/Documentary");
    s_categoryDesc[0x82] = QCoreApplication::translate("(Categories)",
                             "Economics/Social Advisory");
    s_categoryDesc[0x83] = QCoreApplication::translate("(Categories)",
                                                       "Remarkable People");
 
    s_categoryDesc[0x90] = QCoreApplication::translate("(Categories)",
                             "Education/Science/Factual");
    s_categoryDesc[0x91] = QCoreApplication::translate("(Categories)",
                             "Nature/Animals/Environment");
    s_categoryDesc[0x92] = QCoreApplication::translate("(Categories)",
                             "Technology/Natural Sciences");
    s_categoryDesc[0x93] = QCoreApplication::translate("(Categories)",
                             "Medicine/Physiology/Psychology");
    s_categoryDesc[0x94] = QCoreApplication::translate("(Categories)",
                             "Foreign Countries/Expeditions");
    s_categoryDesc[0x95] = QCoreApplication::translate("(Categories)",
                             "Social/Spiritual Sciences");
    s_categoryDesc[0x96] = QCoreApplication::translate("(Categories)",
                                                       "Further Education");
    s_categoryDesc[0x97] = QCoreApplication::translate("(Categories)",
                                                       "Languages");
 
    s_categoryDesc[0xA0] = QCoreApplication::translate("(Categories)",
                                                       "Leisure/Hobbies");
    s_categoryDesc[0xA1] = QCoreApplication::translate("(Categories)",
                                                       "Tourism/Travel");
    s_categoryDesc[0xA2] = QCoreApplication::translate("(Categories)",
                                                       "Handicraft");
    s_categoryDesc[0xA3] = QCoreApplication::translate("(Categories)",
                                                       "Motoring");
    s_categoryDesc[0xA4] = QCoreApplication::translate("(Categories)",
                                                       "Fitness & Health");
    s_categoryDesc[0xA5] = QCoreApplication::translate("(Categories)", "Cooking");
    s_categoryDesc[0xA6] = QCoreApplication::translate("(Categories)",
                                                       "Advertizement/Shopping");
    s_categoryDesc[0xA7] = QCoreApplication::translate("(Categories)",
                                                       "Gardening");
    // Special
    s_categoryDesc[0xB0] = QCoreApplication::translate("(Categories)",
                                                       "Original Language");
    s_categoryDesc[0xB1] = QCoreApplication::translate("(Categories)",
                                                       "Black & White");
    s_categoryDesc[0xB2] = QCoreApplication::translate("(Categories)",
                                                       "\"Unpublished\" Programs");
    s_categoryDesc[0xB3] = QCoreApplication::translate("(Categories)",
                                                       "Live Broadcast");
    // UK Freeview custom id
    s_categoryDesc[0xF0] = QCoreApplication::translate("(Categories)",
                                                       "Drama");
 
    s_categoryDescExists = true;
}
 
QString FrequencyListDescriptor::toString() const
{
    QString str = "FrequencyListDescriptor: frequencies: ";
 
    for (uint i = 0; i < FrequencyCount(); i++)
    {
        str += QString("%1").arg(FrequencyHz(i));
        str += (i+1 < FrequencyCount()) ? ((i+4)%10) ? ", " : ",\n      " : "";
    }
 
    return str;
}
 
QString ServiceDescriptorMapping::toString() const
{
    QString str = "";
 
    if (IsDTV())
        str.append(" (TV)");
    else if (IsDigitalAudio())
        str.append(" (Radio)");
    else if (IsHDTV())
        str.append(" (HDTV)");
    else if (IsUHDTV())
        str.append(" (UHDTV)");
    else if (IsTeletext())
        str.append(" (Teletext)");
    else
        str.append(QString(" (Unknown 0x%1)").arg(ServiceType(),2,16,QChar('0')));
 
    return str;
}
 
QString SubtitlingDescriptor::toString(void) const
{
    QString ret = QString("Subtitling Descriptor ");
    ret += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    ret += QString("length(%1)").arg(DescriptorLength());
 
    for (uint i = 0; i < StreamCount(); i++)
    {
        ret.append("\n      ");
        ret.append(QString("type(0x%1) composition_page_id(%2) ancillary_page_id(%3) lang(%4)")
            .arg(SubtitleType(i),2,16,QChar('0'))
            .arg(CompositionPageID(i))
            .arg(AncillaryPageID(i))
            .arg(LanguageString(i)));
    }
 
    return ret;
}
 
QString TeletextDescriptor::toString(void) const
{
    QString ret = QString("Teletext Descriptor ");
    ret += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    ret += QString("length(%1)").arg(DescriptorLength());
 
    for (uint i = 0; i < StreamCount(); i++)
    {
        ret.append("\n      ");
        ret.append(QString("type(%1) mag(%2) page(%3) lang(%4)")
                   .arg(TeletextType(i))
                   .arg(TeletextMagazineNum(i), 0, 16)
                   .arg(TeletextPageNum(i), 2, 16, QChar('0'))
                   .arg(LanguageString(i)));
    }
 
    return ret;
}
 
QString CableDeliverySystemDescriptor::toString() const
{
    QString str = QString("CableDeliverySystemDescriptor ");
    str += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("length(%1)").arg(DescriptorLength());
 
    str.append(QString("Frequency: %1\n").arg(FrequencyHz()));
    str.append(QString("      Mod=%1, SymbR=%2, FECInner=%3, FECOuter=%4")
        .arg(ModulationString(),
             QString::number(SymbolRateHz()),
             FECInnerString(),
             FECOuterString()));
 
    return str;
}
 
QString SatelliteDeliverySystemDescriptor::toString() const
{
    QString str = QString("SatelliteDeliverySystemDescriptor ");
    str += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("length(%1) ").arg(DescriptorLength());
 
    str.append(QString("Frequency: %1, Type: %2\n").arg(FrequencykHz())
        .arg(ModulationSystemString()));
    str.append(QString("      Mod=%1, SymbR=%2, FECInner=%3, Orbit=%4, Pol=%5")
        .arg(ModulationString(),
             QString::number(SymbolRateHz()),
             FECInnerString(),
             OrbitalPositionString(),
             PolarizationString()));
 
    return str;
}
 
QString TerrestrialDeliverySystemDescriptor::toString() const
{
    QString str = QString("TerrestrialDeliverySystemDescriptor ");
    str += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("length(%1) ").arg(DescriptorLength());
 
    str.append(QString("Frequency: %1\n").arg(FrequencyHz()));
    str.append(QString("      BW=%1MHz C=%2 HP=%3 LP=%4 GI=%5 TransMode=%6k")
        .arg(BandwidthString(),
             ConstellationString(),
             CodeRateHPString(),
             CodeRateLPString(),
             GuardIntervalString(),
             TransmissionModeString()));
 
    return str;
}
 
// 0x79
QString S2SatelliteDeliverySystemDescriptor::toString() const
{
    QString str = QString("S2SatelliteDeliverySystemDescriptor ");
    str += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("length(%1) ").arg(DescriptorLength());
 
    str.append(QString("\n      ScramblingSequenceSelector(%1)").arg(ScramblingSequenceSelector()));
    str.append(QString(" MultipleInputStreamFlag(%1)").arg(MultipleInputStreamFlag()));
    str.append(QString("\n      NotTimesliceFlag(%1)").arg(NotTimesliceFlag()));
    str.append(QString(" TSGSMode(%1)").arg(TSGSMode()));
    //
    // TBD
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x00
QString ImageIconDescriptor::toString() const
{
    QString str = QString("ImageIconDescriptor ");
    str += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("length(%1) ").arg(DescriptorLength());
    str += QString("extension(0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("number %1/%2").arg(DescriptorNumber()).arg(LastDescriptorNumber());
    //
    // TBD
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x04
void T2DeliverySystemDescriptor::Parse(void) const
{
    m_cellPtrs.clear();
    m_subCellPtrs.clear();
 
    const unsigned char *cp = m_data + 8;
    for (uint i=0; (cp - m_data + 4) < DescriptorLength(); i++)
    {
        m_cellPtrs.push_back(cp);
        cp += TFSFlag() ? (2 + 1 + FrequencyLoopLength(i)) : (2 + 4);
        m_subCellPtrs.push_back(cp);
        cp += 1 + SubcellInfoLoopLength(i);
    }
}
 
QString T2DeliverySystemDescriptor::toString() const
{
    QString str = QString("T2DeliverySystemDescriptor ");
    str += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("length(%1) ").arg(DescriptorLength());
    str += QString("extension(0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("plp_id(%1) ").arg(PlpID());
    str += QString("T2_system_id(%1)").arg(T2SystemID());
    if (DescriptorLength() > 4)
    {
        str += QString("\n      %1 ").arg(SisoMisoString());
        str += QString("BW=%1MHz ").arg(BandwidthString());
        str += QString("GI=%1 ").arg(GuardIntervalString());
        str += QString("TransMode=%1 ").arg(TransmissionModeString());
        str += QString("OF=%1 ").arg(OtherFrequencyFlag());
        str += QString("TFS=%1 ").arg(TFSFlag());
    }
    if (DescriptorLength() > 6)
    {
        for (uint i=0; i < NumCells(); i++)
        {
            str += QString("\n      ");
            str += QString("cell_id:%1 ").arg(CellID(i));
            str += QString("centre_frequency:");
            if (TFSFlag())
            {
                for (uint j=0; j<FrequencyLoopLength(i)/4; j++)
                {
                    str += QString(" %1").arg(CentreFrequency(i,j));
                }
            }
            else
            {
                str += QString(" %1").arg(CentreFrequency(i));
            }
            for (uint j=0; j<SubcellInfoLoopLength(i)/5; j++)
            {
                str += QString("\n        ");
                str += QString("cell_id_extension:%1 ").arg(CellIDExtension(i,j));
                str += QString("transposer_frequency:%1").arg(TransposerFrequency(i,j));
            }
        }
    }
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x05
QString SHDeliverySystemDescriptor::toString() const
{
    QString str = QString("SHDeliverySystemDescriptor ");
    str += QString("tag(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("length(%1) ").arg(DescriptorLength());
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    //
    // TBD
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x06
QString SupplementaryAudioDescriptor::toString() const
{
    QString str = QString("SupplementaryAudioDescriptor ");
    str += QString("(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("length(%1)").arg(DescriptorLength());
    str += QString("\n      ");
    str += QString("mix_type(%1) ").arg(MixType());
    str += QString("editorial_classification(%1)").arg(EditorialClassification());
    str += QString("\n      ");
    str += QString("language_code_present(%1)").arg(LanguageCodePresent());
    if (LanguageCodePresent() && DescriptorLength() >= 4)
    {
        str += QString(" language_code(%1)").arg(LanguageString());
    }
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x07
QString NetworkChangeNotifyDescriptor::toString() const
{
    QString str = QString("NetworkChangeNotiyDescriptor ");
    str += QString("(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x08
QString MessageDescriptor::toString() const
{
    QString str = QString("MessageDescriptor ");
    str += QString("(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("length(%1)").arg(DescriptorLength());
    str += QString("\n      ");
    str += QString("message_id(%1) ").arg(MessageID());
    str += QString("language_code(%1)").arg(LanguageString());
    str += QString("\n      ");
    str += QString("text_char(\"%1\")").arg(Message());
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x09
QString TargetRegionDescriptor::toString() const
{
    QString str = QString("TargetRegionDescriptor ");
    str += QString("(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("length(%1)").arg(DescriptorLength());
    str += QString("\n      ");
    str += QString("country_code(%1) ").arg(CountryCodeString());
    //
    // TBD
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x0A
QString TargetRegionNameDescriptor::toString() const
{
    QString str = QString("TargetRegionNameDescriptor ");
    str += QString("(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("length(%1)").arg(DescriptorLength());
    str += QString("\n      ");
    str += QString("country_code(%1) ").arg(CountryCodeString());
    str += QString("language_code(%1)").arg(LanguageString());
    //
    // TBD
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x0B
QString ServiceRelocatedDescriptor::toString() const
{
    QString str = QString("ServiceRelocatedDescriptor ");
    str += QString("(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("length(%1)").arg(DescriptorLength());
    str += QString("\n      ");
    str += QString("old_original_network_id(%1) ").arg(OldOriginalNetworkID());
    str += QString("old_transport_id(%1) ").arg(OldTransportID());
    str += QString("old_service_id(%1) ").arg(OldServiceID());
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x0D
QString C2DeliverySystemDescriptor::toString() const
{
    QString str = QString("C2DeliverySystemDescriptor ");
    str += QString("(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("length(%1)").arg(DescriptorLength());
    //
    // TBD
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
// 0x7F 0x17
QString S2XSatelliteDeliverySystemDescriptor::toString() const
{
    QString str = QString("S2XSatelliteDeliverySystemDescriptor ");
    str += QString("(0x%1 ").arg(DescriptorTag(),2,16,QChar('0'));
    str += QString("0x%1) ").arg(DescriptorTagExtension(),2,16,QChar('0'));
    str += QString("length(%1)").arg(DescriptorLength());
    //
    // TBD
    //
    str.append(" Dumping\n");
    str.append(hexdump());
    return str;
}
 
QString DVBLogicalChannelDescriptor::toString() const
{
    QString ret = "UKChannelListDescriptor sid->chan_num: ";
    for (uint i = 0; i < ChannelCount(); i++)
    {
        ret += QString("%1->%2").arg(ServiceID(i)).arg(ChannelNumber(i));
        ret += (i+1 < ChannelCount()) ? ((i+4)%10) ? ", " : ",\n      " : "";
    }
    return ret;
}
 
QString DVBSimulcastChannelDescriptor::toString() const
{
    QString ret = "DVBSimulcastChannelDescriptor sid->chan_num: ";
    for (uint i = 0; i < ChannelCount(); i++)
    {
        ret += QString("%1->%2").arg(ServiceID(i)).arg(ChannelNumber(i));
        ret += (i+1 < ChannelCount()) ? ((i+3)%10) ? ", " : ",\n      " : "";
    }
    return ret;
}
 
QString SkyLCNDescriptor::toString() const
{
    QString ret = "Sky Logical Channel Number Descriptor ";
    ret += QString("(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    ret += QString("length(%1)").arg(DescriptorLength());
 
    ret += QString("\n      RegionID (%1) (0x%2) Raw (0x%3)")
        .arg(RegionID()).arg(RegionID(),4,16,QChar('0')).arg(RegionRaw(),4,16,QChar('0'));
 
    for (size_t i=0; i<ServiceCount(); i++)
    {
        ret += QString("\n        ServiceID (%1) (0x%2) ").arg(ServiceID(i)).arg(ServiceID(i),4,16,QChar('0'));
        ret += QString("ServiceType (0x%1) ").arg(ServiceType(i),2,16,QChar('0'));
        ret += QString("LCN (%1) ").arg(LogicalChannelNumber(i));
        ret += QString("ChannelID(0x%1) ").arg(ChannelID(i),4,16,QChar('0'));
        ret += QString("Flags(0x%1) ").arg(Flags(i),4,16,QChar('0'));
    }
 
    return ret;
}
 
QString FreesatLCNDescriptor::toString() const
{
    QString ret = "Freesat Logical Channel Number Descriptor ";
    ret += QString("(0x%1)").arg(DescriptorTag(),2,16,QChar('0'));
    ret += QString(" length(%1)").arg(DescriptorLength());
 
    for (size_t i=0; i<ServiceCount(); i++)
    {
        ret += QString("\n      ServiceID (%1) (0x%2) ").arg(ServiceID(i)).arg(ServiceID(i),4,16,QChar('0'));
        ret += QString("ChanID (0x%1)").arg(ChanID(i), 4, 16, QChar('0'));
        for (uint j=0; j<LCNCount(i); j++)
        {
            ret += QString("\n        LCN: %1 Region: %2").arg(LogicalChannelNumber(i,j),3).arg(RegionID(i,j));
        }
    }
    return ret;
}
 
QString FreesatRegionDescriptor::toString() const
{
    QString ret = "Freesat Region Descriptor ";
    ret += QString("(0x%1)").arg(DescriptorTag(),2,16,QChar('0'));
    ret += QString(" length(%1)").arg(DescriptorLength());
 
    for (uint i=0; i<RegionCount(); ++i)
    {
        uint region_id = RegionID(i);
        QString language = Language(i);
        QString region_name = RegionName(i);
        ret += QString("\n    Region (%1) (%2) '%3'")
            .arg(region_id,2).arg(language, region_name);
    }
    return ret;
}
 
QString FreesatCallsignDescriptor::toString(void) const
{
    QString ret = QString("Freesat Callsign Descriptor ");
    ret += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    ret += QString("length(%1)").arg(DescriptorLength());
    ret += QString("  (%1) '%2'").arg(Language(), Callsign());
    return ret;
}
 
QString OpenTVChannelListDescriptor::toString() const
{
    QString ret = QString("OpenTV ChannelList Descriptor region: %1 sid->chan_num(id): ").arg(RegionID());
    for (uint i = 0; i < ChannelCount(); i++)
    {
        ret += QString("%1->%2(%3)").arg(ServiceID(i)).arg(ChannelNumber(i)).arg(ChannelID(i));
        ret += (i+1<ChannelCount()) ? ", " : "";
    }
    return ret;
}
 
QString ApplicationSignallingDescriptor::toString(void) const
{
    QString ret = QString("ApplicationSignallingDescriptor ");
    ret += QString("tag(0x%1) ").arg(DescriptorTag(),2,16,QChar('0'));
    ret += QString("length(%1)").arg(DescriptorLength());
    for (uint i = 0; i < Count(); ++i)
    {
        ret += "\n      ";
        ret += QString("application_type(%1) ").arg(ApplicationType(i));
        ret += QString("AIT_version_number(%1)").arg(AITVersionNumber(i));
    }
    return ret;
}
 
QString CAIdentifierDescriptor::toString(void) const
{
    QString ret = QString("CAIdentifierDescriptor ");
    for (uint i = 0; i < CASystemCount(); ++i)
    {
        ret += QString("ca_system_id(0x%1) ")
            .arg(CASystemId(i), 0, 16);
    }
    return ret;
}
 
QString DataBroadcastDescriptor::toString(void) const
{
    QString ret = QString("DataBroadcastDescriptor: "
                                "data_broadcast_id(%1) "
                                "component_tag(%1) ")
            .arg(DataBroadcastId(), 0, 10)
            .arg(DataComponentTag(), 0, 10);
 
    ret += QString("selector(0x ");
    for (uint i = 0; i < SelectorLength(); i++)
        ret += QString("%1 ").arg(Selector()[i], 0, 16);
    ret += ") ";
 
    ret += QString("ISO_639_language_code(%1) ")
        .arg(LanguageString());
 
    ret += QString("text(%1) ") + Text();
 
    return ret;
}
 
QString LocalTimeOffsetDescriptor::toString(void) const
{
    QString ret = QString("LocalTimeOffsetDescriptor ");
    uint count = Count();
    for (uint i = 0; i < count; ++i)
    {
        ret += QString("country_code(%1) country_region_id(0x%2) "
                       "local_time_offset_with_polarity(%3) "
                       "time_of_change(TODO)")
            .arg(CountryCodeString(i))
            .arg(CountryRegionId(i), 0, 16)
            .arg(LocalTimeOffsetWithPolarity(i));
        // TODO add time of change
    }
    return ret;
}
 
QString NVODReferenceDescriptor::toString(void) const
{
    QString ret = QString("NVODReferenceDescriptor ");
    for (uint i = 0; i < Count(); ++i)
    {
        ret += QString("transport_stream_id(0x%1) original_network_id(0x%2) "
                       "service_id(0x%3) ")
            .arg(TransportStreamId(i), 0, 16)
            .arg(OriginalNetworkId(i), 0, 16)
            .arg(ServiceId(i), 0, 16);
    }
    return ret;
}
 
QString PartialTransportStreamDescriptor::toString(void) const
{
    return QString("PartialTransportStreamDescriptor peak_rate(%1) "
                   "min_overall_smooth_rate(%2) max_overall_smooth_buf(3)")
        .arg(PeakRate()).arg(SmoothRate()).arg(SmoothBuf());
}
 
QString AC3Descriptor::toString(void) const
{
    QString ret = QString("AC-3 Descriptor ");
    ret += QString("tag(%1) length(%2) ").arg(DescriptorTag(), DescriptorLength());
    if (HasComponentType())
        ret += QString("type(0x%1) ").arg(ComponentType(), 2, 16, QChar('0'));
    if (HasBSID())
        ret += QString("bsid(0x%1) ").arg(BSID(), 2, 16, QChar('0'));
    if (HasMainID())
        ret += QString("mainid(0x%1) ").arg(MainID(), 2, 16, QChar('0'));
    if (HasASVC())
        ret += QString("asvc(0x%1) ").arg(ASVC(), 2, 16, QChar('0'));
    return ret;
}
 
QMultiMap<QString,QString> ExtendedEventDescriptor::Items(void) const
{
    QMultiMap<QString, QString> ret;
 
    uint index = 0;
 
    /* handle all items
     * minimum item size is for 8bit length + 8bit length
     */
    while (LengthOfItems() - index >= 2)
    {
        QString item_description = dvb_decode_text (&m_data[8 + index], m_data[7 + index]);
        index += 1 + m_data[7 + index];
        QString item = dvb_decode_text (&m_data[8 + index], m_data[7 + index]);
        index += 1 + m_data[7 + index];
        ret.insert (item_description, item);
    }
 
    return ret;
}