si2168.c revision 389ce3984b337690ed5124f2379fc8c3f3975c53
1/* 2 * Silicon Labs Si2168 DVB-T/T2/C demodulator 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 "si2168_priv.h" 18 19static const struct dvb_frontend_ops si2168_ops; 20 21/* execute firmware command */ 22static int si2168_cmd_execute(struct si2168 *s, struct si2168_cmd *cmd) 23{ 24 int ret; 25 unsigned long timeout; 26 27 mutex_lock(&s->i2c_mutex); 28 29 if (cmd->wlen) { 30 /* write cmd and args for firmware */ 31 ret = i2c_master_send(s->client, cmd->args, cmd->wlen); 32 if (ret < 0) { 33 goto err_mutex_unlock; 34 } else if (ret != cmd->wlen) { 35 ret = -EREMOTEIO; 36 goto err_mutex_unlock; 37 } 38 } 39 40 if (cmd->rlen) { 41 /* wait cmd execution terminate */ 42 #define TIMEOUT 50 43 timeout = jiffies + msecs_to_jiffies(TIMEOUT); 44 while (!time_after(jiffies, timeout)) { 45 ret = i2c_master_recv(s->client, cmd->args, cmd->rlen); 46 if (ret < 0) { 47 goto err_mutex_unlock; 48 } else if (ret != cmd->rlen) { 49 ret = -EREMOTEIO; 50 goto err_mutex_unlock; 51 } 52 53 /* firmware ready? */ 54 if ((cmd->args[0] >> 7) & 0x01) 55 break; 56 } 57 58 dev_dbg(&s->client->dev, "cmd execution took %d ms\n", 59 jiffies_to_msecs(jiffies) - 60 (jiffies_to_msecs(timeout) - TIMEOUT)); 61 62 if (!((cmd->args[0] >> 7) & 0x01)) { 63 ret = -ETIMEDOUT; 64 goto err_mutex_unlock; 65 } 66 } 67 68 ret = 0; 69 70err_mutex_unlock: 71 mutex_unlock(&s->i2c_mutex); 72 if (ret) 73 goto err; 74 75 return 0; 76err: 77 dev_dbg(&s->client->dev, "failed=%d\n", ret); 78 return ret; 79} 80 81static int si2168_read_status(struct dvb_frontend *fe, fe_status_t *status) 82{ 83 struct si2168 *s = fe->demodulator_priv; 84 struct dtv_frontend_properties *c = &fe->dtv_property_cache; 85 int ret; 86 struct si2168_cmd cmd; 87 88 *status = 0; 89 90 if (!s->active) { 91 ret = -EAGAIN; 92 goto err; 93 } 94 95 switch (c->delivery_system) { 96 case SYS_DVBT: 97 memcpy(cmd.args, "\xa0\x01", 2); 98 cmd.wlen = 2; 99 cmd.rlen = 13; 100 break; 101 case SYS_DVBC_ANNEX_A: 102 memcpy(cmd.args, "\x90\x01", 2); 103 cmd.wlen = 2; 104 cmd.rlen = 9; 105 break; 106 case SYS_DVBT2: 107 memcpy(cmd.args, "\x50\x01", 2); 108 cmd.wlen = 2; 109 cmd.rlen = 14; 110 break; 111 default: 112 ret = -EINVAL; 113 goto err; 114 } 115 116 ret = si2168_cmd_execute(s, &cmd); 117 if (ret) 118 goto err; 119 120 /* 121 * Possible values seen, in order from strong signal to weak: 122 * 16 0001 0110 full lock 123 * 1e 0001 1110 partial lock 124 * 1a 0001 1010 partial lock 125 * 18 0001 1000 no lock 126 * 127 * [b3:b1] lock bits 128 * [b4] statistics ready? Set in a few secs after lock is gained. 129 */ 130 131 switch ((cmd.args[2] >> 1) & 0x03) { 132 case 0x01: 133 *status = FE_HAS_SIGNAL | FE_HAS_CARRIER; 134 break; 135 case 0x03: 136 *status = FE_HAS_SIGNAL | FE_HAS_CARRIER | FE_HAS_VITERBI | 137 FE_HAS_SYNC | FE_HAS_LOCK; 138 break; 139 } 140 141 s->fe_status = *status; 142 143 if (*status & FE_HAS_LOCK) { 144 c->cnr.len = 1; 145 c->cnr.stat[0].scale = FE_SCALE_DECIBEL; 146 c->cnr.stat[0].svalue = cmd.args[3] * 1000 / 4; 147 } else { 148 c->cnr.len = 1; 149 c->cnr.stat[0].scale = FE_SCALE_NOT_AVAILABLE; 150 } 151 152 dev_dbg(&s->client->dev, "status=%02x args=%*ph\n", 153 *status, cmd.rlen, cmd.args); 154 155 return 0; 156err: 157 dev_dbg(&s->client->dev, "failed=%d\n", ret); 158 return ret; 159} 160 161static int si2168_set_frontend(struct dvb_frontend *fe) 162{ 163 struct si2168 *s = fe->demodulator_priv; 164 struct dtv_frontend_properties *c = &fe->dtv_property_cache; 165 int ret; 166 struct si2168_cmd cmd; 167 u8 bandwidth, delivery_system; 168 169 dev_dbg(&s->client->dev, 170 "delivery_system=%u modulation=%u frequency=%u bandwidth_hz=%u symbol_rate=%u inversion=%u\n", 171 c->delivery_system, c->modulation, 172 c->frequency, c->bandwidth_hz, c->symbol_rate, 173 c->inversion); 174 175 if (!s->active) { 176 ret = -EAGAIN; 177 goto err; 178 } 179 180 switch (c->delivery_system) { 181 case SYS_DVBT: 182 delivery_system = 0x20; 183 break; 184 case SYS_DVBC_ANNEX_A: 185 delivery_system = 0x30; 186 break; 187 case SYS_DVBT2: 188 delivery_system = 0x70; 189 break; 190 default: 191 ret = -EINVAL; 192 goto err; 193 } 194 195 if (c->bandwidth_hz <= 5000000) 196 bandwidth = 0x05; 197 else if (c->bandwidth_hz <= 6000000) 198 bandwidth = 0x06; 199 else if (c->bandwidth_hz <= 7000000) 200 bandwidth = 0x07; 201 else if (c->bandwidth_hz <= 8000000) 202 bandwidth = 0x08; 203 else if (c->bandwidth_hz <= 9000000) 204 bandwidth = 0x09; 205 else if (c->bandwidth_hz <= 10000000) 206 bandwidth = 0x0a; 207 else 208 bandwidth = 0x0f; 209 210 /* program tuner */ 211 if (fe->ops.tuner_ops.set_params) { 212 ret = fe->ops.tuner_ops.set_params(fe); 213 if (ret) 214 goto err; 215 } 216 217 memcpy(cmd.args, "\x88\x02\x02\x02\x02", 5); 218 cmd.wlen = 5; 219 cmd.rlen = 5; 220 ret = si2168_cmd_execute(s, &cmd); 221 if (ret) 222 goto err; 223 224 /* that has no big effect */ 225 if (c->delivery_system == SYS_DVBT) 226 memcpy(cmd.args, "\x89\x21\x06\x11\xff\x98", 6); 227 else if (c->delivery_system == SYS_DVBC_ANNEX_A) 228 memcpy(cmd.args, "\x89\x21\x06\x11\x89\xf0", 6); 229 else if (c->delivery_system == SYS_DVBT2) 230 memcpy(cmd.args, "\x89\x21\x06\x11\x89\x20", 6); 231 cmd.wlen = 6; 232 cmd.rlen = 3; 233 ret = si2168_cmd_execute(s, &cmd); 234 if (ret) 235 goto err; 236 237 memcpy(cmd.args, "\x51\x03", 2); 238 cmd.wlen = 2; 239 cmd.rlen = 12; 240 ret = si2168_cmd_execute(s, &cmd); 241 if (ret) 242 goto err; 243 244 memcpy(cmd.args, "\x12\x08\x04", 3); 245 cmd.wlen = 3; 246 cmd.rlen = 3; 247 ret = si2168_cmd_execute(s, &cmd); 248 if (ret) 249 goto err; 250 251 memcpy(cmd.args, "\x14\x00\x0c\x10\x12\x00", 6); 252 cmd.wlen = 6; 253 cmd.rlen = 4; 254 ret = si2168_cmd_execute(s, &cmd); 255 if (ret) 256 goto err; 257 258 memcpy(cmd.args, "\x14\x00\x06\x10\x24\x00", 6); 259 cmd.wlen = 6; 260 cmd.rlen = 4; 261 ret = si2168_cmd_execute(s, &cmd); 262 if (ret) 263 goto err; 264 265 memcpy(cmd.args, "\x14\x00\x07\x10\x00\x24", 6); 266 cmd.wlen = 6; 267 cmd.rlen = 4; 268 ret = si2168_cmd_execute(s, &cmd); 269 if (ret) 270 goto err; 271 272 memcpy(cmd.args, "\x14\x00\x0a\x10\x00\x00", 6); 273 cmd.args[4] = delivery_system | bandwidth; 274 cmd.wlen = 6; 275 cmd.rlen = 4; 276 ret = si2168_cmd_execute(s, &cmd); 277 if (ret) 278 goto err; 279 280 /* set DVB-C symbol rate */ 281 if (c->delivery_system == SYS_DVBC_ANNEX_A) { 282 memcpy(cmd.args, "\x14\x00\x02\x11", 4); 283 cmd.args[4] = (c->symbol_rate / 1000) & 0xff; 284 cmd.args[5] = ((c->symbol_rate / 1000) >> 8) & 0xff; 285 cmd.wlen = 6; 286 cmd.rlen = 4; 287 ret = si2168_cmd_execute(s, &cmd); 288 if (ret) 289 goto err; 290 } 291 292 memcpy(cmd.args, "\x14\x00\x0f\x10\x10\x00", 6); 293 cmd.wlen = 6; 294 cmd.rlen = 4; 295 ret = si2168_cmd_execute(s, &cmd); 296 if (ret) 297 goto err; 298 299 memcpy(cmd.args, "\x14\x00\x09\x10\xe3\x18", 6); 300 cmd.wlen = 6; 301 cmd.rlen = 4; 302 ret = si2168_cmd_execute(s, &cmd); 303 if (ret) 304 goto err; 305 306 memcpy(cmd.args, "\x14\x00\x08\x10\xd7\x15", 6); 307 cmd.wlen = 6; 308 cmd.rlen = 4; 309 ret = si2168_cmd_execute(s, &cmd); 310 if (ret) 311 goto err; 312 313 memcpy(cmd.args, "\x14\x00\x01\x12\x00\x00", 6); 314 cmd.wlen = 6; 315 cmd.rlen = 4; 316 ret = si2168_cmd_execute(s, &cmd); 317 if (ret) 318 goto err; 319 320 memcpy(cmd.args, "\x14\x00\x01\x03\x0c\x00", 6); 321 cmd.wlen = 6; 322 cmd.rlen = 4; 323 ret = si2168_cmd_execute(s, &cmd); 324 if (ret) 325 goto err; 326 327 memcpy(cmd.args, "\x85", 1); 328 cmd.wlen = 1; 329 cmd.rlen = 1; 330 ret = si2168_cmd_execute(s, &cmd); 331 if (ret) 332 goto err; 333 334 s->delivery_system = c->delivery_system; 335 336 return 0; 337err: 338 dev_dbg(&s->client->dev, "failed=%d\n", ret); 339 return ret; 340} 341 342static int si2168_init(struct dvb_frontend *fe) 343{ 344 struct si2168 *s = fe->demodulator_priv; 345 int ret, len, remaining; 346 const struct firmware *fw = NULL; 347 u8 *fw_file; 348 const unsigned int i2c_wr_max = 8; 349 struct si2168_cmd cmd; 350 unsigned int chip_id; 351 352 dev_dbg(&s->client->dev, "\n"); 353 354 memcpy(cmd.args, "\xc0\x12\x00\x0c\x00\x0d\x16\x00\x00\x00\x00\x00\x00", 13); 355 cmd.wlen = 13; 356 cmd.rlen = 0; 357 ret = si2168_cmd_execute(s, &cmd); 358 if (ret) 359 goto err; 360 361 memcpy(cmd.args, "\xc0\x06\x01\x0f\x00\x20\x20\x01", 8); 362 cmd.wlen = 8; 363 cmd.rlen = 1; 364 ret = si2168_cmd_execute(s, &cmd); 365 if (ret) 366 goto err; 367 368 /* query chip revision */ 369 memcpy(cmd.args, "\x02", 1); 370 cmd.wlen = 1; 371 cmd.rlen = 13; 372 ret = si2168_cmd_execute(s, &cmd); 373 if (ret) 374 goto err; 375 376 chip_id = cmd.args[1] << 24 | cmd.args[2] << 16 | cmd.args[3] << 8 | 377 cmd.args[4] << 0; 378 379 #define SI2168_A20 ('A' << 24 | 68 << 16 | '2' << 8 | '0' << 0) 380 #define SI2168_A30 ('A' << 24 | 68 << 16 | '3' << 8 | '0' << 0) 381 #define SI2168_B40 ('B' << 24 | 68 << 16 | '4' << 8 | '0' << 0) 382 383 switch (chip_id) { 384 case SI2168_A20: 385 fw_file = SI2168_A20_FIRMWARE; 386 break; 387 case SI2168_A30: 388 fw_file = SI2168_A30_FIRMWARE; 389 break; 390 case SI2168_B40: 391 fw_file = SI2168_B40_FIRMWARE; 392 break; 393 default: 394 dev_err(&s->client->dev, 395 "unknown chip version Si21%d-%c%c%c\n", 396 cmd.args[2], cmd.args[1], 397 cmd.args[3], cmd.args[4]); 398 ret = -EINVAL; 399 goto err; 400 } 401 402 /* cold state - try to download firmware */ 403 dev_info(&s->client->dev, "found a '%s' in cold state\n", 404 si2168_ops.info.name); 405 406 /* request the firmware, this will block and timeout */ 407 ret = request_firmware(&fw, fw_file, &s->client->dev); 408 if (ret) { 409 /* fallback mechanism to handle old name for Si2168 B40 fw */ 410 if (chip_id == SI2168_B40) { 411 fw_file = SI2168_B40_FIRMWARE_FALLBACK; 412 ret = request_firmware(&fw, fw_file, &s->client->dev); 413 } 414 415 if (ret == 0) { 416 dev_notice(&s->client->dev, 417 "please install firmware file '%s'\n", 418 SI2168_B40_FIRMWARE); 419 } else { 420 dev_err(&s->client->dev, 421 "firmware file '%s' not found\n", 422 fw_file); 423 goto err; 424 } 425 } 426 427 dev_info(&s->client->dev, "downloading firmware from file '%s'\n", 428 fw_file); 429 430 for (remaining = fw->size; remaining > 0; remaining -= i2c_wr_max) { 431 len = remaining; 432 if (len > i2c_wr_max) 433 len = i2c_wr_max; 434 435 memcpy(cmd.args, &fw->data[fw->size - remaining], len); 436 cmd.wlen = len; 437 cmd.rlen = 1; 438 ret = si2168_cmd_execute(s, &cmd); 439 if (ret) { 440 dev_err(&s->client->dev, 441 "firmware download failed=%d\n", 442 ret); 443 goto err; 444 } 445 } 446 447 release_firmware(fw); 448 fw = NULL; 449 450 memcpy(cmd.args, "\x01\x01", 2); 451 cmd.wlen = 2; 452 cmd.rlen = 1; 453 ret = si2168_cmd_execute(s, &cmd); 454 if (ret) 455 goto err; 456 457 dev_info(&s->client->dev, "found a '%s' in warm state\n", 458 si2168_ops.info.name); 459 460 /* set ts mode */ 461 memcpy(cmd.args, "\x14\x00\x01\x10\x10\x00", 6); 462 cmd.args[4] |= s->ts_mode; 463 cmd.wlen = 6; 464 cmd.rlen = 4; 465 ret = si2168_cmd_execute(s, &cmd); 466 if (ret) 467 goto err; 468 469 s->active = true; 470 471 return 0; 472err: 473 if (fw) 474 release_firmware(fw); 475 476 dev_dbg(&s->client->dev, "failed=%d\n", ret); 477 return ret; 478} 479 480static int si2168_sleep(struct dvb_frontend *fe) 481{ 482 struct si2168 *s = fe->demodulator_priv; 483 int ret; 484 struct si2168_cmd cmd; 485 486 dev_dbg(&s->client->dev, "\n"); 487 488 s->active = false; 489 490 memcpy(cmd.args, "\x13", 1); 491 cmd.wlen = 1; 492 cmd.rlen = 0; 493 ret = si2168_cmd_execute(s, &cmd); 494 if (ret) 495 goto err; 496 497 return 0; 498err: 499 dev_dbg(&s->client->dev, "failed=%d\n", ret); 500 return ret; 501} 502 503static int si2168_get_tune_settings(struct dvb_frontend *fe, 504 struct dvb_frontend_tune_settings *s) 505{ 506 s->min_delay_ms = 900; 507 508 return 0; 509} 510 511/* 512 * I2C gate logic 513 * We must use unlocked i2c_transfer() here because I2C lock is already taken 514 * by tuner driver. 515 */ 516static int si2168_select(struct i2c_adapter *adap, void *mux_priv, u32 chan) 517{ 518 struct si2168 *s = mux_priv; 519 int ret; 520 struct i2c_msg gate_open_msg = { 521 .addr = s->client->addr, 522 .flags = 0, 523 .len = 3, 524 .buf = "\xc0\x0d\x01", 525 }; 526 527 mutex_lock(&s->i2c_mutex); 528 529 /* open tuner I2C gate */ 530 ret = __i2c_transfer(s->client->adapter, &gate_open_msg, 1); 531 if (ret != 1) { 532 dev_warn(&s->client->dev, "i2c write failed=%d\n", ret); 533 if (ret >= 0) 534 ret = -EREMOTEIO; 535 } else { 536 ret = 0; 537 } 538 539 return ret; 540} 541 542static int si2168_deselect(struct i2c_adapter *adap, void *mux_priv, u32 chan) 543{ 544 struct si2168 *s = mux_priv; 545 int ret; 546 struct i2c_msg gate_close_msg = { 547 .addr = s->client->addr, 548 .flags = 0, 549 .len = 3, 550 .buf = "\xc0\x0d\x00", 551 }; 552 553 /* close tuner I2C gate */ 554 ret = __i2c_transfer(s->client->adapter, &gate_close_msg, 1); 555 if (ret != 1) { 556 dev_warn(&s->client->dev, "i2c write failed=%d\n", ret); 557 if (ret >= 0) 558 ret = -EREMOTEIO; 559 } else { 560 ret = 0; 561 } 562 563 mutex_unlock(&s->i2c_mutex); 564 565 return ret; 566} 567 568static const struct dvb_frontend_ops si2168_ops = { 569 .delsys = {SYS_DVBT, SYS_DVBT2, SYS_DVBC_ANNEX_A}, 570 .info = { 571 .name = "Silicon Labs Si2168", 572 .caps = FE_CAN_FEC_1_2 | 573 FE_CAN_FEC_2_3 | 574 FE_CAN_FEC_3_4 | 575 FE_CAN_FEC_5_6 | 576 FE_CAN_FEC_7_8 | 577 FE_CAN_FEC_AUTO | 578 FE_CAN_QPSK | 579 FE_CAN_QAM_16 | 580 FE_CAN_QAM_32 | 581 FE_CAN_QAM_64 | 582 FE_CAN_QAM_128 | 583 FE_CAN_QAM_256 | 584 FE_CAN_QAM_AUTO | 585 FE_CAN_TRANSMISSION_MODE_AUTO | 586 FE_CAN_GUARD_INTERVAL_AUTO | 587 FE_CAN_HIERARCHY_AUTO | 588 FE_CAN_MUTE_TS | 589 FE_CAN_2G_MODULATION 590 }, 591 592 .get_tune_settings = si2168_get_tune_settings, 593 594 .init = si2168_init, 595 .sleep = si2168_sleep, 596 597 .set_frontend = si2168_set_frontend, 598 599 .read_status = si2168_read_status, 600}; 601 602static int si2168_probe(struct i2c_client *client, 603 const struct i2c_device_id *id) 604{ 605 struct si2168_config *config = client->dev.platform_data; 606 struct si2168 *s; 607 int ret; 608 609 dev_dbg(&client->dev, "\n"); 610 611 s = kzalloc(sizeof(struct si2168), GFP_KERNEL); 612 if (!s) { 613 ret = -ENOMEM; 614 dev_err(&client->dev, "kzalloc() failed\n"); 615 goto err; 616 } 617 618 s->client = client; 619 mutex_init(&s->i2c_mutex); 620 621 /* create mux i2c adapter for tuner */ 622 s->adapter = i2c_add_mux_adapter(client->adapter, &client->dev, s, 623 0, 0, 0, si2168_select, si2168_deselect); 624 if (s->adapter == NULL) { 625 ret = -ENODEV; 626 goto err; 627 } 628 629 /* create dvb_frontend */ 630 memcpy(&s->fe.ops, &si2168_ops, sizeof(struct dvb_frontend_ops)); 631 s->fe.demodulator_priv = s; 632 633 *config->i2c_adapter = s->adapter; 634 *config->fe = &s->fe; 635 s->ts_mode = config->ts_mode; 636 637 i2c_set_clientdata(client, s); 638 639 dev_info(&s->client->dev, 640 "Silicon Labs Si2168 successfully attached\n"); 641 return 0; 642err: 643 kfree(s); 644 dev_dbg(&client->dev, "failed=%d\n", ret); 645 return ret; 646} 647 648static int si2168_remove(struct i2c_client *client) 649{ 650 struct si2168 *s = i2c_get_clientdata(client); 651 652 dev_dbg(&client->dev, "\n"); 653 654 i2c_del_mux_adapter(s->adapter); 655 656 s->fe.ops.release = NULL; 657 s->fe.demodulator_priv = NULL; 658 659 kfree(s); 660 661 return 0; 662} 663 664static const struct i2c_device_id si2168_id[] = { 665 {"si2168", 0}, 666 {} 667}; 668MODULE_DEVICE_TABLE(i2c, si2168_id); 669 670static struct i2c_driver si2168_driver = { 671 .driver = { 672 .owner = THIS_MODULE, 673 .name = "si2168", 674 }, 675 .probe = si2168_probe, 676 .remove = si2168_remove, 677 .id_table = si2168_id, 678}; 679 680module_i2c_driver(si2168_driver); 681 682MODULE_AUTHOR("Antti Palosaari <crope@iki.fi>"); 683MODULE_DESCRIPTION("Silicon Labs Si2168 DVB-T/T2/C demodulator driver"); 684MODULE_LICENSE("GPL"); 685MODULE_FIRMWARE(SI2168_A20_FIRMWARE); 686MODULE_FIRMWARE(SI2168_A30_FIRMWARE); 687MODULE_FIRMWARE(SI2168_B40_FIRMWARE); 688