xref: /src/sys/dev/pci/bktr/bktr_tuner.c

/* $Sourceforge: bktr_tuner.c,v 1.5 2003/03/13 22:21:04 emsi Exp $ */

/*	$NetBSD: bktr_tuner.c,v 1.13 2021/12/19 22:03:41 andvar Exp $	*/
/* $FreeBSD: src/sys/dev/bktr/bktr_tuner.c,v 1.9 2000/10/19 07:33:28 roger Exp$ */

/*
 * This is part of the Driver for Video Capture Cards (Frame grabbers)
 * and TV Tuner cards using the Brooktree Bt848, Bt848A, Bt849A, Bt878, Bt879
 * chipset.
 * Copyright Roger Hardiman and Amancio Hasty.
 *
 * bktr_tuner : This deals with controlling the tuner fitted to TV cards.
 *
 */

/*
 * 1. Redistributions of source code must retain the
 * Copyright (c) 1997 Amancio Hasty, 1999 Roger Hardiman
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *      This product includes software developed by Amancio Hasty and
 *      Roger Hardiman
 * 4. The name of the author may not be used to endorse or promote products
 *    derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#include <sys/cdefs.h>
__KERNEL_RCSID(0, "$NetBSD: bktr_tuner.c,v 1.13 2021/12/19 22:03:41 andvar Exp $");

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/kernel.h>
#include <sys/vnode.h>
#ifdef __NetBSD__
#include <sys/proc.h>
#endif

#ifdef __FreeBSD__
#include <pci/pcivar.h>

#if (__FreeBSD_version < 500000)
#include <machine/clock.h>              /* for DELAY */
#endif

#if (__FreeBSD_version >=300000)
#include <machine/bus_memio.h>          /* for bus space */
#include <sys/bus.h>
#include <sys/bus.h>
#endif
#endif

#ifdef __NetBSD__
#include <dev/ic/bt8xx.h>	/* NetBSD .h file location */
#include <dev/pci/bktr/bktr_reg.h>
#include <dev/pci/bktr/bktr_tuner.h>
#include <dev/pci/bktr/bktr_card.h>
#include <dev/pci/bktr/bktr_core.h>
#else
#include <machine/ioctl_meteor.h>	/* Traditional .h file location */
#include <machine/ioctl_bt848.h>        /* extensions to ioctl_meteor.h */
#include <dev/bktr/bktr_reg.h>
#include <dev/bktr/bktr_tuner.h>
#include <dev/bktr/bktr_card.h>
#include <dev/bktr/bktr_core.h>
#endif



#if defined(TUNER_AFC)
#define AFC_DELAY               10000   /* 10 milliseconds delay */
#define AFC_BITS                0x07
#define AFC_FREQ_MINUS_125      0x00
#define AFC_FREQ_MINUS_62       0x01
#define AFC_FREQ_CENTERED       0x02
#define AFC_FREQ_PLUS_62        0x03
#define AFC_FREQ_PLUS_125       0x04
#define AFC_MAX_STEP            (5 * FREQFACTOR) /* no more than 5 MHz */
#endif /* TUNER_AFC */


#define TTYPE_XXX               0
#define TTYPE_NTSC              1
#define TTYPE_NTSC_J            2
#define TTYPE_PAL               3
#define TTYPE_PAL_M             4
#define TTYPE_PAL_N             5
#define TTYPE_SECAM             6

#define TSA552x_CB_MSB          (0x80)
#define TSA552x_CB_CP           (1<<6)	/* set this for fast tuning */
#define TSA552x_CB_T2           (1<<5)	/* test mode - Normally set to 0 */
#define TSA552x_CB_T1           (1<<4)	/* test mode - Normally set to 0 */
#define TSA552x_CB_T0           (1<<3)	/* test mode - Normally set to 1 */
#define TSA552x_CB_RSA          (1<<2)	/* 0 for 31.25 kHz, 1 for 62.5 kHz */
#define TSA552x_CB_RSB          (1<<1)	/* 0 for FM 50kHz steps, 1 = Use RSA*/
#define TSA552x_CB_OS           (1<<0)	/* Set to 0 for normal operation */

#define TSA552x_RADIO           (TSA552x_CB_MSB |       \
                                 TSA552x_CB_T0)

/* raise the charge pump voltage for fast tuning */
#define TSA552x_FCONTROL        (TSA552x_CB_MSB |       \
                                 TSA552x_CB_CP  |       \
                                 TSA552x_CB_T0  |       \
                                 TSA552x_CB_RSA |       \
                                 TSA552x_CB_RSB)

