bktr_tuner.h revision 330897
1/* $FreeBSD: stable/11/sys/dev/bktr/bktr_tuner.h 330897 2018-03-14 03:19:51Z eadler $ */
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 Bt848_MAX_TUNER		16
67
68/* experimental code for Automatic Frequency Control */
69#define TUNER_AFC
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 */
75void	select_tuner( bktr_ptr_t bktr, int tuner_type );
76
77/*
78 * The Channel Set maps TV channels eg Ch 36, Ch 51, onto frequencies
79 * and is country specific.
80 */
81int	tuner_getchnlset( struct bktr_chnlset *chnlset );
82
83/*
84 * tv_channel sets the tuner to channel 'n' using the current Channel Set
85 * tv_freq sets the tuner to a specific frequency for TV or for FM Radio
86 * get_tuner_status can be used to get the signal strength.
87 */
88#define TV_FREQUENCY       0
89#define FM_RADIO_FREQUENCY 1
90int	tv_channel( bktr_ptr_t bktr, int channel );
91int	tv_freq( bktr_ptr_t bktr, int frequency, int type );
92int	get_tuner_status( bktr_ptr_t bktr );
93
94#if defined( TUNER_AFC )
95int	do_afc( bktr_ptr_t bktr, int addr, int frequency );
96#endif /* TUNER_AFC */
97
98int mt2032_init(bktr_ptr_t bktr);
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
106
107