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); 325