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_hz = 42 * MHz, 392 .frequency_max_hz = 870 * MHz, 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