si2168.c revision e395e573b3ca028271fb2ee7edf614d45913d948
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, 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; 349err: 350 dev_dbg(&s->client->dev, "failed=%d\n", ret); 351 return ret; 352} 353 354static 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 memcpy(cmd.args, "\xc0\x12\x00\x0c\x00\x0d\x16\x00\x00\x00\x00\x00\x00", 13); 367 cmd.wlen = 13; 368 cmd.rlen = 0; 369 ret = si2168_cmd_execute(s, &cmd); 370 if (ret) 371 goto err; 372 373 memcpy(cmd.args, "\xc0\x06\x01\x0f\x00\x20\x20\x01", 8); 374 cmd.wlen = 8; 375 cmd.rlen = 1; 376 ret = si2168_cmd_execute(s, &cmd); 377 if (ret) 378 goto err; 379 380 /* query chip revision */ 381 memcpy(cmd.args, "\x02", 1); 382 cmd.wlen = 1; 383 cmd.rlen = 13; 384 ret = si2168_cmd_execute(s, &cmd); 385 if (ret) 386 goto err; 387 388 chip_id = cmd.args[1] << 24 | cmd.args[2] << 16 | cmd.args[3] << 8 | 389 cmd.args[4] << 0; 390 391 #define SI2168_A20 ('A' << 24 | 68 << 16 | '2' << 8 | '0' << 0) 392 #define SI2168_A30 ('A' << 24 | 68 << 16 | '3' << 8 | '0' << 0) 393 #define SI2168_B40 ('B' << 24 | 68 << 16 | '4' << 8 | '0' << 0) 394 395 switch (chip_id) { 396 case SI2168_A20: 397 fw_file = SI2168_A20_FIRMWARE; 398 break; 399 case SI2168_A30: 400 fw_file = SI2168_A30_FIRMWARE; 401 break; 402 case SI2168_B40: 403 fw_file = SI2168_B40_FIRMWARE; 404 break; 405 default: 406 dev_err(&s->client->dev, 407 "unknown chip version Si21%d-%c%c%c\n", 408 cmd.args[2], cmd.args[1], 409 cmd.args[3], cmd.args[4]); 410 ret = -EINVAL; 411 goto err; 412 } 413 414 /* cold state - try to download firmware */ 415 dev_info(&s->client->dev, "found a '%s' in cold state\n", 416 si2168_ops.info.name); 417 418 /* request the firmware, this will block and timeout */ 419 ret = request_firmware(&fw, fw_file, &s->client->dev); 420 if (ret) { 421 /* fallback mechanism to handle old name for Si2168 B40 fw */ 422 if (chip_id == SI2168_B40) { 423 fw_file = SI2168_B40_FIRMWARE_FALLBACK; 424 ret = request_firmware(&fw, fw_file, &s->client->dev); 425 } 426 427 if (ret == 0) { 428 dev_notice(&s->client->dev, 429 "please install firmware file '%s'\n", 430 SI2168_B40_FIRMWARE); 431 } else { 432 dev_err(&s->client->dev, 433 "firmware file '%s' not found\n", 434 fw_file); 435 goto err; 436 } 437 } 438 439 dev_info(&s->client->dev, "downloading firmware from file '%s'\n", 440 fw_file); 441 442 for (remaining = fw->size; remaining > 0; remaining -= i2c_wr_max) { 443 len = remaining; 444 if (len > i2c_wr_max) 445 len = i2c_wr_max; 446 447 memcpy(cmd.args, &fw->data[fw->size - remaining], len); 448 cmd.wlen = len; 449 cmd.rlen = 1; 450 ret = si2168_cmd_execute(s, &cmd); 451 if (ret) { 452 dev_err(&s->client->dev, 453 "firmware download failed=%d\n", 454 ret); 455 goto err; 456 } 457 } 458 459 release_firmware(fw); 460 fw = NULL; 461 462 memcpy(cmd.args, "\x01\x01", 2); 463 cmd.wlen = 2; 464 cmd.rlen = 1; 465 ret = si2168_cmd_execute(s, &cmd); 466 if (ret) 467 goto err; 468 469 dev_info(&s->client->dev, "found a '%s' in warm state\n", 470 si2168_ops.info.name); 471 472 /* set ts mode */ 473 memcpy(cmd.args, "\x14\x00\x01\x10\x10\x00", 6); 474 cmd.args[4] |= s->ts_mode; 475 cmd.wlen = 6; 476 cmd.rlen = 4; 477 ret = si2168_cmd_execute(s, &cmd); 478 if (ret) 479 goto err; 480 481 s->active = true; 482 483 return 0; 484err: 485 if (fw) 486 release_firmware(fw); 487 488 dev_dbg(&s->client->dev, "failed=%d\n", ret); 489 return ret; 490} 491 492static int si2168_sleep(struct dvb_frontend *fe) 493{ 494 struct si2168 *s = fe->demodulator_priv; 495 int ret; 496 struct si2168_cmd cmd; 497 498 dev_dbg(&s->client->dev, "\n"); 499 500 s->active = false; 501 502 memcpy(cmd.args, "\x13", 1); 503 cmd.wlen = 1; 504 cmd.rlen = 0; 505 ret = si2168_cmd_execute(s, &cmd); 506 if (ret) 507 goto err; 508 509 return 0; 510err: 511 dev_dbg(&s->client->dev, "failed=%d\n", ret); 512 return ret; 513} 514 515static int si2168_get_tune_settings(struct dvb_frontend *fe, 516 struct dvb_frontend_tune_settings *s) 517{ 518 s->min_delay_ms = 900; 519 520 return 0; 521} 522 523/* 524 * I2C gate logic 525 * We must use unlocked i2c_transfer() here because I2C lock is already taken 526 * by tuner driver. 527 */ 528static int si2168_select(struct i2c_adapter *adap, void *mux_priv, u32 chan) 529{ 530 struct si2168 *s = mux_priv; 531 int ret; 532 struct i2c_msg gate_open_msg = { 533 .addr = s->client->addr, 534 .flags = 0, 535 .len = 3, 536 .buf = "\xc0\x0d\x01", 537 }; 538 539 mutex_lock(&s->i2c_mutex); 540 541 /* open tuner I2C gate */ 542 ret = __i2c_transfer(s->client->adapter, &gate_open_msg, 1); 543 if (ret != 1) { 544 dev_warn(&s->client->dev, "i2c write failed=%d\n", ret); 545 if (ret >= 0) 546 ret = -EREMOTEIO; 547 } else { 548 ret = 0; 549 } 550 551 return ret; 552} 553 554static int si2168_deselect(struct i2c_adapter *adap, void *mux_priv, u32 chan) 555{ 556 struct si2168 *s = mux_priv; 557 int ret; 558 struct i2c_msg gate_close_msg = { 559 .addr = s->client->addr, 560 .flags = 0, 561 .len = 3, 562 .buf = "\xc0\x0d\x00", 563 }; 564 565 /* close tuner I2C gate */ 566 ret = __i2c_transfer(s->client->adapter, &gate_close_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 mutex_unlock(&s->i2c_mutex); 576 577 return ret; 578} 579 580static const struct dvb_frontend_ops si2168_ops = { 581 .delsys = {SYS_DVBT, SYS_DVBT2, SYS_DVBC_ANNEX_A}, 582 .info = { 583 .name = "Silicon Labs Si2168", 584 .caps = FE_CAN_FEC_1_2 | 585 FE_CAN_FEC_2_3 | 586 FE_CAN_FEC_3_4 | 587 FE_CAN_FEC_5_6 | 588 FE_CAN_FEC_7_8 | 589 FE_CAN_FEC_AUTO | 590 FE_CAN_QPSK | 591 FE_CAN_QAM_16 | 592 FE_CAN_QAM_32 | 593 FE_CAN_QAM_64 | 594 FE_CAN_QAM_128 | 595 FE_CAN_QAM_256 | 596 FE_CAN_QAM_AUTO | 597 FE_CAN_TRANSMISSION_MODE_AUTO | 598 FE_CAN_GUARD_INTERVAL_AUTO | 599 FE_CAN_HIERARCHY_AUTO | 600 FE_CAN_MUTE_TS | 601 FE_CAN_2G_MODULATION 602 }, 603 604 .get_tune_settings = si2168_get_tune_settings, 605 606 .init = si2168_init, 607 .sleep = si2168_sleep, 608 609 .set_frontend = si2168_set_frontend, 610 611 .read_status = si2168_read_status, 612}; 613 614static int si2168_probe(struct i2c_client *client, 615 const struct i2c_device_id *id) 616{ 617 struct si2168_config *config = client->dev.platform_data; 618 struct si2168 *s; 619 int ret; 620 621 dev_dbg(&client->dev, "\n"); 622 623 s = kzalloc(sizeof(struct si2168), GFP_KERNEL); 624 if (!s) { 625 ret = -ENOMEM; 626 dev_err(&client->dev, "kzalloc() failed\n"); 627 goto err; 628 } 629 630 s->client = client; 631 mutex_init(&s->i2c_mutex); 632 633 /* create mux i2c adapter for tuner */ 634 s->adapter = i2c_add_mux_adapter(client->adapter, &client->dev, s, 635 0, 0, 0, si2168_select, si2168_deselect); 636 if (s->adapter == NULL) { 637 ret = -ENODEV; 638 goto err; 639 } 640 641 /* create dvb_frontend */ 642 memcpy(&s->fe.ops, &si2168_ops, sizeof(struct dvb_frontend_ops)); 643 s->fe.demodulator_priv = s; 644 645 *config->i2c_adapter = s->adapter; 646 *config->fe = &s->fe; 647 s->ts_mode = config->ts_mode; 648 649 i2c_set_clientdata(client, s); 650 651 dev_info(&s->client->dev, 652 "Silicon Labs Si2168 successfully attached\n"); 653 return 0; 654err: 655 kfree(s); 656 dev_dbg(&client->dev, "failed=%d\n", ret); 657 return ret; 658} 659 660static int si2168_remove(struct i2c_client *client) 661{ 662 struct si2168 *s = i2c_get_clientdata(client); 663 664 dev_dbg(&client->dev, "\n"); 665 666 i2c_del_mux_adapter(s->adapter); 667 668 s->fe.ops.release = NULL; 669 s->fe.demodulator_priv = NULL; 670 671 kfree(s); 672 673 return 0; 674} 675 676static const struct i2c_device_id si2168_id[] = { 677 {"si2168", 0}, 678 {} 679}; 680MODULE_DEVICE_TABLE(i2c, si2168_id); 681 682static struct i2c_driver si2168_driver = { 683 .driver = { 684 .owner = THIS_MODULE, 685 .name = "si2168", 686 }, 687 .probe = si2168_probe, 688 .remove = si2168_remove, 689 .id_table = si2168_id, 690}; 691 692module_i2c_driver(si2168_driver); 693 694MODULE_AUTHOR("Antti Palosaari <crope@iki.fi>"); 695MODULE_DESCRIPTION("Silicon Labs Si2168 DVB-T/T2/C demodulator driver"); 696MODULE_LICENSE("GPL"); 697MODULE_FIRMWARE(SI2168_A20_FIRMWARE); 698MODULE_FIRMWARE(SI2168_A30_FIRMWARE); 699MODULE_FIRMWARE(SI2168_B40_FIRMWARE); 700