/* lower the charge pump voltage for better residual oscillator FM */
#define TSA552x_SCONTROL        (TSA552x_CB_MSB |       \
                                 TSA552x_CB_T0  |       \
                                 TSA552x_CB_RSA |       \
                                 TSA552x_CB_RSB)

/* The control value for the ALPS TSCH5 Tuner */
#define TSCH5_FCONTROL          0x82
#define TSCH5_RADIO             0x86

/* The control value for the ALPS TSBH1 Tuner */
#define TSBH1_FCONTROL		0xce


static const struct TUNER tuners[] = {
/* XXX FIXME: fill in the band-switch crosspoints */
	/* NO_TUNER */
	{ "<no>",				/* the 'name' */
	   TTYPE_XXX,				/* input type */
 	   { 0x00,				/* control byte for Tuner PLL */
 	     0x00,
 	     0x00,
 	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0x00, 0x00, 0x00,0x00} },		/* the band-switch values */

	/* TEMIC_NTSC */
	{ "Temic NTSC",				/* the 'name' */
	   TTYPE_NTSC,				/* input type */
	   { TSA552x_SCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_SCONTROL,
	     TSA552x_SCONTROL,
	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0x02, 0x04, 0x01, 0x00 } },	/* the band-switch values */

	/* TEMIC_PAL */
	{ "Temic PAL",				/* the 'name' */
	   TTYPE_PAL,				/* input type */
	   { TSA552x_SCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_SCONTROL,
	     TSA552x_SCONTROL,
	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0x02, 0x04, 0x01, 0x00 } },	/* the band-switch values */

	/* TEMIC_SECAM */
	{ "Temic SECAM",			/* the 'name' */
	   TTYPE_SECAM,				/* input type */
	   { TSA552x_SCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_SCONTROL,
	     TSA552x_SCONTROL,
	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0x02, 0x04, 0x01,0x00 } },		/* the band-switch values */

	/* PHILIPS_NTSC */
	{ "Philips NTSC",			/* the 'name' */
	   TTYPE_NTSC,				/* input type */
	   { TSA552x_SCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_SCONTROL,
	     TSA552x_SCONTROL,
	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0xa0, 0x90, 0x30, 0x00 } },	/* the band-switch values */

	/* PHILIPS_PAL */
	{ "Philips PAL",			/* the 'name' */
	   TTYPE_PAL,				/* input type */
	   { TSA552x_SCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_SCONTROL,
	     TSA552x_SCONTROL,
	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0xa0, 0x90, 0x30, 0x00 } },	/* the band-switch values */

	/* PHILIPS_SECAM */
	{ "Philips SECAM",			/* the 'name' */
	   TTYPE_SECAM,				/* input type */
	   { TSA552x_SCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_SCONTROL,
	     TSA552x_SCONTROL,
	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0xa7, 0x97, 0x37, 0x00 } },	/* the band-switch values */

	/* TEMIC_PAL I */
	{ "Temic PAL I",			/* the 'name' */
	   TTYPE_PAL,				/* input type */
	   { TSA552x_SCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_SCONTROL,
	     TSA552x_SCONTROL,
	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0x02, 0x04, 0x01,0x00 } },		/* the band-switch values */

	/* PHILIPS_PALI */
	{ "Philips PAL I",			/* the 'name' */
	   TTYPE_PAL,				/* input type */
	   { TSA552x_SCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_SCONTROL,
	     TSA552x_SCONTROL,
	     0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
          { 0xa0, 0x90, 0x30,0x00 } },         /* the band-switch values */

       /* PHILIPS_FR1236_NTSC */
       { "Philips FR1236 NTSC FM",             /* the 'name' */
          TTYPE_NTSC,                          /* input type */
	  { TSA552x_FCONTROL,			/* control byte for Tuner PLL */
	    TSA552x_FCONTROL,
	    TSA552x_FCONTROL,
	    TSA552x_RADIO  },
	   { 160, 454 },			/* band-switch crosspoints */
	  { 0xa0, 0x90, 0x30,0xa4 } },		/* the band-switch values */

	/* PHILIPS_FR1216_PAL */
	{ "Philips FR1216 PAL FM" ,		/* the 'name' */
	   TTYPE_PAL,				/* input type */
	   { TSA552x_FCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_FCONTROL,
	     TSA552x_FCONTROL,
	     TSA552x_RADIO },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0xa0, 0x90, 0x30, 0xa4 } },	/* the band-switch values */

	/* PHILIPS_FR1236_SECAM */
	{ "Philips FR1236 SECAM FM",		/* the 'name' */
	   TTYPE_SECAM,				/* input type */
	   { TSA552x_FCONTROL,			/* control byte for Tuner PLL */
	     TSA552x_FCONTROL,
	     TSA552x_FCONTROL,
	     TSA552x_RADIO },
	   { 160, 454 },			/* band-switch crosspoints */
	   { 0xa7, 0x97, 0x37, 0xa4 } },	/* the band-switch values */

        /* ALPS TSCH5 NTSC */
        { "ALPS TSCH5 NTSC FM",                 /* the 'name' */
           TTYPE_NTSC,                          /* input type */
           { TSCH5_FCONTROL,                    /* control byte for Tuner PLL */
             TSCH5_FCONTROL,
             TSCH5_FCONTROL,
             TSCH5_RADIO },
	   { 160, 454 },			/* band-switch crosspoints */
           { 0x14, 0x12, 0x11, 0x04 } },        /* the band-switch values */

        /* ALPS TSBH1 NTSC */
        { "ALPS TSBH1 NTSC",                    /* the 'name' */
           TTYPE_NTSC,                          /* input type */
           { TSBH1_FCONTROL,                    /* control byte for Tuner PLL */
             TSBH1_FCONTROL,
             TSBH1_FCONTROL,
             0x00 },
	   { 160, 454 },			/* band-switch crosspoints */
           { 0x01, 0x02, 0x08, 0x00 } }         /* the band-switch values */
};


