Merge from vendor branch FILE:
[dragonfly.git] / sys / dev / video / bktr / bktr_tuner.h
1 /* $FreeBSD: src/sys/dev/bktr/bktr_tuner.h,v 1.6 2005/01/23 07:13:09 julian Exp */
2 /* $DragonFly: src/sys/dev/video/bktr/bktr_tuner.h,v 1.4 2005/03/12 11:35:27 corecode Exp $ */
3
4 /*
5  * This is part of the Driver for Video Capture Cards (Frame grabbers)
6  * and TV Tuner cards using the Brooktree Bt848, Bt848A, Bt849A, Bt878, Bt879
7  * chipset.
8  * Copyright Roger Hardiman and Amancio Hasty.
9  * 
10  * bktr_tuner : This deals with controlling the tuner fitted to TV cards.
11  *
12  */
13
14 /*
15  * 1. Redistributions of source code must retain the
16  * Copyright (c) 1997 Amancio Hasty, 1999 Roger Hardiman
17  * All rights reserved.
18  *
19  * Redistribution and use in source and binary forms, with or without
20  * modification, are permitted provided that the following conditions
21  * are met:
22  * 1. Redistributions of source code must retain the above copyright
23  *    notice, this list of conditions and the following disclaimer.
24  * 2. Redistributions in binary form must reproduce the above copyright
25  *    notice, this list of conditions and the following disclaimer in the
26  *    documentation and/or other materials provided with the distribution.
27  * 3. All advertising materials mentioning features or use of this software
28  *    must display the following acknowledgement:
29  *      This product includes software developed by Amancio Hasty and
30  *      Roger Hardiman
31  * 4. The name of the author may not be used to endorse or promote products
32  *    derived from this software without specific prior written permission.
33  *
34  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
35  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
36  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
37  * DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
38  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
39  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
40  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
41  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
42  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
43  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
44  * POSSIBILITY OF SUCH DAMAGE.
45  */
46
47 /* Definitions for Tuners */
48
49 #define NO_TUNER                0
50 #define TEMIC_NTSC              1
51 #define TEMIC_PAL               2
52 #define TEMIC_SECAM             3
53 #define PHILIPS_NTSC            4
54 #define PHILIPS_PAL             5
55 #define PHILIPS_SECAM           6
56 #define TEMIC_PALI              7
57 #define PHILIPS_PALI            8
58 #define PHILIPS_FR1236_NTSC     9    /* These have FM radio support */
59 #define PHILIPS_FR1216_PAL      10   /* These have FM radio support */
60 #define PHILIPS_FR1236_SECAM    11   /* These have FM radio support */
61 #define ALPS_TSCH5              12
62 #define ALPS_TSBH1              13
63 #define TUNER_MT2032            14
64 #define Bt848_MAX_TUNER         15
65
66 /* experimental code for Automatic Frequency Control */ 
67 #define TUNER_AFC
68
69 int mt2032_init(bktr_ptr_t bktr);                                              
70
71 /*
72  * Fill in the tuner entries in the bktr_softc based on the selected tuner
73  * type (from the list of tuners above)
74  */
75 void    select_tuner( bktr_ptr_t bktr, int tuner_type );
76
77
78 /*
79  * The Channel Set maps TV channels eg Ch 36, Ch 51, onto frequencies
80  * and is country specific.
81  */
82 int     tuner_getchnlset( struct bktr_chnlset *chnlset );
83
84 /*
85  * tv_channel sets the tuner to channel 'n' using the current Channel Set
86  * tv_freq sets the tuner to a specific frequency for TV or for FM Radio
87  * get_tuner_status can be used to get the signal strength.
88  */
89 #define TV_FREQUENCY       0
90 #define FM_RADIO_FREQUENCY 1
91 int     tv_channel( bktr_ptr_t bktr, int channel );
92 int     tv_freq( bktr_ptr_t bktr, int frequency, int type );
93 int     get_tuner_status( bktr_ptr_t bktr );
94
95 #if defined( TUNER_AFC )
96 int     do_afc( bktr_ptr_t bktr, int addr, int frequency );
97 #endif /* TUNER_AFC */
98
99
100 /* 
101  * This is for start-up convenience only, NOT mandatory.
102  */
103 #if !defined( DEFAULT_CHNLSET )
104 #define DEFAULT_CHNLSET CHNLSET_WEUROPE
105 #endif