xref: /freebsd-12.1/sys/dev/bktr/bktr_tuner.h (revision 4c9d19e8)
1 /* $FreeBSD$ */
2 
3 /*
4  * This is part of the Driver for Video Capture Cards (Frame grabbers)
5  * and TV Tuner cards using the Brooktree Bt848, Bt848A, Bt849A, Bt878, Bt879
6  * chipset.
7  * Copyright Roger Hardiman and Amancio Hasty.
8  *
9  * bktr_tuner : This deals with controlling the tuner fitted to TV cards.
10  *
11  */
12 
13 /*-
14  * SPDX-License-Identifier: BSD-4-Clause
15  *
16  * 1. Redistributions of source code must retain the
17  * Copyright (c) 1997 Amancio Hasty, 1999 Roger Hardiman
18  * All rights reserved.
19  *
20  * Redistribution and use in source and binary forms, with or without
21  * modification, are permitted provided that the following conditions
22  * are met:
23  * 1. Redistributions of source code must retain the above copyright
24  *    notice, this list of conditions and the following disclaimer.
25  * 2. Redistributions in binary form must reproduce the above copyright
26  *    notice, this list of conditions and the following disclaimer in the
27  *    documentation and/or other materials provided with the distribution.
28  * 3. All advertising materials mentioning features or use of this software
29  *    must display the following acknowledgement:
30  *      This product includes software developed by Amancio Hasty and
31  *      Roger Hardiman
32  * 4. The name of the author may not be used to endorse or promote products
33  *    derived from this software without specific prior written permission.
34  *
35  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
36  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
37  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
38  * DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
39  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
40  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
41  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
42  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
43  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
44  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
45  * POSSIBILITY OF SUCH DAMAGE.
46  */
47 
48 /* Definitions for Tuners */
49 
50 #define NO_TUNER		0
51 #define TEMIC_NTSC		1
52 #define TEMIC_PAL		2
53 #define TEMIC_SECAM		3
54 #define PHILIPS_NTSC		4
55 #define PHILIPS_PAL		5
56 #define PHILIPS_SECAM		6
57 #define TEMIC_PALI		7
58 #define PHILIPS_PALI		8
59 #define PHILIPS_FR1236_NTSC	9	/* These have FM radio support */
60 #define PHILIPS_FR1216_PAL	10	/* These have FM radio support */
61 #define PHILIPS_FR1236_SECAM	11	/* These have FM radio support */
62 #define ALPS_TSCH5		12
63 #define ALPS_TSBH1		13
64 #define TUNER_MT2032		14
65 #define	LG_TPI8PSB12P_PAL	15
66 #define PHILIPS_FI1216          16
67 #define Bt848_MAX_TUNER		17
68 
69 /* experimental code for Automatic Frequency Control */
70 #define TUNER_AFC
71 
72 /*
73  * Fill in the tuner entries in the bktr_softc based on the selected tuner
74  * type (from the list of tuners above)
75  */
76 void	select_tuner( bktr_ptr_t bktr, int tuner_type );
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 int mt2032_init(bktr_ptr_t bktr);
100 
101 /*
102  * This is for start-up convenience only, NOT mandatory.
103  */
104 #if !defined( DEFAULT_CHNLSET )
105 #define DEFAULT_CHNLSET CHNLSET_WEUROPE
106 #endif
107 
108