drivers/media/usb/hdpvr/hdpvr.h

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