Merge with rsync://rsync.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / drivers / media / video / tuner-simple.c
1 /*
2 * $Id: tuner-simple.c,v 1.31 2005/06/21 16:02:25 mkrufky Exp $
3 *
4 * i2c tv tuner chip device driver
5 * controls all those simple 4-control-bytes style tuners.
6 */
7 #include <linux/delay.h>
8 #include <linux/i2c.h>
9 #include <linux/videodev.h>
10 #include <media/tuner.h>
11
12 /* ---------------------------------------------------------------------- */
13
14 /* tv standard selection for Temic 4046 FM5
15 this value takes the low bits of control byte 2
16 from datasheet Rev.01, Feb.00
17 standard BG I L L2 D
18 picture IF 38.9 38.9 38.9 33.95 38.9
19 sound 1 33.4 32.9 32.4 40.45 32.4
20 sound 2 33.16
21 NICAM 33.05 32.348 33.05 33.05
22 */
23 #define TEMIC_SET_PAL_I 0x05
24 #define TEMIC_SET_PAL_DK 0x09
25 #define TEMIC_SET_PAL_L 0x0a // SECAM ?
26 #define TEMIC_SET_PAL_L2 0x0b // change IF !
27 #define TEMIC_SET_PAL_BG 0x0c
28
29 /* tv tuner system standard selection for Philips FQ1216ME
30 this value takes the low bits of control byte 2
31 from datasheet "1999 Nov 16" (supersedes "1999 Mar 23")
32 standard BG DK I L L`
33 picture carrier 38.90 38.90 38.90 38.90 33.95
34 colour 34.47 34.47 34.47 34.47 38.38
35 sound 1 33.40 32.40 32.90 32.40 40.45
36 sound 2 33.16 - - - -
37 NICAM 33.05 33.05 32.35 33.05 39.80
38 */
39 #define PHILIPS_SET_PAL_I 0x01 /* Bit 2 always zero !*/
40 #define PHILIPS_SET_PAL_BGDK 0x09
41 #define PHILIPS_SET_PAL_L2 0x0a
42 #define PHILIPS_SET_PAL_L 0x0b
43
44 /* system switching for Philips FI1216MF MK2
45 from datasheet "1996 Jul 09",
46 standard BG L L'
47 picture carrier 38.90 38.90 33.95
48 colour 34.47 34.37 38.38
49 sound 1 33.40 32.40 40.45
50 sound 2 33.16 - -
51 NICAM 33.05 33.05 39.80
52 */
53 #define PHILIPS_MF_SET_BG 0x01 /* Bit 2 must be zero, Bit 3 is system output */
54 #define PHILIPS_MF_SET_PAL_L 0x03 // France
55 #define PHILIPS_MF_SET_PAL_L2 0x02 // L'
56
57
58 /* ---------------------------------------------------------------------- */
59
60 struct tunertype
61 {
62 char *name;
63 unsigned char Vendor;
64 unsigned char Type;
65
66 unsigned short thresh1; /* band switch VHF_LO <=> VHF_HI */
67 unsigned short thresh2; /* band switch VHF_HI <=> UHF */
68 unsigned char VHF_L;
69 unsigned char VHF_H;
70 unsigned char UHF;
71 unsigned char config;
72 unsigned short IFPCoff; /* 622.4=16*38.90 MHz PAL,
73 732 =16*45.75 NTSCi,
74 940 =16*58.75 NTSC-Japan
75 704 =16*44 ATSC */
76 };
77
78 /*
79 * The floats in the tuner struct are computed at compile time
80 * by gcc and cast back to integers. Thus we don't violate the
81 * "no float in kernel" rule.
82 */
83 static struct tunertype tuners[] = {
84 { "Temic PAL (4002 FH5)", TEMIC, PAL,
85 16*140.25,16*463.25,0x02,0x04,0x01,0x8e,623},
86 { "Philips PAL_I (FI1246 and compatibles)", Philips, PAL_I,
87 16*140.25,16*463.25,0xa0,0x90,0x30,0x8e,623},
88 { "Philips NTSC (FI1236,FM1236 and compatibles)", Philips, NTSC,
89 16*157.25,16*451.25,0xA0,0x90,0x30,0x8e,732},
90 { "Philips (SECAM+PAL_BG) (FI1216MF, FM1216MF, FR1216MF)", Philips, SECAM,
91 16*168.25,16*447.25,0xA7,0x97,0x37,0x8e,623},
92
93 { "NoTuner", NoTuner, NOTUNER,
94 0,0,0x00,0x00,0x00,0x00,0x00},
95 { "Philips PAL_BG (FI1216 and compatibles)", Philips, PAL,
96 16*168.25,16*447.25,0xA0,0x90,0x30,0x8e,623},
97 { "Temic NTSC (4032 FY5)", TEMIC, NTSC,
98 16*157.25,16*463.25,0x02,0x04,0x01,0x8e,732},
99 { "Temic PAL_I (4062 FY5)", TEMIC, PAL_I,
100 16*170.00,16*450.00,0x02,0x04,0x01,0x8e,623},
101
102 { "Temic NTSC (4036 FY5)", TEMIC, NTSC,
103 16*157.25,16*463.25,0xa0,0x90,0x30,0x8e,732},
104 { "Alps HSBH1", TEMIC, NTSC,
105 16*137.25,16*385.25,0x01,0x02,0x08,0x8e,732},
106 { "Alps TSBE1",TEMIC,PAL,
107 16*137.25,16*385.25,0x01,0x02,0x08,0x8e,732},
108 { "Alps TSBB5", Alps, PAL_I, /* tested (UK UHF) with Modulartech MM205 */
109 16*133.25,16*351.25,0x01,0x02,0x08,0x8e,632},
110
111 { "Alps TSBE5", Alps, PAL, /* untested - data sheet guess. Only IF differs. */
112 16*133.25,16*351.25,0x01,0x02,0x08,0x8e,622},
113 { "Alps TSBC5", Alps, PAL, /* untested - data sheet guess. Only IF differs. */
114 16*133.25,16*351.25,0x01,0x02,0x08,0x8e,608},
115 { "Temic PAL_BG (4006FH5)", TEMIC, PAL,
116 16*170.00,16*450.00,0xa0,0x90,0x30,0x8e,623},
117 { "Alps TSCH6",Alps,NTSC,
118 16*137.25,16*385.25,0x14,0x12,0x11,0x8e,732},
119
120 { "Temic PAL_DK (4016 FY5)",TEMIC,PAL,
121 16*168.25,16*456.25,0xa0,0x90,0x30,0x8e,623},
122 { "Philips NTSC_M (MK2)",Philips,NTSC,
123 16*160.00,16*454.00,0xa0,0x90,0x30,0x8e,732},
124 { "Temic PAL_I (4066 FY5)", TEMIC, PAL_I,
125 16*169.00, 16*454.00, 0xa0,0x90,0x30,0x8e,623},
126 { "Temic PAL* auto (4006 FN5)", TEMIC, PAL,
127 16*169.00, 16*454.00, 0xa0,0x90,0x30,0x8e,623},
128
129 { "Temic PAL_BG (4009 FR5) or PAL_I (4069 FR5)", TEMIC, PAL,
130 16*141.00, 16*464.00, 0xa0,0x90,0x30,0x8e,623},
131 { "Temic NTSC (4039 FR5)", TEMIC, NTSC,
132 16*158.00, 16*453.00, 0xa0,0x90,0x30,0x8e,732},
133 { "Temic PAL/SECAM multi (4046 FM5)", TEMIC, PAL,
134 16*169.00, 16*454.00, 0xa0,0x90,0x30,0x8e,623},
135 { "Philips PAL_DK (FI1256 and compatibles)", Philips, PAL,
136 16*170.00,16*450.00,0xa0,0x90,0x30,0x8e,623},
137
138 { "Philips PAL/SECAM multi (FQ1216ME)", Philips, PAL,
139 16*170.00,16*450.00,0xa0,0x90,0x30,0x8e,623},
140 { "LG PAL_I+FM (TAPC-I001D)", LGINNOTEK, PAL_I,
141 16*170.00,16*450.00,0xa0,0x90,0x30,0x8e,623},
142 { "LG PAL_I (TAPC-I701D)", LGINNOTEK, PAL_I,
143 16*170.00,16*450.00,0xa0,0x90,0x30,0x8e,623},
144 { "LG NTSC+FM (TPI8NSR01F)", LGINNOTEK, NTSC,
145 16*210.00,16*497.00,0xa0,0x90,0x30,0x8e,732},
146
147 { "LG PAL_BG+FM (TPI8PSB01D)", LGINNOTEK, PAL,
148 16*170.00,16*450.00,0xa0,0x90,0x30,0x8e,623},
149 { "LG PAL_BG (TPI8PSB11D)", LGINNOTEK, PAL,
150 16*170.00,16*450.00,0xa0,0x90,0x30,0x8e,623},
151 { "Temic PAL* auto + FM (4009 FN5)", TEMIC, PAL,
152 16*141.00, 16*464.00, 0xa0,0x90,0x30,0x8e,623},
153 { "SHARP NTSC_JP (2U5JF5540)", SHARP, NTSC, /* 940=16*58.75 NTSC@Japan */
154 16*137.25,16*317.25,0x01,0x02,0x08,0x8e,940 },
155
156 { "Samsung PAL TCPM9091PD27", Samsung, PAL, /* from sourceforge v3tv */
157 16*169,16*464,0xA0,0x90,0x30,0x8e,623},
158 { "MT20xx universal", Microtune,PAL|NTSC,
159 /* see mt20xx.c for details */ },
160 { "Temic PAL_BG (4106 FH5)", TEMIC, PAL,
161 16*141.00, 16*464.00, 0xa0,0x90,0x30,0x8e,623},
162 { "Temic PAL_DK/SECAM_L (4012 FY5)", TEMIC, PAL,
163 16*140.25, 16*463.25, 0x02,0x04,0x01,0x8e,623},
164
165 { "Temic NTSC (4136 FY5)", TEMIC, NTSC,
166 16*158.00, 16*453.00, 0xa0,0x90,0x30,0x8e,732},
167 { "LG PAL (newer TAPC series)", LGINNOTEK, PAL,
168 16*170.00, 16*450.00, 0x01,0x02,0x08,0x8e,623},
169 { "Philips PAL/SECAM multi (FM1216ME MK3)", Philips, PAL,
170 16*160.00,16*442.00,0x01,0x02,0x04,0x8e,623 },
171 { "LG NTSC (newer TAPC series)", LGINNOTEK, NTSC,
172 16*170.00, 16*450.00, 0x01,0x02,0x08,0x8e,732},
173
174 { "HITACHI V7-J180AT", HITACHI, NTSC,
175 16*170.00, 16*450.00, 0x01,0x02,0x08,0x8e,940 },
176 { "Philips PAL_MK (FI1216 MK)", Philips, PAL,
177 16*140.25,16*463.25,0x01,0xc2,0xcf,0x8e,623},
178 { "Philips 1236D ATSC/NTSC daul in",Philips,ATSC,
179 16*157.25,16*454.00,0xa0,0x90,0x30,0x8e,732},
180 { "Philips NTSC MK3 (FM1236MK3 or FM1236/F)", Philips, NTSC,
181 16*160.00,16*442.00,0x01,0x02,0x04,0x8e,732},
182
183 { "Philips 4 in 1 (ATI TV Wonder Pro/Conexant)", Philips, NTSC,
184 16*160.00,16*442.00,0x01,0x02,0x04,0x8e,732},
185 { "Microtune 4049 FM5",Microtune,PAL,
186 16*141.00,16*464.00,0xa0,0x90,0x30,0x8e,623},
187 { "Panasonic VP27s/ENGE4324D", Panasonic, NTSC,
188 16*160.00,16*454.00,0x01,0x02,0x08,0xce,940},
189 { "LG NTSC (TAPE series)", LGINNOTEK, NTSC,
190 16*160.00,16*442.00,0x01,0x02,0x04,0x8e,732 },
191
192 { "Tenna TNF 8831 BGFF)", Philips, PAL,
193 16*161.25,16*463.25,0xa0,0x90,0x30,0x8e,623},
194 { "Microtune 4042 FI5 ATSC/NTSC dual in", Microtune, NTSC,
195 16*162.00,16*457.00,0xa2,0x94,0x31,0x8e,732},
196 { "TCL 2002N", TCL, NTSC,
197 16*172.00,16*448.00,0x01,0x02,0x08,0x8e,732},
198 { "Philips PAL/SECAM_D (FM 1256 I-H3)", Philips, PAL,
199 16*160.00,16*442.00,0x01,0x02,0x04,0x8e,623 },
200
201 { "Thomson DDT 7610 (ATSC/NTSC)", THOMSON, ATSC,
202 16*157.25,16*454.00,0x39,0x3a,0x3c,0x8e,732},
203 { "Philips FQ1286", Philips, NTSC,
204 16*160.00,16*454.00,0x41,0x42,0x04,0x8e,940}, // UHF band untested
205 { "tda8290+75", Philips,PAL|NTSC,
206 /* see tda8290.c for details */ },
207 { "LG PAL (TAPE series)", LGINNOTEK, PAL,
208 16*170.00, 16*450.00, 0x01,0x02,0x08,0xce,623},
209
210 { "Philips PAL/SECAM multi (FQ1216AME MK4)", Philips, PAL,
211 16*160.00,16*442.00,0x01,0x02,0x04,0xce,623 },
212 { "Philips FQ1236A MK4", Philips, NTSC,
213 16*160.00,16*442.00,0x01,0x02,0x04,0x8e,732 },
214
215 /* Should work for TVF8531MF, TVF8831MF, TVF8731MF */
216 { "Ymec TVision TVF-8531MF", Philips, NTSC,
217 16*160.00,16*454.00,0xa0,0x90,0x30,0x8e,732},
218 { "Ymec TVision TVF-5533MF", Philips, NTSC,
219 16*160.00,16*454.00,0x01,0x02,0x04,0x8e,732},
220 { "Thomson DDT 7611 (ATSC/NTSC)", THOMSON, ATSC,
221 16*157.25,16*454.00,0x39,0x3a,0x3c,0x8e,732},
222 /* Should work for TNF9533-D/IF, TNF9533-B/DF */
223 { "Tena TNF9533-D/IF", Philips, PAL,
224 16*160.25,16*464.25,0x01,0x02,0x04,0x8e,623},
225
226 /* This entry is for TEA5767 FM radio only chip used on several boards w/TV tuner */
227 { TEA5767_TUNER_NAME, Philips, RADIO,
228 -1, -1, 0, 0, 0, TEA5767_LOW_LO_32768,0},
229 { "Philips FMD1216ME MK3 Hybrid Tuner", Philips, PAL,
230 16*160.00,16*442.00,0x51,0x52,0x54,0x86,623 },
231 };
232
233 unsigned const int tuner_count = ARRAY_SIZE(tuners);
234
235 /* ---------------------------------------------------------------------- */
236
237 static int tuner_getstatus(struct i2c_client *c)
238 {
239 unsigned char byte;
240
241 if (1 != i2c_master_recv(c,&byte,1))
242 return 0;
243
244 return byte;
245 }
246
247 #define TUNER_POR 0x80
248 #define TUNER_FL 0x40
249 #define TUNER_MODE 0x38
250 #define TUNER_AFC 0x07
251
252 #define TUNER_STEREO 0x10 /* radio mode */
253 #define TUNER_STEREO_MK3 0x04 /* radio mode */
254 #define TUNER_SIGNAL 0x07 /* radio mode */
255
256 static int tuner_signal(struct i2c_client *c)
257 {
258 return (tuner_getstatus(c) & TUNER_SIGNAL) << 13;
259 }
260
261 static int tuner_stereo(struct i2c_client *c)
262 {
263 int stereo, status;
264 struct tuner *t = i2c_get_clientdata(c);
265
266 status = tuner_getstatus (c);
267
268 switch (t->type) {
269 case TUNER_PHILIPS_FM1216ME_MK3:
270 case TUNER_PHILIPS_FM1236_MK3:
271 case TUNER_PHILIPS_FM1256_IH3:
272 stereo = ((status & TUNER_SIGNAL) == TUNER_STEREO_MK3);
273 break;
274 default:
275 stereo = status & TUNER_STEREO;
276 }
277
278 return stereo;
279 }
280
281 #if 0 /* unused */
282 static int tuner_islocked (struct i2c_client *c)
283 {
284 return (tuner_getstatus (c) & TUNER_FL);
285 }
286
287 static int tuner_afcstatus (struct i2c_client *c)
288 {
289 return (tuner_getstatus (c) & TUNER_AFC) - 2;
290 }
291
292 static int tuner_mode (struct i2c_client *c)
293 {
294 return (tuner_getstatus (c) & TUNER_MODE) >> 3;
295 }
296 #endif
297
298 /* ---------------------------------------------------------------------- */
299
300 static void default_set_tv_freq(struct i2c_client *c, unsigned int freq)
301 {
302 struct tuner *t = i2c_get_clientdata(c);
303 u8 config;
304 u16 div;
305 struct tunertype *tun;
306 unsigned char buffer[4];
307 int rc;
308
309 tun = &tuners[t->type];
310 if (freq < tun->thresh1) {
311 config = tun->VHF_L;
312 tuner_dbg("tv: VHF lowrange\n");
313 } else if (freq < tun->thresh2) {
314 config = tun->VHF_H;
315 tuner_dbg("tv: VHF high range\n");
316 } else {
317 config = tun->UHF;
318 tuner_dbg("tv: UHF range\n");
319 }
320
321
322 /* tv norm specific stuff for multi-norm tuners */
323 switch (t->type) {
324 case TUNER_PHILIPS_SECAM: // FI1216MF
325 /* 0x01 -> ??? no change ??? */
326 /* 0x02 -> PAL BDGHI / SECAM L */
327 /* 0x04 -> ??? PAL others / SECAM others ??? */
328 config &= ~0x02;
329 if (t->std & V4L2_STD_SECAM)
330 config |= 0x02;
331 break;
332
333 case TUNER_TEMIC_4046FM5:
334 config &= ~0x0f;
335
336 if (t->std & V4L2_STD_PAL_BG) {
337 config |= TEMIC_SET_PAL_BG;
338
339 } else if (t->std & V4L2_STD_PAL_I) {
340 config |= TEMIC_SET_PAL_I;
341
342 } else if (t->std & V4L2_STD_PAL_DK) {
343 config |= TEMIC_SET_PAL_DK;
344
345 } else if (t->std & V4L2_STD_SECAM_L) {
346 config |= TEMIC_SET_PAL_L;
347
348 }
349 break;
350
351 case TUNER_PHILIPS_FQ1216ME:
352 config &= ~0x0f;
353
354 if (t->std & (V4L2_STD_PAL_BG|V4L2_STD_PAL_DK)) {
355 config |= PHILIPS_SET_PAL_BGDK;
356
357 } else if (t->std & V4L2_STD_PAL_I) {
358 config |= PHILIPS_SET_PAL_I;
359
360 } else if (t->std & V4L2_STD_SECAM_L) {
361 config |= PHILIPS_SET_PAL_L;
362
363 }
364 break;
365
366 case TUNER_PHILIPS_ATSC:
367 /* 0x00 -> ATSC antenna input 1 */
368 /* 0x01 -> ATSC antenna input 2 */
369 /* 0x02 -> NTSC antenna input 1 */
370 /* 0x03 -> NTSC antenna input 2 */
371 config &= ~0x03;
372 if (!(t->std & V4L2_STD_ATSC))
373 config |= 2;
374 /* FIXME: input */
375 break;
376
377 case TUNER_MICROTUNE_4042FI5:
378 /* Set the charge pump for fast tuning */
379 tun->config |= 0x40;
380 break;
381 }
382
383 /*
384 * Philips FI1216MK2 remark from specification :
385 * for channel selection involving band switching, and to ensure
386 * smooth tuning to the desired channel without causing
387 * unnecessary charge pump action, it is recommended to consider
388 * the difference between wanted channel frequency and the
389 * current channel frequency. Unnecessary charge pump action
390 * will result in very low tuning voltage which may drive the
391 * oscillator to extreme conditions.
392 *
393 * Progfou: specification says to send config data before
394 * frequency in case (wanted frequency < current frequency).
395 */
396
397 div=freq + tun->IFPCoff;
398 if (t->type == TUNER_PHILIPS_SECAM && freq < t->freq) {
399 buffer[0] = tun->config;
400 buffer[1] = config;
401 buffer[2] = (div>>8) & 0x7f;
402 buffer[3] = div & 0xff;
403 } else {
404 buffer[0] = (div>>8) & 0x7f;
405 buffer[1] = div & 0xff;
406 buffer[2] = tun->config;
407 buffer[3] = config;
408 }
409 tuner_dbg("tv 0x%02x 0x%02x 0x%02x 0x%02x\n",
410 buffer[0],buffer[1],buffer[2],buffer[3]);
411
412 if (4 != (rc = i2c_master_send(c,buffer,4)))
413 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
414
415 if (t->type == TUNER_MICROTUNE_4042FI5) {
416 // FIXME - this may also work for other tuners
417 unsigned long timeout = jiffies + msecs_to_jiffies(1);
418 u8 status_byte = 0;
419
420 /* Wait until the PLL locks */
421 for (;;) {
422 if (time_after(jiffies,timeout))
423 return;
424 if (1 != (rc = i2c_master_recv(c,&status_byte,1))) {
425 tuner_warn("i2c i/o read error: rc == %d (should be 1)\n",rc);
426 break;
427 }
428 /* bit 6 is PLL locked indicator */
429 if (status_byte & 0x40)
430 break;
431 udelay(10);
432 }
433
434 /* Set the charge pump for optimized phase noise figure */
435 tun->config &= ~0x40;
436 buffer[0] = (div>>8) & 0x7f;
437 buffer[1] = div & 0xff;
438 buffer[2] = tun->config;
439 buffer[3] = config;
440 tuner_dbg("tv 0x%02x 0x%02x 0x%02x 0x%02x\n",
441 buffer[0],buffer[1],buffer[2],buffer[3]);
442
443 if (4 != (rc = i2c_master_send(c,buffer,4)))
444 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
445 }
446 }
447
448 static void default_set_radio_freq(struct i2c_client *c, unsigned int freq)
449 {
450 struct tunertype *tun;
451 struct tuner *t = i2c_get_clientdata(c);
452 unsigned char buffer[4];
453 unsigned div;
454 int rc;
455
456 tun=&tuners[t->type];
457 div = (freq / 1000) + (int)(16*10.7);
458 buffer[2] = tun->config;
459
460 switch (t->type) {
461 case TUNER_TENA_9533_DI:
462 case TUNER_YMEC_TVF_5533MF:
463 /*These values are empirically determinated */
464 div = (freq * 122) / 16000 - 20;
465 buffer[2] = 0x88; /* could be also 0x80 */
466 buffer[3] = 0x19; /* could be also 0x10, 0x18, 0x99 */
467 break;
468 case TUNER_PHILIPS_FM1216ME_MK3:
469 case TUNER_PHILIPS_FM1236_MK3:
470 case TUNER_PHILIPS_FMD1216ME_MK3:
471 buffer[3] = 0x19;
472 break;
473 case TUNER_PHILIPS_FM1256_IH3:
474 div = (20 * freq) / 16000 + 333 * 2;
475 buffer[2] = 0x80;
476 buffer[3] = 0x19;
477 break;
478 case TUNER_LG_PAL_FM:
479 buffer[3] = 0xa5;
480 break;
481 default:
482 buffer[3] = 0xa4;
483 break;
484 }
485 buffer[0] = (div>>8) & 0x7f;
486 buffer[1] = div & 0xff;
487
488 tuner_dbg("radio 0x%02x 0x%02x 0x%02x 0x%02x\n",
489 buffer[0],buffer[1],buffer[2],buffer[3]);
490
491 if (4 != (rc = i2c_master_send(c,buffer,4)))
492 tuner_warn("i2c i/o error: rc == %d (should be 4)\n",rc);
493 }
494
495 int default_tuner_init(struct i2c_client *c)
496 {
497 struct tuner *t = i2c_get_clientdata(c);
498
499 tuner_info("type set to %d (%s)\n",
500 t->type, tuners[t->type].name);
501 strlcpy(c->name, tuners[t->type].name, sizeof(c->name));
502
503 t->tv_freq = default_set_tv_freq;
504 t->radio_freq = default_set_radio_freq;
505 t->has_signal = tuner_signal;
506 t->is_stereo = tuner_stereo;
507
508 return 0;
509 }
510
511 /*
512 * Overrides for Emacs so that we follow Linus's tabbing style.
513 * ---------------------------------------------------------------------------
514 * Local variables:
515 * c-basic-offset: 8
516 * End:
517 */