3  * i2c tv tuner chip device driver
 
   4  * controls all those simple 4-control-bytes style tuners.
 
   6 #include <linux/delay.h>
 
   8 #include <linux/videodev.h>
 
   9 #include <media/tuner.h>
 
  10 #include <media/v4l2-common.h>
 
  12 static int offset = 0;
 
  13 module_param(offset, int, 0664);
 
  14 MODULE_PARM_DESC(offset,"Allows to specify an offset for tuner");
 
  16 /* ---------------------------------------------------------------------- */
 
  18 /* tv standard selection for Temic 4046 FM5
 
  19    this value takes the low bits of control byte 2
 
  20    from datasheet Rev.01, Feb.00
 
  22      picture IF   38.9    38.9    38.9    33.95   38.9
 
  23      sound 1      33.4    32.9    32.4    40.45   32.4
 
  25      NICAM        33.05   32.348  33.05           33.05
 
  27 #define TEMIC_SET_PAL_I         0x05
 
  28 #define TEMIC_SET_PAL_DK        0x09
 
  29 #define TEMIC_SET_PAL_L         0x0a // SECAM ?
 
  30 #define TEMIC_SET_PAL_L2        0x0b // change IF !
 
  31 #define TEMIC_SET_PAL_BG        0x0c
 
  33 /* tv tuner system standard selection for Philips FQ1216ME
 
  34    this value takes the low bits of control byte 2
 
  35    from datasheet "1999 Nov 16" (supersedes "1999 Mar 23")
 
  37      picture carrier    38.90   38.90   38.90   38.90   33.95
 
  38      colour             34.47   34.47   34.47   34.47   38.38
 
  39      sound 1            33.40   32.40   32.90   32.40   40.45
 
  41      NICAM              33.05   33.05   32.35   33.05   39.80
 
  43 #define PHILIPS_SET_PAL_I       0x01 /* Bit 2 always zero !*/
 
  44 #define PHILIPS_SET_PAL_BGDK    0x09
 
  45 #define PHILIPS_SET_PAL_L2      0x0a
 
  46 #define PHILIPS_SET_PAL_L       0x0b
 
  48 /* system switching for Philips FI1216MF MK2
 
  49    from datasheet "1996 Jul 09",
 
  51     picture carrier  38.90  38.90  33.95
 
  52     colour           34.47  34.37  38.38
 
  53     sound 1          33.40  32.40  40.45
 
  55     NICAM            33.05  33.05  39.80
 
  57 #define PHILIPS_MF_SET_BG       0x01 /* Bit 2 must be zero, Bit 3 is system output */
 
  58 #define PHILIPS_MF_SET_PAL_L    0x03 // France
 
  59 #define PHILIPS_MF_SET_PAL_L2   0x02 // L'
 
  63 #define TUNER_RATIO_MASK        0x06 /* Bit cb1:cb2 */
 
  64 #define TUNER_RATIO_SELECT_50   0x00
 
  65 #define TUNER_RATIO_SELECT_32   0x02
 
  66 #define TUNER_RATIO_SELECT_166  0x04
 
  67 #define TUNER_RATIO_SELECT_62   0x06
 
  69 #define TUNER_CHARGE_PUMP       0x40  /* Bit cb6 */
 
  73 #define TUNER_POR         0x80
 
  75 #define TUNER_MODE        0x38
 
  76 #define TUNER_AFC         0x07
 
  77 #define TUNER_SIGNAL      0x07
 
  78 #define TUNER_STEREO      0x10
 
  80 #define TUNER_PLL_LOCKED   0x40
 
  81 #define TUNER_STEREO_MK3   0x04
 
  83 /* ---------------------------------------------------------------------- */
 
  85 static int tuner_getstatus(struct i2c_client *c)
 
  89         if (1 != i2c_master_recv(c,&byte,1))
 
  95 static int tuner_signal(struct i2c_client *c)
 
  97         return (tuner_getstatus(c) & TUNER_SIGNAL) << 13;
 
 100 static int tuner_stereo(struct i2c_client *c)
 
 103         struct tuner *t = i2c_get_clientdata(c);
 
 105         status = tuner_getstatus (c);
 
 108                 case TUNER_PHILIPS_FM1216ME_MK3:
 
 109                 case TUNER_PHILIPS_FM1236_MK3:
 
 110                 case TUNER_PHILIPS_FM1256_IH3:
 
 111                 case TUNER_LG_NTSC_TAPE:
 
 112                         stereo = ((status & TUNER_SIGNAL) == TUNER_STEREO_MK3);
 
 115                         stereo = status & TUNER_STEREO;
 
 122 /* ---------------------------------------------------------------------- */
 
 124 static void default_set_tv_freq(struct i2c_client *c, unsigned int freq)
 
 126         struct tuner *t = i2c_get_clientdata(c);
 
 127         u8 config, cb, tuneraddr;
 
 129         struct tunertype *tun;
 
 131         int rc, IFPCoff, i, j;
 
 132         enum param_type desired_type;
 
 133         struct tuner_params *params;
 
 135         tun = &tuners[t->type];
 
 137         /* IFPCoff = Video Intermediate Frequency - Vif:
 
 138                 940  =16*58.75  NTSC/J (Japan)
 
 139                 732  =16*45.75  M/N STD
 
 140                 704  =16*44     ATSC (at DVB code)
 
 142                 622.4=16*38.90  B/G D/K I, L STD
 
 143                 592  =16*37.00  D China
 
 144                 590  =16.36.875 B Australia
 
 145                 543.2=16*33.95  L' STD
 
 146                 171.2=16*10.70  FM Radio (at set_radio_freq)
 
 149         if (t->std == V4L2_STD_NTSC_M_JP) {
 
 151                 desired_type = TUNER_PARAM_TYPE_NTSC;
 
 152         } else if ((t->std & V4L2_STD_MN) &&
 
 153                   !(t->std & ~V4L2_STD_MN)) {
 
 155                 desired_type = TUNER_PARAM_TYPE_NTSC;
 
 156         } else if (t->std == V4L2_STD_SECAM_LC) {
 
 158                 desired_type = TUNER_PARAM_TYPE_SECAM;
 
 161                 desired_type = TUNER_PARAM_TYPE_PAL;
 
 164         for (j = 0; j < tun->count-1; j++) {
 
 165                 if (desired_type != tun->params[j].type)
 
 169         /* use default tuner_params if desired_type not available */
 
 170         if (desired_type != tun->params[j].type) {
 
 171                 tuner_dbg("IFPCoff = %d: tuner_params undefined for tuner %d\n",
 
 175         params = &tun->params[j];
 
 177         for (i = 0; i < params->count; i++) {
 
 178                 if (freq > params->ranges[i].limit)
 
 182         if (i == params->count) {
 
 183                 tuner_dbg("TV frequency out of range (%d > %d)",
 
 184                                 freq, params->ranges[i - 1].limit);
 
 185                 freq = params->ranges[--i].limit;
 
 187         config = params->ranges[i].config;
 
 188         cb     = params->ranges[i].cb;
 
 192         tuner_dbg("tv: param %d, range %d\n",j,i);
 
 194         div=freq + IFPCoff + offset;
 
 196         tuner_dbg("Freq= %d.%02d MHz, V_IF=%d.%02d MHz, Offset=%d.%02d MHz, div=%0d\n",
 
 197                                         freq / 16, freq % 16 * 100 / 16,
 
 198                                         IFPCoff / 16, IFPCoff % 16 * 100 / 16,
 
 199                                         offset / 16, offset % 16 * 100 / 16,
 
 202         /* tv norm specific stuff for multi-norm tuners */
 
 204         case TUNER_PHILIPS_SECAM: // FI1216MF
 
 205                 /* 0x01 -> ??? no change ??? */
 
 206                 /* 0x02 -> PAL BDGHI / SECAM L */
 
 207                 /* 0x04 -> ??? PAL others / SECAM others ??? */
 
 209                 if (t->std & V4L2_STD_SECAM)
 
 213         case TUNER_TEMIC_4046FM5:
 
 216                 if (t->std & V4L2_STD_PAL_BG) {
 
 217                         cb |= TEMIC_SET_PAL_BG;
 
 219                 } else if (t->std & V4L2_STD_PAL_I) {
 
 220                         cb |= TEMIC_SET_PAL_I;
 
 222                 } else if (t->std & V4L2_STD_PAL_DK) {
 
 223                         cb |= TEMIC_SET_PAL_DK;
 
 225                 } else if (t->std & V4L2_STD_SECAM_L) {
 
 226                         cb |= TEMIC_SET_PAL_L;
 
 231         case TUNER_PHILIPS_FQ1216ME:
 
 234                 if (t->std & (V4L2_STD_PAL_BG|V4L2_STD_PAL_DK)) {
 
 235                         cb |= PHILIPS_SET_PAL_BGDK;
 
 237                 } else if (t->std & V4L2_STD_PAL_I) {
 
 238                         cb |= PHILIPS_SET_PAL_I;
 
 240                 } else if (t->std & V4L2_STD_SECAM_L) {
 
 241                         cb |= PHILIPS_SET_PAL_L;
 
 246         case TUNER_PHILIPS_ATSC:
 
 247                 /* 0x00 -> ATSC antenna input 1 */
 
 248                 /* 0x01 -> ATSC antenna input 2 */
 
 249                 /* 0x02 -> NTSC antenna input 1 */
 
 250                 /* 0x03 -> NTSC antenna input 2 */
 
 252                 if (!(t->std & V4L2_STD_ATSC))
 
 257         case TUNER_MICROTUNE_4042FI5:
 
 258                 /* Set the charge pump for fast tuning */
 
 259                 config |= TUNER_CHARGE_PUMP;
 
 262         case TUNER_PHILIPS_TUV1236D:
 
 263                 /* 0x40 -> ATSC antenna input 1 */
 
 264                 /* 0x48 -> ATSC antenna input 2 */
 
 265                 /* 0x00 -> NTSC antenna input 1 */
 
 266                 /* 0x08 -> NTSC antenna input 2 */
 
 272                 if (t->std & V4L2_STD_ATSC) {
 
 276                 /* set to the correct mode (analog or digital) */
 
 279                 if (2 != (rc = i2c_master_send(c,&buffer[0],2)))
 
 280                         tuner_warn("i2c i/o error: rc == %d (should be 2)\n",rc);
 
 281                 if (2 != (rc = i2c_master_send(c,&buffer[2],2)))
 
 282                         tuner_warn("i2c i/o error: rc == %d (should be 2)\n",rc);
 
 288         if (params->cb_first_if_lower_freq && div < t->last_div) {
 
 291                 buffer[2] = (div>>8) & 0x7f;
 
 292                 buffer[3] = div      & 0xff;
 
 294                 buffer[0] = (div>>8) & 0x7f;
 
 295                 buffer[1] = div      & 0xff;
 
 300         if (params->has_tda9887) {
 
 302                 int is_secam_l = (t->std & (V4L2_STD_SECAM_L | V4L2_STD_SECAM_LC)) &&
 
 303                         !(t->std & ~(V4L2_STD_SECAM_L | V4L2_STD_SECAM_LC));
 
 305                 if (t->std == V4L2_STD_SECAM_LC) {
 
 306                         if (params->port1_active ^ params->port1_invert_for_secam_lc)
 
 307                                 config |= TDA9887_PORT1_ACTIVE;
 
 308                         if (params->port2_active ^ params->port2_invert_for_secam_lc)
 
 309                                 config |= TDA9887_PORT2_ACTIVE;
 
 312                         if (params->port1_active)
 
 313                                 config |= TDA9887_PORT1_ACTIVE;
 
 314                         if (params->port2_active)
 
 315                                 config |= TDA9887_PORT2_ACTIVE;
 
 317                 if (params->intercarrier_mode)
 
 318                         config |= TDA9887_INTERCARRIER;
 
 320                         if (i == 0 && params->default_top_secam_low)
 
 321                                 config |= TDA9887_TOP(params->default_top_secam_low);
 
 322                         else if (i == 1 && params->default_top_secam_mid)
 
 323                                 config |= TDA9887_TOP(params->default_top_secam_mid);
 
 324                         else if (params->default_top_secam_high)
 
 325                                 config |= TDA9887_TOP(params->default_top_secam_high);
 
 328                         if (i == 0 && params->default_top_low)
 
 329                                 config |= TDA9887_TOP(params->default_top_low);
 
 330                         else if (i == 1 && params->default_top_mid)
 
 331                                 config |= TDA9887_TOP(params->default_top_mid);
 
 332                         else if (params->default_top_high)
 
 333                                 config |= TDA9887_TOP(params->default_top_high);
 
 335                 if (params->default_pll_gating_18)
 
 336                         config |= TDA9887_GATING_18;
 
 337                 i2c_clients_command(c->adapter, TDA9887_SET_CONFIG, &config);
 
 339         tuner_dbg("tv 0x%02x 0x%02x 0x%02x 0x%02x\n",
 
 340                   buffer[0],buffer[1],buffer[2],buffer[3]);
 
 342         if (4 != (rc = i2c_master_send(c,buffer,4)))
 
 343                 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
 
 346         case TUNER_LG_TDVS_H06XF:
 
 347                 /* Set the Auxiliary Byte. */
 
 348                 buffer[0] = buffer[2];
 
 352                 tuner_dbg("tv 0x%02x 0x%02x\n",buffer[0],buffer[1]);
 
 354                 if (2 != (rc = i2c_master_send(c,buffer,2)))
 
 355                         tuner_warn("i2c i/o error: rc == %d (should be 2)\n",rc);
 
 357         case TUNER_MICROTUNE_4042FI5:
 
 359                 // FIXME - this may also work for other tuners
 
 360                 unsigned long timeout = jiffies + msecs_to_jiffies(1);
 
 363                 /* Wait until the PLL locks */
 
 365                         if (time_after(jiffies,timeout))
 
 367                         if (1 != (rc = i2c_master_recv(c,&status_byte,1))) {
 
 368                                 tuner_warn("i2c i/o read error: rc == %d (should be 1)\n",rc);
 
 371                         if (status_byte & TUNER_PLL_LOCKED)
 
 376                 /* Set the charge pump for optimized phase noise figure */
 
 377                 config &= ~TUNER_CHARGE_PUMP;
 
 378                 buffer[0] = (div>>8) & 0x7f;
 
 379                 buffer[1] = div      & 0xff;
 
 382                 tuner_dbg("tv 0x%02x 0x%02x 0x%02x 0x%02x\n",
 
 383                           buffer[0],buffer[1],buffer[2],buffer[3]);
 
 385                 if (4 != (rc = i2c_master_send(c,buffer,4)))
 
 386                         tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
 
 392 static void default_set_radio_freq(struct i2c_client *c, unsigned int freq)
 
 394         struct tunertype *tun;
 
 395         struct tuner *t = i2c_get_clientdata(c);
 
 399         enum param_type desired_type = TUNER_PARAM_TYPE_RADIO;
 
 400         struct tuner_params *params;
 
 402         tun = &tuners[t->type];
 
 404         for (j = 0; j < tun->count-1; j++) {
 
 405                 if (desired_type != tun->params[j].type)
 
 409         /* use default tuner_params if desired_type not available */
 
 410         if (desired_type != tun->params[j].type)
 
 413         div = (20 * freq / 16000) + (int)(20*10.7); /* IF 10.7 MHz */
 
 414         params = &tun->params[j];
 
 415         buffer[2] = (params->ranges[0].config & ~TUNER_RATIO_MASK) | TUNER_RATIO_SELECT_50; /* 50 kHz step */
 
 418         case TUNER_TENA_9533_DI:
 
 419         case TUNER_YMEC_TVF_5533MF:
 
 420                 tuner_dbg ("This tuner doesn't have FM. Most cards has a TEA5767 for FM\n");
 
 422         case TUNER_PHILIPS_FM1216ME_MK3:
 
 423         case TUNER_PHILIPS_FM1236_MK3:
 
 424         case TUNER_PHILIPS_FMD1216ME_MK3:
 
 425         case TUNER_LG_NTSC_TAPE:
 
 428         case TUNER_TNF_5335MF:
 
 431         case TUNER_PHILIPS_FM1256_IH3:
 
 432                 div = (20 * freq) / 16000 + (int)(33.3 * 20);  /* IF 33.3 MHz */
 
 435         case TUNER_LG_PAL_FM:
 
 438         case TUNER_MICROTUNE_4049FM5:
 
 439                 div = (20 * freq) / 16000 + (int)(33.3 * 20); /* IF 33.3 MHz */
 
 446         if (params->cb_first_if_lower_freq && div < t->last_div) {
 
 447                 buffer[0] = buffer[2];
 
 448                 buffer[1] = buffer[3];
 
 449                 buffer[2] = (div>>8) & 0x7f;
 
 450                 buffer[3] = div      & 0xff;
 
 452                 buffer[0] = (div>>8) & 0x7f;
 
 453                 buffer[1] = div      & 0xff;
 
 456         tuner_dbg("radio 0x%02x 0x%02x 0x%02x 0x%02x\n",
 
 457                buffer[0],buffer[1],buffer[2],buffer[3]);
 
 460         if (params->has_tda9887) {
 
 462                 if (params->port1_active && !params->port1_fm_high_sensitivity)
 
 463                         config |= TDA9887_PORT1_ACTIVE;
 
 464                 if (params->port2_active && !params->port2_fm_high_sensitivity)
 
 465                         config |= TDA9887_PORT2_ACTIVE;
 
 466                 if (params->intercarrier_mode)
 
 467                         config |= TDA9887_INTERCARRIER;
 
 468 /*              if (params->port1_set_for_fm_mono)
 
 469                         config &= ~TDA9887_PORT1_ACTIVE;*/
 
 470                 if (params->fm_gain_normal)
 
 471                         config |= TDA9887_GAIN_NORMAL;
 
 472                 i2c_clients_command(c->adapter, TDA9887_SET_CONFIG, &config);
 
 474         if (4 != (rc = i2c_master_send(c,buffer,4)))
 
 475                 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
 
 478 int default_tuner_init(struct i2c_client *c)
 
 480         struct tuner *t = i2c_get_clientdata(c);
 
 482         tuner_info("type set to %d (%s)\n",
 
 483                    t->type, tuners[t->type].name);
 
 484         strlcpy(c->name, tuners[t->type].name, sizeof(c->name));
 
 486         t->set_tv_freq = default_set_tv_freq;
 
 487         t->set_radio_freq = default_set_radio_freq;
 
 488         t->has_signal = tuner_signal;
 
 489         t->is_stereo = tuner_stereo;
 
 496  * Overrides for Emacs so that we follow Linus's tabbing style.
 
 497  * ---------------------------------------------------------------------------