xref: /linux/drivers/media/tuners/si2157.c (revision 3ad0876554cafa368f574d4d408468510543e9ff)
1 /*
2  * Silicon Labs Si2146/2147/2148/2157/2158 silicon tuner driver
3  *
4  * Copyright (C) 2014 Antti Palosaari <crope@iki.fi>
5  *
6  *    This program is free software; you can redistribute it and/or modify
7  *    it under the terms of the GNU General Public License as published by
8  *    the Free Software Foundation; either version 2 of the License, or
9  *    (at your option) any later version.
10  *
11  *    This program is distributed in the hope that it will be useful,
12  *    but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *    GNU General Public License for more details.
15  */
16 
17 #include "si2157_priv.h"
18 
19 static const struct dvb_tuner_ops si2157_ops;
20 
21 /* execute firmware command */
22 static int si2157_cmd_execute(struct i2c_client *client, struct si2157_cmd *cmd)
23 {
24 	struct si2157_dev *dev = i2c_get_clientdata(client);
25 	int ret;
26 	unsigned long timeout;
27 
28 	mutex_lock(&dev->i2c_mutex);
29 
30 	if (cmd->wlen) {
31 		/* write cmd and args for firmware */
32 		ret = i2c_master_send(client, cmd->args, cmd->wlen);
33 		if (ret < 0) {
34 			goto err_mutex_unlock;
35 		} else if (ret != cmd->wlen) {
36 			ret = -EREMOTEIO;
37 			goto err_mutex_unlock;
38 		}
39 	}
40 
41 	if (cmd->rlen) {
42 		/* wait cmd execution terminate */
43 		#define TIMEOUT 80
44 		timeout = jiffies + msecs_to_jiffies(TIMEOUT);
45 		while (!time_after(jiffies, timeout)) {
46 			ret = i2c_master_recv(client, cmd->args, cmd->rlen);
47 			if (ret < 0) {
48 				goto err_mutex_unlock;
49 			} else if (ret != cmd->rlen) {
50 				ret = -EREMOTEIO;
51 				goto err_mutex_unlock;
52 			}
53 
54 			/* firmware ready? */
55 			if ((cmd->args[0] >> 7) & 0x01)
56 				break;
57 		}
58 
59 		dev_dbg(&client->dev, "cmd execution took %d ms\n",
60 				jiffies_to_msecs(jiffies) -
61 				(jiffies_to_msecs(timeout) - TIMEOUT));
62 
63 		if (!((cmd->args[0] >> 7) & 0x01)) {
64 			ret = -ETIMEDOUT;
65 			goto err_mutex_unlock;
66 		}
67 	}
68 
69 	mutex_unlock(&dev->i2c_mutex);
70 	return 0;
71 
72 err_mutex_unlock:
73 	mutex_unlock(&dev->i2c_mutex);
74 	dev_dbg(&client->dev, "failed=%d\n", ret);
75 	return ret;
76 }
77 
78 static int si2157_init(struct dvb_frontend *fe)
79 {
80 	struct i2c_client *client = fe->tuner_priv;
81 	struct si2157_dev *dev = i2c_get_clientdata(client);
82 	struct dtv_frontend_properties *c = &fe->dtv_property_cache;
83 	int ret, len, remaining;
84 	struct si2157_cmd cmd;
85 	const struct firmware *fw;
86 	const char *fw_name;
87 	unsigned int uitmp, chip_id;
88 
89 	dev_dbg(&client->dev, "\n");
90 
91 	/* Returned IF frequency is garbage when firmware is not running */
92 	memcpy(cmd.args, "\x15\x00\x06\x07", 4);
93 	cmd.wlen = 4;
94 	cmd.rlen = 4;
95 	ret = si2157_cmd_execute(client, &cmd);
96 	if (ret)
97 		goto err;
98 
99 	uitmp = cmd.args[2] << 0 | cmd.args[3] << 8;
100 	dev_dbg(&client->dev, "if_frequency kHz=%u\n", uitmp);
101 
102 	if (uitmp == dev->if_frequency / 1000)
103 		goto warm;
104 
105 	/* power up */
106 	if (dev->chiptype == SI2157_CHIPTYPE_SI2146) {
107 		memcpy(cmd.args, "\xc0\x05\x01\x00\x00\x0b\x00\x00\x01", 9);
108 		cmd.wlen = 9;
109 	} else if (dev->chiptype == SI2157_CHIPTYPE_SI2141) {
110 		memcpy(cmd.args, "\xc0\x00\x0d\x0e\x00\x01\x01\x01\x01\x03", 10);
111 		cmd.wlen = 10;
112 	} else {
113 		memcpy(cmd.args, "\xc0\x00\x0c\x00\x00\x01\x01\x01\x01\x01\x01\x02\x00\x00\x01", 15);
114 		cmd.wlen = 15;
115 	}
116 	cmd.rlen = 1;
117 	ret = si2157_cmd_execute(client, &cmd);
118 	if (ret)
119 		goto err;
120 
121 	/* Si2141 needs a second command before it answers the revision query */
122 	if (dev->chiptype == SI2157_CHIPTYPE_SI2141) {
123 		memcpy(cmd.args, "\xc0\x08\x01\x02\x00\x00\x01", 7);
124 		cmd.wlen = 7;
125 		ret = si2157_cmd_execute(client, &cmd);
126 		if (ret)
127 			goto err;
128 	}
129 
130 	/* query chip revision */
131 	memcpy(cmd.args, "\x02", 1);
132 	cmd.wlen = 1;
133 	cmd.rlen = 13;
134 	ret = si2157_cmd_execute(client, &cmd);
135 	if (ret)
136 		goto err;
137 
138 	chip_id = cmd.args[1] << 24 | cmd.args[2] << 16 | cmd.args[3] << 8 |
139 			cmd.args[4] << 0;
140 
141 	#define SI2158_A20 ('A' << 24 | 58 << 16 | '2' << 8 | '0' << 0)
142 	#define SI2148_A20 ('A' << 24 | 48 << 16 | '2' << 8 | '0' << 0)
143 	#define SI2157_A30 ('A' << 24 | 57 << 16 | '3' << 8 | '0' << 0)
144 	#define SI2147_A30 ('A' << 24 | 47 << 16 | '3' << 8 | '0' << 0)
145 	#define SI2146_A10 ('A' << 24 | 46 << 16 | '1' << 8 | '0' << 0)
146 	#define SI2141_A10 ('A' << 24 | 41 << 16 | '1' << 8 | '0' << 0)
147 
148 	switch (chip_id) {
149 	case SI2158_A20:
150 	case SI2148_A20:
151 		fw_name = SI2158_A20_FIRMWARE;
152 		break;
153 	case SI2141_A10:
154 		fw_name = SI2141_A10_FIRMWARE;
155 		break;
156 	case SI2157_A30:
157 	case SI2147_A30:
158 	case SI2146_A10:
159 		fw_name = NULL;
160 		break;
161 	default:
162 		dev_err(&client->dev, "unknown chip version Si21%d-%c%c%c\n",
163 				cmd.args[2], cmd.args[1],
164 				cmd.args[3], cmd.args[4]);
165 		ret = -EINVAL;
166 		goto err;
167 	}
168 
169 	dev_info(&client->dev, "found a 'Silicon Labs Si21%d-%c%c%c'\n",
170 			cmd.args[2], cmd.args[1], cmd.args[3], cmd.args[4]);
171 
172 	if (fw_name == NULL)
173 		goto skip_fw_download;
174 
175 	/* request the firmware, this will block and timeout */
176 	ret = request_firmware(&fw, fw_name, &client->dev);
177 	if (ret) {
178 		dev_err(&client->dev, "firmware file '%s' not found\n",
179 				fw_name);
180 		goto err;
181 	}
182 
183 	/* firmware should be n chunks of 17 bytes */
184 	if (fw->size % 17 != 0) {
185 		dev_err(&client->dev, "firmware file '%s' is invalid\n",
186 				fw_name);
187 		ret = -EINVAL;
188 		goto err_release_firmware;
189 	}
190 
191 	dev_info(&client->dev, "downloading firmware from file '%s'\n",
192 			fw_name);
193 
194 	for (remaining = fw->size; remaining > 0; remaining -= 17) {
195 		len = fw->data[fw->size - remaining];
196 		if (len > SI2157_ARGLEN) {
197 			dev_err(&client->dev, "Bad firmware length\n");
198 			ret = -EINVAL;
199 			goto err_release_firmware;
200 		}
201 		memcpy(cmd.args, &fw->data[(fw->size - remaining) + 1], len);
202 		cmd.wlen = len;
203 		cmd.rlen = 1;
204 		ret = si2157_cmd_execute(client, &cmd);
205 		if (ret) {
206 			dev_err(&client->dev, "firmware download failed %d\n",
207 					ret);
208 			goto err_release_firmware;
209 		}
210 	}
211 
212 	release_firmware(fw);
213 
214 skip_fw_download:
215 	/* reboot the tuner with new firmware? */
216 	memcpy(cmd.args, "\x01\x01", 2);
217 	cmd.wlen = 2;
218 	cmd.rlen = 1;
219 	ret = si2157_cmd_execute(client, &cmd);
220 	if (ret)
221 		goto err;
222 
223 	/* query firmware version */
224 	memcpy(cmd.args, "\x11", 1);
225 	cmd.wlen = 1;
226 	cmd.rlen = 10;
227 	ret = si2157_cmd_execute(client, &cmd);
228 	if (ret)
229 		goto err;
230 
231 	dev_info(&client->dev, "firmware version: %c.%c.%d\n",
232 			cmd.args[6], cmd.args[7], cmd.args[8]);
233 warm:
234 	/* init statistics in order signal app which are supported */
235 	c->strength.len = 1;
236 	c->strength.stat[0].scale = FE_SCALE_NOT_AVAILABLE;
237 	/* start statistics polling */
238 	schedule_delayed_work(&dev->stat_work, msecs_to_jiffies(1000));
239 
240 	dev->active = true;
241 	return 0;
242 err_release_firmware:
243 	release_firmware(fw);
244 err:
245 	dev_dbg(&client->dev, "failed=%d\n", ret);
246 	return ret;
247 }
248 
249 static int si2157_sleep(struct dvb_frontend *fe)
250 {
251 	struct i2c_client *client = fe->tuner_priv;
252 	struct si2157_dev *dev = i2c_get_clientdata(client);
253 	int ret;
254 	struct si2157_cmd cmd;
255 
256 	dev_dbg(&client->dev, "\n");
257 
258 	dev->active = false;
259 
260 	/* stop statistics polling */
261 	cancel_delayed_work_sync(&dev->stat_work);
262 
263 	/* standby */
264 	memcpy(cmd.args, "\x16\x00", 2);
265 	cmd.wlen = 2;
266 	cmd.rlen = 1;
267 	ret = si2157_cmd_execute(client, &cmd);
268 	if (ret)
269 		goto err;
270 
271 	return 0;
272 err:
273 	dev_dbg(&client->dev, "failed=%d\n", ret);
274 	return ret;
275 }
276 
277 static int si2157_set_params(struct dvb_frontend *fe)
278 {
279 	struct i2c_client *client = fe->tuner_priv;
280 	struct si2157_dev *dev = i2c_get_clientdata(client);
281 	struct dtv_frontend_properties *c = &fe->dtv_property_cache;
282 	int ret;
283 	struct si2157_cmd cmd;
284 	u8 bandwidth, delivery_system;
285 	u32 if_frequency = 5000000;
286 
287 	dev_dbg(&client->dev,
288 			"delivery_system=%d frequency=%u bandwidth_hz=%u\n",
289 			c->delivery_system, c->frequency, c->bandwidth_hz);
290 
291 	if (!dev->active) {
292 		ret = -EAGAIN;
293 		goto err;
294 	}
295 
296 	if (c->bandwidth_hz <= 6000000)
297 		bandwidth = 0x06;
298 	else if (c->bandwidth_hz <= 7000000)
299 		bandwidth = 0x07;
300 	else if (c->bandwidth_hz <= 8000000)
301 		bandwidth = 0x08;
302 	else
303 		bandwidth = 0x0f;
304 
305 	switch (c->delivery_system) {
306 	case SYS_ATSC:
307 			delivery_system = 0x00;
308 			if_frequency = 3250000;
309 			break;
310 	case SYS_DVBC_ANNEX_B:
311 			delivery_system = 0x10;
312 			if_frequency = 4000000;
313 			break;
314 	case SYS_DVBT:
315 	case SYS_DVBT2: /* it seems DVB-T and DVB-T2 both are 0x20 here */
316 			delivery_system = 0x20;
317 			break;
318 	case SYS_DVBC_ANNEX_A:
319 			delivery_system = 0x30;
320 			break;
321 	default:
322 			ret = -EINVAL;
323 			goto err;
324 	}
325 
326 	memcpy(cmd.args, "\x14\x00\x03\x07\x00\x00", 6);
327 	cmd.args[4] = delivery_system | bandwidth;
328 	if (dev->inversion)
329 		cmd.args[5] = 0x01;
330 	cmd.wlen = 6;
331 	cmd.rlen = 4;
332 	ret = si2157_cmd_execute(client, &cmd);
333 	if (ret)
334 		goto err;
335 
336 	if (dev->chiptype == SI2157_CHIPTYPE_SI2146)
337 		memcpy(cmd.args, "\x14\x00\x02\x07\x00\x01", 6);
338 	else
339 		memcpy(cmd.args, "\x14\x00\x02\x07\x00\x00", 6);
340 	cmd.args[4] = dev->if_port;
341 	cmd.wlen = 6;
342 	cmd.rlen = 4;
343 	ret = si2157_cmd_execute(client, &cmd);
344 	if (ret)
345 		goto err;
346 
347 	/* set if frequency if needed */
348 	if (if_frequency != dev->if_frequency) {
349 		memcpy(cmd.args, "\x14\x00\x06\x07", 4);
350 		cmd.args[4] = (if_frequency / 1000) & 0xff;
351 		cmd.args[5] = ((if_frequency / 1000) >> 8) & 0xff;
352 		cmd.wlen = 6;
353 		cmd.rlen = 4;
354 		ret = si2157_cmd_execute(client, &cmd);
355 		if (ret)
356 			goto err;
357 
358 		dev->if_frequency = if_frequency;
359 	}
360 
361 	/* set frequency */
362 	memcpy(cmd.args, "\x41\x00\x00\x00\x00\x00\x00\x00", 8);
363 	cmd.args[4] = (c->frequency >>  0) & 0xff;
364 	cmd.args[5] = (c->frequency >>  8) & 0xff;
365 	cmd.args[6] = (c->frequency >> 16) & 0xff;
366 	cmd.args[7] = (c->frequency >> 24) & 0xff;
367 	cmd.wlen = 8;
368 	cmd.rlen = 1;
369 	ret = si2157_cmd_execute(client, &cmd);
370 	if (ret)
371 		goto err;
372 
373 	return 0;
374 err:
375 	dev_dbg(&client->dev, "failed=%d\n", ret);
376 	return ret;
377 }
378 
379 static int si2157_get_if_frequency(struct dvb_frontend *fe, u32 *frequency)
380 {
381 	struct i2c_client *client = fe->tuner_priv;
382 	struct si2157_dev *dev = i2c_get_clientdata(client);
383 
384 	*frequency = dev->if_frequency;
385 	return 0;
386 }
387 
388 static const struct dvb_tuner_ops si2157_ops = {
389 	.info = {
390 		.name           = "Silicon Labs Si2141/Si2146/2147/2148/2157/2158",
391 		.frequency_min  = 42000000,
392 		.frequency_max  = 870000000,
393 	},
394 
395 	.init = si2157_init,
396 	.sleep = si2157_sleep,
397 	.set_params = si2157_set_params,
398 	.get_if_frequency = si2157_get_if_frequency,
399 };
400 
401 static void si2157_stat_work(struct work_struct *work)
402 {
403 	struct si2157_dev *dev = container_of(work, struct si2157_dev, stat_work.work);
404 	struct dvb_frontend *fe = dev->fe;
405 	struct i2c_client *client = fe->tuner_priv;
406 	struct dtv_frontend_properties *c = &fe->dtv_property_cache;
407 	struct si2157_cmd cmd;
408 	int ret;
409 
410 	dev_dbg(&client->dev, "\n");
411 
412 	memcpy(cmd.args, "\x42\x00", 2);
413 	cmd.wlen = 2;
414 	cmd.rlen = 12;
415 	ret = si2157_cmd_execute(client, &cmd);
416 	if (ret)
417 		goto err;
418 
419 	c->strength.stat[0].scale = FE_SCALE_DECIBEL;
420 	c->strength.stat[0].svalue = (s8) cmd.args[3] * 1000;
421 
422 	schedule_delayed_work(&dev->stat_work, msecs_to_jiffies(2000));
423 	return;
424 err:
425 	c->strength.stat[0].scale = FE_SCALE_NOT_AVAILABLE;
426 	dev_dbg(&client->dev, "failed=%d\n", ret);
427 }
428 
429 static int si2157_probe(struct i2c_client *client,
430 			const struct i2c_device_id *id)
431 {
432 	struct si2157_config *cfg = client->dev.platform_data;
433 	struct dvb_frontend *fe = cfg->fe;
434 	struct si2157_dev *dev;
435 	struct si2157_cmd cmd;
436 	int ret;
437 
438 	dev = kzalloc(sizeof(*dev), GFP_KERNEL);
439 	if (!dev) {
440 		ret = -ENOMEM;
441 		dev_err(&client->dev, "kzalloc() failed\n");
442 		goto err;
443 	}
444 
445 	i2c_set_clientdata(client, dev);
446 	dev->fe = cfg->fe;
447 	dev->inversion = cfg->inversion;
448 	dev->if_port = cfg->if_port;
449 	dev->chiptype = (u8)id->driver_data;
450 	dev->if_frequency = 5000000; /* default value of property 0x0706 */
451 	mutex_init(&dev->i2c_mutex);
452 	INIT_DELAYED_WORK(&dev->stat_work, si2157_stat_work);
453 
454 	/* check if the tuner is there */
455 	cmd.wlen = 0;
456 	cmd.rlen = 1;
457 	ret = si2157_cmd_execute(client, &cmd);
458 	if (ret)
459 		goto err_kfree;
460 
461 	memcpy(&fe->ops.tuner_ops, &si2157_ops, sizeof(struct dvb_tuner_ops));
462 	fe->tuner_priv = client;
463 
464 #ifdef CONFIG_MEDIA_CONTROLLER
465 	if (cfg->mdev) {
466 		dev->mdev = cfg->mdev;
467 
468 		dev->ent.name = KBUILD_MODNAME;
469 		dev->ent.function = MEDIA_ENT_F_TUNER;
470 
471 		dev->pad[TUNER_PAD_RF_INPUT].flags = MEDIA_PAD_FL_SINK;
472 		dev->pad[TUNER_PAD_OUTPUT].flags = MEDIA_PAD_FL_SOURCE;
473 		dev->pad[TUNER_PAD_AUD_OUT].flags = MEDIA_PAD_FL_SOURCE;
474 
475 		ret = media_entity_pads_init(&dev->ent, TUNER_NUM_PADS,
476 					     &dev->pad[0]);
477 
478 		if (ret)
479 			goto err_kfree;
480 
481 		ret = media_device_register_entity(cfg->mdev, &dev->ent);
482 		if (ret) {
483 			media_entity_cleanup(&dev->ent);
484 			goto err_kfree;
485 		}
486 	}
487 #endif
488 
489 	dev_info(&client->dev, "Silicon Labs %s successfully attached\n",
490 			dev->chiptype == SI2157_CHIPTYPE_SI2141 ?  "Si2141" :
491 			dev->chiptype == SI2157_CHIPTYPE_SI2146 ?
492 			"Si2146" : "Si2147/2148/2157/2158");
493 
494 	return 0;
495 
496 err_kfree:
497 	kfree(dev);
498 err:
499 	dev_dbg(&client->dev, "failed=%d\n", ret);
500 	return ret;
501 }
502 
503 static int si2157_remove(struct i2c_client *client)
504 {
505 	struct si2157_dev *dev = i2c_get_clientdata(client);
506 	struct dvb_frontend *fe = dev->fe;
507 
508 	dev_dbg(&client->dev, "\n");
509 
510 	/* stop statistics polling */
511 	cancel_delayed_work_sync(&dev->stat_work);
512 
513 #ifdef CONFIG_MEDIA_CONTROLLER_DVB
514 	if (dev->mdev)
515 		media_device_unregister_entity(&dev->ent);
516 #endif
517 
518 	memset(&fe->ops.tuner_ops, 0, sizeof(struct dvb_tuner_ops));
519 	fe->tuner_priv = NULL;
520 	kfree(dev);
521 
522 	return 0;
523 }
524 
525 static const struct i2c_device_id si2157_id_table[] = {
526 	{"si2157", SI2157_CHIPTYPE_SI2157},
527 	{"si2146", SI2157_CHIPTYPE_SI2146},
528 	{"si2141", SI2157_CHIPTYPE_SI2141},
529 	{}
530 };
531 MODULE_DEVICE_TABLE(i2c, si2157_id_table);
532 
533 static struct i2c_driver si2157_driver = {
534 	.driver = {
535 		.name		     = "si2157",
536 		.suppress_bind_attrs = true,
537 	},
538 	.probe		= si2157_probe,
539 	.remove		= si2157_remove,
540 	.id_table	= si2157_id_table,
541 };
542 
543 module_i2c_driver(si2157_driver);
544 
545 MODULE_DESCRIPTION("Silicon Labs Si2141/Si2146/2147/2148/2157/2158 silicon tuner driver");
546 MODULE_AUTHOR("Antti Palosaari <crope@iki.fi>");
547 MODULE_LICENSE("GPL");
548 MODULE_FIRMWARE(SI2158_A20_FIRMWARE);
549 MODULE_FIRMWARE(SI2141_A10_FIRMWARE);
550