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 | |