/*
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) 2022
Matthias P. Braendli, matthias.braendli@mpb.li
http://www.opendigitalradio.org
This file defines all data structures used in DabMux to represent
and save ensemble data.
*/
/*
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 .
*/
#pragma once
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include "dabOutput/dabOutput.h"
#include "input/inputs.h"
#include "RemoteControl.h"
#include "Eti.h"
// Protection levels and bitrates for UEP.
const unsigned char ProtectionLevelTable[64] = {
4, 3, 2, 1, 0,
4, 3, 2, 1, 0,
4, 3, 2, 1,
4, 3, 2, 1, 0,
4, 3, 2, 1, 0,
4, 3, 2, 1, 0,
4, 3, 2, 1,
4, 3, 2, 1, 0,
4, 3, 2, 1, 0,
4, 3, 2, 1, 0,
4, 3, 2, 1, 0,
4, 3, 2, 1, 0,
4, 3, 1,
4, 2, 0
};
const unsigned short BitRateTable[64] = {
32, 32, 32, 32, 32,
48, 48, 48, 48, 48,
56, 56, 56, 56,
64, 64, 64, 64, 64,
80, 80, 80, 80, 80,
96, 96, 96, 96, 96,
112, 112, 112, 112,
128, 128, 128, 128, 128,
160, 160, 160, 160, 160,
192, 192, 192, 192, 192,
224, 224, 224, 224, 224,
256, 256, 256, 256, 256,
320, 320, 320,
384, 384, 384
};
class MuxInitException : public std::exception
{
public:
MuxInitException(const std::string m = "ODR-DabMux initialisation error")
throw()
: msg(m) {}
~MuxInitException(void) throw() {}
const char* what() const throw() { return msg.c_str(); }
private:
std::string msg;
};
enum class subchannel_type_t {
DABAudio,
DABPlusAudio,
DataDmb,
Packet
};
/* Announcement switching flags,
* define in ETSI TS 101 756 Table 15 */
const char * const annoucement_flags_names[] = {
"Alarm",
"Traffic",
"Travel",
"Warning",
"News",
"Weather",
"Event",
"Special",
"ProgrammeInfo",
"Sports",
"Finance",
"tba1", "tba2", "tba3", "tba4", "tba5"
};
/* Class representing an announcement cluster for FIG 0/19 */
class AnnouncementCluster : public RemoteControllable {
public:
AnnouncementCluster(const std::string& name) :
RemoteControllable(name)
{
RC_ADD_PARAMETER(active, "Signal this announcement [0 or 1]");
/* This supports deferred start/stop to allow the user
* to compensate for audio encoding delay
*/
RC_ADD_PARAMETER(start_in,
"Start signalling this announcement after a delay [ms]");
RC_ADD_PARAMETER(stop_in,
"Stop signalling this announcement after a delay [ms]");
}
uint8_t cluster_id = 0;
uint16_t flags = 0;
std::string subchanneluid;
std::string tostring(void) const;
/* Check if the activation/deactivation timeout occurred,
* and return of if the Announcement is active
*/
bool is_active(void);
private:
mutable std::mutex m_active_mutex;
bool m_active = false;
boost::optional<
std::chrono::time_point<
std::chrono::steady_clock> > m_deferred_start_time;
boost::optional<
std::chrono::time_point<
std::chrono::steady_clock> > m_deferred_stop_time;
/* Remote control */
virtual void set_parameter(const std::string& parameter,
const std::string& value);
/* Getting a parameter always returns a string. */
virtual const std::string get_parameter(const std::string& parameter) const;
};
struct dabOutput {
dabOutput(const char* proto, const char* name) :
outputProto(proto), outputName(name), output(NULL) { }
// outputs are specified with outputProto://outputName
// during config parsing
std::string outputProto;
std::string outputName;
// later, the corresponding output is then created
DabOutput* output;
};
#define DABLABEL_LENGTH 16
struct FIG2TextControl {
bool bidi_flag = false;
bool base_direction_is_rtl = false;
bool contextual_flag = false;
bool combining_flag = false;
};
class DabLabel
{
public:
/* Set a new label and short label. If the label parses as valid UTF-8, it
* will be converted to EBU Latin. If utf-8 decoding fails, the label
* will be used as is. Characters that cannot be converted are replaced
* by a space.
*
* returns: 0 on success
* -1 if the short_label is not a representable
* -2 if the short_label is too long
* -3 if the text is too long
*/
int setLabel(const std::string& label, const std::string& short_label);
/* Same as above, but sets the flag to 0xff00, truncating at 8
* characters.
*
* returns: 0 on success
* -3 if the text is too long
*/
int setLabel(const std::string& label);
/* Set the FIG2 label. label must be UTF-8.
*
* returns: 0 on success
*/
int setFIG2Label(const std::string& label);
/* FIG2 can either be sent with a character field (old spec)
* or with a text control (draftETSI TS 103 176 v2.2.1).
*
* Setting one clears the other, and selects the value of the
* Rfu bit in the FIG 2 Data Field
*/
void setFIG2CharacterField(uint16_t character_field);
void setFIG2TextControl(FIG2TextControl tc);
// For FIG 1
/* Write the label to the 16-byte buffer given in buf
* In the DAB standard, the label is 16 bytes long, and is
* padded using spaces.
*/
void writeLabel(uint8_t* buf) const;
bool has_fig1_label() const { return not m_fig1_label.empty(); }
uint16_t flag() const { return m_fig1_flag; }
const std::string long_label() const;
const std::string short_label() const;
// For FIG 2
bool has_fig2_label() const { return not m_fig2_label.empty(); }
bool fig2_uses_text_control() const { return m_fig2_use_text_control; }
FIG2TextControl fig2_text_control() const { return m_fig2_text_control; }
uint16_t fig2_character_field() const { return m_fig2_character_field; }
const std::string fig2_label() const;
/* FIG 2 labels are either in UCS-2 or in UTF-8. Because there are upcoming
* changes in the spec regarding the encoding of FIG2 (currently in draft
* ETSI TS 103 176 v2.2.1), the character flag is not implemented yet.
*
* Both FIG 1 and FIG 2 labels can be sent, and receiver will show the one
* they support.
*/
private:
/* The m_fig1_label is not padded in any way. Stored in EBU Latin Charset */
std::string m_fig1_label;
/* The flag field selects which label characters make
* up the short label
*/
uint16_t m_fig1_flag = 0xFFFF;
/* FIG2 label, stored in UTF-8. TODO: support UCS-2 */
std::string m_fig2_label;
bool m_fig2_use_text_control = true; // Default to the new variant
uint16_t m_fig2_character_field = 0xFF00;
FIG2TextControl m_fig2_text_control;
/* Checks and calculates the flag. slabel must be EBU Latin Charset */
int setFIG1ShortLabel(const std::string& slabel);
};
class DabService;
class DabComponent;
class DabSubchannel;
class LinkageSet;
struct FrequencyInformation;
struct ServiceOtherEnsembleInfo;
using vec_sp_component = std::vector >;
using vec_sp_service = std::vector >;
using vec_sp_subchannel = std::vector >;
enum class TransmissionMode_e {
TM_I,
TM_II,
TM_III,
TM_IV
};
class dabEnsemble : public RemoteControllable {
public:
dabEnsemble()
: RemoteControllable("ensemble")
{
RC_ADD_PARAMETER(localtimeoffset,
"local time offset, 'auto' or -24 to +24 [half-hours]");
}
/* Remote control */
virtual void set_parameter(const std::string& parameter,
const std::string& value);
/* Getting a parameter always returns a string. */
virtual const std::string get_parameter(const std::string& parameter) const;
/* Check if the Linkage Sets are valid */
bool validate_linkage_sets(void);
/* all fields are public, since this was a struct before */
uint16_t id = 0;
uint8_t ecc = 0;
DabLabel label;
TransmissionMode_e transmission_mode = TransmissionMode_e::TM_I;
/* Use the local time to calculate the lto */
bool lto_auto = true;
int lto = 0; // local time offset in half-hours
// range: -24 to +24
// 1 corresponds to the PTy used in RDS
// 2 corresponds to program types used in north america
int international_table = 1;
// Modulo-1024 counter for FIG0/7.
// Set to RECONFIG_COUNTER_DISABLED to disable FIG0/7.
// Set to RECONFIG_COUNTER_HASH to calculate the counter value using a hash function
// on relevant ensemble configuration parameters.
static constexpr int RECONFIG_COUNTER_DISABLED = -1;
static constexpr int RECONFIG_COUNTER_HASH = -2;
int reconfig_counter = RECONFIG_COUNTER_DISABLED;
// alarm flag is use for AL flag in FIG 0/0.
// set to true if one announcement group with cluster ID 0xFF is available in multiplex file
bool alarm_flag = 0;
vec_sp_service services;
vec_sp_component components;
vec_sp_subchannel subchannels;
std::vector > clusters;
std::vector > linkagesets;
std::vector frequency_information;
std::vector service_other_ensemble;
};
struct dabProtectionUEP {
unsigned char tableIndex;
};
enum dab_protection_eep_profile {
EEP_A,
EEP_B
};
struct dabProtectionEEP {
dab_protection_eep_profile profile;
// option is a 3-bit field where 000 and 001 are used to
// select EEP profile A and B.
// Other values are for future use, see
// EN 300 401 Clause 6.2.1 "Basic sub-channel organisation"
uint8_t GetOption(void) const {
return (this->profile == EEP_A) ? 0 : 1;
}
};
enum dab_protection_form_t {
UEP, // implies FIG0/1 Short form
EEP // Long form
};
struct dabProtection {
uint8_t level;
dab_protection_form_t form;
union {
dabProtectionUEP uep;
dabProtectionEEP eep;
};
// According to ETSI EN 300 799 5.4.1.2
uint8_t to_tpl() const;
};
class DabSubchannel
{
public:
DabSubchannel(const std::string& uid) :
uid(uid),
protection() { }
// Calculate subchannel size in number of CU
unsigned short getSizeCu(void) const;
// Calculate subchannel size in number of bytes
unsigned short getSizeByte(void) const;
// Calculate subchannel size in number of uint32_t
unsigned short getSizeWord(void) const;
// Calculate subchannel size in number of uint64_t
unsigned short getSizeDWord(void) const;
// Read from the input, using the correct buffer management
size_t readFrame(uint8_t *buffer, size_t size, std::time_t seconds, int utco, uint32_t tsta);
std::string uid;
std::string inputUri;
std::shared_ptr input;
unsigned char id = 0;
subchannel_type_t type = subchannel_type_t::DABAudio;
bool packet_enhanced = false; // Enables additional FEC and FIG0/14
uint16_t startAddress = 0;
uint16_t bitrate = 0;
struct dabProtection protection;
};
/* For FIG 0/13 (EN 300 401 Clause 6.3.6) */
struct userApplication {
/* This 11-bit field identifies the user application that shall be used to decode the data in the channel identified
* by SId and SCIdS. The interpretation of this field shall be as defined in ETSI TS 101 756 [3], table 16. */
uint16_t uaType = 0xFFFF;
/* X-PAD Application Type: this 5-bit field shall specify the lowest numbered application type used to transport
* this user application (see clause 7.4.3).
* Also See EN 300 401 Table 11 "X-PAD Application types" */
uint8_t xpadAppType;
};
struct dabAudioComponent {
std::vector uaTypes;
};
struct dabDataComponent {
};
struct dabPacketComponent {
uint16_t id = 0;
uint16_t address = 0;
std::vector uaTypes;
bool datagroup = false;
};
class DabComponent : public RemoteControllable
{
public:
DabComponent(std::string& uid) :
RemoteControllable(uid),
uid(uid)
{
RC_ADD_PARAMETER(label, "Label and shortlabel [label,short]");
}
std::string uid;
DabLabel label;
uint32_t serviceId = 0;
uint8_t subchId = 0;
uint8_t type = 0;
uint8_t SCIdS = 0;
dabAudioComponent audio;
dabDataComponent data;
dabPacketComponent packet;
bool isPacketComponent(vec_sp_subchannel& subchannels) const;
/* Remote control */
virtual void set_parameter(const std::string& parameter,
const std::string& value);
/* Getting a parameter always returns a string. */
virtual const std::string get_parameter(const std::string& parameter) const;
};
class DabService : public RemoteControllable
{
public:
DabService(std::string& uid) :
RemoteControllable(uid),
uid(uid),
label()
{
RC_ADD_PARAMETER(label, "Label and shortlabel [label,short]");
RC_ADD_PARAMETER(pty, "Programme Type");
RC_ADD_PARAMETER(ptysd, "PTy Static/Dynamic [static,dynamic]");
}
std::string uid;
uint32_t id = 0;
/* Services with different ECC than the ensemble must be signalled in FIG0/9.
* here, leave at 0 if they have the same as the ensemble
*/
uint8_t ecc = 0;
struct pty_settings_t {
uint8_t pty = 0; // 0 means disabled
bool dynamic_no_static = false;
};
pty_settings_t pty_settings;
unsigned char language = 0;
/* ASu (Announcement support) flags: this 16-bit flag field shall
* specify the type(s) of announcements by which it is possible to
* interrupt the reception of the service. The interpretation of this
* field shall be as defined in TS 101 756, table 14.
*/
uint16_t ASu = 0;
std::vector clusters;
subchannel_type_t getType(const std::shared_ptr ensemble) const;
bool isProgramme(const std::shared_ptr& ensemble) const;
unsigned char nbComponent(const vec_sp_component& components) const;
DabLabel label;
/* Remote control */
virtual void set_parameter(const std::string& parameter,
const std::string& value);
/* Getting a parameter always returns a string. */
virtual const std::string get_parameter(const std::string& parameter) const;
};
/* Represent an entry for FIG0/24 */
struct ServiceOtherEnsembleInfo {
uint32_t service_id = 0;
// Ensembles in which this service is also available
std::vector other_ensembles;
};
enum class ServiceLinkType {DAB, FM, DRM, AMSS};
/* Represent one link inside a linkage set */
struct ServiceLink {
ServiceLinkType type;
uint16_t id;
uint8_t ecc;
};
/* Represents a linkage set linkage sets according to
* TS 103 176 Clause 5.2.3 "Linkage sets". This information will
* be encoded in FIG 0/6.
*/
class LinkageSet {
public:
LinkageSet(const std::string& name,
uint16_t lsn,
bool active,
bool hard,
bool international);
std::string get_name(void) const { return m_name; }
std::list id_list;
/* Linkage Set Number is a 12-bit number that identifies the linkage
* set in a country (requires coordination between multiplex operators
* in a country)
*/
uint16_t lsn;
bool active; // TODO: Remote-controllable
bool hard;
bool international;
std::string keyservice; // TODO replace by pointer to service
/* Return a LinkageSet with id_list filtered to include
* only those links of a given type
*/
LinkageSet filter_type(const ServiceLinkType type);
private:
std::string m_name;
};
// FIG 0/21
enum class RangeModulation {
dab_ensemble = 0,
drm = 6,
fm_with_rds = 8,
amss = 14
};
struct FrequencyInfoDab {
enum class ControlField_e {
adjacent_no_mode = 0,
adjacent_mode1 = 2,
disjoint_no_mode = 1,
disjoint_mode1 = 3};
struct ListElement {
std::string uid;
ControlField_e control_field;
float frequency;
};
uint16_t eid;
std::vector frequencies;
};
struct FrequencyInfoDrm {
uint32_t drm_service_id;
std::vector frequencies;
};
struct FrequencyInfoFm {
uint16_t pi_code;
std::vector frequencies;
};
struct FrequencyInfoAmss {
uint32_t amss_service_id;
std::vector frequencies;
};
/* One FI database entry. DB key are oe, rm, and idfield, which is
* inside the fi_XXX field
*/
struct FrequencyInformation {
std::string uid;
bool other_ensemble = false;
// The latest draft spec does not specify the RegionId anymore, it's
// now a reserved field.
RangeModulation rm = RangeModulation::dab_ensemble;
bool continuity = false;
// Only one of those must contain information, which
// must be consistent with RangeModulation
FrequencyInfoDab fi_dab;
FrequencyInfoDrm fi_drm;
FrequencyInfoFm fi_fm;
FrequencyInfoAmss fi_amss;
};
vec_sp_subchannel::iterator getSubchannel(
vec_sp_subchannel& subchannels,
int id);
vec_sp_component::iterator getComponent(
vec_sp_component& components,
uint32_t serviceId,
vec_sp_component::iterator current);
vec_sp_component::iterator getComponent(
vec_sp_component& components,
uint32_t serviceId);
vec_sp_service::iterator getService(
std::shared_ptr component,
vec_sp_service& services);