summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/bktr.4 4.html
blob: 8c7ded41aadc21342d4bb873924a58b113b05a8a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
<table class="head">
  <tr>
    <td class="head-ltitle">BKTR(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">BKTR(4)</td>
  </tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">bktr</code> &#x2014; <span class="Nd">Brooktree
    848 compatible TV card driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">bktr* at pci? dev ? function ?</code>
  <br/>
  <code class="Cd">radio* at bktr?</code></p>
<p class="Pp">
  <br/>
  <code class="In">#include &lt;<a class="In">dev/ic/bt8xx.h</a>&gt;</code></p>
<p class="Pp">
  <br/>
  <code class="Cd">options BKTR_OVERRIDE_CARD=n</code>
  <br/>
  <code class="Cd">options BKTR_OVERRIDE_TUNER=n</code>
  <br/>
  <code class="Cd">options BKTR_OVERRIDE_DBX=n</code>
  <br/>
  <code class="Cd">options BKTR_OVERRIDE_MSP=n</code>
  <br/>
  <code class="Cd">options BKTR_SYSTEM_DEFAULT=n</code>
  <br/>
  <code class="Cd">options BKTR_USE_PLL</code>
  <br/>
  <code class="Cd">options BKTR_GPIO_ACCESS</code>
  <br/>
  <code class="Cd">options BKTR_NO_MSP_RESET</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">This driver supports video capture (frame grabber) and TV tuner
    cards based on the Brooktree Bt848, Bt848A, Bt849A, Bt878, and Bt879
  chips.</p>
<p class="Pp">Note that <code class="Nm">bktr</code> is not part of the
    <a class="Xr">dtv(4)</a> framework.</p>
<p class="Pp">Supported cards include most cards by AVerMedia, Hauppauge,
    Leadtek, Miro, Pinnacle, Pixelview, Terratec, and some other companies,
    especially all cards based on the Brooktree Bt848, Bt848A, Bt849A, Bt878, or
    Bt879 chips. A notable exception are the ATI All-in-Wonder cards.</p>
<p class="Pp">The following kernel configuration options are available:</p>
<dl class="Bl-ohang">
  <dt><code class="Cd">options BKTR_OVERRIDE_CARD=n</code></dt>
  <dd>If the card is not recognized correctly by the auto-detection routine, it
      can be overridden by setting this option to the appropriate value. The
      following values are allowed:
    <dl class="Bl-tag Bl-compact">
      <dt>1</dt>
      <dd>Pinnacle Systems (Miro) TV,</dd>
      <dt>2</dt>
      <dd>Hauppauge WinCast/TV,</dd>
      <dt>3</dt>
      <dd>STB TV/PCI,</dd>
      <dt>4</dt>
      <dd>Intel Smart Video III and Videologic Captivator PCI,</dd>
      <dt>5</dt>
      <dd>IMS TV Turbo,</dd>
      <dt>6</dt>
      <dd>AVerMedia TV/FM,</dd>
      <dt>7</dt>
      <dd>MMAC Osprey,</dd>
      <dt>8</dt>
      <dd>NEC PK-UG-X017,</dd>
      <dt>9</dt>
      <dd>I/O DATA GV-BCTV2/PCI,</dd>
      <dt>10</dt>
      <dd>Animation Technologies FlyVideo,</dd>
      <dt>11</dt>
      <dd>Zoltrix TV,</dd>
      <dt>12</dt>
      <dd>KISS TV/FM PCI,</dd>
      <dt>13</dt>
      <dd>Video Highway Xtreme,</dd>
      <dt>14</dt>
      <dd>Askey/Dynalink Magic TView,</dd>
      <dt>15</dt>
      <dd>Leadtek WinFast TV 2000/VC100,</dd>
      <dt>16</dt>
      <dd>TerraTec TerraTV+, and</dd>
      <dt>17</dt>
      <dd>TerraTec TValue.</dd>
    </dl>
  </dd>
  <dt><code class="Cd">options BKTR_OVERRIDE_TUNER=n</code></dt>
  <dd>If the TV tuner is not recognized correctly by the auto-detection routine,
      it can be overridden by setting this option to the appropriate value.
      Known values are:
    <dl class="Bl-tag Bl-compact">
      <dt>1</dt>
      <dd>Temic NTSC,</dd>
      <dt>2</dt>
      <dd>Temic PAL,</dd>
      <dt>3</dt>
      <dd>Temic SECAM,</dd>
      <dt>4</dt>
      <dd>Philips NTSC,</dd>
      <dt>5</dt>
      <dd>Philips PAL,</dd>
      <dt>6</dt>
      <dd>Philips SECAM,</dd>
      <dt>7</dt>
      <dd>Temic PAL I,</dd>
      <dt>8</dt>
      <dd>Philips PAL I,</dd>
      <dt>9</dt>
      <dd>Philips FR1236 NTSC FM,</dd>
      <dt>10</dt>
      <dd>Philips FR1216 PAL FM,</dd>
      <dt>11</dt>
      <dd>Philips FR1236 SECAM FM,</dd>
      <dt>12</dt>
      <dd>ALPS TSCH5 NTSC FM, and</dd>
      <dt>13</dt>
      <dd>ALPS TSBH1 NTSC.</dd>
    </dl>
  </dd>
  <dt><code class="Cd">options BKTR_OVERRIDE_DBX=n</code></dt>
  <dd>To override detection of the BTSC (dbx) chip, set this to
      <i class="Em">1</i> if you have one, or <i class="Em">0</i> if not.</dd>
  <dt><code class="Cd">options BKTR_OVERRIDE_MSP=n</code></dt>
  <dd>To override detection of the MSP 34xx chip, set this to
      <i class="Em">1</i> if you have one, or <i class="Em">0</i> if not.</dd>
  <dt id="BROOKTREE_PAL"><code class="Cd">options
    BKTR_SYSTEM_DEFAULT=n</code></dt>
  <dd>If this option is set to
      <a class="permalink" href="#BROOKTREE_PAL"><i class="Em">BROOKTREE_PAL</i></a>
      default to PAL, else to NTSC.</dd>
  <dt><code class="Cd">options BKTR_USE_PLL</code></dt>
  <dd>Default to PLL instead of XTAL.</dd>
  <dt id="ioctl"><code class="Cd">options BKTR_GPIO_ACCESS</code></dt>
  <dd>Use
      <a class="permalink" href="#ioctl"><code class="Fn">ioctl</code></a>()s
      for direct GPIO access.</dd>
  <dt><code class="Cd">options BKTR_NO_MSP_RESET</code></dt>
  <dd>Skip the MSP reset. This option is handy if you initialize the MSP audio
      in another operating system first and then do a soft reboot.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="VIDEO_CAPTURE_INTERFACE"><a class="permalink" href="#VIDEO_CAPTURE_INTERFACE">VIDEO
  CAPTURE INTERFACE</a></h1>
<p class="Pp">The video capture interface to <code class="Nm">bktr</code> is
    accessed through the <span class="Pa">/dev/bktrN</span> devices. The
    following <a class="Xr">ioctl(2)</a> commands are supported on the
    Brooktree848 video capture interface:</p>
<dl class="Bl-tag">
  <dt id="METEORSFMT"><a class="permalink" href="#METEORSFMT"><code class="Dv">METEORSFMT</code></a>
    <var class="Fa">unsigned long *</var></dt>
  <dd>This command sets the video format, also sometimes referred to as the
      video norm. The supported formats are:
    <p class="Pp"></p>
    <dl class="Bl-tag Bl-compact">
      <dt id="METEOR_FMT_NTSC"><a class="permalink" href="#METEOR_FMT_NTSC"><code class="Dv">METEOR_FMT_NTSC</code></a></dt>
      <dd>NTSC</dd>
      <dt id="METEOR_FMT_PAL"><a class="permalink" href="#METEOR_FMT_PAL"><code class="Dv">METEOR_FMT_PAL</code></a></dt>
      <dd>PAL</dd>
      <dt id="METEOR_FMT_SECAM"><a class="permalink" href="#METEOR_FMT_SECAM"><code class="Dv">METEOR_FMT_SECAM</code></a></dt>
      <dd>SECAM</dd>
      <dt id="METEOR_FMT_AUTOMODE"><a class="permalink" href="#METEOR_FMT_AUTOMODE"><code class="Dv">METEOR_FMT_AUTOMODE</code></a></dt>
      <dd>hardware default</dd>
    </dl>
  </dd>
  <dt id="METEORGFMT"><a class="permalink" href="#METEORGFMT"><code class="Dv">METEORGFMT</code></a>
    <var class="Fa">unsigned long *</var></dt>
  <dd>This command retrieves the current video format to the
      <var class="Vt">unsigned long *</var> argument.</dd>
  <dt id="METEORSETGEO"><a class="permalink" href="#METEORSETGEO"><code class="Dv">METEORSETGEO</code></a>
    <var class="Fa">struct meteor_geomet *</var></dt>
  <dd>This command sets the video properties that affect the bit size of a frame
      through the <var class="Vt">meteor_geomet *</var> argument.
    <div class="Bd Pp Li">
    <pre>struct meteor_geomet {
	u_short		rows;	 /* height in pixels*/
	u_short		columns; /* width in pixels */
	u_short		frames;
	u_long		oformat;
}</pre>
    </div>
    <p class="Pp">The <var class="Va">frames</var> field is the number of frames
        to buffer. Currently only 1 frame is supported for most operations.</p>
    <p class="Pp">The <var class="Va">oformat</var> field is a bit-field
        describing the output pixel format type and which video fields to
        capture. The following are supported pixel format types:
      <br/>
       .Pp</p>
    <dl class="Bl-tag Bl-compact">
      <dt id="METEOR_GEO_RGB16"><a class="permalink" href="#METEOR_GEO_RGB16"><code class="Dv">METEOR_GEO_RGB16</code></a></dt>
      <dd>16-bit RGB</dd>
      <dt id="METEOR_GEO_RGB24"><a class="permalink" href="#METEOR_GEO_RGB24"><code class="Dv">METEOR_GEO_RGB24</code></a></dt>
      <dd>24-bit RGB in 32 bits</dd>
      <dt id="METEOR_GEO_YUV_PACKED"><a class="permalink" href="#METEOR_GEO_YUV_PACKED"><code class="Dv">METEOR_GEO_YUV_PACKED</code></a></dt>
      <dd>16-bit 4:2:2 YUV</dd>
      <dt id="METEOR_GEO_YUV_PLANAR"><a class="permalink" href="#METEOR_GEO_YUV_PLANAR"><code class="Dv">METEOR_GEO_YUV_PLANAR</code></a></dt>
      <dd>16-bit 4:2:2 YUV</dd>
      <dt id="METEOR_GEO_YUV_UNSIGNED"><a class="permalink" href="#METEOR_GEO_YUV_UNSIGNED"><code class="Dv">METEOR_GEO_YUV_UNSIGNED</code></a></dt>
      <dd>unsigned UV</dd>
      <dt id="METEOR_GEO_YUV_422"><a class="permalink" href="#METEOR_GEO_YUV_422"><code class="Dv">METEOR_GEO_YUV_422</code></a></dt>
      <dd style="width: auto;">&#x00A0;</dd>
      <dt id="METEOR_GEO_YUV_12"><a class="permalink" href="#METEOR_GEO_YUV_12"><code class="Dv">METEOR_GEO_YUV_12</code></a></dt>
      <dd style="width: auto;">&#x00A0;</dd>
      <dt id="METEOR_GEO_YUV_9"><a class="permalink" href="#METEOR_GEO_YUV_9"><code class="Dv">METEOR_GEO_YUV_9</code></a></dt>
      <dd style="width: auto;">&#x00A0;</dd>
    </dl>
    <p class="Pp">The following are supported field capture modes:</p>
    <p class="Pp"></p>
    <dl class="Bl-tag Bl-compact">
      <dt id="METEOR_GEO_ODD_ONLY"><a class="permalink" href="#METEOR_GEO_ODD_ONLY"><code class="Dv">METEOR_GEO_ODD_ONLY</code></a></dt>
      <dd>only odd fields</dd>
      <dt id="METEOR_GEO_EVEN_ONLY"><a class="permalink" href="#METEOR_GEO_EVEN_ONLY"><code class="Dv">METEOR_GEO_EVEN_ONLY</code></a></dt>
      <dd>only even fields</dd>
    </dl>
    <p class="Pp">By default, frames will consist of both the odd and even
        fields.</p>
  </dd>
  <dt id="METEORGSUPPIXFMT"><a class="permalink" href="#METEORGSUPPIXFMT"><code class="Dv">METEORGSUPPIXFMT</code></a>
    <var class="Fa">struct meteor_pixfmt *</var></dt>
  <dd>This command is used interactively to fetch descriptions of supported
      output pixel formats into the <var class="Vt">meteor_pixfmt *</var>
      argument.
    <div class="Bd Pp Li">
    <pre>struct meteor_pixfmt {
	u_int          index;
	METEOR_PIXTYPE type;
	u_int          Bpp;		/* bytes per pixel */
	u_long         masks[3];	/* YUV bit masks */
	unsigned       swap_bytes :1;
	unsigned       swap_shorts:1;
};</pre>
    </div>
    <p class="Pp">To query all the supported formats, start with an index field
        of 0 and continue with successive encodings (1, 2, ...) until the
        command returns an error.</p>
  </dd>
  <dt id="METEORSACTPIXFMT"><a class="permalink" href="#METEORSACTPIXFMT"><code class="Dv">METEORSACTPIXFMT</code></a>
    <var class="Fa">int *</var></dt>
  <dd>This command sets the active pixel format. The <var class="Vt">int *</var>
      argument is the index of the pixel format as returned by
      <code class="Dv">METEORGSUPPIXFMT</code>.</dd>
  <dt id="METEORGACTPIXFMT"><a class="permalink" href="#METEORGACTPIXFMT"><code class="Dv">METEORGACTPIXFMT</code></a>
    <var class="Fa">int *</var></dt>
  <dd>This command fetches the active pixel format index into the
      <var class="Vt">int *</var> argument.</dd>
  <dt id="METEORSINPUT"><a class="permalink" href="#METEORSINPUT"><code class="Dv">METEORSINPUT</code></a>
    <var class="Fa">unsigned long *</var></dt>
  <dd>This command sets the input port of the Brooktree848 device. The following
      are supported input ports:
    <p class="Pp"></p>
    <dl class="Bl-tag Bl-compact">
      <dt id="METEOR_INPUT_DEV0"><a class="permalink" href="#METEOR_INPUT_DEV0"><code class="Dv">METEOR_INPUT_DEV0</code></a></dt>
      <dd>composite (RCA)</dd>
      <dt id="METEOR_INPUT_DEV1"><a class="permalink" href="#METEOR_INPUT_DEV1"><code class="Dv">METEOR_INPUT_DEV1</code></a></dt>
      <dd>tuner</dd>
      <dt id="METEOR_INPUT_DEV2"><a class="permalink" href="#METEOR_INPUT_DEV2"><code class="Dv">METEOR_INPUT_DEV2</code></a></dt>
      <dd>composite S-video</dd>
      <dt id="METEOR_INPUT_DEV3"><a class="permalink" href="#METEOR_INPUT_DEV3"><code class="Dv">METEOR_INPUT_DEV3</code></a></dt>
      <dd>mystery device</dd>
      <dt id="METEOR_INPUT_DEV_RGB"><a class="permalink" href="#METEOR_INPUT_DEV_RGB"><code class="Dv">METEOR_INPUT_DEV_RGB</code></a></dt>
      <dd>rgb meteor</dd>
      <dt id="METEOR_INPUT_DEV_SVIDEO"><a class="permalink" href="#METEOR_INPUT_DEV_SVIDEO"><code class="Dv">METEOR_INPUT_DEV_SVIDEO</code></a></dt>
      <dd>S-Video</dd>
    </dl>
    <p class="Pp">Not all devices built with Brooktree848 chips support the full
        list of input ports.</p>
  </dd>
  <dt id="METEORGINPUT"><a class="permalink" href="#METEORGINPUT"><code class="Dv">METEORGINPUT</code></a>
    <var class="Fa">unsigned long *</var></dt>
  <dd>This command retrieves the current input port to the
      <var class="Vt">unsigned long *</var> argument.</dd>
  <dt id="METEORSFPS"><a class="permalink" href="#METEORSFPS"><code class="Dv">METEORSFPS</code></a>
    <var class="Fa">unsigned short *</var></dt>
  <dd>This command sets the number of frames to grab each second. Valid frame
      rates are integers from 0 to 30.</dd>
  <dt id="METEORGFPS"><a class="permalink" href="#METEORGFPS"><code class="Dv">METEORGFPS</code></a>
    <var class="Fa">unsigned short *</var></dt>
  <dd>This command fetches the number of frames to grab each second into the
      <var class="Vt">unsigned short *</var> argument.</dd>
  <dt id="METEORCAPTUR"><a class="permalink" href="#METEORCAPTUR"><code class="Dv">METEORCAPTUR</code></a>
    <var class="Fa">int *</var></dt>
  <dd>This command controls capturing of video data. The following are valid
      arguments:
    <p class="Pp"></p>
    <dl class="Bl-tag Bl-compact">
      <dt id="METEOR_CAP_SINGLE"><a class="permalink" href="#METEOR_CAP_SINGLE"><code class="Dv">METEOR_CAP_SINGLE</code></a></dt>
      <dd>capture one frame</dd>
      <dt id="METEOR_CAP_CONTINOUS"><a class="permalink" href="#METEOR_CAP_CONTINOUS"><code class="Dv">METEOR_CAP_CONTINOUS</code></a></dt>
      <dd>continuously capture</dd>
      <dt id="METEOR_CAP_STOP_CONT"><a class="permalink" href="#METEOR_CAP_STOP_CONT"><code class="Dv">METEOR_CAP_STOP_CONT</code></a></dt>
      <dd>stop continuous capture</dd>
    </dl>
  </dd>
  <dt id="METEORSSIGNAL"><a class="permalink" href="#METEORSSIGNAL"><code class="Dv">METEORSSIGNAL</code></a>
    <var class="Fa">unsigned int *</var></dt>
  <dd>This command controls the signal emission properties of
      <code class="Nm">bktr</code>. If the <var class="Vt">unsigned int *</var>
      argument is a valid signal, then that signal will be emitted when either a
      frame or field capture has completed. To select between frame or field
      signalling, the following arguments are used:
    <p class="Pp"></p>
    <dl class="Bl-tag Bl-compact">
      <dt id="METEOR_SIG_FRAME"><a class="permalink" href="#METEOR_SIG_FRAME"><code class="Dv">METEOR_SIG_FRAME</code></a></dt>
      <dd>signal every frame</dd>
      <dt id="METEOR_SIG_FIELD"><a class="permalink" href="#METEOR_SIG_FIELD"><code class="Dv">METEOR_SIG_FIELD</code></a></dt>
      <dd>signal every field</dd>
    </dl>
    <p class="Pp">By default, signals will be generated for every frame.
        Generation of signals is terminated with the
        <code class="Dv">METEOR_SIG_MODE_MASK</code> argument.</p>
  </dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="TUNER_INTERFACE"><a class="permalink" href="#TUNER_INTERFACE">TUNER
  INTERFACE</a></h1>
<p class="Pp">Most cards supported by this driver feature a hardware television
    tuner on the I2C bus. The tuner interface to <code class="Nm">bktr</code> is
    accessed through the <span class="Pa">/dev/tunerN</span> devices. The
    following <a class="Xr">ioctl(2)</a> commands are supported on the tuner
    interface:</p>
<dl class="Bl-tag">
  <dt id="TVTUNER_SETTYPE"><a class="permalink" href="#TVTUNER_SETTYPE"><code class="Dv">TVTUNER_SETTYPE</code></a>
    <var class="Fa">unsigned int *</var></dt>
  <dd>This command sets the tuner's TV channel set, also sometimes called the TV
      channel band. This setting is used to calculate the proper tuning
      frequencies. The desired channel set must be selected before attempting to
      set the tuner channel or frequency. The following is a list of valid
      channel sets:
    <p class="Pp"></p>
    <dl class="Bl-tag Bl-compact">
      <dt id="CHNLSET_NABCST"><a class="permalink" href="#CHNLSET_NABCST"><code class="Dv">CHNLSET_NABCST</code></a></dt>
      <dd>North America broadcast</dd>
      <dt id="CHNLSET_CABLEIRC"><a class="permalink" href="#CHNLSET_CABLEIRC"><code class="Dv">CHNLSET_CABLEIRC</code></a></dt>
      <dd>North America IRC cable</dd>
      <dt id="CHNLSET_CABLEHRC"><a class="permalink" href="#CHNLSET_CABLEHRC"><code class="Dv">CHNLSET_CABLEHRC</code></a></dt>
      <dd>North America HRC cable</dd>
      <dt id="CHNLSET_WEUROPE"><a class="permalink" href="#CHNLSET_WEUROPE"><code class="Dv">CHNLSET_WEUROPE</code></a></dt>
      <dd>Western Europe</dd>
      <dt id="CHNLSET_JPNBCST"><a class="permalink" href="#CHNLSET_JPNBCST"><code class="Dv">CHNLSET_JPNBCST</code></a></dt>
      <dd>Japan broadcast</dd>
      <dt id="CHNLSET_JPNCABLE"><a class="permalink" href="#CHNLSET_JPNCABLE"><code class="Dv">CHNLSET_JPNCABLE</code></a></dt>
      <dd>Japan cable</dd>
      <dt id="CHNLSET_XUSSR"><a class="permalink" href="#CHNLSET_XUSSR"><code class="Dv">CHNLSET_XUSSR</code></a></dt>
      <dd>Russia</dd>
      <dt id="CHNLSET_AUSTRALIA"><a class="permalink" href="#CHNLSET_AUSTRALIA"><code class="Dv">CHNLSET_AUSTRALIA</code></a></dt>
      <dd>Australia</dd>
      <dt id="CHNLSET_FRANCE"><a class="permalink" href="#CHNLSET_FRANCE"><code class="Dv">CHNLSET_FRANCE</code></a></dt>
      <dd>France</dd>
    </dl>
  </dd>
  <dt id="TVTUNER_GETTYPE"><a class="permalink" href="#TVTUNER_GETTYPE"><code class="Dv">TVTUNER_GETTYPE</code></a>
    <var class="Fa">unsigned int *</var></dt>
  <dd>This command fetches the tuner's current channel set to the
      <var class="Vt">unsigned int *</var> argument.</dd>
  <dt id="TVTUNER_SETCHNL"><a class="permalink" href="#TVTUNER_SETCHNL"><code class="Dv">TVTUNER_SETCHNL</code></a>
    <var class="Fa">unsigned int *</var></dt>
  <dd>This command sets the tuner's frequency to a specified channel in the
      current channel set.</dd>
  <dt id="TVTUNER_GETCHNL"><a class="permalink" href="#TVTUNER_GETCHNL"><code class="Dv">TVTUNER_GETCHNL</code></a>
    <var class="Fa">unsigned int *</var></dt>
  <dd>This command fetches the last selected channel. Note that it is not
      necessarily the current channel. In particular, changing the tuner's
      frequency by a command other than <code class="Dv">TVTUNER_SETCHNL</code>
      will not update this setting, and it defaults to 0 on driver
      initialization.</dd>
  <dt id="TVTUNER_SETFREQ"><a class="permalink" href="#TVTUNER_SETFREQ"><code class="Dv">TVTUNER_SETFREQ</code></a>
    <var class="Fa">unsigned int *</var></dt>
  <dd>This command sets the tuner's frequency to 1/16th the value of the
      <var class="Vt">unsigned int *</var> argument, in MHz. Note that the
      current channelset is used to determine frequency offsets when this
      command is executed.</dd>
  <dt id="TVTUNER_GETFREQ"><a class="permalink" href="#TVTUNER_GETFREQ"><code class="Dv">TVTUNER_GETFREQ</code></a>
    <var class="Fa">unsigned int *</var></dt>
  <dd>This command fetches the tuner's current frequency to the
      <var class="Vt">unsigned int *</var> argument. Note that this value is 16
      times the actual tuner frequency, in MHz.</dd>
  <dt id="BT848_SAUDIO"><a class="permalink" href="#BT848_SAUDIO"><code class="Dv">BT848_SAUDIO</code></a>
    <var class="Fa">int *</var></dt>
  <dd>This command controls the audio input port and mute state. The following
      is a list of valid arguments:
    <p class="Pp"></p>
    <dl class="Bl-tag Bl-compact">
      <dt id="AUDIO_TUNER"><a class="permalink" href="#AUDIO_TUNER"><code class="Dv">AUDIO_TUNER</code></a></dt>
      <dd>tuner audio port</dd>
      <dt id="AUDIO_EXTERN"><a class="permalink" href="#AUDIO_EXTERN"><code class="Dv">AUDIO_EXTERN</code></a></dt>
      <dd>external audio port</dd>
      <dt id="AUDIO_INTERN"><a class="permalink" href="#AUDIO_INTERN"><code class="Dv">AUDIO_INTERN</code></a></dt>
      <dd>internal audio port</dd>
      <dt id="AUDIO_MUTE"><a class="permalink" href="#AUDIO_MUTE"><code class="Dv">AUDIO_MUTE</code></a></dt>
      <dd>mute audio</dd>
      <dt id="AUDIO_UNMUTE"><a class="permalink" href="#AUDIO_UNMUTE"><code class="Dv">AUDIO_UNMUTE</code></a></dt>
      <dd>unmute audio</dd>
    </dl>
  </dd>
  <dt id="BT848_GAUDIO"><a class="permalink" href="#BT848_GAUDIO"><code class="Dv">BT848_GAUDIO</code></a>
    <var class="Fa">int *</var></dt>
  <dd>This command fetches the audio input and mute state bits to the
      <var class="Vt">int *</var> argument.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag Bl-compact">
  <dt><span class="Pa">/dev/bktr*</span></dt>
  <dd><code class="Nm">bktr</code> driver interface device</dd>
  <dt><span class="Pa">/dev/tuner*</span></dt>
  <dd><code class="Nm">bktr</code> tuner interface device</dd>
  <dt><span class="Pa">/dev/vbi*</span></dt>
  <dd>teletext interface device</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  ALSO</a></h1>
<p class="Pp"><a class="Xr">options(4)</a>, <a class="Xr">pci(4)</a>,
    <a class="Xr">radio(4)</a>, <span class="Pa">pkgsrc/audio/xmradio</span>,
    <span class="Pa">pkgsrc/multimedia/ffmpeg</span>,
    <span class="Pa">pkgsrc/multimedia/fxtv</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">bktr</code> driver appeared in
    <span class="Ux">FreeBSD 2.2</span> and <span class="Ux">NetBSD
  1.5</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">bktr</code> driver was originally written by
    <span class="An">Amancio Hasty</span> for <span class="Ux">FreeBSD</span>
    and is now maintained by <span class="An">Roger Hardiman</span>.
    <span class="Ux">NetBSD</span> porting was done by <span class="An">Bernd
    Ernesti</span>, <span class="An">Berndt Josef Wulf</span>,
    <span class="An">Matthias Scheler</span>, and <span class="An">Thomas
    Klausner</span>.</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">August 30, 2011</td>
    <td class="foot-os">NetBSD 10.1</td>
  </tr>
</table>