tuner.h 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228
  1. /* SPDX-License-Identifier: GPL-2.0-or-later */
  2. /*
  3. * tuner.h - definition for different tuners
  4. *
  5. * Copyright (C) 1997 Markus Schroeder ([email protected])
  6. * minor modifications by Ralph Metzler ([email protected])
  7. */
  8. #ifndef _TUNER_H
  9. #define _TUNER_H
  10. #ifdef __KERNEL__
  11. #include <linux/videodev2.h>
  12. #include <media/v4l2-mc.h>
  13. #define ADDR_UNSET (255)
  14. #define TUNER_TEMIC_PAL 0 /* 4002 FH5 (3X 7756, 9483) */
  15. #define TUNER_PHILIPS_PAL_I 1
  16. #define TUNER_PHILIPS_NTSC 2
  17. #define TUNER_PHILIPS_SECAM 3 /* you must actively select B/G, L, L` */
  18. #define TUNER_ABSENT 4
  19. #define TUNER_PHILIPS_PAL 5
  20. #define TUNER_TEMIC_NTSC 6 /* 4032 FY5 (3X 7004, 9498, 9789) */
  21. #define TUNER_TEMIC_PAL_I 7 /* 4062 FY5 (3X 8501, 9957) */
  22. #define TUNER_TEMIC_4036FY5_NTSC 8 /* 4036 FY5 (3X 1223, 1981, 7686) */
  23. #define TUNER_ALPS_TSBH1_NTSC 9
  24. #define TUNER_ALPS_TSBE1_PAL 10
  25. #define TUNER_ALPS_TSBB5_PAL_I 11
  26. #define TUNER_ALPS_TSBE5_PAL 12
  27. #define TUNER_ALPS_TSBC5_PAL 13
  28. #define TUNER_TEMIC_4006FH5_PAL 14 /* 4006 FH5 (3X 9500, 9501, 7291) */
  29. #define TUNER_ALPS_TSHC6_NTSC 15
  30. #define TUNER_TEMIC_PAL_DK 16 /* 4016 FY5 (3X 1392, 1393) */
  31. #define TUNER_PHILIPS_NTSC_M 17
  32. #define TUNER_TEMIC_4066FY5_PAL_I 18 /* 4066 FY5 (3X 7032, 7035) */
  33. #define TUNER_TEMIC_4006FN5_MULTI_PAL 19 /* B/G, I and D/K autodetected (3X 7595, 7606, 7657) */
  34. #define TUNER_TEMIC_4009FR5_PAL 20 /* incl. FM radio (3X 7607, 7488, 7711) */
  35. #define TUNER_TEMIC_4039FR5_NTSC 21 /* incl. FM radio (3X 7246, 7578, 7732) */
  36. #define TUNER_TEMIC_4046FM5 22 /* you must actively select B/G, D/K, I, L, L` ! (3X 7804, 7806, 8103, 8104) */
  37. #define TUNER_PHILIPS_PAL_DK 23
  38. #define TUNER_PHILIPS_FQ1216ME 24 /* you must actively select B/G/D/K, I, L, L` */
  39. #define TUNER_LG_PAL_I_FM 25
  40. #define TUNER_LG_PAL_I 26
  41. #define TUNER_LG_NTSC_FM 27
  42. #define TUNER_LG_PAL_FM 28
  43. #define TUNER_LG_PAL 29
  44. #define TUNER_TEMIC_4009FN5_MULTI_PAL_FM 30 /* B/G, I and D/K autodetected (3X 8155, 8160, 8163) */
  45. #define TUNER_SHARP_2U5JF5540_NTSC 31
  46. #define TUNER_Samsung_PAL_TCPM9091PD27 32
  47. #define TUNER_MT2032 33
  48. #define TUNER_TEMIC_4106FH5 34 /* 4106 FH5 (3X 7808, 7865) */
  49. #define TUNER_TEMIC_4012FY5 35 /* 4012 FY5 (3X 0971, 1099) */
  50. #define TUNER_TEMIC_4136FY5 36 /* 4136 FY5 (3X 7708, 7746) */
  51. #define TUNER_LG_PAL_NEW_TAPC 37
  52. #define TUNER_PHILIPS_FM1216ME_MK3 38
  53. #define TUNER_LG_NTSC_NEW_TAPC 39
  54. #define TUNER_HITACHI_NTSC 40
  55. #define TUNER_PHILIPS_PAL_MK 41
  56. #define TUNER_PHILIPS_FCV1236D 42
  57. #define TUNER_PHILIPS_FM1236_MK3 43
  58. #define TUNER_PHILIPS_4IN1 44 /* ATI TV Wonder Pro - Conexant */
  59. /*
  60. * Microtune merged with Temic 12/31/1999 partially financed by Alps.
  61. * these may be similar to Temic
  62. */
  63. #define TUNER_MICROTUNE_4049FM5 45
  64. #define TUNER_PANASONIC_VP27 46
  65. #define TUNER_LG_NTSC_TAPE 47
  66. #define TUNER_TNF_8831BGFF 48
  67. #define TUNER_MICROTUNE_4042FI5 49 /* DViCO FusionHDTV 3 Gold-Q - 4042 FI5 (3X 8147) */
  68. #define TUNER_TCL_2002N 50
  69. #define TUNER_PHILIPS_FM1256_IH3 51
  70. #define TUNER_THOMSON_DTT7610 52
  71. #define TUNER_PHILIPS_FQ1286 53
  72. #define TUNER_PHILIPS_TDA8290 54
  73. #define TUNER_TCL_2002MB 55 /* Hauppauge PVR-150 PAL */
  74. #define TUNER_PHILIPS_FQ1216AME_MK4 56 /* Hauppauge PVR-150 PAL */
  75. #define TUNER_PHILIPS_FQ1236A_MK4 57 /* Hauppauge PVR-500MCE NTSC */
  76. #define TUNER_YMEC_TVF_8531MF 58
  77. #define TUNER_YMEC_TVF_5533MF 59 /* Pixelview Pro Ultra NTSC */
  78. #define TUNER_THOMSON_DTT761X 60 /* DTT 7611 7611A 7612 7613 7613A 7614 7615 7615A */
  79. #define TUNER_TENA_9533_DI 61
  80. #define TUNER_TEA5767 62 /* Only FM Radio Tuner */
  81. #define TUNER_PHILIPS_FMD1216ME_MK3 63
  82. #define TUNER_LG_TDVS_H06XF 64 /* TDVS H061F, H062F, H064F */
  83. #define TUNER_YMEC_TVF66T5_B_DFF 65 /* Acorp Y878F */
  84. #define TUNER_LG_TALN 66
  85. #define TUNER_PHILIPS_TD1316 67
  86. #define TUNER_PHILIPS_TUV1236D 68 /* ATI HDTV Wonder */
  87. #define TUNER_TNF_5335MF 69 /* Sabrent Bt848 */
  88. #define TUNER_SAMSUNG_TCPN_2121P30A 70 /* Hauppauge PVR-500MCE NTSC */
  89. #define TUNER_XC2028 71
  90. #define TUNER_THOMSON_FE6600 72 /* DViCO FusionHDTV DVB-T Hybrid */
  91. #define TUNER_SAMSUNG_TCPG_6121P30A 73 /* Hauppauge PVR-500 PAL */
  92. #define TUNER_TDA9887 74 /* This tuner should be used only internally */
  93. #define TUNER_TEA5761 75 /* Only FM Radio Tuner */
  94. #define TUNER_XC5000 76 /* Xceive Silicon Tuner */
  95. #define TUNER_TCL_MF02GIP_5N 77 /* TCL MF02GIP_5N */
  96. #define TUNER_PHILIPS_FMD1216MEX_MK3 78
  97. #define TUNER_PHILIPS_FM1216MK5 79
  98. #define TUNER_PHILIPS_FQ1216LME_MK3 80 /* Active loopthrough, no FM */
  99. #define TUNER_PARTSNIC_PTI_5NF05 81
  100. #define TUNER_PHILIPS_CU1216L 82
  101. #define TUNER_NXP_TDA18271 83
  102. #define TUNER_SONY_BTF_PXN01Z 84
  103. #define TUNER_PHILIPS_FQ1236_MK5 85 /* NTSC, TDA9885, no FM radio */
  104. #define TUNER_TENA_TNF_5337 86
  105. #define TUNER_XC4000 87 /* Xceive Silicon Tuner */
  106. #define TUNER_XC5000C 88 /* Xceive Silicon Tuner */
  107. #define TUNER_SONY_BTF_PG472Z 89 /* PAL+SECAM */
  108. #define TUNER_SONY_BTF_PK467Z 90 /* NTSC_JP */
  109. #define TUNER_SONY_BTF_PB463Z 91 /* NTSC */
  110. #define TUNER_SI2157 92
  111. /* tv card specific */
  112. #define TDA9887_PRESENT (1<<0)
  113. #define TDA9887_PORT1_INACTIVE (1<<1)
  114. #define TDA9887_PORT2_INACTIVE (1<<2)
  115. #define TDA9887_QSS (1<<3)
  116. #define TDA9887_INTERCARRIER (1<<4)
  117. #define TDA9887_PORT1_ACTIVE (1<<5)
  118. #define TDA9887_PORT2_ACTIVE (1<<6)
  119. #define TDA9887_INTERCARRIER_NTSC (1<<7)
  120. /* Tuner takeover point adjustment, in dB, -16 <= top <= 15 */
  121. #define TDA9887_TOP_MASK (0x3f << 8)
  122. #define TDA9887_TOP_SET (1 << 13)
  123. #define TDA9887_TOP(top) (TDA9887_TOP_SET | \
  124. (((16 + (top)) & 0x1f) << 8))
  125. /* config options */
  126. #define TDA9887_DEEMPHASIS_MASK (3<<16)
  127. #define TDA9887_DEEMPHASIS_NONE (1<<16)
  128. #define TDA9887_DEEMPHASIS_50 (2<<16)
  129. #define TDA9887_DEEMPHASIS_75 (3<<16)
  130. #define TDA9887_AUTOMUTE (1<<18)
  131. #define TDA9887_GATING_18 (1<<19)
  132. #define TDA9887_GAIN_NORMAL (1<<20)
  133. #define TDA9887_RIF_41_3 (1<<21) /* radio IF1 41.3 vs 33.3 */
  134. /**
  135. * enum tuner_mode - Mode of the tuner
  136. *
  137. * @T_RADIO: Tuner core will work in radio mode
  138. * @T_ANALOG_TV: Tuner core will work in analog TV mode
  139. *
  140. * Older boards only had a single tuner device, but some devices have a
  141. * separate tuner for radio. In any case, the tuner-core needs to know if
  142. * the tuner chip(s) will be used in radio mode or analog TV mode, as, on
  143. * radio mode, frequencies are specified on a different range than on TV
  144. * mode. This enum is used by the tuner core in order to work with the
  145. * proper tuner range and eventually use a different tuner chip while in
  146. * radio mode.
  147. */
  148. enum tuner_mode {
  149. T_RADIO = 1 << V4L2_TUNER_RADIO,
  150. T_ANALOG_TV = 1 << V4L2_TUNER_ANALOG_TV,
  151. /* Don't map V4L2_TUNER_DIGITAL_TV, as tuner-core won't use it */
  152. };
  153. /**
  154. * struct tuner_setup - setup the tuner chipsets
  155. *
  156. * @addr: I2C address used to control the tuner device/chipset
  157. * @type: Type of the tuner, as defined at the TUNER_* macros.
  158. * Each different tuner model should have an unique
  159. * identifier.
  160. * @mode_mask: Mask with the allowed tuner modes: V4L2_TUNER_RADIO,
  161. * V4L2_TUNER_ANALOG_TV and/or V4L2_TUNER_DIGITAL_TV,
  162. * describing if the tuner should be used to support
  163. * Radio, analog TV and/or digital TV.
  164. * @config: Used to send tuner-specific configuration for complex
  165. * tuners that require extra parameters to be set.
  166. * Only a very few tuners require it and its usage on
  167. * newer tuners should be avoided.
  168. * @tuner_callback: Some tuners require to call back the bridge driver,
  169. * in order to do some tasks like rising a GPIO at the
  170. * bridge chipset, in order to do things like resetting
  171. * the device.
  172. *
  173. * Older boards only had a single tuner device. Nowadays multiple tuner
  174. * devices may be present on a single board. Using TUNER_SET_TYPE_ADDR
  175. * to pass the tuner_setup structure it is possible to setup each tuner
  176. * device in turn.
  177. *
  178. * Since multiple devices may be present it is no longer sufficient to
  179. * send a command to a single i2c device. Instead you should broadcast
  180. * the command to all i2c devices.
  181. *
  182. * By setting the mode_mask correctly you can select which commands are
  183. * accepted by a specific tuner device. For example, set mode_mask to
  184. * T_RADIO if the device is a radio-only tuner. That specific tuner will
  185. * only accept commands when the tuner is in radio mode and ignore them
  186. * when the tuner is set to TV mode.
  187. */
  188. struct tuner_setup {
  189. unsigned short addr;
  190. unsigned int type;
  191. unsigned int mode_mask;
  192. void *config;
  193. int (*tuner_callback)(void *dev, int component, int cmd, int arg);
  194. };
  195. #endif /* __KERNEL__ */
  196. #endif /* _TUNER_H */