bt8xx.h revision 1.2 1 /* $NetBSD: bt8xx.h,v 1.2 2000/05/07 03:01:59 wiz Exp $ */
2
3 /* This file is merged from ioctl_meteor.h and ioctl_bt848.h from FreeBSD. */
4 /* The copyright below only applies to the ioctl_meteor.h part of this file. */
5
6 #ifndef _DEV_IC_BT8XX_H_
7 #define _DEV_IC_BT8XX_H_
8 /*
9 * Copyright (c) 1995 Mark Tinguely and Jim Lowe
10 * All rights reserved.
11 *
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
14 * are met:
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
20 * 3. All advertising materials mentioning features or use of this software
21 * must display the following acknowledgement:
22 * This product includes software developed by Mark Tinguely and Jim Lowe
23 * 4. The name of the author may not be used to endorse or promote products
24 * derived from this software without specific prior written permission.
25 *
26 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
27 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
28 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
29 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
30 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
31 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
32 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
34 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
35 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36 * POSSIBILITY OF SUCH DAMAGE.
37 */
38 /*
39 * ioctl constants for Matrox Meteor Capture card.
40 */
41
42
43 #ifndef KERNEL
44 #include <sys/types.h>
45 #endif
46 #include <sys/ioccom.h>
47
48 struct meteor_capframe {
49 short command; /* see below for valid METEORCAPFRM commands */
50 short lowat; /* start transfer if < this number */
51 short hiwat; /* stop transfer if > this number */
52 } ;
53
54 /* structure for METEOR[GS]ETGEO - get/set geometry */
55 struct meteor_geomet {
56 u_short rows;
57 u_short columns;
58 u_short frames;
59 u_long oformat;
60 } ;
61
62 /* structure for METEORGCOUNT-get count of frames, fifo errors and dma errors */
63 struct meteor_counts {
64 u_long fifo_errors; /* count of fifo errors since open */
65 u_long dma_errors; /* count of dma errors since open */
66 u_long frames_captured; /* count of frames captured since open */
67 u_long even_fields_captured; /* count of even fields captured */
68 u_long odd_fields_captured; /* count of odd fields captured */
69 } ;
70
71 /* structure for getting and setting direct transfers to vram */
72 struct meteor_video {
73 u_long addr; /* Address of location to dma to */
74 u_long width; /* Width of memory area */
75 u_long banksize; /* Size of Vram bank */
76 u_long ramsize; /* Size of Vram */
77 };
78
79 #define METEORCAPTUR _IOW('x', 1, int) /* capture a frame */
80 #define METEORCAPFRM _IOW('x', 2, struct meteor_capframe) /* sync capture */
81 #define METEORSETGEO _IOW('x', 3, struct meteor_geomet) /* set geometry */
82 #define METEORGETGEO _IOR('x', 4, struct meteor_geomet) /* get geometry */
83 #define METEORSTATUS _IOR('x', 5, unsigned short) /* get status */
84 #define METEORSHUE _IOW('x', 6, signed char) /* set hue */
85 #define METEORGHUE _IOR('x', 6, signed char) /* get hue */
86 #define METEORSFMT _IOW('x', 7, unsigned long) /* set format */
87 #define METEORGFMT _IOR('x', 7, unsigned long) /* get format */
88 #define METEORSINPUT _IOW('x', 8, unsigned long) /* set input dev */
89 #define METEORGINPUT _IOR('x', 8, unsigned long) /* get input dev */
90 #define METEORSCHCV _IOW('x', 9, unsigned char) /* set uv gain */
91 #define METEORGCHCV _IOR('x', 9, unsigned char) /* get uv gain */
92 #define METEORSCOUNT _IOW('x',10, struct meteor_counts)
93 #define METEORGCOUNT _IOR('x',10, struct meteor_counts)
94 #define METEORSFPS _IOW('x',11, unsigned short) /* set fps */
95 #define METEORGFPS _IOR('x',11, unsigned short) /* get fps */
96 #define METEORSSIGNAL _IOW('x', 12, unsigned int) /* set signal */
97 #define METEORGSIGNAL _IOR('x', 12, unsigned int) /* get signal */
98 #define METEORSVIDEO _IOW('x', 13, struct meteor_video) /* set video */
99 #define METEORGVIDEO _IOR('x', 13, struct meteor_video) /* get video */
100 #define METEORSBRIG _IOW('x', 14, unsigned char) /* set brightness */
101 #define METEORGBRIG _IOR('x', 14, unsigned char) /* get brightness */
102 #define METEORSCSAT _IOW('x', 15, unsigned char) /* set chroma sat */
103 #define METEORGCSAT _IOR('x', 15, unsigned char) /* get uv saturation */
104 #define METEORSCONT _IOW('x', 16, unsigned char) /* set contrast */
105 #define METEORGCONT _IOR('x', 16, unsigned char) /* get contrast */
106 #define METEORSBT254 _IOW('x', 17, unsigned short) /* set Bt254 reg */
107 #define METEORGBT254 _IOR('x', 17, unsigned short) /* get Bt254 reg */
108 #define METEORSHWS _IOW('x', 18, unsigned char) /* set hor start reg */
109 #define METEORGHWS _IOR('x', 18, unsigned char) /* get hor start reg */
110 #define METEORSVWS _IOW('x', 19, unsigned char) /* set vert start reg */
111 #define METEORGVWS _IOR('x', 19, unsigned char) /* get vert start reg */
112 #define METEORSTS _IOW('x', 20, unsigned char) /* set time stamp */
113 #define METEORGTS _IOR('x', 20, unsigned char) /* get time stamp */
114
115 #define METEOR_STATUS_ID_MASK 0xf000 /* ID of 7196 */
116 #define METEOR_STATUS_DIR 0x0800 /* Direction of Expansion port YUV */
117 #define METEOR_STATUS_OEF 0x0200 /* Field detected: Even/Odd */
118 #define METEOR_STATUS_SVP 0x0100 /* State of VRAM Port:inactive/active */
119 #define METEOR_STATUS_STTC 0x0080 /* Time Constant: TV/VCR */
120 #define METEOR_STATUS_HCLK 0x0040 /* Horiz PLL: locked/unlocked */
121 #define METEOR_STATUS_FIDT 0x0020 /* Field detect: 50/60hz */
122 #define METEOR_STATUS_ALTD 0x0002 /* Line alt: no line alt/line alt */
123 #define METEOR_STATUS_CODE 0x0001 /* Colour info: no colour/colour */
124
125 /* METEORCAPTUR capture options */
126 #define METEOR_CAP_SINGLE 0x0001 /* capture one frame */
127 #define METEOR_CAP_CONTINOUS 0x0002 /* continuously capture */
128 #define METEOR_CAP_STOP_CONT 0x0004 /* stop the continuous capture */
129
130 /* METEORCAPFRM capture commands */
131 #define METEOR_CAP_N_FRAMES 0x0001 /* capture N frames */
132 #define METEOR_CAP_STOP_FRAMES 0x0002 /* stop capture N frames */
133 #define METEOR_HALT_N_FRAMES 0x0003 /* halt of capture N frames */
134 #define METEOR_CONT_N_FRAMES 0x0004 /* continue after above halt */
135
136 /* valid video input formats: */
137 #define METEOR_FMT_NTSC 0x00100 /* NTSC -- initialized default */
138 #define METEOR_FMT_PAL 0x00200 /* PAL */
139 #define METEOR_FMT_SECAM 0x00400 /* SECAM */
140 #define METEOR_FMT_AUTOMODE 0x00800 /* auto-mode */
141 #define METEOR_INPUT_DEV0 0x01000 /* camera input 0 -- default */
142 #define METEOR_INPUT_DEV_RCA METEOR_INPUT_DEV0
143 #define METEOR_INPUT_DEV1 0x02000 /* camera input 1 */
144 #define METEOR_INPUT_DEV2 0x04000 /* camera input 2 */
145 #define METEOR_INPUT_DEV3 0x08000 /* camera input 3 */
146 #define METEOR_INPUT_DEV_RGB 0x0a000 /* for rgb version of meteor */
147 #define METEOR_INPUT_DEV_SVIDEO 0x06000 /* S-video input port */
148
149 /* valid video output formats: */
150 #define METEOR_GEO_RGB16 0x0010000 /* packed -- initialized default */
151 #define METEOR_GEO_RGB24 0x0020000 /* RBG 24 bits packed */
152 /* internally stored in 32 bits */
153 #define METEOR_GEO_YUV_PACKED 0x0040000 /* 4-2-2 YUV 16 bits packed */
154 #define METEOR_GEO_YUV_PLANAR 0x0080000 /* 4-2-2 YUV 16 bits planer */
155 #define METEOR_GEO_YUV_PLANER METEOR_GEO_YUV_PLANAR
156 #define METEOR_GEO_UNSIGNED 0x0400000 /* unsigned uv outputs */
157 #define METEOR_GEO_EVEN_ONLY 0x1000000 /* set for even only field capture */
158 #define METEOR_GEO_ODD_ONLY 0x2000000 /* set for odd only field capture */
159 #define METEOR_GEO_FIELD_MASK 0x3000000
160 #define METEOR_GEO_YUV_422 0x4000000 /* 4-2-2 YUV in Y-U-V combined */
161 #define METEOR_GEO_OUTPUT_MASK 0x40f0000
162 #define METEOR_GEO_YUV_12 0x10000000 /* YUV 12 format */
163 #define METEOR_GEO_YUV_9 0x40000000 /* YUV 9 format */
164
165 #define METEOR_FIELD_MODE 0x80000000 /* Field cap or Frame cap */
166
167 #define METEOR_SIG_MODE_MASK 0xffff0000
168 #define METEOR_SIG_FRAME 0x00000000 /* signal every frame */
169 #define METEOR_SIG_FIELD 0x00010000 /* signal every field */
170
171 /* following structure is used to coordinate the synchronous */
172
173 struct meteor_mem {
174 /* kernel write only */
175 int frame_size; /* row*columns*depth */
176 unsigned num_bufs; /* number of frames in buffer (1-32) */
177 /* user and kernel change these */
178 int lowat; /* kernel starts capture if < this number */
179 int hiwat; /* kernel stops capture if > this number.
180 hiwat <= numbufs */
181 unsigned active; /* bit mask of active frame buffers
182 kernel sets, user clears */
183 int num_active_bufs; /* count of active frame buffer
184 kernel increments, user decrements */
185
186 /* reference to mmapped data */
187 caddr_t buf; /* The real space (virtual addr) */
188 } ;
189
190 /*
191 * extensions to ioctl_meteor.h for the bt848 cards
192 *
193 * FreeBSD: src/sys/i386/include/ioctl_bt848.h,v 1.24 1999/08/28 00:44:16 peter Exp
194 */
195
196
197 /*
198 * frequency sets
199 */
200 #define CHNLSET_NABCST 1
201 #define CHNLSET_CABLEIRC 2
202 #define CHNLSET_CABLEHRC 3
203 #define CHNLSET_WEUROPE 4
204 #define CHNLSET_JPNBCST 5
205 #define CHNLSET_JPNCABLE 6
206 #define CHNLSET_XUSSR 7
207 #define CHNLSET_AUSTRALIA 8
208 #define CHNLSET_FRANCE 9
209 #define CHNLSET_MIN CHNLSET_NABCST
210 #define CHNLSET_MAX CHNLSET_FRANCE
211
212
213 /*
214 * constants for various tuner registers
215 */
216 #define BT848_HUEMIN (-90)
217 #define BT848_HUEMAX 90
218 #define BT848_HUECENTER 0
219 #define BT848_HUERANGE 179.3
220 #define BT848_HUEREGMIN (-128)
221 #define BT848_HUEREGMAX 127
222 #define BT848_HUESTEPS 256
223
224 #define BT848_BRIGHTMIN (-50)
225 #define BT848_BRIGHTMAX 50
226 #define BT848_BRIGHTCENTER 0
227 #define BT848_BRIGHTRANGE 99.6
228 #define BT848_BRIGHTREGMIN (-128)
229 #define BT848_BRIGHTREGMAX 127
230 #define BT848_BRIGHTSTEPS 256
231
232 #define BT848_CONTRASTMIN 0
233 #define BT848_CONTRASTMAX 237
234 #define BT848_CONTRASTCENTER 100
235 #define BT848_CONTRASTRANGE 236.57
236 #define BT848_CONTRASTREGMIN 0
237 #define BT848_CONTRASTREGMAX 511
238 #define BT848_CONTRASTSTEPS 512
239
240 #define BT848_CHROMAMIN 0
241 #define BT848_CHROMAMAX 284
242 #define BT848_CHROMACENTER 100
243 #define BT848_CHROMARANGE 283.89
244 #define BT848_CHROMAREGMIN 0
245 #define BT848_CHROMAREGMAX 511
246 #define BT848_CHROMASTEPS 512
247
248 #define BT848_SATUMIN 0
249 #define BT848_SATUMAX 202
250 #define BT848_SATUCENTER 100
251 #define BT848_SATURANGE 201.18
252 #define BT848_SATUREGMIN 0
253 #define BT848_SATUREGMAX 511
254 #define BT848_SATUSTEPS 512
255
256 #define BT848_SATVMIN 0
257 #define BT848_SATVMAX 284
258 #define BT848_SATVCENTER 100
259 #define BT848_SATVRANGE 283.89
260 #define BT848_SATVREGMIN 0
261 #define BT848_SATVREGMAX 511
262 #define BT848_SATVSTEPS 512
263
264
265 /*
266 * audio stuff
267 */
268 #define AUDIO_TUNER 0x00 /* command for the audio routine */
269 #define AUDIO_EXTERN 0x01 /* don't confuse them with bit */
270 #define AUDIO_INTERN 0x02 /* settings */
271 #define AUDIO_MUTE 0x80
272 #define AUDIO_UNMUTE 0x81
273
274
275 /*
276 * EEProm stuff
277 */
278 struct eeProm {
279 short offset;
280 short count;
281 u_char bytes[ 256 ];
282 };
283
284
285 /*
286 * XXX: this is a hack, should be in ioctl_meteor.h
287 * here to avoid touching that file for now...
288 */
289 #define TVTUNER_SETCHNL _IOW('x', 32, unsigned int) /* set channel */
290 #define TVTUNER_GETCHNL _IOR('x', 32, unsigned int) /* get channel */
291 #define TVTUNER_SETTYPE _IOW('x', 33, unsigned int) /* set tuner type */
292 #define TVTUNER_GETTYPE _IOR('x', 33, unsigned int) /* get tuner type */
293 #define TVTUNER_GETSTATUS _IOR('x', 34, unsigned int) /* get tuner status */
294 #define TVTUNER_SETFREQ _IOW('x', 35, unsigned int) /* set frequency */
295 #define TVTUNER_GETFREQ _IOR('x', 36, unsigned int) /* get frequency */
296
297
298 #define BT848_SHUE _IOW('x', 37, int) /* set hue */
299 #define BT848_GHUE _IOR('x', 37, int) /* get hue */
300 #define BT848_SBRIG _IOW('x', 38, int) /* set brightness */
301 #define BT848_GBRIG _IOR('x', 38, int) /* get brightness */
302 #define BT848_SCSAT _IOW('x', 39, int) /* set chroma sat */
303 #define BT848_GCSAT _IOR('x', 39, int) /* get UV saturation */
304 #define BT848_SCONT _IOW('x', 40, int) /* set contrast */
305 #define BT848_GCONT _IOR('x', 40, int) /* get contrast */
306 #define BT848_SVSAT _IOW('x', 41, int) /* set chroma V sat */
307 #define BT848_GVSAT _IOR('x', 41, int) /* get V saturation */
308 #define BT848_SUSAT _IOW('x', 42, int) /* set chroma U sat */
309 #define BT848_GUSAT _IOR('x', 42, int) /* get U saturation */
310
311 #define BT848_SCBARS _IOR('x', 43, int) /* set colorbar */
312 #define BT848_CCBARS _IOR('x', 44, int) /* clear colorbar */
313
314
315 #define BT848_SAUDIO _IOW('x', 46, int) /* set audio channel */
316 #define BT848_GAUDIO _IOR('x', 47, int) /* get audio channel */
317 #define BT848_SBTSC _IOW('x', 48, int) /* set audio channel */
318
319 #define BT848_GSTATUS _IOR('x', 49, unsigned int) /* reap status */
320
321 #define BT848_WEEPROM _IOWR('x', 50, struct eeProm) /* write to EEProm */
322 #define BT848_REEPROM _IOWR('x', 51, struct eeProm) /* read from EEProm */
323
324 #define BT848_SIGNATURE _IOWR('x', 52, struct eeProm) /* read card sig */
325
326 #define TVTUNER_SETAFC _IOW('x', 53, int) /* turn AFC on/off */
327 #define TVTUNER_GETAFC _IOR('x', 54, int) /* query AFC on/off */
328 #define BT848_SLNOTCH _IOW('x', 55, int) /* set luma notch */
329 #define BT848_GLNOTCH _IOR('x', 56, int) /* get luma notch */
330
331 /* Read/Write the BT848's I2C bus directly
332 * b7-b0: data (read/write)
333 * b15-b8: internal peripheral register (write)
334 * b23-b16: i2c addr (write)
335 * b31-b24: 1 = write, 0 = read
336 */
337 #define BT848_I2CWR _IOWR('x', 57, u_long) /* i2c read-write */
338
339 /* Support for radio tuner */
340 #define RADIO_SETMODE _IOW('x', 58, unsigned int) /* set radio modes */
341 #define RADIO_GETMODE _IOR('x', 58, unsigned char) /* get radio modes */
342 #define RADIO_AFC 0x01 /* These modes will probably not */
343 #define RADIO_MONO 0x02 /* work on the FRxxxx. It does */
344 #define RADIO_MUTE 0x08 /* work on the FMxxxx. */
345 #define RADIO_SETFREQ _IOW('x', 59, unsigned int) /* set frequency */
346 #define RADIO_GETFREQ _IOR('x', 59, unsigned int) /* set frequency */
347 /* Argument is frequency*100MHz */
348
349 /*
350 * XXX: more bad magic,
351 * we need to fix the METEORGINPUT to return something public
352 * duplicate them here for now...
353 */
354 #define METEOR_DEV0 0x00001000
355 #define METEOR_DEV1 0x00002000
356 #define METEOR_DEV2 0x00004000
357 #define METEOR_DEV3 0x00008000
358 #define METEOR_DEV_SVIDEO 0x00006000
359 /*
360 * right now I don't know were to put these, but as they are suppose to be
361 * a part of a common video capture interface, these should be relocated to
362 * another place. Probably most of the METEOR_xxx defines need to be
363 * renamed and moved to a common header
364 */
365
366 typedef enum { METEOR_PIXTYPE_RGB, METEOR_PIXTYPE_YUV,
367 METEOR_PIXTYPE_YUV_PACKED,
368 METEOR_PIXTYPE_YUV_12 } METEOR_PIXTYPE;
369
370
371 struct meteor_pixfmt {
372 u_int index; /* Index in supported pixfmt list */
373 METEOR_PIXTYPE type; /* What's the board gonna feed us */
374 u_int Bpp; /* Bytes per pixel */
375 u_long masks[3]; /* R,G,B or Y,U,V masks, respectively */
376 unsigned swap_bytes :1; /* Bytes swapped within shorts */
377 unsigned swap_shorts:1; /* Shorts swapped within longs */
378 };
379
380
381 struct bktr_clip {
382 int x_min;
383 int x_max;
384 int y_min;
385 int y_max;
386 };
387
388 #define BT848_MAX_CLIP_NODE 100
389 struct _bktr_clip {
390 struct bktr_clip x[BT848_MAX_CLIP_NODE];
391 };
392
393 /*
394 * I'm using METEOR_xxx just because that will be common to other interface
395 * and less of a surprise
396 */
397 #define METEORSACTPIXFMT _IOW('x', 64, int )
398 #define METEORGACTPIXFMT _IOR('x', 64, int )
399 #define METEORGSUPPIXFMT _IOWR('x', 65, struct meteor_pixfmt)
400
401 /* set clip list */
402 #define BT848SCLIP _IOW('x', 66, struct _bktr_clip )
403 #define BT848GCLIP _IOR('x', 66, struct _bktr_clip )
404
405
406 /* set input format */
407 #define BT848SFMT _IOW('x', 67, unsigned long )
408 #define BT848GFMT _IOR('x', 67, unsigned long )
409
410 /* set clear-buffer-on-start */
411 #define BT848SCBUF _IOW('x', 68, int)
412 #define BT848GCBUF _IOR('x', 68, int)
413
414 /* set capture area */
415 /* The capture area is the area of the video image which is grabbed */
416 /* Usually the capture area is 640x480 (768x576 PAL) pixels */
417 /* This area is then scaled to the dimensions the user requires */
418 /* using the METEORGEO ioctl */
419 /* However, the capture area could be 400x300 pixels from the top right */
420 /* corner of the video image */
421 struct bktr_capture_area {
422 int x_offset;
423 int y_offset;
424 int x_size;
425 int y_size;
426 };
427 #define BT848_SCAPAREA _IOW('x', 69, struct bktr_capture_area)
428 #define BT848_GCAPAREA _IOR('x', 69, struct bktr_capture_area)
429
430
431 /* Get channel Set */
432 #define BT848_MAX_CHNLSET_NAME_LEN 16
433 struct bktr_chnlset {
434 short index;
435 short max_channel;
436 char name[BT848_MAX_CHNLSET_NAME_LEN];
437 };
438 #define TVTUNER_GETCHNLSET _IOWR('x', 70, struct bktr_chnlset)
439
440
441
442 /* Infra Red Remote Control */
443 struct bktr_remote {
444 unsigned char data[3];
445 };
446 #define REMOTE_GETKEY _IOR('x', 71, struct bktr_remote)/*read the remote */
447 /*control receiver*/
448 /*returns raw data*/
449
450
451 /*
452 * Direct access to GPIO pins. You must add BKTR_GPIO_ACCESS to your kernel
453 * configuration file to use these
454 */
455 #define BT848_GPIO_SET_EN _IOW('x', 72, int) /* set gpio_out_en */
456 #define BT848_GPIO_GET_EN _IOR('x', 73, int) /* get gpio_out_en */
457 #define BT848_GPIO_SET_DATA _IOW('x', 74, int) /* set gpio_data */
458 #define BT848_GPIO_GET_DATA _IOR('x', 75, int) /* get gpio_data */
459
460
461
462 /* XXX - Copied from /sys/pci/brktree_reg.h */
463 #define BT848_IFORM_FORMAT (0x7<<0)
464 # define BT848_IFORM_F_RSVD (0x7)
465 # define BT848_IFORM_F_SECAM (0x6)
466 # define BT848_IFORM_F_PALN (0x5)
467 # define BT848_IFORM_F_PALM (0x4)
468 # define BT848_IFORM_F_PALBDGHI (0x3)
469 # define BT848_IFORM_F_NTSCJ (0x2)
470 # define BT848_IFORM_F_NTSCM (0x1)
471 # define BT848_IFORM_F_AUTO (0x0)
472
473
474
475 #endif /* _DEV_IC_BT8XX_H_ */
476