drivers/media/video/tuner-simple.c

   1 /*
   2  *
   3  * i2c tv tuner chip device driver
   4  * controls all those simple 4-control-bytes style tuners.
   5  */
   6 #include <linux/delay.h>
   7 #include <linux/i2c.h>
   8 #include <linux/videodev.h>
   9 #include <media/tuner.h>
  10
  11 static int offset = 0;
  12 module_param(offset, int, 0666);
  13 MODULE_PARM_DESC(offset,"Allows to specify an offset for tuner");
  14
  15 /* ---------------------------------------------------------------------- */
  16
  17 /* tv standard selection for Temic 4046 FM5
  18    this value takes the low bits of control byte 2
  19    from datasheet Rev.01, Feb.00
  20      standard     BG      I       L       L2      D
  21      picture IF   38.9    38.9    38.9    33.95   38.9
  22      sound 1      33.4    32.9    32.4    40.45   32.4
  23      sound 2      33.16
  24      NICAM        33.05   32.348  33.05           33.05
  25  */
  26 #define TEMIC_SET_PAL_I         0x05
  27 #define TEMIC_SET_PAL_DK        0x09
  28 #define TEMIC_SET_PAL_L         0x0a // SECAM ?
  29 #define TEMIC_SET_PAL_L2        0x0b // change IF !
  30 #define TEMIC_SET_PAL_BG        0x0c
  31
  32 /* tv tuner system standard selection for Philips FQ1216ME
  33    this value takes the low bits of control byte 2
  34    from datasheet "1999 Nov 16" (supersedes "1999 Mar 23")
  35      standard           BG      DK      I       L       L`
  36      picture carrier    38.90   38.90   38.90   38.90   33.95
  37      colour             34.47   34.47   34.47   34.47   38.38
  38      sound 1            33.40   32.40   32.90   32.40   40.45
  39      sound 2            33.16   -       -       -       -
  40      NICAM              33.05   33.05   32.35   33.05   39.80
  41  */
  42 #define PHILIPS_SET_PAL_I       0x01 /* Bit 2 always zero !*/
  43 #define PHILIPS_SET_PAL_BGDK    0x09
  44 #define PHILIPS_SET_PAL_L2      0x0a
  45 #define PHILIPS_SET_PAL_L       0x0b
  46
  47 /* system switching for Philips FI1216MF MK2
  48    from datasheet "1996 Jul 09",
  49     standard         BG     L      L'
  50     picture carrier  38.90  38.90  33.95
  51     colour           34.47  34.37  38.38
  52     sound 1          33.40  32.40  40.45
  53     sound 2          33.16  -      -
  54     NICAM            33.05  33.05  39.80
  55  */
  56 #define PHILIPS_MF_SET_BG       0x01 /* Bit 2 must be zero, Bit 3 is system output */
  57 #define PHILIPS_MF_SET_PAL_L    0x03 // France
  58 #define PHILIPS_MF_SET_PAL_L2   0x02 // L'
  59
  60 /* Control byte */
  61
  62 #define TUNER_RATIO_MASK        0x06 /* Bit cb1:cb2 */
  63 #define TUNER_RATIO_SELECT_50   0x00
  64 #define TUNER_RATIO_SELECT_32   0x02
  65 #define TUNER_RATIO_SELECT_166  0x04
  66 #define TUNER_RATIO_SELECT_62   0x06
  67
  68 #define TUNER_CHARGE_PUMP       0x40  /* Bit cb6 */
  69
  70 /* Status byte */
  71
  72 #define TUNER_POR         0x80
  73 #define TUNER_FL          0x40
  74 #define TUNER_MODE        0x38
  75 #define TUNER_AFC         0x07
  76 #define TUNER_SIGNAL      0x07
  77 #define TUNER_STEREO      0x10
  78
  79 #define TUNER_PLL_LOCKED   0x40
  80 #define TUNER_STEREO_MK3   0x04
  81
  82 #define TUNER_PARAM_ANALOG 0  /* to be removed */
  83 /* FIXME:
  84  * Right now, all tuners are using the first tuner_params[] array element
  85  * for analog mode. In the future, we will be merging similar tuner
  86  * definitions together, such that each tuner definition will have a
  87  * tuner_params struct for each available video standard. At that point,
  88  * TUNER_PARAM_ANALOG will be removed, and the tuner_params[] array
  89  * element will be chosen based on the video standard in use.
  90  *
  91  */
  92
  93 /* ---------------------------------------------------------------------- */
  94
  95 static int tuner_getstatus(struct i2c_client *c)
  96 {
  97         unsigned char byte;
  98
  99         if (1 != i2c_master_recv(c,&byte,1))
 100                 return 0;
 101
 102         return byte;
 103 }
 104
 105 static int tuner_signal(struct i2c_client *c)
 106 {
 107         return (tuner_getstatus(c) & TUNER_SIGNAL) << 13;
 108 }
 109
 110 static int tuner_stereo(struct i2c_client *c)
 111 {
 112         int stereo, status;
 113         struct tuner *t = i2c_get_clientdata(c);
 114
 115         status = tuner_getstatus (c);
 116
 117         switch (t->type) {
 118                 case TUNER_PHILIPS_FM1216ME_MK3:
 119                 case TUNER_PHILIPS_FM1236_MK3:
 120                 case TUNER_PHILIPS_FM1256_IH3:
 121                 case TUNER_LG_NTSC_TAPE:
 122                         stereo = ((status & TUNER_SIGNAL) == TUNER_STEREO_MK3);
 123                         break;
 124                 default:
 125                         stereo = status & TUNER_STEREO;
 126         }
 127
 128         return stereo;
 129 }
 130
 131
 132 /* ---------------------------------------------------------------------- */
 133
 134 static void default_set_tv_freq(struct i2c_client *c, unsigned int freq)
 135 {
 136         struct tuner *t = i2c_get_clientdata(c);
 137         u8 config, tuneraddr;
 138         u16 div;
 139         struct tunertype *tun;
 140         u8 buffer[4];
 141         int rc, IFPCoff, i, j;
 142
 143         tun = &tuners[t->type];
 144         j = TUNER_PARAM_ANALOG;
 145
 146         for (i = 0; i < tun->params[j].count; i++) {
 147                 if (freq > tun->params[j].ranges[i].limit)
 148                         continue;
 149                 break;
 150         }
 151         if (i == tun->params[j].count) {
 152                 tuner_dbg("TV frequency out of range (%d > %d)",
 153                                 freq, tun->params[j].ranges[i - 1].limit);
 154                 freq = tun->params[j].ranges[--i].limit;
 155         }
 156         config = tun->params[j].ranges[i].cb;
 157         /*  i == 0 -> VHF_LO  */
 158         /*  i == 1 -> VHF_HI  */
 159         /*  i == 2 -> UHF     */
 160         tuner_dbg("tv: range %d\n",i);
 161
 162         /* tv norm specific stuff for multi-norm tuners */
 163         switch (t->type) {
 164         case TUNER_PHILIPS_SECAM: // FI1216MF
 165                 /* 0x01 -> ??? no change ??? */
 166                 /* 0x02 -> PAL BDGHI / SECAM L */
 167                 /* 0x04 -> ??? PAL others / SECAM others ??? */
 168                 config &= ~0x02;
 169                 if (t->std & V4L2_STD_SECAM)
 170                         config |= 0x02;
 171                 break;
 172
 173         case TUNER_TEMIC_4046FM5:
 174                 config &= ~0x0f;
 175
 176                 if (t->std & V4L2_STD_PAL_BG) {
 177                         config |= TEMIC_SET_PAL_BG;
 178
 179                 } else if (t->std & V4L2_STD_PAL_I) {
 180                         config |= TEMIC_SET_PAL_I;
 181
 182                 } else if (t->std & V4L2_STD_PAL_DK) {
 183                         config |= TEMIC_SET_PAL_DK;
 184
 185                 } else if (t->std & V4L2_STD_SECAM_L) {
 186                         config |= TEMIC_SET_PAL_L;
 187
 188                 }
 189                 break;
 190
 191         case TUNER_PHILIPS_FQ1216ME:
 192                 config &= ~0x0f;
 193
 194                 if (t->std & (V4L2_STD_PAL_BG|V4L2_STD_PAL_DK)) {
 195                         config |= PHILIPS_SET_PAL_BGDK;
 196
 197                 } else if (t->std & V4L2_STD_PAL_I) {
 198                         config |= PHILIPS_SET_PAL_I;
 199
 200                 } else if (t->std & V4L2_STD_SECAM_L) {
 201                         config |= PHILIPS_SET_PAL_L;
 202
 203                 }
 204                 break;
 205
 206         case TUNER_PHILIPS_ATSC:
 207                 /* 0x00 -> ATSC antenna input 1 */
 208                 /* 0x01 -> ATSC antenna input 2 */
 209                 /* 0x02 -> NTSC antenna input 1 */
 210                 /* 0x03 -> NTSC antenna input 2 */
 211                 config &= ~0x03;
 212                 if (!(t->std & V4L2_STD_ATSC))
 213                         config |= 2;
 214                 /* FIXME: input */
 215                 break;
 216
 217         case TUNER_MICROTUNE_4042FI5:
 218                 /* Set the charge pump for fast tuning */
 219                 tun->params[j].config |= TUNER_CHARGE_PUMP;
 220                 break;
 221
 222         case TUNER_PHILIPS_TUV1236D:
 223                 /* 0x40 -> ATSC antenna input 1 */
 224                 /* 0x48 -> ATSC antenna input 2 */
 225                 /* 0x00 -> NTSC antenna input 1 */
 226                 /* 0x08 -> NTSC antenna input 2 */
 227                 buffer[0] = 0x14;
 228                 buffer[1] = 0x00;
 229                 buffer[2] = 0x17;
 230                 buffer[3] = 0x00;
 231                 config &= ~0x40;
 232                 if (t->std & V4L2_STD_ATSC) {
 233                         config |= 0x40;
 234                         buffer[1] = 0x04;
 235                 }
 236                 /* set to the correct mode (analog or digital) */
 237                 tuneraddr = c->addr;
 238                 c->addr = 0x0a;
 239                 if (2 != (rc = i2c_master_send(c,&buffer[0],2)))
 240                         tuner_warn("i2c i/o error: rc == %d (should be 2)\n",rc);
 241                 if (2 != (rc = i2c_master_send(c,&buffer[2],2)))
 242                         tuner_warn("i2c i/o error: rc == %d (should be 2)\n",rc);
 243                 c->addr = tuneraddr;
 244                 /* FIXME: input */
 245                 break;
 246         }
 247
 248         /* IFPCoff = Video Intermediate Frequency - Vif:
 249                 940  =16*58.75  NTSC/J (Japan)
 250                 732  =16*45.75  M/N STD
 251                 704  =16*44     ATSC (at DVB code)
 252                 632  =16*39.50  I U.K.
 253                 622.4=16*38.90  B/G D/K I, L STD
 254                 592  =16*37.00  D China
 255                 590  =16.36.875 B Australia
 256                 543.2=16*33.95  L' STD
 257                 171.2=16*10.70  FM Radio (at set_radio_freq)
 258         */
 259
 260         if (t->std == V4L2_STD_NTSC_M_JP) {
 261                 IFPCoff = 940;
 262         } else if ((t->std & V4L2_STD_MN) &&
 263                   !(t->std & ~V4L2_STD_MN)) {
 264                 IFPCoff = 732;
 265         } else if (t->std == V4L2_STD_SECAM_LC) {
 266                 IFPCoff = 543;
 267         } else {
 268                 IFPCoff = 623;
 269         }
 270
 271         div=freq + IFPCoff + offset;
 272
 273         tuner_dbg("Freq= %d.%02d MHz, V_IF=%d.%02d MHz, Offset=%d.%02d MHz, div=%0d\n",
 274                                         freq / 16, freq % 16 * 100 / 16,
 275                                         IFPCoff / 16, IFPCoff % 16 * 100 / 16,
 276                                         offset / 16, offset % 16 * 100 / 16,
 277                                         div);
 278
 279         if (tuners[t->type].params->cb_first_if_lower_freq && div < t->last_div) {
 280                 buffer[0] = tun->params[j].config;
 281                 buffer[1] = config;
 282                 buffer[2] = (div>>8) & 0x7f;
 283                 buffer[3] = div      & 0xff;
 284         } else {
 285                 buffer[0] = (div>>8) & 0x7f;
 286                 buffer[1] = div      & 0xff;
 287                 buffer[2] = tun->params[j].config;
 288                 buffer[3] = config;
 289         }
 290         t->last_div = div;
 291         tuner_dbg("tv 0x%02x 0x%02x 0x%02x 0x%02x\n",
 292                   buffer[0],buffer[1],buffer[2],buffer[3]);
 293
 294         if (4 != (rc = i2c_master_send(c,buffer,4)))
 295                 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
 296
 297         if (t->type == TUNER_MICROTUNE_4042FI5) {
 298                 // FIXME - this may also work for other tuners
 299                 unsigned long timeout = jiffies + msecs_to_jiffies(1);
 300                 u8 status_byte = 0;
 301
 302                 /* Wait until the PLL locks */
 303                 for (;;) {
 304                         if (time_after(jiffies,timeout))
 305                                 return;
 306                         if (1 != (rc = i2c_master_recv(c,&status_byte,1))) {
 307                                 tuner_warn("i2c i/o read error: rc == %d (should be 1)\n",rc);
 308                                 break;
 309                         }
 310                         if (status_byte & TUNER_PLL_LOCKED)
 311                                 break;
 312                         udelay(10);
 313                 }
 314
 315                 /* Set the charge pump for optimized phase noise figure */
 316                 tun->params[j].config &= ~TUNER_CHARGE_PUMP;
 317                 buffer[0] = (div>>8) & 0x7f;
 318                 buffer[1] = div      & 0xff;
 319                 buffer[2] = tun->params[j].config;
 320                 buffer[3] = config;
 321                 tuner_dbg("tv 0x%02x 0x%02x 0x%02x 0x%02x\n",
 322                        buffer[0],buffer[1],buffer[2],buffer[3]);
 323
 324                 if (4 != (rc = i2c_master_send(c,buffer,4)))
 325                         tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
 326         }
 327 }
 328
 329 static void default_set_radio_freq(struct i2c_client *c, unsigned int freq)
 330 {
 331         struct tunertype *tun;
 332         struct tuner *t = i2c_get_clientdata(c);
 333         u8 buffer[4];
 334         u16 div;
 335         int rc, j;
 336
 337         tun = &tuners[t->type];
 338         j = TUNER_PARAM_ANALOG;
 339
 340         div = (20 * freq / 16000) + (int)(20*10.7); /* IF 10.7 MHz */
 341         buffer[2] = (tun->params[j].config & ~TUNER_RATIO_MASK) | TUNER_RATIO_SELECT_50; /* 50 kHz step */
 342
 343         switch (t->type) {
 344         case TUNER_TENA_9533_DI:
 345         case TUNER_YMEC_TVF_5533MF:
 346                 tuner_dbg ("This tuner doesn't have FM. Most cards has a TEA5767 for FM\n");
 347                 return;
 348         case TUNER_PHILIPS_FM1216ME_MK3:
 349         case TUNER_PHILIPS_FM1236_MK3:
 350         case TUNER_PHILIPS_FMD1216ME_MK3:
 351         case TUNER_LG_NTSC_TAPE:
 352                 buffer[3] = 0x19;
 353                 break;
 354         case TUNER_PHILIPS_FM1256_IH3:
 355                 div = (20 * freq) / 16000 + (int)(33.3 * 20);  /* IF 33.3 MHz */
 356                 buffer[3] = 0x19;
 357                 break;
 358         case TUNER_LG_PAL_FM:
 359                 buffer[3] = 0xa5;
 360                 break;
 361         case TUNER_MICROTUNE_4049FM5:
 362                 div = (20 * freq) / 16000 + (int)(33.3 * 20); /* IF 33.3 MHz */
 363                 buffer[3] = 0xa4;
 364                 break;
 365         default:
 366                 buffer[3] = 0xa4;
 367                 break;
 368         }
 369         buffer[0] = (div>>8) & 0x7f;
 370         buffer[1] = div      & 0xff;
 371         if (tuners[t->type].params->cb_first_if_lower_freq && div < t->last_div) {
 372                 buffer[0] = buffer[2];
 373                 buffer[1] = buffer[3];
 374                 buffer[2] = (div>>8) & 0x7f;
 375                 buffer[3] = div      & 0xff;
 376         } else {
 377                 buffer[0] = (div>>8) & 0x7f;
 378                 buffer[1] = div      & 0xff;
 379         }
 380
 381         tuner_dbg("radio 0x%02x 0x%02x 0x%02x 0x%02x\n",
 382                buffer[0],buffer[1],buffer[2],buffer[3]);
 383         t->last_div = div;
 384
 385         if (4 != (rc = i2c_master_send(c,buffer,4)))
 386                 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
 387 }
 388
 389 int default_tuner_init(struct i2c_client *c)
 390 {
 391         struct tuner *t = i2c_get_clientdata(c);
 392
 393         tuner_info("type set to %d (%s)\n",
 394                    t->type, tuners[t->type].name);
 395         strlcpy(c->name, tuners[t->type].name, sizeof(c->name));
 396
 397         t->set_tv_freq = default_set_tv_freq;
 398         t->set_radio_freq = default_set_radio_freq;
 399         t->has_signal = tuner_signal;
 400         t->is_stereo = tuner_stereo;
 401         t->standby = NULL;
 402
 403         return 0;
 404 }
 405
 406 /*
 407  * Overrides for Emacs so that we follow Linus's tabbing style.
 408  * ---------------------------------------------------------------------------
 409  * Local variables:
 410  * c-basic-offset: 8
 411  * End:
 412  */