Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
demux.h
Go to the documentation of this file.
1 /*
2  * demux.h
3  *
4  * Copyright (c) 2002 Convergence GmbH
5  *
6  * based on code:
7  * Copyright (c) 2000 Nokia Research Center
8  * Tampere, FINLAND
9  *
10  * This program is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU Lesser General Public License
12  * as published by the Free Software Foundation; either version 2.1
13  * of the License, or (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU Lesser General Public License
21  * along with this program; if not, write to the Free Software
22  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23  *
24  */
25 
26 #ifndef __DEMUX_H
27 #define __DEMUX_H
28 
29 #include <linux/types.h>
30 #include <linux/errno.h>
31 #include <linux/list.h>
32 #include <linux/time.h>
33 #include <linux/dvb/dmx.h>
34 
35 /*--------------------------------------------------------------------------*/
36 /* Common definitions */
37 /*--------------------------------------------------------------------------*/
38 
39 /*
40  * DMX_MAX_FILTER_SIZE: Maximum length (in bytes) of a section/PES filter.
41  */
42 
43 #ifndef DMX_MAX_FILTER_SIZE
44 #define DMX_MAX_FILTER_SIZE 18
45 #endif
46 
47 /*
48  * DMX_MAX_SECFEED_SIZE: Maximum length (in bytes) of a private section feed filter.
49  */
50 
51 #ifndef DMX_MAX_SECTION_SIZE
52 #define DMX_MAX_SECTION_SIZE 4096
53 #endif
54 #ifndef DMX_MAX_SECFEED_SIZE
55 #define DMX_MAX_SECFEED_SIZE (DMX_MAX_SECTION_SIZE + 188)
56 #endif
57 
58 
59 /*
60  * enum dmx_success: Success codes for the Demux Callback API.
61  */
62 
64  DMX_OK = 0, /* Received Ok */
65  DMX_LENGTH_ERROR, /* Incorrect length */
66  DMX_OVERRUN_ERROR, /* Receiver ring buffer overrun */
67  DMX_CRC_ERROR, /* Incorrect CRC */
68  DMX_FRAME_ERROR, /* Frame alignment error */
69  DMX_FIFO_ERROR, /* Receiver FIFO overrun */
70  DMX_MISSED_ERROR /* Receiver missed packet */
71 } ;
72 
73 /*--------------------------------------------------------------------------*/
74 /* TS packet reception */
75 /*--------------------------------------------------------------------------*/
76 
77 /* TS filter type for set() */
78 
79 #define TS_PACKET 1 /* send TS packets (188 bytes) to callback (default) */
80 #define TS_PAYLOAD_ONLY 2 /* in case TS_PACKET is set, only send the TS
81  payload (<=184 bytes per packet) to callback */
82 #define TS_DECODER 4 /* send stream to built-in decoder (if present) */
83 #define TS_DEMUX 8 /* in case TS_PACKET is set, send the TS to
84  the demux device, not to the dvr device */
85 
86 /* PES type for filters which write to built-in decoder */
87 /* these should be kept identical to the types in dmx.h */
88 
90 { /* also send packets to decoder (if it exists) */
96 
114 
116 };
118 #define DMX_TS_PES_AUDIO DMX_TS_PES_AUDIO0
119 #define DMX_TS_PES_VIDEO DMX_TS_PES_VIDEO0
120 #define DMX_TS_PES_TELETEXT DMX_TS_PES_TELETEXT0
121 #define DMX_TS_PES_SUBTITLE DMX_TS_PES_SUBTITLE0
122 #define DMX_TS_PES_PCR DMX_TS_PES_PCR0
125 struct dmx_ts_feed {
126  int is_filtering; /* Set to non-zero when filtering in progress */
127  struct dmx_demux *parent; /* Back-pointer */
128  void *priv; /* Pointer to private data of the API client */
129  int (*set) (struct dmx_ts_feed *feed,
130  u16 pid,
131  int type,
132  enum dmx_ts_pes pes_type,
133  size_t circular_buffer_size,
134  struct timespec timeout);
135  int (*start_filtering) (struct dmx_ts_feed* feed);
136  int (*stop_filtering) (struct dmx_ts_feed* feed);
137 };
138 
139 /*--------------------------------------------------------------------------*/
140 /* Section reception */
141 /*--------------------------------------------------------------------------*/
147  struct dmx_section_feed* parent; /* Back-pointer */
148  void* priv; /* Pointer to private data of the API client */
149 };
152  int is_filtering; /* Set to non-zero when filtering in progress */
153  struct dmx_demux* parent; /* Back-pointer */
154  void* priv; /* Pointer to private data of the API client */
156  int check_crc;
162 
163  int (*set) (struct dmx_section_feed* feed,
164  u16 pid,
165  size_t circular_buffer_size,
166  int check_crc);
168  struct dmx_section_filter** filter);
171  int (*start_filtering) (struct dmx_section_feed* feed);
172  int (*stop_filtering) (struct dmx_section_feed* feed);
173 };
174 
175 /*--------------------------------------------------------------------------*/
176 /* Callback functions */
177 /*--------------------------------------------------------------------------*/
178 
179 typedef int (*dmx_ts_cb) ( const u8 * buffer1,
180  size_t buffer1_length,
181  const u8 * buffer2,
182  size_t buffer2_length,
183  struct dmx_ts_feed* source,
184  enum dmx_success success);
185 
186 typedef int (*dmx_section_cb) ( const u8 * buffer1,
187  size_t buffer1_len,
188  const u8 * buffer2,
189  size_t buffer2_len,
190  struct dmx_section_filter * source,
191  enum dmx_success success);
192 
193 /*--------------------------------------------------------------------------*/
194 /* DVB Front-End */
195 /*--------------------------------------------------------------------------*/
203  DMX_STREAM_0, /* external stream input, e.g. LVDS */
205  DMX_STREAM_2,
207 };
209 struct dmx_frontend {
210  struct list_head connectivity_list; /* List of front-ends that can
211  be connected to a particular
212  demux */
214 };
215 
216 /*--------------------------------------------------------------------------*/
217 /* MPEG-2 TS Demux */
218 /*--------------------------------------------------------------------------*/
219 
220 /*
221  * Flags OR'ed in the capabilities field of struct dmx_demux.
222  */
224 #define DMX_TS_FILTERING 1
225 #define DMX_PES_FILTERING 2
226 #define DMX_SECTION_FILTERING 4
227 #define DMX_MEMORY_BASED_FILTERING 8 /* write() available */
228 #define DMX_CRC_CHECKING 16
229 #define DMX_TS_DESCRAMBLING 32
230 
231 /*
232  * Demux resource type identifier.
233 */
234 
235 /*
236  * DMX_FE_ENTRY(): Casts elements in the list of registered
237  * front-ends from the generic type struct list_head
238  * to the type * struct dmx_frontend
239  *.
240 */
241 
242 #define DMX_FE_ENTRY(list) list_entry(list, struct dmx_frontend, connectivity_list)
244 struct dmx_demux {
245  u32 capabilities; /* Bitfield of capability flags */
246  struct dmx_frontend* frontend; /* Front-end connected to the demux */
247  void* priv; /* Pointer to private data of the API client */
248  int (*open) (struct dmx_demux* demux);
249  int (*close) (struct dmx_demux* demux);
250  int (*write) (struct dmx_demux* demux, const char __user *buf, size_t count);
251  int (*allocate_ts_feed) (struct dmx_demux* demux,
252  struct dmx_ts_feed** feed,
254  int (*release_ts_feed) (struct dmx_demux* demux,
255  struct dmx_ts_feed* feed);
256  int (*allocate_section_feed) (struct dmx_demux* demux,
257  struct dmx_section_feed** feed,
259  int (*release_section_feed) (struct dmx_demux* demux,
260  struct dmx_section_feed* feed);
261  int (*add_frontend) (struct dmx_demux* demux,
262  struct dmx_frontend* frontend);
263  int (*remove_frontend) (struct dmx_demux* demux,
265  struct list_head* (*get_frontends) (struct dmx_demux* demux);
266  int (*connect_frontend) (struct dmx_demux* demux,
267  struct dmx_frontend* frontend);
268  int (*disconnect_frontend) (struct dmx_demux* demux);
269 
270  int (*get_pes_pids) (struct dmx_demux* demux, u16 *pids);
271 
272  int (*get_caps) (struct dmx_demux* demux, struct dmx_caps *caps);
273 
274  int (*set_source) (struct dmx_demux* demux, const dmx_source_t *src);
275 
276  int (*get_stc) (struct dmx_demux* demux, unsigned int num,
277  u64 *stc, unsigned int *base);
278 };
279 
280 #endif /* #ifndef __DEMUX_H */