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 63enum dmx_success { 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 89enum dmx_ts_pes 90{ /* also send packets to decoder (if it exists) */ 91 DMX_TS_PES_AUDIO0, 92 DMX_TS_PES_VIDEO0, 93 DMX_TS_PES_TELETEXT0, 94 DMX_TS_PES_SUBTITLE0, 95 DMX_TS_PES_PCR0, 96 97 DMX_TS_PES_AUDIO1, 98 DMX_TS_PES_VIDEO1, 99 DMX_TS_PES_TELETEXT1, 100 DMX_TS_PES_SUBTITLE1, 101 DMX_TS_PES_PCR1, 102 103 DMX_TS_PES_AUDIO2, 104 DMX_TS_PES_VIDEO2, 105 DMX_TS_PES_TELETEXT2, 106 DMX_TS_PES_SUBTITLE2, 107 DMX_TS_PES_PCR2, 108 109 DMX_TS_PES_AUDIO3, 110 DMX_TS_PES_VIDEO3, 111 DMX_TS_PES_TELETEXT3, 112 DMX_TS_PES_SUBTITLE3, 113 DMX_TS_PES_PCR3, 114 115 DMX_TS_PES_OTHER 116}; 117 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 123 124 125struct 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/*--------------------------------------------------------------------------*/ 142 143struct dmx_section_filter { 144 u8 filter_value [DMX_MAX_FILTER_SIZE]; 145 u8 filter_mask [DMX_MAX_FILTER_SIZE]; 146 u8 filter_mode [DMX_MAX_FILTER_SIZE]; 147 struct dmx_section_feed* parent; /* Back-pointer */ 148 void* priv; /* Pointer to private data of the API client */ 149}; 150 151struct dmx_section_feed { 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 */ 155 156 int check_crc; 157 u32 crc_val; 158 159 u8 *secbuf; 160 u8 secbuf_base[DMX_MAX_SECFEED_SIZE]; 161 u16 secbufp, seclen, tsfeedp; 162 163 int (*set) (struct dmx_section_feed* feed, 164 u16 pid, 165 size_t circular_buffer_size, 166 int check_crc); 167 int (*allocate_filter) (struct dmx_section_feed* feed, 168 struct dmx_section_filter** filter); 169 int (*release_filter) (struct dmx_section_feed* feed, 170 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 179typedef 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 186typedef 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/*--------------------------------------------------------------------------*/ 196 197enum dmx_frontend_source { 198 DMX_MEMORY_FE, 199 DMX_FRONTEND_0, 200 DMX_FRONTEND_1, 201 DMX_FRONTEND_2, 202 DMX_FRONTEND_3, 203 DMX_STREAM_0, /* external stream input, e.g. LVDS */ 204 DMX_STREAM_1, 205 DMX_STREAM_2, 206 DMX_STREAM_3 207}; 208 209struct dmx_frontend { 210 struct list_head connectivity_list; /* List of front-ends that can 211 be connected to a particular 212 demux */ 213 enum dmx_frontend_source source; 214}; 215 216/*--------------------------------------------------------------------------*/ 217/* MPEG-2 TS Demux */ 218/*--------------------------------------------------------------------------*/ 219 220/* 221 * Flags OR'ed in the capabilities field of struct dmx_demux. 222 */ 223 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) 243 244struct 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, 253 dmx_ts_cb callback); 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, 258 dmx_section_cb callback); 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, 264 struct dmx_frontend* frontend); 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 */ 281