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 19 static const struct dvb_frontend_ops si2168_ops; 20 21 /* execute firmware command */ 22 static 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 70 err_mutex_unlock: 71 mutex_unlock(&s->i2c_mutex); 72 if (ret) 73 goto err; 74 75 return 0; 76 err: 77 dev_dbg(&s->client->dev, "failed=%d\n", ret); 78 return ret; 79 } 80 81 static 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; 156 err: 157 dev_dbg(&s->client->dev, "failed=%d\n", ret); 158 return ret; 159 } 160 161 static 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, stream_id=%d\n", 171 c->delivery_system, c->modulation, 172 c->frequency, c->bandwidth_hz, c->symbol_rate, 173 c->inversion, c->stream_id); 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 if (c->delivery_system == SYS_DVBT2) { 238 /* select PLP */ 239 cmd.args[0] = 0x52; 240 cmd.args[1] = c->stream_id & 0xff; 241 cmd.args[2] = c->stream_id == NO_STREAM_ID_FILTER ? 0 : 1; 242 cmd.wlen = 3; 243 cmd.rlen = 1; 244 ret = si2168_cmd_execute(s, &cmd); 245 if (ret) 246 goto err; 247 } 248 249 memcpy(cmd.args, "\x51\x03", 2); 250 cmd.wlen = 2; 251 cmd.rlen = 12; 252 ret = si2168_cmd_execute(s, &cmd); 253 if (ret) 254 goto err; 255 256 memcpy(cmd.args, "\x12\x08\x04", 3); 257 cmd.wlen = 3; 258 cmd.rlen = 3; 259 ret = si2168_cmd_execute(s, &cmd); 260 if (ret) 261 goto err; 262 263 memcpy(cmd.args, "\x14\x00\x0c\x10\x12\x00", 6); 264 cmd.wlen = 6; 265 cmd.rlen = 4; 266 ret = si2168_cmd_execute(s, &cmd); 267 if (ret) 268 goto err; 269 270 memcpy(cmd.args, "\x14\x00\x06\x10\x24\x00", 6); 271 cmd.wlen = 6; 272 cmd.rlen = 4; 273 ret = si2168_cmd_execute(s, &cmd); 274 if (ret) 275 goto err; 276 277 memcpy(cmd.args, "\x14\x00\x07\x10\x00\x24", 6); 278 cmd.wlen = 6; 279 cmd.rlen = 4; 280 ret = si2168_cmd_execute(s, &cmd); 281 if (ret) 282 goto err; 283 284 memcpy(cmd.args, "\x14\x00\x0a\x10\x00\x00", 6); 285 cmd.args[4] = delivery_system | bandwidth; 286 cmd.wlen = 6; 287 cmd.rlen = 4; 288 ret = si2168_cmd_execute(s, &cmd); 289 if (ret) 290 goto err; 291 292 /* set DVB-C symbol rate */ 293 if (c->delivery_system == SYS_DVBC_ANNEX_A) { 294 memcpy(cmd.args, "\x14\x00\x02\x11", 4); 295 cmd.args[4] = (c->symbol_rate / 1000) & 0xff; 296 cmd.args[5] = ((c->symbol_rate / 1000) >> 8) & 0xff; 297 cmd.wlen = 6; 298 cmd.rlen = 4; 299 ret = si2168_cmd_execute(s, &cmd); 300 if (ret) 301 goto err; 302 } 303 304 memcpy(cmd.args, "\x14\x00\x0f\x10\x10\x00", 6); 305 cmd.wlen = 6; 306 cmd.rlen = 4; 307 ret = si2168_cmd_execute(s, &cmd); 308 if (ret) 309 goto err; 310 311 memcpy(cmd.args, "\x14\x00\x09\x10\xe3\x18", 6); 312 cmd.wlen = 6; 313 cmd.rlen = 4; 314 ret = si2168_cmd_execute(s, &cmd); 315 if (ret) 316 goto err; 317 318 memcpy(cmd.args, "\x14\x00\x08\x10\xd7\x15", 6); 319 cmd.wlen = 6; 320 cmd.rlen = 4; 321 ret = si2168_cmd_execute(s, &cmd); 322 if (ret) 323 goto err; 324 325 memcpy(cmd.args, "\x14\x00\x01\x12\x00\x00", 6); 326 cmd.wlen = 6; 327 cmd.rlen = 4; 328 ret = si2168_cmd_execute(s, &cmd); 329 if (ret) 330 goto err; 331 332 memcpy(cmd.args, "\x14\x00\x01\x03\x0c\x00", 6); 333 cmd.wlen = 6; 334 cmd.rlen = 4; 335 ret = si2168_cmd_execute(s, &cmd); 336 if (ret) 337 goto err; 338 339 memcpy(cmd.args, "\x85", 1); 340 cmd.wlen = 1; 341 cmd.rlen = 1; 342 ret = si2168_cmd_execute(s, &cmd); 343 if (ret) 344 goto err; 345 346 s->delivery_system = c->delivery_system; 347 348 return 0; 349 err: 350 dev_dbg(&s->client->dev, "failed=%d\n", ret); 351 return ret; 352 } 353 354 static int si2168_init(struct dvb_frontend *fe) 355 { 356 struct si2168 *s = fe->demodulator_priv; 357 int ret, len, remaining; 358 const struct firmware *fw = NULL; 359 u8 *fw_file; 360 const unsigned int i2c_wr_max = 8; 361 struct si2168_cmd cmd; 362 unsigned int chip_id; 363 364 dev_dbg(&s->client->dev, "\n"); 365 366 /* initialize */ 367 memcpy(cmd.args, "\xc0\x12\x00\x0c\x00\x0d\x16\x00\x00\x00\x00\x00\x00", 13); 368 cmd.wlen = 13; 369 cmd.rlen = 0; 370 ret = si2168_cmd_execute(s, &cmd); 371 if (ret) 372 goto err; 373 374 if (s->fw_loaded) { 375 /* resume */ 376 memcpy(cmd.args, "\xc0\x06\x08\x0f\x00\x20\x21\x01", 8); 377 cmd.wlen = 8; 378 cmd.rlen = 1; 379 ret = si2168_cmd_execute(s, &cmd); 380 if (ret) 381 goto err; 382 383 memcpy(cmd.args, "\x85", 1); 384 cmd.wlen = 1; 385 cmd.rlen = 1; 386 ret = si2168_cmd_execute(s, &cmd); 387 if (ret) 388 goto err; 389 390 goto warm; 391 } 392 393 /* power up */ 394 memcpy(cmd.args, "\xc0\x06\x01\x0f\x00\x20\x20\x01", 8); 395 cmd.wlen = 8; 396 cmd.rlen = 1; 397 ret = si2168_cmd_execute(s, &cmd); 398 if (ret) 399 goto err; 400 401 /* query chip revision */ 402 memcpy(cmd.args, "\x02", 1); 403 cmd.wlen = 1; 404 cmd.rlen = 13; 405 ret = si2168_cmd_execute(s, &cmd); 406 if (ret) 407 goto err; 408 409 chip_id = cmd.args[1] << 24 | cmd.args[2] << 16 | cmd.args[3] << 8 | 410 cmd.args[4] << 0; 411 412 #define SI2168_A20 ('A' << 24 | 68 << 16 | '2' << 8 | '0' << 0) 413 #define SI2168_A30 ('A' << 24 | 68 << 16 | '3' << 8 | '0' << 0) 414 #define SI2168_B40 ('B' << 24 | 68 << 16 | '4' << 8 | '0' << 0) 415 416 switch (chip_id) { 417 case SI2168_A20: 418 fw_file = SI2168_A20_FIRMWARE; 419 break; 420 case SI2168_A30: 421 fw_file = SI2168_A30_FIRMWARE; 422 break; 423 case SI2168_B40: 424 fw_file = SI2168_B40_FIRMWARE; 425 break; 426 default: 427 dev_err(&s->client->dev, 428 "unknown chip version Si21%d-%c%c%c\n", 429 cmd.args[2], cmd.args[1], 430 cmd.args[3], cmd.args[4]); 431 ret = -EINVAL; 432 goto err; 433 } 434 435 /* cold state - try to download firmware */ 436 dev_info(&s->client->dev, "found a '%s' in cold state\n", 437 si2168_ops.info.name); 438 439 /* request the firmware, this will block and timeout */ 440 ret = request_firmware(&fw, fw_file, &s->client->dev); 441 if (ret) { 442 /* fallback mechanism to handle old name for Si2168 B40 fw */ 443 if (chip_id == SI2168_B40) { 444 fw_file = SI2168_B40_FIRMWARE_FALLBACK; 445 ret = request_firmware(&fw, fw_file, &s->client->dev); 446 } 447 448 if (ret == 0) { 449 dev_notice(&s->client->dev, 450 "please install firmware file '%s'\n", 451 SI2168_B40_FIRMWARE); 452 } else { 453 dev_err(&s->client->dev, 454 "firmware file '%s' not found\n", 455 fw_file); 456 goto err; 457 } 458 } 459 460 dev_info(&s->client->dev, "downloading firmware from file '%s'\n", 461 fw_file); 462 463 for (remaining = fw->size; remaining > 0; remaining -= i2c_wr_max) { 464 len = remaining; 465 if (len > i2c_wr_max) 466 len = i2c_wr_max; 467 468 memcpy(cmd.args, &fw->data[fw->size - remaining], len); 469 cmd.wlen = len; 470 cmd.rlen = 1; 471 ret = si2168_cmd_execute(s, &cmd); 472 if (ret) { 473 dev_err(&s->client->dev, 474 "firmware download failed=%d\n", 475 ret); 476 goto err; 477 } 478 } 479 480 release_firmware(fw); 481 fw = NULL; 482 483 memcpy(cmd.args, "\x01\x01", 2); 484 cmd.wlen = 2; 485 cmd.rlen = 1; 486 ret = si2168_cmd_execute(s, &cmd); 487 if (ret) 488 goto err; 489 490 /* set ts mode */ 491 memcpy(cmd.args, "\x14\x00\x01\x10\x10\x00", 6); 492 cmd.args[4] |= s->ts_mode; 493 cmd.wlen = 6; 494 cmd.rlen = 4; 495 ret = si2168_cmd_execute(s, &cmd); 496 if (ret) 497 goto err; 498 499 s->fw_loaded = true; 500 501 warm: 502 dev_info(&s->client->dev, "found a '%s' in warm state\n", 503 si2168_ops.info.name); 504 505 s->active = true; 506 507 return 0; 508 err: 509 if (fw) 510 release_firmware(fw); 511 512 dev_dbg(&s->client->dev, "failed=%d\n", ret); 513 return ret; 514 } 515 516 static int si2168_sleep(struct dvb_frontend *fe) 517 { 518 struct si2168 *s = fe->demodulator_priv; 519 int ret; 520 struct si2168_cmd cmd; 521 522 dev_dbg(&s->client->dev, "\n"); 523 524 s->active = false; 525 526 memcpy(cmd.args, "\x13", 1); 527 cmd.wlen = 1; 528 cmd.rlen = 0; 529 ret = si2168_cmd_execute(s, &cmd); 530 if (ret) 531 goto err; 532 533 return 0; 534 err: 535 dev_dbg(&s->client->dev, "failed=%d\n", ret); 536 return ret; 537 } 538 539 static int si2168_get_tune_settings(struct dvb_frontend *fe, 540 struct dvb_frontend_tune_settings *s) 541 { 542 s->min_delay_ms = 900; 543 544 return 0; 545 } 546 547 /* 548 * I2C gate logic 549 * We must use unlocked i2c_transfer() here because I2C lock is already taken 550 * by tuner driver. 551 */ 552 static int si2168_select(struct i2c_adapter *adap, void *mux_priv, u32 chan) 553 { 554 struct si2168 *s = mux_priv; 555 int ret; 556 struct i2c_msg gate_open_msg = { 557 .addr = s->client->addr, 558 .flags = 0, 559 .len = 3, 560 .buf = "\xc0\x0d\x01", 561 }; 562 563 mutex_lock(&s->i2c_mutex); 564 565 /* open tuner I2C gate */ 566 ret = __i2c_transfer(s->client->adapter, &gate_open_msg, 1); 567 if (ret != 1) { 568 dev_warn(&s->client->dev, "i2c write failed=%d\n", ret); 569 if (ret >= 0) 570 ret = -EREMOTEIO; 571 } else { 572 ret = 0; 573 } 574 575 return ret; 576 } 577 578 static int si2168_deselect(struct i2c_adapter *adap, void *mux_priv, u32 chan) 579 { 580 struct si2168 *s = mux_priv; 581 int ret; 582 struct i2c_msg gate_close_msg = { 583 .addr = s->client->addr, 584 .flags = 0, 585 .len = 3, 586 .buf = "\xc0\x0d\x00", 587 }; 588 589 /* close tuner I2C gate */ 590 ret = __i2c_transfer(s->client->adapter, &gate_close_msg, 1); 591 if (ret != 1) { 592 dev_warn(&s->client->dev, "i2c write failed=%d\n", ret); 593 if (ret >= 0) 594 ret = -EREMOTEIO; 595 } else { 596 ret = 0; 597 } 598 599 mutex_unlock(&s->i2c_mutex); 600 601 return ret; 602 } 603 604 static const struct dvb_frontend_ops si2168_ops = { 605 .delsys = {SYS_DVBT, SYS_DVBT2, SYS_DVBC_ANNEX_A}, 606 .info = { 607 .name = "Silicon Labs Si2168", 608 .caps = FE_CAN_FEC_1_2 | 609 FE_CAN_FEC_2_3 | 610 FE_CAN_FEC_3_4 | 611 FE_CAN_FEC_5_6 | 612 FE_CAN_FEC_7_8 | 613 FE_CAN_FEC_AUTO | 614 FE_CAN_QPSK | 615 FE_CAN_QAM_16 | 616 FE_CAN_QAM_32 | 617 FE_CAN_QAM_64 | 618 FE_CAN_QAM_128 | 619 FE_CAN_QAM_256 | 620 FE_CAN_QAM_AUTO | 621 FE_CAN_TRANSMISSION_MODE_AUTO | 622 FE_CAN_GUARD_INTERVAL_AUTO | 623 FE_CAN_HIERARCHY_AUTO | 624 FE_CAN_MUTE_TS | 625 FE_CAN_2G_MODULATION | 626 FE_CAN_MULTISTREAM 627 }, 628 629 .get_tune_settings = si2168_get_tune_settings, 630 631 .init = si2168_init, 632 .sleep = si2168_sleep, 633 634 .set_frontend = si2168_set_frontend, 635 636 .read_status = si2168_read_status, 637 }; 638 639 static int si2168_probe(struct i2c_client *client, 640 const struct i2c_device_id *id) 641 { 642 struct si2168_config *config = client->dev.platform_data; 643 struct si2168 *s; 644 int ret; 645 646 dev_dbg(&client->dev, "\n"); 647 648 s = kzalloc(sizeof(struct si2168), GFP_KERNEL); 649 if (!s) { 650 ret = -ENOMEM; 651 dev_err(&client->dev, "kzalloc() failed\n"); 652 goto err; 653 } 654 655 s->client = client; 656 mutex_init(&s->i2c_mutex); 657 658 /* create mux i2c adapter for tuner */ 659 s->adapter = i2c_add_mux_adapter(client->adapter, &client->dev, s, 660 0, 0, 0, si2168_select, si2168_deselect); 661 if (s->adapter == NULL) { 662 ret = -ENODEV; 663 goto err; 664 } 665 666 /* create dvb_frontend */ 667 memcpy(&s->fe.ops, &si2168_ops, sizeof(struct dvb_frontend_ops)); 668 s->fe.demodulator_priv = s; 669 670 *config->i2c_adapter = s->adapter; 671 *config->fe = &s->fe; 672 s->ts_mode = config->ts_mode; 673 s->fw_loaded = false; 674 675 i2c_set_clientdata(client, s); 676 677 dev_info(&s->client->dev, 678 "Silicon Labs Si2168 successfully attached\n"); 679 return 0; 680 err: 681 kfree(s); 682 dev_dbg(&client->dev, "failed=%d\n", ret); 683 return ret; 684 } 685 686 static int si2168_remove(struct i2c_client *client) 687 { 688 struct si2168 *s = i2c_get_clientdata(client); 689 690 dev_dbg(&client->dev, "\n"); 691 692 i2c_del_mux_adapter(s->adapter); 693 694 s->fe.ops.release = NULL; 695 s->fe.demodulator_priv = NULL; 696 697 kfree(s); 698 699 return 0; 700 } 701 702 static const struct i2c_device_id si2168_id[] = { 703 {"si2168", 0}, 704 {} 705 }; 706 MODULE_DEVICE_TABLE(i2c, si2168_id); 707 708 static struct i2c_driver si2168_driver = { 709 .driver = { 710 .owner = THIS_MODULE, 711 .name = "si2168", 712 }, 713 .probe = si2168_probe, 714 .remove = si2168_remove, 715 .id_table = si2168_id, 716 }; 717 718 module_i2c_driver(si2168_driver); 719 720 MODULE_AUTHOR("Antti Palosaari <crope@iki.fi>"); 721 MODULE_DESCRIPTION("Silicon Labs Si2168 DVB-T/T2/C demodulator driver"); 722 MODULE_LICENSE("GPL"); 723 MODULE_FIRMWARE(SI2168_A20_FIRMWARE); 724 MODULE_FIRMWARE(SI2168_A30_FIRMWARE); 725 MODULE_FIRMWARE(SI2168_B40_FIRMWARE); 726