vdr  2.2.0
channels.h
Go to the documentation of this file.
1 /*
2  * channels.h: Channel handling
3  *
4  * See the main source file 'vdr.c' for copyright information and
5  * how to reach the author.
6  *
7  * $Id: channels.h 3.3 2015/02/01 13:30:26 kls Exp $
8  */
9 
10 #ifndef __CHANNELS_H
11 #define __CHANNELS_H
12 
13 #include "config.h"
14 #include "sources.h"
15 #include "thread.h"
16 #include "tools.h"
17 
18 #define ISTRANSPONDER(f1, f2) (abs((f1) - (f2)) < 4) //XXX
19 
20 #define CHANNELMOD_NONE 0x00
21 #define CHANNELMOD_ALL 0xFF
22 #define CHANNELMOD_NAME 0x01
23 #define CHANNELMOD_PIDS 0x02
24 #define CHANNELMOD_ID 0x04
25 #define CHANNELMOD_AUX 0x08
26 #define CHANNELMOD_CA 0x10
27 #define CHANNELMOD_TRANSP 0x20
28 #define CHANNELMOD_LANGS 0x40
29 #define CHANNELMOD_RETUNE (CHANNELMOD_PIDS | CHANNELMOD_CA | CHANNELMOD_TRANSP)
30 
31 #define CHANNELSMOD_NONE 0
32 #define CHANNELSMOD_AUTO 1
33 #define CHANNELSMOD_USER 2
34 
35 #define MAXAPIDS 32 // audio
36 #define MAXDPIDS 16 // dolby (AC3 + DTS)
37 #define MAXSPIDS 32 // subtitles
38 #define MAXCAIDS 12 // conditional access
39 
40 #define MAXLANGCODE1 4 // a 3 letter language code, zero terminated
41 #define MAXLANGCODE2 8 // up to two 3 letter language codes, separated by '+' and zero terminated
42 
43 #define CA_FTA 0x0000
44 #define CA_DVB_MIN 0x0001
45 #define CA_DVB_MAX 0x000F
46 #define CA_USER_MIN 0x0010
47 #define CA_USER_MAX 0x00FF
48 #define CA_ENCRYPTED_MIN 0x0100
49 #define CA_ENCRYPTED_MAX 0xFFFF
50 
51 struct tChannelID {
52 private:
53  int source;
54  int nid;
55  int tid;
56  int sid;
57  int rid;
58 public:
59  tChannelID(void) { source = nid = tid = sid = rid = 0; }
60  tChannelID(int Source, int Nid, int Tid, int Sid, int Rid = 0) { source = Source; nid = Nid; tid = Tid; sid = Sid; rid = Rid; }
61  bool operator== (const tChannelID &arg) const { return source == arg.source && nid == arg.nid && tid == arg.tid && sid == arg.sid && rid == arg.rid; }
62  bool Valid(void) const { return (nid || tid) && sid; } // rid is optional and source may be 0//XXX source may not be 0???
63  tChannelID &ClrRid(void) { rid = 0; return *this; }
65  int Source(void) const { return source; }
66  int Nid(void) const { return nid; }
67  int Tid(void) const { return tid; }
68  int Sid(void) const { return sid; }
69  int Rid(void) const { return rid; }
70  static tChannelID FromString(const char *s);
71  cString ToString(void) const;
72  static const tChannelID InvalidID;
73  };
74 
75 class cChannel;
76 
77 class cLinkChannel : public cListObject {
78 private:
80 public:
82  cChannel *Channel(void) { return channel; }
83  };
84 
85 class cLinkChannels : public cList<cLinkChannel> {
86  };
87 
88 class cSchedule;
89 
90 class cChannel : public cListObject {
91  friend class cSchedules;
92  friend class cMenuEditChannel;
93  friend class cDvbSourceParam;
94 private:
95  static cString ToText(const cChannel *Channel);
96  char *name;
97  char *shortName;
98  char *provider;
99  char *portalName;
101  int frequency; // MHz
102  int source;
103  int srate;
104  int vpid;
105  int ppid;
106  int vtype;
107  int apids[MAXAPIDS + 1]; // list is zero-terminated
108  int atypes[MAXAPIDS + 1]; // list is zero-terminated
110  int dpids[MAXDPIDS + 1]; // list is zero-terminated
111  int dtypes[MAXAPIDS + 1]; // list is zero-terminated
113  int spids[MAXSPIDS + 1]; // list is zero-terminated
118  int tpid;
119  int caids[MAXCAIDS + 1]; // list is zero-terminated
120  int nid;
121  int tid;
122  int sid;
123  int rid;
124  int lcn; // Logical channel number assigned by data stream (or -1 if not available)
125  int number; // Sequence number assigned on load
126  bool groupSep;
132  time_t seen; // When this channel was last seen in the SDT of its transponder
133  mutable const cSchedule *schedule;
136  cString TransponderDataToString(void) const;
137 public:
138  cChannel(void);
139  cChannel(const cChannel &Channel);
140  ~cChannel();
141  cChannel& operator= (const cChannel &Channel);
142  cString ToText(void) const;
143  bool Parse(const char *s);
144  bool Save(FILE *f);
145  const char *Name(void) const;
146  const char *ShortName(bool OrName = false) const;
147  const char *Provider(void) const { return provider; }
148  const char *PortalName(void) const { return portalName; }
149  int Frequency(void) const { return frequency; }
150  int Transponder(void) const;
151  static int Transponder(int Frequency, char Polarization);
152  int Source(void) const { return source; }
153  int Srate(void) const { return srate; }
154  int Vpid(void) const { return vpid; }
155  int Ppid(void) const { return ppid; }
156  int Vtype(void) const { return vtype; }
157  const int *Apids(void) const { return apids; }
158  const int *Dpids(void) const { return dpids; }
159  const int *Spids(void) const { return spids; }
160  int Apid(int i) const { return (0 <= i && i < MAXAPIDS) ? apids[i] : 0; }
161  int Dpid(int i) const { return (0 <= i && i < MAXDPIDS) ? dpids[i] : 0; }
162  int Spid(int i) const { return (0 <= i && i < MAXSPIDS) ? spids[i] : 0; }
163  const char *Alang(int i) const { return (0 <= i && i < MAXAPIDS) ? alangs[i] : ""; }
164  const char *Dlang(int i) const { return (0 <= i && i < MAXDPIDS) ? dlangs[i] : ""; }
165  const char *Slang(int i) const { return (0 <= i && i < MAXSPIDS) ? slangs[i] : ""; }
166  int Atype(int i) const { return (0 <= i && i < MAXAPIDS) ? atypes[i] : 0; }
167  int Dtype(int i) const { return (0 <= i && i < MAXDPIDS) ? dtypes[i] : 0; }
168  uchar SubtitlingType(int i) const { return (0 <= i && i < MAXSPIDS) ? subtitlingTypes[i] : uchar(0); }
169  uint16_t CompositionPageId(int i) const { return (0 <= i && i < MAXSPIDS) ? compositionPageIds[i] : uint16_t(0); }
170  uint16_t AncillaryPageId(int i) const { return (0 <= i && i < MAXSPIDS) ? ancillaryPageIds[i] : uint16_t(0); }
171  int Tpid(void) const { return tpid; }
172  const int *Caids(void) const { return caids; }
173  int Ca(int Index = 0) const { return Index < MAXCAIDS ? caids[Index] : 0; }
174  int Nid(void) const { return nid; }
175  int Tid(void) const { return tid; }
176  int Sid(void) const { return sid; }
177  int Rid(void) const { return rid; }
178  int Lcn(void) const { return lcn; }
179  int Number(void) const { return number; }
180  void SetNumber(int Number) { number = Number; }
181  bool GroupSep(void) const { return groupSep; }
182  const char *Parameters(void) const { return parameters; }
183  const cLinkChannels* LinkChannels(void) const { return linkChannels; }
184  const cChannel *RefChannel(void) const { return refChannel; }
185  bool IsAtsc(void) const { return cSource::IsAtsc(source); }
186  bool IsCable(void) const { return cSource::IsCable(source); }
187  bool IsSat(void) const { return cSource::IsSat(source); }
188  bool IsTerr(void) const { return cSource::IsTerr(source); }
189  bool IsSourceType(char Source) const { return cSource::IsType(source, Source); }
190  tChannelID GetChannelID(void) const { return tChannelID(source, nid, (nid || tid) ? tid : Transponder(), sid, rid); }
191  bool HasTimer(void) const;
192  int Modification(int Mask = CHANNELMOD_ALL);
193  time_t Seen(void) { return seen; }
194  void CopyTransponderData(const cChannel *Channel);
195  bool SetTransponderData(int Source, int Frequency, int Srate, const char *Parameters, bool Quiet = false);
196  void SetId(int Nid, int Tid, int Sid, int Rid = 0);
197  void SetLcn(int Lcn);
198  void SetName(const char *Name, const char *ShortName, const char *Provider);
199  void SetPortalName(const char *PortalName);
200  void SetPids(int Vpid, int Ppid, int Vtype, int *Apids, int *Atypes, char ALangs[][MAXLANGCODE2], int *Dpids, int *Dtypes, char DLangs[][MAXLANGCODE2], int *Spids, char SLangs[][MAXLANGCODE2], int Tpid);
201  void SetCaIds(const int *CaIds); // list must be zero-terminated
202  void SetCaDescriptors(int Level);
205  void SetSubtitlingDescriptors(uchar *SubtitlingTypes, uint16_t *CompositionPageIds, uint16_t *AncillaryPageIds);
206  void SetSeen(void);
207  };
208 
209 class cChannels : public cRwLock, public cConfig<cChannel> {
210 private:
214  int modified;
217  void DeleteDuplicateChannels(void);
218 public:
219  cChannels(void);
220  bool Load(const char *FileName, bool AllowComments = false, bool MustExist = false);
221  void HashChannel(cChannel *Channel);
222  void UnhashChannel(cChannel *Channel);
223  int GetNextGroup(int Idx); // Get next channel group
224  int GetPrevGroup(int Idx); // Get previous channel group
225  int GetNextNormal(int Idx); // Get next normal channel (not group)
226  int GetPrevNormal(int Idx); // Get previous normal channel (not group)
227  void ReNumber(void); // Recalculate 'number' based on channel type
228  cChannel *GetByNumber(int Number, int SkipGap = 0);
229  cChannel *GetByServiceID(int Source, int Transponder, unsigned short ServiceID);
230  cChannel *GetByChannelID(tChannelID ChannelID, bool TryWithoutRid = false, bool TryWithoutPolarization = false);
232  int BeingEdited(void) { return beingEdited; }
233  void IncBeingEdited(void) { beingEdited++; }
234  void DecBeingEdited(void) { beingEdited--; }
235  bool HasUniqueChannelID(cChannel *NewChannel, cChannel *OldChannel = NULL);
236  bool SwitchTo(int Number);
237  int MaxNumber(void) { return maxNumber; }
238  int MaxChannelNameLength(void);
239  int MaxShortChannelNameLength(void);
240  void SetModified(bool ByUser = false);
241  int Modified(void);
245  cChannel *NewChannel(const cChannel *Transponder, const char *Name, const char *ShortName, const char *Provider, int Nid, int Tid, int Sid, int Rid = 0);
246  void MarkObsoleteChannels(int Source, int Nid, int Tid);
247  };
248 
249 extern cChannels Channels;
250 
251 cString ChannelString(const cChannel *Channel, int Number);
252 
253 #endif //__CHANNELS_H
cChannel * channel
Definition: channels.h:79
uint16_t AncillaryPageId(int i) const
Definition: channels.h:170
int sid
Definition: channels.h:56
unsigned char uchar
Definition: tools.h:30
int Tid(void) const
Definition: channels.h:175
void SetId(int Nid, int Tid, int Sid, int Rid=0)
Definition: channels.c:232
int Modified(void)
Returns 0 if no channels have been modified, 1 if an automatic modification has been made...
Definition: channels.c:1022
int Vpid(void) const
Definition: channels.h:154
int Number(void) const
Definition: channels.h:179
const int * Dpids(void) const
Definition: channels.h:158
int tid
Definition: channels.h:121
static tChannelID FromString(const char *s)
Definition: channels.c:25
int Index(void) const
Definition: tools.c:1989
time_t seen
Definition: channels.h:132
int Dtype(int i) const
Definition: channels.h:167
int GetPrevGroup(int Idx)
Definition: channels.c:867
void SetNumber(int Number)
Definition: channels.h:180
int MaxShortChannelNameLength(void)
Definition: channels.c:1005
int MaxNumber(void)
Definition: channels.h:237
const cLinkChannels * LinkChannels(void) const
Definition: channels.h:183
const char * PortalName(void) const
Definition: channels.h:148
int Rid(void) const
Definition: channels.h:69
void CopyTransponderData(const cChannel *Channel)
Definition: channels.c:186
int Nid(void) const
Definition: channels.h:174
uint16_t compositionPageIds[MAXSPIDS]
Definition: channels.h:116
uchar SubtitlingType(int i) const
Definition: channels.h:168
int Spid(int i) const
Definition: channels.h:162
uint16_t ancillaryPageIds[MAXSPIDS]
Definition: channels.h:117
int Ca(int Index=0) const
Definition: channels.h:173
int Dpid(int i) const
Definition: channels.h:161
int modification
Definition: channels.h:131
tChannelID(void)
Definition: channels.h:59
int tid
Definition: channels.h:55
static bool IsTerr(int Code)
Definition: sources.h:58
int ppid
Definition: channels.h:105
int maxChannelNameLength
Definition: channels.h:212
void MarkObsoleteChannels(int Source, int Nid, int Tid)
Definition: channels.c:1048
int Srate(void) const
Definition: channels.h:153
uchar subtitlingTypes[MAXSPIDS]
Definition: channels.h:115
const char * ShortName(bool OrName=false) const
Definition: channels.c:132
cChannel & operator=(const cChannel &Channel)
Definition: channels.c:109
Definition: tools.h:489
bool GroupSep(void) const
Definition: channels.h:181
int Sid(void) const
Definition: channels.h:68
tChannelID & ClrPolarization(void)
Definition: channels.c:49
char * name
Definition: channels.h:96
void ReNumber(void)
Definition: channels.c:891
int spids[MAXSPIDS+1]
Definition: channels.h:113
int MaxChannelNameLength(void)
Definition: channels.c:994
cString nameSource
Definition: channels.h:128
const char * Dlang(int i) const
Definition: channels.h:164
int nid
actually the "original" network id
Definition: channels.h:54
int Ppid(void) const
Definition: channels.h:155
int Transponder(void) const
Returns the transponder frequency in MHz, plus the polarization in case of sat.
Definition: channels.c:157
bool groupSep
Definition: channels.h:126
int nid
Definition: channels.h:120
const cSchedule * schedule
Definition: channels.h:133
char * provider
Definition: channels.h:98
const char * FileName(void)
Definition: config.h:119
const char * Alang(int i) const
Definition: channels.h:163
int maxShortChannelNameLength
Definition: channels.h:213
bool Save(FILE *f)
Definition: channels.c:787
int tpid
Definition: channels.h:118
const char * Parameters(void) const
Definition: channels.h:182
bool Load(const char *FileName, bool AllowComments=false, bool MustExist=false)
Definition: channels.c:839
bool SetTransponderData(int Source, int Frequency, int Srate, const char *Parameters, bool Quiet=false)
Definition: channels.c:196
#define CHANNELMOD_ALL
Definition: channels.h:21
cChannel * Channel(void)
Definition: channels.h:82
char * shortName
Definition: channels.h:97
const char * Name(void) const
Definition: channels.c:122
cChannel * NewChannel(const cChannel *Transponder, const char *Name, const char *ShortName, const char *Provider, int Nid, int Tid, int Sid, int Rid=0)
Definition: channels.c:1029
void SetName(const char *Name, const char *ShortName, const char *Provider)
Definition: channels.c:260
int Source(void) const
Definition: channels.h:152
time_t Seen(void)
Definition: channels.h:193
const int * Caids(void) const
Definition: channels.h:172
int Rid(void) const
Definition: channels.h:177
char alangs[MAXAPIDS][MAXLANGCODE2]
Definition: channels.h:109
cChannel(void)
Definition: channels.c:58
bool Parse(const char *s)
Definition: channels.c:581
static bool IsAtsc(int Code)
Definition: sources.h:55
void IncBeingEdited(void)
Definition: channels.h:233
tChannelID(int Source, int Nid, int Tid, int Sid, int Rid=0)
Definition: channels.h:60
int GetNextNormal(int Idx)
Definition: channels.c:875
int source
Definition: channels.h:53
int Tpid(void) const
Definition: channels.h:171
int GetPrevNormal(int Idx)
Definition: channels.c:883
void SetCaDescriptors(int Level)
Definition: channels.c:450
cChannels(void)
Definition: channels.c:812
int __EndData__
Definition: channels.h:127
char dlangs[MAXDPIDS][MAXLANGCODE2]
Definition: channels.h:112
int Atype(int i) const
Definition: channels.h:166
static bool IsSat(int Code)
Definition: sources.h:57
int atypes[MAXAPIDS+1]
Definition: channels.h:108
int rid
Definition: channels.h:123
tChannelID GetChannelID(void) const
Definition: channels.h:190
int frequency
Definition: channels.h:101
void SetModified(bool ByUser=false)
Definition: channels.c:1016
int GetNextGroup(int Idx)
Definition: channels.c:859
cString TransponderDataToString(void) const
Definition: channels.c:512
void SetLcn(int Lcn)
Definition: channels.c:251
const char * Provider(void) const
Definition: channels.h:147
cChannel * GetByServiceID(int Source, int Transponder, unsigned short ServiceID)
Definition: channels.c:924
int __BeginData__
Definition: channels.h:100
const cChannel * RefChannel(void) const
Definition: channels.h:184
int Frequency(void) const
Returns the actual frequency, as given in 'channels.conf'.
Definition: channels.h:149
void SetSubtitlingDescriptors(uchar *SubtitlingTypes, uint16_t *CompositionPageIds, uint16_t *AncillaryPageIds)
Definition: channels.c:408
cChannel * GetByChannelID(tChannelID ChannelID, bool TryWithoutRid=false, bool TryWithoutPolarization=false)
Definition: channels.c:937
int vpid
Definition: channels.h:104
#define MAXLANGCODE2
Definition: channels.h:41
bool HasTimer(void) const
Definition: channels.c:170
bool Valid(void) const
Definition: channels.h:62
int sid
Definition: channels.h:122
static bool IsType(int Code, char Source)
Definition: sources.h:59
bool IsSat(void) const
Definition: channels.h:187
cString shortNameSource
Definition: channels.h:129
const int * Apids(void) const
Definition: channels.h:157
void DecBeingEdited(void)
Definition: channels.h:234
void SetLinkChannels(cLinkChannels *LinkChannels)
Definition: channels.c:460
bool HasUniqueChannelID(cChannel *NewChannel, cChannel *OldChannel=NULL)
Definition: channels.c:978
#define MAXDPIDS
Definition: channels.h:36
cString ToString(void) const
Definition: channels.c:42
void SetRefChannel(cChannel *RefChannel)
Definition: channels.c:507
int dpids[MAXDPIDS+1]
Definition: channels.h:110
cString ChannelString(const cChannel *Channel, int Number)
Definition: channels.c:1061
bool IsTerr(void) const
Definition: channels.h:188
cChannel * GetByNumber(int Number, int SkipGap=0)
Definition: channels.c:909
Definition: thread.h:53
void DeleteDuplicateChannels(void)
Definition: channels.c:820
Definition: epg.h:143
bool IsSourceType(char Source) const
Definition: channels.h:189
static bool IsCable(int Code)
Definition: sources.h:56
uint16_t CompositionPageId(int i) const
Definition: channels.h:169
int Apid(int i) const
Definition: channels.h:160
~cChannel()
Definition: channels.c:85
int maxNumber
Definition: channels.h:211
int source
Definition: channels.h:102
cString parameters
Definition: channels.h:130
int rid
Definition: channels.h:57
char slangs[MAXSPIDS][MAXLANGCODE2]
Definition: channels.h:114
#define MAXSPIDS
Definition: channels.h:37
int vtype
Definition: channels.h:106
int caids[MAXCAIDS+1]
Definition: channels.h:119
const char * Slang(int i) const
Definition: channels.h:165
bool operator==(const tChannelID &arg) const
Definition: channels.h:61
cHash< cChannel > channelsHashSid
Definition: channels.h:216
cChannels Channels
Definition: channels.c:810
int Tid(void) const
Definition: channels.h:67
cChannel * GetByTransponderID(tChannelID ChannelID)
Definition: channels.c:966
static const tChannelID InvalidID
Definition: channels.h:72
int beingEdited
Definition: channels.h:215
int Modification(int Mask=CHANNELMOD_ALL)
Definition: channels.c:179
bool SwitchTo(int Number)
Definition: channels.c:988
const int * Spids(void) const
Definition: channels.h:159
void UnhashChannel(cChannel *Channel)
Definition: channels.c:854
cChannel * refChannel
Definition: channels.h:135
int modified
Definition: channels.h:214
int Lcn(void) const
Definition: channels.h:178
bool IsCable(void) const
Definition: channels.h:186
int number
Definition: channels.h:125
cLinkChannel(cChannel *Channel)
Definition: channels.h:81
#define MAXCAIDS
Definition: channels.h:38
void SetPids(int Vpid, int Ppid, int Vtype, int *Apids, int *Atypes, char ALangs[][MAXLANGCODE2], int *Dpids, int *Dtypes, char DLangs[][MAXLANGCODE2], int *Spids, char SLangs[][MAXLANGCODE2], int Tpid)
Definition: channels.c:340
int Sid(void) const
Definition: channels.h:176
void SetPortalName(const char *PortalName)
Definition: channels.c:286
tChannelID & ClrRid(void)
Definition: channels.h:63
cLinkChannels * linkChannels
Definition: channels.h:134
char * portalName
Definition: channels.h:99
void SetSeen(void)
Definition: channels.c:424
bool IsAtsc(void) const
Definition: channels.h:185
int Vtype(void) const
Definition: channels.h:156
int BeingEdited(void)
Definition: channels.h:232
void SetCaIds(const int *CaIds)
Definition: channels.c:429
int lcn
Definition: channels.h:124
cString ToText(void) const
Definition: channels.c:576
int srate
Definition: channels.h:103
void HashChannel(cChannel *Channel)
Definition: channels.c:849
Definition: tools.h:168
int Source(void) const
Definition: channels.h:65
int apids[MAXAPIDS+1]
Definition: channels.h:107
#define MAXAPIDS
Definition: channels.h:35
int Nid(void) const
Definition: channels.h:66
int dtypes[MAXAPIDS+1]
Definition: channels.h:111