/* scaling factor for frequencies expressed as ints */
#define FREQFACTOR		16

/*
 * Format:
 *	entry 0:         MAX legal channel
 *	entry 1:         IF frequency
 *			 expressed as fi{MHz} * 16,
 *			 eg 45.75MHz == 45.75 * 16 = 732
 *	entry 2:         [place holder/future]
 *	entry 3:         base of channel record 0
 *	entry 3 + (x*3): base of channel record 'x'
 *	entry LAST:      NULL channel entry marking end of records
 *
 * Record:
 *	int 0:		base channel
 *	int 1:		frequency of base channel,
 *			 expressed as fb{MHz} * 16,
 *	int 2:		offset frequency between channels,
 *			 expressed as fo{MHz} * 16,
 */

/*
 * North American Broadcast Channels:
 *
 *  2:  55.25 MHz -  4:  67.25 MHz
 *  5:  77.25 MHz -  6:	 83.25 MHz
 *  7: 175.25 MHz - 13:	211.25 MHz
 * 14: 471.25 MHz - 83:	885.25 MHz
 *
 * IF freq: 45.75 MHz
 */
#define OFFSET	6.00
static const int nabcst[] = {
	83,	(int)( 45.75 * FREQFACTOR),	0,
	14,	(int)(471.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 7,	(int)(175.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 5,	(int)( 77.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 2,	(int)( 55.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 0
};
#undef OFFSET

/*
 * North American Cable Channels, IRC:
 *
 *  2:  55.25 MHz -  4:  67.25 MHz
 *  5:  77.25 MHz -  6:  83.25 MHz
 *  7: 175.25 MHz - 13: 211.25 MHz
 * 14: 121.25 MHz - 22: 169.25 MHz
 * 23: 217.25 MHz - 94: 643.25 MHz
 * 95:  91.25 MHz - 99: 115.25 MHz
 *
 * IF freq: 45.75 MHz
 */
#define OFFSET	6.00
static const int irccable[] = {
	116,	(int)( 45.75 * FREQFACTOR),	0,
	100,	(int)(649.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 95,	(int)( 91.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 23,	(int)(217.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 14,	(int)(121.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	  7,	(int)(175.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	  5,	(int)( 77.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	  2,	(int)( 55.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	  0
};
#undef OFFSET

/*
 * North American Cable Channels, HRC:
 *
 * 2:   54 MHz  - 4:    66 MMz
 * 5:   78 MHz  - 6:    84 MHz
 * 7:  174 MHz  - 13:  210 MHz
 * 14: 120 MHz  - 22:  168 MHz
 * 23: 216 MHz  - 94:  642 MHz
 * 95:  90 MHz  - 99:  114 MHz
 *
 * IF freq: 45.75 MHz
 */
#define OFFSET  6.00
static const int hrccable[] = {
	116,	(int)( 45.75 * FREQFACTOR),	0,
	100,	(int)(648.00 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 95,	(int)( 90.00 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 23,	(int)(216.00 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 14,	(int)(120.00 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	  7,	(int)(174.00 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	  5,	(int)( 78.00 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	  2,	(int)( 54.00 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	  0
};
#undef OFFSET

/*
 * Western European broadcast channels:
 *
 * (there are others that appear to vary between countries - rmt)
 *
 * here's the table Philips provides:
 * caution, some of the offsets don't compute...
 *
 *  1	 4525	700	N21
 *
 *  2	 4825	700	E2
 *  3	 5525	700	E3
 *  4	 6225	700	E4
 *
 *  5	17525	700	E5
 *  6	18225	700	E6
 *  7	18925	700	E7
 *  8	19625	700	E8
 *  9	20325	700	E9
 * 10	21025	700	E10
 * 11	21725	700	E11
 * 12	22425	700	E12
 *
 * 13	 5375	700	ITA
 * 14	 6225	700	ITB
 *
 * 15	 8225	700	ITC
 *
 * 16	17525	700	ITD
 * 17	18325	700	ITE
 *
 * 18	19225	700	ITF
 * 19	20125	700	ITG
 * 20	21025	700	ITH
 *
 * 21	47125	800	E21
 * 22	47925	800	E22
 * 23	48725	800	E23
 * 24	49525	800	E24
 * 25	50325	800	E25
 * 26	51125	800	E26
 * 27	51925	800	E27
 * 28	52725	800	E28
 * 29	53525	800	E29
 * 30	54325	800	E30
 * 31	55125	800	E31
 * 32	55925	800	E32
 * 33	56725	800	E33
 * 34	57525	800	E34
 * 35	58325	800	E35
 * 36	59125	800	E36
 * 37	59925	800	E37
 * 38	60725	800	E38
 * 39	61525	800	E39
 * 40	62325	800	E40
 * 41	63125	800	E41
 * 42	63925	800	E42
 * 43	64725	800	E43
 * 44	65525	800	E44
 * 45	66325	800	E45
 * 46	67125	800	E46
 * 47	67925	800	E47
 * 48	68725	800	E48
 * 49	69525	800	E49
 * 50	70325	800	E50
 * 51	71125	800	E51
 * 52	71925	800	E52
 * 53	72725	800	E53
 * 54	73525	800	E54
 * 55	74325	800	E55
 * 56	75125	800	E56
 * 57	75925	800	E57
 * 58	76725	800	E58
 * 59	77525	800	E59
 * 60	78325	800	E60
 * 61	79125	800	E61
 * 62	79925	800	E62
 * 63	80725	800	E63
 * 64	81525	800	E64
 * 65	82325	800	E65
 * 66	83125	800	E66
 * 67	83925	800	E67
 * 68	84725	800	E68
 * 69	85525	800	E69
 *
 * 70	 4575	800	IA
 * 71	 5375	800	IB
 * 72	 6175	800	IC
 *
 * 74	 6925	700	S01
 * 75	 7625	700	S02
 * 76	 8325	700	S03
 *
 * 80	10525	700	S1
 * 81	11225	700	S2
 * 82	11925	700	S3
 * 83	12625	700	S4
 * 84	13325	700	S5
 * 85	14025	700	S6
 * 86	14725	700	S7
 * 87	15425	700	S8
 * 88	16125	700	S9
 * 89	16825	700	S10
 * 90	23125	700	S11
 * 91	23825	700	S12
 * 92	24525	700	S13
 * 93	25225	700	S14
 * 94	25925	700	S15
 * 95	26625	700	S16
 * 96	27325	700	S17
 * 97	28025	700	S18
 * 98	28725	700	S19
 * 99	29425	700	S20
 *
 *
 * Channels S21 - S41 are taken from
 * http://gemma.apple.com:80/dev/technotes/tn/tn1012.html
 *
 * 100	30325	800	S21
 * 101	31125	800	S22
 * 102	31925	800	S23
 * 103	32725	800	S24
 * 104	33525	800	S25
 * 105	34325	800	S26
 * 106	35125	800	S27
 * 107	35925	800	S28
 * 108	36725	800	S29
 * 109	37525	800	S30
 * 110	38325	800	S31
 * 111	39125	800	S32
 * 112	39925	800	S33
 * 113	40725	800	S34
 * 114	41525	800	S35
 * 115	42325	800	S36
 * 116	43125	800	S37
 * 117	43925	800	S38
 * 118	44725	800	S39
 * 119	45525	800	S40
 * 120	46325	800	S41
 *
 * 121	 3890	000	IFFREQ
 *
 */
static const int weurope[] = {
	121,	(int)( 38.90 * FREQFACTOR),	0,
	100,	(int)(303.25 * FREQFACTOR),	(int)(8.00 * FREQFACTOR),
	 90,	(int)(231.25 * FREQFACTOR),	(int)(7.00 * FREQFACTOR),
	 80,	(int)(105.25 * FREQFACTOR),	(int)(7.00 * FREQFACTOR),
	 74,	(int)( 69.25 * FREQFACTOR),	(int)(7.00 * FREQFACTOR),
	 21,	(int)(471.25 * FREQFACTOR),	(int)(8.00 * FREQFACTOR),
	 17,	(int)(183.25 * FREQFACTOR),	(int)(9.00 * FREQFACTOR),
	 16,	(int)(175.25 * FREQFACTOR),	(int)(9.00 * FREQFACTOR),
	 15,	(int)( 82.25 * FREQFACTOR),	(int)(8.50 * FREQFACTOR),
	 13,	(int)( 53.75 * FREQFACTOR),	(int)(8.50 * FREQFACTOR),
	  5,	(int)(175.25 * FREQFACTOR),	(int)(7.00 * FREQFACTOR),
	  2,	(int)( 48.25 * FREQFACTOR),	(int)(7.00 * FREQFACTOR),
	  0
};

/*
 * Japanese Broadcast Channels:
 *
 *  1:  91.25MHz -  3: 103.25MHz
 *  4: 171.25MHz -  7: 189.25MHz
 *  8: 193.25MHz - 12: 217.25MHz  (VHF)
 * 13: 471.25MHz - 62: 765.25MHz  (UHF)
 *
 * IF freq: 45.75 MHz
 *  OR
 * IF freq: 58.75 MHz
 */
#define OFFSET  6.00
#define IF_FREQ 45.75
static const int jpnbcst[] = {
	62,	(int)(IF_FREQ * FREQFACTOR),	0,
	13,	(int)(471.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 8,	(int)(193.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 4,	(int)(171.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 1,	(int)( 91.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 0
};
#undef IF_FREQ
#undef OFFSET

/*
 * Japanese Cable Channels:
 *
 *  1:  91.25MHz -  3: 103.25MHz
 *  4: 171.25MHz -  7: 189.25MHz
 *  8: 193.25MHz - 12: 217.25MHz
 * 13: 109.25MHz - 21: 157.25MHz
 * 22: 165.25MHz
 * 23: 223.25MHz - 63: 463.25MHz
 *
 * IF freq: 45.75 MHz
 */
#define OFFSET  6.00
#define IF_FREQ 45.75
static const int jpncable[] = {
	63,	(int)(IF_FREQ * FREQFACTOR),	0,
	23,	(int)(223.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	22,	(int)(165.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	13,	(int)(109.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 8,	(int)(193.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 4,	(int)(171.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 1,	(int)( 91.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 0
};
#undef IF_FREQ
#undef OFFSET

/*
 * xUSSR Broadcast Channels:
 *
 *  1:  49.75MHz -  2:  59.25MHz
 *  3:  77.25MHz -  5:  93.25MHz
 *  6: 175.25MHz - 12: 223.25MHz
 * 13-20 - not exist
 * 21: 471.25MHz - 34: 575.25MHz
 * 35: 583.25MHz - 69: 855.25MHz
 *
 * Cable channels
 *
 * 70: 111.25MHz - 77: 167.25MHz
 * 78: 231.25MHz -107: 463.25MHz
 *
 * IF freq: 38.90 MHz
 */
#define IF_FREQ 38.90
static const int xussr[] = {
	107,	(int)(IF_FREQ * FREQFACTOR),	0,
	 78,	(int)(231.25 * FREQFACTOR),	(int)(8.00 * FREQFACTOR),
	 70,	(int)(111.25 * FREQFACTOR),	(int)(8.00 * FREQFACTOR),
	 35,	(int)(583.25 * FREQFACTOR),	(int)(8.00 * FREQFACTOR),
	 21,	(int)(471.25 * FREQFACTOR),	(int)(8.00 * FREQFACTOR),
	  6,	(int)(175.25 * FREQFACTOR),	(int)(8.00 * FREQFACTOR),
	  3,	(int)( 77.25 * FREQFACTOR),	(int)(8.00 * FREQFACTOR),
	  1,	(int)( 49.75 * FREQFACTOR),	(int)(9.50 * FREQFACTOR),
	  0
};
#undef IF_FREQ

/*
 * Australian broadcast channels
 */
#define OFFSET	7.00
#define IF_FREQ 38.90
static const int australia[] = {
	83,	(int)(IF_FREQ * FREQFACTOR),	0,
	28,	(int)(527.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	10,	(int)(209.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 6,	(int)(175.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 4,	(int)( 95.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 3,	(int)( 86.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 1,	(int)( 57.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR),
	 0
};
#undef OFFSET
#undef IF_FREQ

/*
 * France broadcast channels
 */
#define OFFSET 8.00
#define IF_FREQ 38.90
static const int france[] = {
	69,	(int)(IF_FREQ * FREQFACTOR),	0,
	21,	(int)(471.25 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR), /* 21 -> 69 */
	 5,	(int)(176.00 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR), /* 5 -> 10 */
	 4,	(int)( 63.75 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR), /* 4    */
	 3,	(int)( 60.50 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR), /* 3    */
	 1,	(int)( 47.75 * FREQFACTOR),	(int)(OFFSET * FREQFACTOR), /* 1  2 */
	 0
};
#undef OFFSET
#undef IF_FREQ

static const struct {
        const int     *ptr;
        const char    name[BT848_MAX_CHNLSET_NAME_LEN];
} freqTable[] = {
        {NULL,          ""},
        {nabcst,        "nabcst"},
        {irccable,      "cableirc"},
        {hrccable,      "cablehrc"},
        {weurope,       "weurope"},
        {jpnbcst,       "jpnbcst"},
        {jpncable,      "jpncable"},
        {xussr,         "xussr"},
        {australia,     "australia"},
        {france,        "france"},

};

#define TBL_CHNL	freqTable[bktr->tuner.chnlset].ptr[x]
#define TBL_BASE_FREQ	freqTable[bktr->tuner.chnlset].ptr[x + 1]
#define TBL_OFFSET	freqTable[bktr->tuner.chnlset].ptr[x + 2]
static int
frequency_lookup(bktr_ptr_t bktr, int channel)
{
	int	x;

	/* check for "> MAX channel" */
	x = 0;
	if (channel > TBL_CHNL)
		return(-1);

	/* search the table for data */
	for (x = 3; TBL_CHNL; x += 3) {
		if (channel >= TBL_CHNL) {
			return(TBL_BASE_FREQ +
				 ((channel - TBL_CHNL) * TBL_OFFSET));
		}
	}

	/* not found, must be below the MIN channel */
	return(-1);
}
#undef TBL_OFFSET
#undef TBL_BASE_FREQ
#undef TBL_CHNL


#define TBL_IF	freqTable[bktr->tuner.chnlset].ptr[1]


/* Initialise the tuner structures in the bktr_softc */
/* This is needed as the tuner details are no longer globally declared */

void    select_tuner(bktr_ptr_t bktr, int tuner_type) {
	if (tuner_type < Bt848_MAX_TUNER) {
		bktr->card.tuner = &tuners[tuner_type];
	} else {
		bktr->card.tuner = NULL;
	}
}

/*
 * Tuner Notes:
 * Programming the tuner properly is quite complicated.
 * Here are some notes, based on a FM1246 data sheet for a PAL-I tuner.
 * The tuner (front end) covers 45.75 MHz - 855.25 MHz and an FM band of
 * 87.5 MHz to 108.0 MHz.
 *
 * RF and IF.  RF = radio frequencies, it is the transmitted signal.
 *             IF is the Intermediate Frequency (the offset from the base
 *             signal where the video, color,  audio and NICAM signals are.
 *
 * Eg, Picture at 38.9 MHz, Colour at 34.47 MHz, sound at 32.9 MHz
 * NICAM at 32.348 MHz.
 * Strangely enough, there is an IF (intermediate frequency) for
 * FM Radio which is 10.7 MHz.
 *
 * The tuner also works in Bands. Philips bands are
 * FM radio band 87.50 to 108.00 MHz
 * Low band 45.75 to 170.00 MHz
 * Mid band 170.00 to 450.00 MHz
 * High band 450.00 to 855.25 MHz
 *
 *
 * Now we need to set the PLL on the tuner to the required frequency.
 * It has a programmable divisor.
 * For TV we want
 *  N = 16 (freq RF(pc) + freq IF(pc))  pc is picture carrier and RF and IF
 *  are in MHz.

 * For RADIO we want a different equation.
 *  freq IF is 10.70 MHz (so the data sheet tells me)
 * N = (freq RF + freq IF) / step size
 * The step size must be set to 50 kHz (so the data sheet tells me)
 * (note this is 50 kHz, the other things are in MHz)
 * so we end up with N = 20x(freq RF + 10.7)
 *
 */

#define LOW_BAND 0
#define MID_BAND 1
#define HIGH_BAND 2
#define FM_RADIO_BAND 3


/* Check if these are correct for other than Philips PAL */
#define STATUSBIT_COLD   0x80
#define STATUSBIT_LOCK   0x40
#define STATUSBIT_TV     0x20
#define STATUSBIT_STEREO 0x10 /* valid if FM (aka not TV) */
#define STATUSBIT_ADC    0x07

/*
 * set the frequency of the tuner
 * If 'type' is TV_FREQUENCY, the frequency is freq MHz*16
 * If 'type' is FM_RADIO_FREQUENCY, the frequency is freq MHz * 100
 * (note *16 gives is 4 bits of fraction, eg steps of nnn.0625)
 *
 */
int
tv_freq(bktr_ptr_t bktr, int frequency, int type)
{
	const struct TUNER*	tuner;
	u_char			addr;
	u_char			control;
	u_char			band;
	int			N;
	int			band_select = 0;
#if defined(TEST_TUNER_AFC)
	int			oldFrequency, afcDelta;
#endif

	tuner = bktr->card.tuner;
	if (tuner == NULL)
		return(-1);

	if (type == TV_FREQUENCY) {
		/*
		 * select the band based on frequency
		 */
		if (frequency < (tuner->bandLimits[0] * FREQFACTOR))
		    band_select = LOW_BAND;
		else if (frequency < (tuner->bandLimits[1] * FREQFACTOR))
		    band_select = MID_BAND;
		else
		    band_select = HIGH_BAND;

#if defined(TEST_TUNER_AFC)
		if (bktr->tuner.afc)
			frequency -= 4;
#endif
		/*
		 * N = 16 * { fRF(pc) + fIF(pc) }
		 * or N = 16* fRF(pc) + 16*fIF(pc) }
		 * where:
		 *  pc is picture carrier, fRF & fIF are in MHz
		 *
		 * fortunately, frequency is passed in as MHz * 16
		 * and the TBL_IF frequency is also stored in MHz * 16
		 */
		N = frequency + TBL_IF;

		/* set the address of the PLL */
		addr    = bktr->card.tuner_pllAddr;
		control = tuner->pllControl[band_select];
		band    = tuner->bandAddrs[band_select];

		if(!(band && control))		/* Don't try to set un-	*/
		  return(-1);			/* supported modes.	*/

		if (frequency > bktr->tuner.frequency) {
			i2cWrite(bktr, addr, (N>>8) & 0x7f, N & 0xff);
			i2cWrite(bktr, addr, control, band);
	        }
	        else {
			i2cWrite(bktr, addr, control, band);
			i2cWrite(bktr, addr, (N>>8) & 0x7f, N & 0xff);
       		}

#if defined(TUNER_AFC)
		if (bktr->tuner.afc == TRUE) {
#if defined(TEST_TUNER_AFC)
			oldFrequency = frequency;
#endif
			if ((N = do_afc(bktr, addr, N)) < 0) {
			    /* AFC failed, restore requested frequency */
			    N = frequency + TBL_IF;
#if defined(TEST_TUNER_AFC)
			    printf("%s: do_afc: failed to lock\n",
				   bktr_name(bktr));
#endif
			    i2cWrite(bktr, addr, (N>>8) & 0x7f, N & 0xff);
			}
			else
			    frequency = N - TBL_IF;
#if defined(TEST_TUNER_AFC)
 printf("%s: do_afc: returned freq %d (%d %% %d)\n", bktr_name(bktr), frequency, frequency / 16, frequency % 16);
			    afcDelta = frequency - oldFrequency;
 printf("%s: changed by: %d clicks (%d mod %d)\n", bktr_name(bktr), afcDelta, afcDelta / 16, afcDelta % 16);
#endif
			}
#endif /* TUNER_AFC */

		bktr->tuner.frequency = frequency;
	}

	if (type == FM_RADIO_FREQUENCY) {
		band_select = FM_RADIO_BAND;

		/*
		 * N = { fRF(pc) + fIF(pc) }/step_size
                 * The step size is 50kHz for FM radio.
		 * (eg after 102.35MHz comes 102.40 MHz)
		 * fIF is 10.7 MHz (as detailed in the specs)
		 *
		 * frequency is passed in as MHz * 100
		 *
		 * So, we have N = (frequency/100 + 10.70)  /(50/1000)
		 */
		N = (frequency + 1070)/5;

		/* set the address of the PLL */
		addr    = bktr->card.tuner_pllAddr;
		control = tuner->pllControl[band_select];
		band    = tuner->bandAddrs[band_select];

		if(!(band && control))		/* Don't try to set un-	*/
		  return(-1);			/* supported modes.	*/

		band |= bktr->tuner.radio_mode; /* tuner.radio_mode is set in
						 * the ioctls RADIO_SETMODE
						 * and RADIO_GETMODE */

		i2cWrite(bktr, addr, control, band);
		i2cWrite(bktr, addr, (N>>8) & 0x7f, N & 0xff);

		bktr->tuner.frequency = (N * 5) - 1070;


	}


	return(0);
}



#if defined(TUNER_AFC)
/*
 *
 */
int
do_afc(bktr_ptr_t bktr, int addr, int frequency)
{
	int step;
	int status;
	int origFrequency;

	origFrequency = frequency;

	/* wait for first setting to take effect */
	tsleep(BKTR_SLEEP, PZERO, "tuning", hz/8);

	if ((status = i2cRead(bktr, addr + 1)) < 0)
		return(-1);

#if defined(TEST_TUNER_AFC)
 printf("%s: Original freq: %d, status: 0x%02x\n", bktr_name(bktr), frequency, status);
#endif
	for (step = 0; step < AFC_MAX_STEP; ++step) {
		if ((status = i2cRead(bktr, addr + 1)) < 0)
			goto fubar;
		if (!(status & 0x40)) {
#if defined(TEST_TUNER_AFC)
 printf("%s: no lock!\n", bktr_name(bktr));
#endif
			goto fubar;
		}

		switch(status & AFC_BITS) {
		case AFC_FREQ_CENTERED:
#if defined(TEST_TUNER_AFC)
 printf("%s: Centered, freq: %d, status: 0x%02x\n", bktr_name(bktr), frequency, status);
#endif
			return(frequency);

		case AFC_FREQ_MINUS_125:
		case AFC_FREQ_MINUS_62:
#if defined(TEST_TUNER_AFC)
 printf("%s: Low, freq: %d, status: 0x%02x\n", bktr_name(bktr), frequency, status);
#endif
			--frequency;
			break;

		case AFC_FREQ_PLUS_62:
		case AFC_FREQ_PLUS_125:
#if defined(TEST_TUNER_AFC)
 printf("%s: Hi, freq: %d, status: 0x%02x\n", bktr_name(bktr), frequency, status);
#endif
			++frequency;
			break;
		}

		i2cWrite(bktr, addr,
			  (frequency>>8) & 0x7f, frequency & 0xff);
		DELAY(AFC_DELAY);
	}

 fubar:
	i2cWrite(bktr, addr,
		  (origFrequency>>8) & 0x7f, origFrequency & 0xff);

	return(-1);
}
#endif /* TUNER_AFC */
#undef TBL_IF


/*
 * Get the Tuner status and signal strength
 */
int     get_tuner_status(bktr_ptr_t bktr) {
	return i2cRead(bktr, bktr->card.tuner_pllAddr + 1);
}

/*
 * set the channel of the tuner
 */
int
tv_channel(bktr_ptr_t bktr, int channel)
{
	int frequency;

	/* calculate the frequency according to tuner type */
	if ((frequency = frequency_lookup(bktr, channel)) < 0)
		return(-1);

	/* set the new frequency */
	if (tv_freq(bktr, frequency, TV_FREQUENCY) < 0)
		return(-1);

	/* OK to update records */
	return((bktr->tuner.channel = channel));
}

/*
 * get channelset name
 */
int
tuner_getchnlset(struct bktr_chnlset *chnlset)
{
       if ((chnlset->index < CHNLSET_MIN) ||
               (chnlset->index > CHNLSET_MAX))
                       return(EINVAL);

       memcpy(&chnlset->name, &freqTable[chnlset->index].name,
               BT848_MAX_CHNLSET_NAME_LEN);

       chnlset->max_channel=freqTable[chnlset->index].ptr[0];
       return(0);
}