linux/drivers/media/video/hdpvr/hdpvr.h
<<
>>
Prefs
   1/*
   2 * Hauppauge HD PVR USB driver
   3 *
   4 * Copyright (C) 2008      Janne Grunau (j@jannau.net)
   5 *
   6 *      This program is free software; you can redistribute it and/or
   7 *      modify it under the terms of the GNU General Public License as
   8 *      published by the Free Software Foundation, version 2.
   9 *
  10 */
  11
  12#include <linux/usb.h>
  13#include <linux/i2c.h>
  14#include <linux/mutex.h>
  15#include <linux/workqueue.h>
  16#include <linux/videodev2.h>
  17
  18#include <media/v4l2-device.h>
  19
  20#define HDPVR_MAJOR_VERSION 0
  21#define HDPVR_MINOR_VERSION 2
  22#define HDPVR_RELEASE 0
  23#define HDPVR_VERSION \
  24        KERNEL_VERSION(HDPVR_MAJOR_VERSION, HDPVR_MINOR_VERSION, HDPVR_RELEASE)
  25
  26#define HDPVR_MAX 8
  27
  28/* Define these values to match your devices */
  29#define HD_PVR_VENDOR_ID        0x2040
  30#define HD_PVR_PRODUCT_ID       0x4900
  31#define HD_PVR_PRODUCT_ID1      0x4901
  32#define HD_PVR_PRODUCT_ID2      0x4902
  33#define HD_PVR_PRODUCT_ID3      0x4982
  34
  35#define UNSET    (-1U)
  36
  37#define NUM_BUFFERS 64
  38
  39#define HDPVR_FIRMWARE_VERSION          0x8
  40#define HDPVR_FIRMWARE_VERSION_AC3      0xd
  41
  42/* #define HDPVR_DEBUG */
  43
  44extern int hdpvr_debug;
  45
  46#define MSG_INFO        1
  47#define MSG_BUFFER      2
  48
  49struct hdpvr_options {
  50        u8      video_std;
  51        u8      video_input;
  52        u8      audio_input;
  53        u8      bitrate;        /* in 100kbps */
  54        u8      peak_bitrate;   /* in 100kbps */
  55        u8      bitrate_mode;
  56        u8      gop_mode;
  57        enum v4l2_mpeg_audio_encoding   audio_codec;
  58        u8      brightness;
  59        u8      contrast;
  60        u8      hue;
  61        u8      saturation;
  62        u8      sharpness;
  63};
  64
  65/* Structure to hold all of our device specific stuff */
  66struct hdpvr_device {
  67        /* the v4l device for this device */
  68        struct video_device     *video_dev;
  69        /* the usb device for this device */
  70        struct usb_device       *udev;
  71        /* v4l2-device unused */
  72        struct v4l2_device      v4l2_dev;
  73
  74        /* the max packet size of the bulk endpoint */
  75        size_t                  bulk_in_size;
  76        /* the address of the bulk in endpoint */
  77        __u8                    bulk_in_endpointAddr;
  78
  79        /* holds the current device status */
  80        __u8                    status;
  81        /* count the number of openers */
  82        uint                    open_count;
  83
  84        /* holds the cureent set options */
  85        struct hdpvr_options    options;
  86
  87        uint                    flags;
  88
  89        /* synchronize I/O */
  90        struct mutex            io_mutex;
  91        /* available buffers */
  92        struct list_head        free_buff_list;
  93        /* in progress buffers */
  94        struct list_head        rec_buff_list;
  95        /* waitqueue for buffers */
  96        wait_queue_head_t       wait_buffer;
  97        /* waitqueue for data */
  98        wait_queue_head_t       wait_data;
  99        /**/
 100        struct workqueue_struct *workqueue;
 101        /**/
 102        struct work_struct      worker;
 103
 104        /* I2C adapter */
 105        struct i2c_adapter      *i2c_adapter;
 106        /* I2C lock */
 107        struct mutex            i2c_mutex;
 108
 109        /* usb control transfer buffer and lock */
 110        struct mutex            usbc_mutex;
 111        u8                      *usbc_buf;
 112};
 113
 114static inline struct hdpvr_device *to_hdpvr_dev(struct v4l2_device *v4l2_dev)
 115{
 116        return container_of(v4l2_dev, struct hdpvr_device, v4l2_dev);
 117}
 118
 119
 120/* buffer one bulk urb of data */
 121struct hdpvr_buffer {
 122        struct list_head        buff_list;
 123
 124        struct urb              *urb;
 125
 126        struct hdpvr_device     *dev;
 127
 128        uint                    pos;
 129
 130        __u8                    status;
 131};
 132
 133/* */
 134
 135struct hdpvr_video_info {
 136        u16     width;
 137        u16     height;
 138        u8      fps;
 139};
 140
 141enum {
 142        STATUS_UNINITIALIZED    = 0,
 143        STATUS_IDLE,
 144        STATUS_STARTING,
 145        STATUS_SHUTTING_DOWN,
 146        STATUS_STREAMING,
 147        STATUS_ERROR,
 148        STATUS_DISCONNECTED,
 149};
 150
 151enum {
 152        HDPVR_FLAG_AC3_CAP = 1,
 153};
 154
 155enum {
 156        BUFSTAT_UNINITIALIZED = 0,
 157        BUFSTAT_AVAILABLE,
 158        BUFSTAT_INPROGRESS,
 159        BUFSTAT_READY,
 160};
 161
 162#define CTRL_START_STREAMING_VALUE      0x0700
 163#define CTRL_STOP_STREAMING_VALUE       0x0800
 164#define CTRL_BITRATE_VALUE              0x1000
 165#define CTRL_BITRATE_MODE_VALUE         0x1200
 166#define CTRL_GOP_MODE_VALUE             0x1300
 167#define CTRL_VIDEO_INPUT_VALUE          0x1500
 168#define CTRL_VIDEO_STD_TYPE             0x1700
 169#define CTRL_AUDIO_INPUT_VALUE          0x2500
 170#define CTRL_BRIGHTNESS                 0x2900
 171#define CTRL_CONTRAST                   0x2a00
 172#define CTRL_HUE                        0x2b00
 173#define CTRL_SATURATION                 0x2c00
 174#define CTRL_SHARPNESS                  0x2d00
 175#define CTRL_LOW_PASS_FILTER_VALUE      0x3100
 176
 177#define CTRL_DEFAULT_INDEX              0x0003
 178
 179
 180        /* :0 s 38 01 1000 0003 0004 4 = 0a00ca00
 181         * BITRATE SETTING
 182         *   1st and 2nd byte (little endian): average bitrate in 100 000 bit/s
 183         *                                     min: 1 mbit/s, max: 13.5 mbit/s
 184         *   3rd and 4th byte (little endian): peak bitrate in 100 000 bit/s
 185         *                                     min: average + 100kbit/s,
 186         *                                      max: 20.2 mbit/s
 187         */
 188
 189        /* :0 s 38 01 1200 0003 0001 1 = 02
 190         * BIT RATE MODE
 191         *  constant = 1, variable (peak) = 2, variable (average) = 3
 192         */
 193
 194        /* :0 s 38 01 1300 0003 0001 1 = 03
 195         * GOP MODE (2 bit)
 196         *    low bit 0/1: advanced/simple GOP
 197         *   high bit 0/1: IDR(4/32/128) / no IDR (4/32/0)
 198         */
 199
 200        /* :0 s 38 01 1700 0003 0001 1 = 00
 201         * VIDEO STANDARD or FREQUNCY 0 = 60hz, 1 = 50hz
 202         */
 203
 204        /* :0 s 38 01 3100 0003 0004 4 = 03030000
 205         * FILTER CONTROL
 206         *   1st byte luma low pass filter strength,
 207         *   2nd byte chroma low pass filter strength,
 208         *   3rd byte MF enable chroma, min=0, max=1
 209         *   4th byte n
 210         */
 211
 212
 213        /* :0 s 38 b9 0001 0000 0000 0 */
 214
 215
 216
 217/* :0 s 38 d3 0000 0000 0001 1 = 00 */
 218/*              ret = usb_control_msg(dev->udev, */
 219/*                                    usb_sndctrlpipe(dev->udev, 0), */
 220/*                                    0xd3, 0x38, */
 221/*                                    0, 0, */
 222/*                                    "\0", 1, */
 223/*                                    1000); */
 224
 225/*              info("control request returned %d", ret); */
 226/*              msleep(5000); */
 227
 228
 229        /* :0 s b8 81 1400 0003 0005 5 <
 230         * :0 0 5 = d0024002 19
 231         * QUERY FRAME SIZE AND RATE
 232         *   1st and 2nd byte (little endian): horizontal resolution
 233         *   3rd and 4th byte (little endian): vertical resolution
 234         *   5th byte: frame rate
 235         */
 236
 237        /* :0 s b8 81 1800 0003 0003 3 <
 238         * :0 0 3 = 030104
 239         * QUERY SIGNAL AND DETECTED LINES, maybe INPUT
 240         */
 241
 242enum hdpvr_video_std {
 243        HDPVR_60HZ = 0,
 244        HDPVR_50HZ,
 245};
 246
 247enum hdpvr_video_input {
 248        HDPVR_COMPONENT = 0,
 249        HDPVR_SVIDEO,
 250        HDPVR_COMPOSITE,
 251        HDPVR_VIDEO_INPUTS
 252};
 253
 254enum hdpvr_audio_inputs {
 255        HDPVR_RCA_BACK = 0,
 256        HDPVR_RCA_FRONT,
 257        HDPVR_SPDIF,
 258        HDPVR_AUDIO_INPUTS
 259};
 260
 261enum hdpvr_bitrate_mode {
 262        HDPVR_CONSTANT = 1,
 263        HDPVR_VARIABLE_PEAK,
 264        HDPVR_VARIABLE_AVERAGE,
 265};
 266
 267enum hdpvr_gop_mode {
 268        HDPVR_ADVANCED_IDR_GOP = 0,
 269        HDPVR_SIMPLE_IDR_GOP,
 270        HDPVR_ADVANCED_NOIDR_GOP,
 271        HDPVR_SIMPLE_NOIDR_GOP,
 272};
 273
 274void hdpvr_delete(struct hdpvr_device *dev);
 275
 276/*========================================================================*/
 277/* hardware control functions */
 278int hdpvr_set_options(struct hdpvr_device *dev);
 279
 280int hdpvr_set_bitrate(struct hdpvr_device *dev);
 281
 282int hdpvr_set_audio(struct hdpvr_device *dev, u8 input,
 283                    enum v4l2_mpeg_audio_encoding codec);
 284
 285int hdpvr_config_call(struct hdpvr_device *dev, uint value,
 286                      unsigned char valbuf);
 287
 288struct hdpvr_video_info *get_video_info(struct hdpvr_device *dev);
 289
 290/* :0 s b8 81 1800 0003 0003 3 < */
 291/* :0 0 3 = 0301ff */
 292int get_input_lines_info(struct hdpvr_device *dev);
 293
 294
 295/*========================================================================*/
 296/* v4l2 registration */
 297int hdpvr_register_videodev(struct hdpvr_device *dev, struct device *parent,
 298                            int devnumber);
 299
 300int hdpvr_cancel_queue(struct hdpvr_device *dev);
 301
 302/*========================================================================*/
 303/* i2c adapter registration */
 304int hdpvr_register_i2c_adapter(struct hdpvr_device *dev);
 305
 306/*========================================================================*/
 307/* buffer management */
 308int hdpvr_free_buffers(struct hdpvr_device *dev);
 309int hdpvr_alloc_buffers(struct hdpvr_device *dev, uint count);
 310