1 /**************************************************************** 2 3 Siano Mobile Silicon, Inc. 4 MDTV receiver kernel modules. 5 Copyright (C) 2006-2008, Uri Shkolnik, Anatoly Greenblat 6 7 This program is free software: you can redistribute it and/or modify 8 it under the terms of the GNU General Public License as published by 9 the Free Software Foundation, either version 2 of the License, or 10 (at your option) any later version. 11 12 This program is distributed in the hope that it will be useful, 13 but WITHOUT ANY WARRANTY; without even the implied warranty of 14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 GNU General Public License for more details. 16 17 You should have received a copy of the GNU General Public License 18 along with this program. If not, see <http://www.gnu.org/licenses/>. 19 20 ****************************************************************/ 21 22 #ifndef __SMS_CORE_API_H__ 23 #define __SMS_CORE_API_H__ 24 25 #include <linux/version.h> 26 #include <linux/device.h> 27 #include <linux/list.h> 28 #include <linux/mm.h> 29 #include <linux/scatterlist.h> 30 #include <linux/types.h> 31 #include <linux/mutex.h> 32 #include <linux/wait.h> 33 #include <linux/timer.h> 34 35 #include <asm/page.h> 36 37 #include "smsir.h" 38 39 #define kmutex_init(_p_) mutex_init(_p_) 40 #define kmutex_lock(_p_) mutex_lock(_p_) 41 #define kmutex_trylock(_p_) mutex_trylock(_p_) 42 #define kmutex_unlock(_p_) mutex_unlock(_p_) 43 44 #ifndef min 45 #define min(a, b) (((a) < (b)) ? (a) : (b)) 46 #endif 47 48 #define SMS_PROTOCOL_MAX_RAOUNDTRIP_MS (10000) 49 #define SMS_ALLOC_ALIGNMENT 128 50 #define SMS_DMA_ALIGNMENT 16 51 #define SMS_ALIGN_ADDRESS(addr) \ 52 ((((uintptr_t)(addr)) + (SMS_DMA_ALIGNMENT-1)) & ~(SMS_DMA_ALIGNMENT-1)) 53 54 #define SMS_DEVICE_FAMILY2 1 55 #define SMS_ROM_NO_RESPONSE 2 56 #define SMS_DEVICE_NOT_READY 0x8000000 57 58 enum sms_device_type_st { 59 SMS_STELLAR = 0, 60 SMS_NOVA_A0, 61 SMS_NOVA_B0, 62 SMS_VEGA, 63 SMS_NUM_OF_DEVICE_TYPES 64 }; 65 66 struct smscore_device_t; 67 struct smscore_client_t; 68 struct smscore_buffer_t; 69 70 typedef int (*hotplug_t)(struct smscore_device_t *coredev, 71 struct device *device, int arrival); 72 73 typedef int (*setmode_t)(void *context, int mode); 74 typedef void (*detectmode_t)(void *context, int *mode); 75 typedef int (*sendrequest_t)(void *context, void *buffer, size_t size); 76 typedef int (*loadfirmware_t)(void *context, void *buffer, size_t size); 77 typedef int (*preload_t)(void *context); 78 typedef int (*postload_t)(void *context); 79 80 typedef int (*onresponse_t)(void *context, struct smscore_buffer_t *cb); 81 typedef void (*onremove_t)(void *context); 82 83 struct smscore_buffer_t { 84 /* public members, once passed to clients can be changed freely */ 85 struct list_head entry; 86 int size; 87 int offset; 88 89 /* private members, read-only for clients */ 90 void *p; 91 dma_addr_t phys; 92 unsigned long offset_in_common; 93 }; 94 95 struct smsdevice_params_t { 96 struct device *device; 97 98 int buffer_size; 99 int num_buffers; 100 101 char devpath[32]; 102 unsigned long flags; 103 104 setmode_t setmode_handler; 105 detectmode_t detectmode_handler; 106 sendrequest_t sendrequest_handler; 107 preload_t preload_handler; 108 postload_t postload_handler; 109 110 void *context; 111 enum sms_device_type_st device_type; 112 }; 113 114 struct smsclient_params_t { 115 int initial_id; 116 int data_type; 117 onresponse_t onresponse_handler; 118 onremove_t onremove_handler; 119 void *context; 120 }; 121 122 struct smscore_device_t { 123 struct list_head entry; 124 125 struct list_head clients; 126 struct list_head subclients; 127 spinlock_t clientslock; 128 129 struct list_head buffers; 130 spinlock_t bufferslock; 131 int num_buffers; 132 133 void *common_buffer; 134 int common_buffer_size; 135 dma_addr_t common_buffer_phys; 136 137 void *context; 138 struct device *device; 139 140 char devpath[32]; 141 unsigned long device_flags; 142 143 setmode_t setmode_handler; 144 detectmode_t detectmode_handler; 145 sendrequest_t sendrequest_handler; 146 preload_t preload_handler; 147 postload_t postload_handler; 148 149 int mode, modes_supported; 150 151 /* host <--> device messages */ 152 struct completion version_ex_done, data_download_done, trigger_done; 153 struct completion init_device_done, reload_start_done, resume_done; 154 struct completion gpio_configuration_done, gpio_set_level_done; 155 struct completion gpio_get_level_done, ir_init_done; 156 157 /* Buffer management */ 158 wait_queue_head_t buffer_mng_waitq; 159 160 /* GPIO */ 161 int gpio_get_res; 162 163 /* Target hardware board */ 164 int board_id; 165 166 /* Firmware */ 167 u8 *fw_buf; 168 u32 fw_buf_size; 169 170 /* Infrared (IR) */ 171 struct ir_t ir; 172 173 int led_state; 174 }; 175 176 /* GPIO definitions for antenna frequency domain control (SMS8021) */ 177 #define SMS_ANTENNA_GPIO_0 1 178 #define SMS_ANTENNA_GPIO_1 0 179 180 #define BW_8_MHZ 0 181 #define BW_7_MHZ 1 182 #define BW_6_MHZ 2 183 #define BW_5_MHZ 3 184 #define BW_ISDBT_1SEG 4 185 #define BW_ISDBT_3SEG 5 186 187 #define MSG_HDR_FLAG_SPLIT_MSG 4 188 189 #define MAX_GPIO_PIN_NUMBER 31 190 191 #define HIF_TASK 11 192 #define SMS_HOST_LIB 150 193 #define DVBT_BDA_CONTROL_MSG_ID 201 194 195 #define SMS_MAX_PAYLOAD_SIZE 240 196 #define SMS_TUNE_TIMEOUT 500 197 198 #define MSG_SMS_GPIO_CONFIG_REQ 507 199 #define MSG_SMS_GPIO_CONFIG_RES 508 200 #define MSG_SMS_GPIO_SET_LEVEL_REQ 509 201 #define MSG_SMS_GPIO_SET_LEVEL_RES 510 202 #define MSG_SMS_GPIO_GET_LEVEL_REQ 511 203 #define MSG_SMS_GPIO_GET_LEVEL_RES 512 204 #define MSG_SMS_RF_TUNE_REQ 561 205 #define MSG_SMS_RF_TUNE_RES 562 206 #define MSG_SMS_INIT_DEVICE_REQ 578 207 #define MSG_SMS_INIT_DEVICE_RES 579 208 #define MSG_SMS_ADD_PID_FILTER_REQ 601 209 #define MSG_SMS_ADD_PID_FILTER_RES 602 210 #define MSG_SMS_REMOVE_PID_FILTER_REQ 603 211 #define MSG_SMS_REMOVE_PID_FILTER_RES 604 212 #define MSG_SMS_DAB_CHANNEL 607 213 #define MSG_SMS_GET_PID_FILTER_LIST_REQ 608 214 #define MSG_SMS_GET_PID_FILTER_LIST_RES 609 215 #define MSG_SMS_GET_STATISTICS_RES 616 216 #define MSG_SMS_GET_STATISTICS_REQ 615 217 #define MSG_SMS_HO_PER_SLICES_IND 630 218 #define MSG_SMS_SET_ANTENNA_CONFIG_REQ 651 219 #define MSG_SMS_SET_ANTENNA_CONFIG_RES 652 220 #define MSG_SMS_SLEEP_RESUME_COMP_IND 655 221 #define MSG_SMS_DATA_DOWNLOAD_REQ 660 222 #define MSG_SMS_DATA_DOWNLOAD_RES 661 223 #define MSG_SMS_SWDOWNLOAD_TRIGGER_REQ 664 224 #define MSG_SMS_SWDOWNLOAD_TRIGGER_RES 665 225 #define MSG_SMS_SWDOWNLOAD_BACKDOOR_REQ 666 226 #define MSG_SMS_SWDOWNLOAD_BACKDOOR_RES 667 227 #define MSG_SMS_GET_VERSION_EX_REQ 668 228 #define MSG_SMS_GET_VERSION_EX_RES 669 229 #define MSG_SMS_SET_CLOCK_OUTPUT_REQ 670 230 #define MSG_SMS_I2C_SET_FREQ_REQ 685 231 #define MSG_SMS_GENERIC_I2C_REQ 687 232 #define MSG_SMS_GENERIC_I2C_RES 688 233 #define MSG_SMS_DVBT_BDA_DATA 693 234 #define MSG_SW_RELOAD_REQ 697 235 #define MSG_SMS_DATA_MSG 699 236 #define MSG_SW_RELOAD_START_REQ 702 237 #define MSG_SW_RELOAD_START_RES 703 238 #define MSG_SW_RELOAD_EXEC_REQ 704 239 #define MSG_SW_RELOAD_EXEC_RES 705 240 #define MSG_SMS_SPI_INT_LINE_SET_REQ 710 241 #define MSG_SMS_GPIO_CONFIG_EX_REQ 712 242 #define MSG_SMS_GPIO_CONFIG_EX_RES 713 243 #define MSG_SMS_ISDBT_TUNE_REQ 776 244 #define MSG_SMS_ISDBT_TUNE_RES 777 245 #define MSG_SMS_TRANSMISSION_IND 782 246 #define MSG_SMS_START_IR_REQ 800 247 #define MSG_SMS_START_IR_RES 801 248 #define MSG_SMS_IR_SAMPLES_IND 802 249 #define MSG_SMS_SIGNAL_DETECTED_IND 827 250 #define MSG_SMS_NO_SIGNAL_IND 828 251 252 #define SMS_INIT_MSG_EX(ptr, type, src, dst, len) do { \ 253 (ptr)->msgType = type; (ptr)->msgSrcId = src; (ptr)->msgDstId = dst; \ 254 (ptr)->msgLength = len; (ptr)->msgFlags = 0; \ 255 } while (0) 256 257 #define SMS_INIT_MSG(ptr, type, len) \ 258 SMS_INIT_MSG_EX(ptr, type, 0, HIF_TASK, len) 259 260 enum SMS_DVB3_EVENTS { 261 DVB3_EVENT_INIT = 0, 262 DVB3_EVENT_SLEEP, 263 DVB3_EVENT_HOTPLUG, 264 DVB3_EVENT_FE_LOCK, 265 DVB3_EVENT_FE_UNLOCK, 266 DVB3_EVENT_UNC_OK, 267 DVB3_EVENT_UNC_ERR 268 }; 269 270 enum SMS_DEVICE_MODE { 271 DEVICE_MODE_NONE = -1, 272 DEVICE_MODE_DVBT = 0, 273 DEVICE_MODE_DVBH, 274 DEVICE_MODE_DAB_TDMB, 275 DEVICE_MODE_DAB_TDMB_DABIP, 276 DEVICE_MODE_DVBT_BDA, 277 DEVICE_MODE_ISDBT, 278 DEVICE_MODE_ISDBT_BDA, 279 DEVICE_MODE_CMMB, 280 DEVICE_MODE_RAW_TUNER, 281 DEVICE_MODE_MAX, 282 }; 283 284 struct SmsMsgHdr_ST { 285 u16 msgType; 286 u8 msgSrcId; 287 u8 msgDstId; 288 u16 msgLength; /* Length of entire message, including header */ 289 u16 msgFlags; 290 }; 291 292 struct SmsMsgData_ST { 293 struct SmsMsgHdr_ST xMsgHeader; 294 u32 msgData[1]; 295 }; 296 297 struct SmsMsgData_ST2 { 298 struct SmsMsgHdr_ST xMsgHeader; 299 u32 msgData[2]; 300 }; 301 302 struct SmsDataDownload_ST { 303 struct SmsMsgHdr_ST xMsgHeader; 304 u32 MemAddr; 305 u8 Payload[SMS_MAX_PAYLOAD_SIZE]; 306 }; 307 308 struct SmsVersionRes_ST { 309 struct SmsMsgHdr_ST xMsgHeader; 310 311 u16 ChipModel; /* e.g. 0x1102 for SMS-1102 "Nova" */ 312 u8 Step; /* 0 - Step A */ 313 u8 MetalFix; /* 0 - Metal 0 */ 314 315 /* FirmwareId 0xFF if ROM, otherwise the 316 * value indicated by SMSHOSTLIB_DEVICE_MODES_E */ 317 u8 FirmwareId; 318 /* SupportedProtocols Bitwise OR combination of 319 * supported protocols */ 320 u8 SupportedProtocols; 321 322 u8 VersionMajor; 323 u8 VersionMinor; 324 u8 VersionPatch; 325 u8 VersionFieldPatch; 326 327 u8 RomVersionMajor; 328 u8 RomVersionMinor; 329 u8 RomVersionPatch; 330 u8 RomVersionFieldPatch; 331 332 u8 TextLabel[34]; 333 }; 334 335 struct SmsFirmware_ST { 336 u32 CheckSum; 337 u32 Length; 338 u32 StartAddress; 339 u8 Payload[1]; 340 }; 341 342 /* Statistics information returned as response for 343 * SmsHostApiGetStatistics_Req */ 344 struct SMSHOSTLIB_STATISTICS_ST { 345 u32 Reserved; /* Reserved */ 346 347 /* Common parameters */ 348 u32 IsRfLocked; /* 0 - not locked, 1 - locked */ 349 u32 IsDemodLocked; /* 0 - not locked, 1 - locked */ 350 u32 IsExternalLNAOn; /* 0 - external LNA off, 1 - external LNA on */ 351 352 /* Reception quality */ 353 s32 SNR; /* dB */ 354 u32 BER; /* Post Viterbi BER [1E-5] */ 355 u32 FIB_CRC; /* CRC errors percentage, valid only for DAB */ 356 u32 TS_PER; /* Transport stream PER, 357 0xFFFFFFFF indicate N/A, valid only for DVB-T/H */ 358 u32 MFER; /* DVB-H frame error rate in percentage, 359 0xFFFFFFFF indicate N/A, valid only for DVB-H */ 360 s32 RSSI; /* dBm */ 361 s32 InBandPwr; /* In band power in dBM */ 362 s32 CarrierOffset; /* Carrier Offset in bin/1024 */ 363 364 /* Transmission parameters */ 365 u32 Frequency; /* Frequency in Hz */ 366 u32 Bandwidth; /* Bandwidth in MHz, valid only for DVB-T/H */ 367 u32 TransmissionMode; /* Transmission Mode, for DAB modes 1-4, 368 for DVB-T/H FFT mode carriers in Kilos */ 369 u32 ModemState; /* from SMSHOSTLIB_DVB_MODEM_STATE_ET, 370 valid only for DVB-T/H */ 371 u32 GuardInterval; /* Guard Interval from 372 SMSHOSTLIB_GUARD_INTERVALS_ET, valid only for DVB-T/H */ 373 u32 CodeRate; /* Code Rate from SMSHOSTLIB_CODE_RATE_ET, 374 valid only for DVB-T/H */ 375 u32 LPCodeRate; /* Low Priority Code Rate from 376 SMSHOSTLIB_CODE_RATE_ET, valid only for DVB-T/H */ 377 u32 Hierarchy; /* Hierarchy from SMSHOSTLIB_HIERARCHY_ET, 378 valid only for DVB-T/H */ 379 u32 Constellation; /* Constellation from 380 SMSHOSTLIB_CONSTELLATION_ET, valid only for DVB-T/H */ 381 382 /* Burst parameters, valid only for DVB-H */ 383 u32 BurstSize; /* Current burst size in bytes, 384 valid only for DVB-H */ 385 u32 BurstDuration; /* Current burst duration in mSec, 386 valid only for DVB-H */ 387 u32 BurstCycleTime; /* Current burst cycle time in mSec, 388 valid only for DVB-H */ 389 u32 CalculatedBurstCycleTime;/* Current burst cycle time in mSec, 390 as calculated by demodulator, valid only for DVB-H */ 391 u32 NumOfRows; /* Number of rows in MPE table, 392 valid only for DVB-H */ 393 u32 NumOfPaddCols; /* Number of padding columns in MPE table, 394 valid only for DVB-H */ 395 u32 NumOfPunctCols; /* Number of puncturing columns in MPE table, 396 valid only for DVB-H */ 397 u32 ErrorTSPackets; /* Number of erroneous 398 transport-stream packets */ 399 u32 TotalTSPackets; /* Total number of transport-stream packets */ 400 u32 NumOfValidMpeTlbs; /* Number of MPE tables which do not include 401 errors after MPE RS decoding */ 402 u32 NumOfInvalidMpeTlbs;/* Number of MPE tables which include errors 403 after MPE RS decoding */ 404 u32 NumOfCorrectedMpeTlbs;/* Number of MPE tables which were 405 corrected by MPE RS decoding */ 406 /* Common params */ 407 u32 BERErrorCount; /* Number of errornous SYNC bits. */ 408 u32 BERBitCount; /* Total number of SYNC bits. */ 409 410 /* Interface information */ 411 u32 SmsToHostTxErrors; /* Total number of transmission errors. */ 412 413 /* DAB/T-DMB */ 414 u32 PreBER; /* DAB/T-DMB only: Pre Viterbi BER [1E-5] */ 415 416 /* DVB-H TPS parameters */ 417 u32 CellId; /* TPS Cell ID in bits 15..0, bits 31..16 zero; 418 if set to 0xFFFFFFFF cell_id not yet recovered */ 419 u32 DvbhSrvIndHP; /* DVB-H service indication info, bit 1 - 420 Time Slicing indicator, bit 0 - MPE-FEC indicator */ 421 u32 DvbhSrvIndLP; /* DVB-H service indication info, bit 1 - 422 Time Slicing indicator, bit 0 - MPE-FEC indicator */ 423 424 u32 NumMPEReceived; /* DVB-H, Num MPE section received */ 425 426 u32 ReservedFields[10]; /* Reserved */ 427 }; 428 429 struct SmsMsgStatisticsInfo_ST { 430 u32 RequestResult; 431 432 struct SMSHOSTLIB_STATISTICS_ST Stat; 433 434 /* Split the calc of the SNR in DAB */ 435 u32 Signal; /* dB */ 436 u32 Noise; /* dB */ 437 438 }; 439 440 struct SMSHOSTLIB_ISDBT_LAYER_STAT_ST { 441 /* Per-layer information */ 442 u32 CodeRate; /* Code Rate from SMSHOSTLIB_CODE_RATE_ET, 443 * 255 means layer does not exist */ 444 u32 Constellation; /* Constellation from SMSHOSTLIB_CONSTELLATION_ET, 445 * 255 means layer does not exist */ 446 u32 BER; /* Post Viterbi BER [1E-5], 0xFFFFFFFF indicate N/A */ 447 u32 BERErrorCount; /* Post Viterbi Error Bits Count */ 448 u32 BERBitCount; /* Post Viterbi Total Bits Count */ 449 u32 PreBER; /* Pre Viterbi BER [1E-5], 0xFFFFFFFF indicate N/A */ 450 u32 TS_PER; /* Transport stream PER [%], 0xFFFFFFFF indicate N/A */ 451 u32 ErrorTSPackets; /* Number of erroneous transport-stream packets */ 452 u32 TotalTSPackets; /* Total number of transport-stream packets */ 453 u32 TILdepthI; /* Time interleaver depth I parameter, 454 * 255 means layer does not exist */ 455 u32 NumberOfSegments; /* Number of segments in layer A, 456 * 255 means layer does not exist */ 457 u32 TMCCErrors; /* TMCC errors */ 458 }; 459 460 struct SMSHOSTLIB_STATISTICS_ISDBT_ST { 461 u32 StatisticsType; /* Enumerator identifying the type of the 462 * structure. Values are the same as 463 * SMSHOSTLIB_DEVICE_MODES_E 464 * 465 * This field MUST always be first in any 466 * statistics structure */ 467 468 u32 FullSize; /* Total size of the structure returned by the modem. 469 * If the size requested by the host is smaller than 470 * FullSize, the struct will be truncated */ 471 472 /* Common parameters */ 473 u32 IsRfLocked; /* 0 - not locked, 1 - locked */ 474 u32 IsDemodLocked; /* 0 - not locked, 1 - locked */ 475 u32 IsExternalLNAOn; /* 0 - external LNA off, 1 - external LNA on */ 476 477 /* Reception quality */ 478 s32 SNR; /* dB */ 479 s32 RSSI; /* dBm */ 480 s32 InBandPwr; /* In band power in dBM */ 481 s32 CarrierOffset; /* Carrier Offset in Hz */ 482 483 /* Transmission parameters */ 484 u32 Frequency; /* Frequency in Hz */ 485 u32 Bandwidth; /* Bandwidth in MHz */ 486 u32 TransmissionMode; /* ISDB-T transmission mode */ 487 u32 ModemState; /* 0 - Acquisition, 1 - Locked */ 488 u32 GuardInterval; /* Guard Interval, 1 divided by value */ 489 u32 SystemType; /* ISDB-T system type (ISDB-T / ISDB-Tsb) */ 490 u32 PartialReception; /* TRUE - partial reception, FALSE otherwise */ 491 u32 NumOfLayers; /* Number of ISDB-T layers in the network */ 492 493 /* Per-layer information */ 494 /* Layers A, B and C */ 495 struct SMSHOSTLIB_ISDBT_LAYER_STAT_ST LayerInfo[3]; 496 /* Per-layer statistics, see SMSHOSTLIB_ISDBT_LAYER_STAT_ST */ 497 498 /* Interface information */ 499 u32 SmsToHostTxErrors; /* Total number of transmission errors. */ 500 }; 501 502 struct PID_STATISTICS_DATA_S { 503 struct PID_BURST_S { 504 u32 size; 505 u32 padding_cols; 506 u32 punct_cols; 507 u32 duration; 508 u32 cycle; 509 u32 calc_cycle; 510 } burst; 511 512 u32 tot_tbl_cnt; 513 u32 invalid_tbl_cnt; 514 u32 tot_cor_tbl; 515 }; 516 517 struct PID_DATA_S { 518 u32 pid; 519 u32 num_rows; 520 struct PID_STATISTICS_DATA_S pid_statistics; 521 }; 522 523 #define CORRECT_STAT_RSSI(_stat) ((_stat).RSSI *= -1) 524 #define CORRECT_STAT_BANDWIDTH(_stat) (_stat.Bandwidth = 8 - _stat.Bandwidth) 525 #define CORRECT_STAT_TRANSMISSON_MODE(_stat) \ 526 if (_stat.TransmissionMode == 0) \ 527 _stat.TransmissionMode = 2; \ 528 else if (_stat.TransmissionMode == 1) \ 529 _stat.TransmissionMode = 8; \ 530 else \ 531 _stat.TransmissionMode = 4; 532 533 struct TRANSMISSION_STATISTICS_S { 534 u32 Frequency; /* Frequency in Hz */ 535 u32 Bandwidth; /* Bandwidth in MHz */ 536 u32 TransmissionMode; /* FFT mode carriers in Kilos */ 537 u32 GuardInterval; /* Guard Interval from 538 SMSHOSTLIB_GUARD_INTERVALS_ET */ 539 u32 CodeRate; /* Code Rate from SMSHOSTLIB_CODE_RATE_ET */ 540 u32 LPCodeRate; /* Low Priority Code Rate from 541 SMSHOSTLIB_CODE_RATE_ET */ 542 u32 Hierarchy; /* Hierarchy from SMSHOSTLIB_HIERARCHY_ET */ 543 u32 Constellation; /* Constellation from 544 SMSHOSTLIB_CONSTELLATION_ET */ 545 546 /* DVB-H TPS parameters */ 547 u32 CellId; /* TPS Cell ID in bits 15..0, bits 31..16 zero; 548 if set to 0xFFFFFFFF cell_id not yet recovered */ 549 u32 DvbhSrvIndHP; /* DVB-H service indication info, bit 1 - 550 Time Slicing indicator, bit 0 - MPE-FEC indicator */ 551 u32 DvbhSrvIndLP; /* DVB-H service indication info, bit 1 - 552 Time Slicing indicator, bit 0 - MPE-FEC indicator */ 553 u32 IsDemodLocked; /* 0 - not locked, 1 - locked */ 554 }; 555 556 struct RECEPTION_STATISTICS_S { 557 u32 IsRfLocked; /* 0 - not locked, 1 - locked */ 558 u32 IsDemodLocked; /* 0 - not locked, 1 - locked */ 559 u32 IsExternalLNAOn; /* 0 - external LNA off, 1 - external LNA on */ 560 561 u32 ModemState; /* from SMSHOSTLIB_DVB_MODEM_STATE_ET */ 562 s32 SNR; /* dB */ 563 u32 BER; /* Post Viterbi BER [1E-5] */ 564 u32 BERErrorCount; /* Number of erronous SYNC bits. */ 565 u32 BERBitCount; /* Total number of SYNC bits. */ 566 u32 TS_PER; /* Transport stream PER, 567 0xFFFFFFFF indicate N/A */ 568 u32 MFER; /* DVB-H frame error rate in percentage, 569 0xFFFFFFFF indicate N/A, valid only for DVB-H */ 570 s32 RSSI; /* dBm */ 571 s32 InBandPwr; /* In band power in dBM */ 572 s32 CarrierOffset; /* Carrier Offset in bin/1024 */ 573 u32 ErrorTSPackets; /* Number of erroneous 574 transport-stream packets */ 575 u32 TotalTSPackets; /* Total number of transport-stream packets */ 576 577 s32 MRC_SNR; /* dB */ 578 s32 MRC_RSSI; /* dBm */ 579 s32 MRC_InBandPwr; /* In band power in dBM */ 580 }; 581 582 583 /* Statistics information returned as response for 584 * SmsHostApiGetStatisticsEx_Req for DVB applications, SMS1100 and up */ 585 struct SMSHOSTLIB_STATISTICS_DVB_S { 586 /* Reception */ 587 struct RECEPTION_STATISTICS_S ReceptionData; 588 589 /* Transmission parameters */ 590 struct TRANSMISSION_STATISTICS_S TransmissionData; 591 592 /* Burst parameters, valid only for DVB-H */ 593 #define SRVM_MAX_PID_FILTERS 8 594 struct PID_DATA_S PidData[SRVM_MAX_PID_FILTERS]; 595 }; 596 597 struct SRVM_SIGNAL_STATUS_S { 598 u32 result; 599 u32 snr; 600 u32 tsPackets; 601 u32 etsPackets; 602 u32 constellation; 603 u32 hpCode; 604 u32 tpsSrvIndLP; 605 u32 tpsSrvIndHP; 606 u32 cellId; 607 u32 reason; 608 609 s32 inBandPower; 610 u32 requestId; 611 }; 612 613 struct SMSHOSTLIB_I2C_REQ_ST { 614 u32 DeviceAddress; /* I2c device address */ 615 u32 WriteCount; /* number of bytes to write */ 616 u32 ReadCount; /* number of bytes to read */ 617 u8 Data[1]; 618 }; 619 620 struct SMSHOSTLIB_I2C_RES_ST { 621 u32 Status; /* non-zero value in case of failure */ 622 u32 ReadCount; /* number of bytes read */ 623 u8 Data[1]; 624 }; 625 626 627 struct smscore_config_gpio { 628 #define SMS_GPIO_DIRECTION_INPUT 0 629 #define SMS_GPIO_DIRECTION_OUTPUT 1 630 u8 direction; 631 632 #define SMS_GPIO_PULLUPDOWN_NONE 0 633 #define SMS_GPIO_PULLUPDOWN_PULLDOWN 1 634 #define SMS_GPIO_PULLUPDOWN_PULLUP 2 635 #define SMS_GPIO_PULLUPDOWN_KEEPER 3 636 u8 pullupdown; 637 638 #define SMS_GPIO_INPUTCHARACTERISTICS_NORMAL 0 639 #define SMS_GPIO_INPUTCHARACTERISTICS_SCHMITT 1 640 u8 inputcharacteristics; 641 642 #define SMS_GPIO_OUTPUTSLEWRATE_FAST 0 643 #define SMS_GPIO_OUTPUTSLEWRATE_SLOW 1 644 u8 outputslewrate; 645 646 #define SMS_GPIO_OUTPUTDRIVING_4mA 0 647 #define SMS_GPIO_OUTPUTDRIVING_8mA 1 648 #define SMS_GPIO_OUTPUTDRIVING_12mA 2 649 #define SMS_GPIO_OUTPUTDRIVING_16mA 3 650 u8 outputdriving; 651 }; 652 653 struct smscore_gpio_config { 654 #define SMS_GPIO_DIRECTION_INPUT 0 655 #define SMS_GPIO_DIRECTION_OUTPUT 1 656 u8 Direction; 657 658 #define SMS_GPIO_PULL_UP_DOWN_NONE 0 659 #define SMS_GPIO_PULL_UP_DOWN_PULLDOWN 1 660 #define SMS_GPIO_PULL_UP_DOWN_PULLUP 2 661 #define SMS_GPIO_PULL_UP_DOWN_KEEPER 3 662 u8 PullUpDown; 663 664 #define SMS_GPIO_INPUT_CHARACTERISTICS_NORMAL 0 665 #define SMS_GPIO_INPUT_CHARACTERISTICS_SCHMITT 1 666 u8 InputCharacteristics; 667 668 #define SMS_GPIO_OUTPUT_SLEW_RATE_SLOW 1 /* 10xx */ 669 #define SMS_GPIO_OUTPUT_SLEW_RATE_FAST 0 /* 10xx */ 670 671 672 #define SMS_GPIO_OUTPUT_SLEW_RATE_0_45_V_NS 0 /* 11xx */ 673 #define SMS_GPIO_OUTPUT_SLEW_RATE_0_9_V_NS 1 /* 11xx */ 674 #define SMS_GPIO_OUTPUT_SLEW_RATE_1_7_V_NS 2 /* 11xx */ 675 #define SMS_GPIO_OUTPUT_SLEW_RATE_3_3_V_NS 3 /* 11xx */ 676 u8 OutputSlewRate; 677 678 #define SMS_GPIO_OUTPUT_DRIVING_S_4mA 0 /* 10xx */ 679 #define SMS_GPIO_OUTPUT_DRIVING_S_8mA 1 /* 10xx */ 680 #define SMS_GPIO_OUTPUT_DRIVING_S_12mA 2 /* 10xx */ 681 #define SMS_GPIO_OUTPUT_DRIVING_S_16mA 3 /* 10xx */ 682 683 #define SMS_GPIO_OUTPUT_DRIVING_1_5mA 0 /* 11xx */ 684 #define SMS_GPIO_OUTPUT_DRIVING_2_8mA 1 /* 11xx */ 685 #define SMS_GPIO_OUTPUT_DRIVING_4mA 2 /* 11xx */ 686 #define SMS_GPIO_OUTPUT_DRIVING_7mA 3 /* 11xx */ 687 #define SMS_GPIO_OUTPUT_DRIVING_10mA 4 /* 11xx */ 688 #define SMS_GPIO_OUTPUT_DRIVING_11mA 5 /* 11xx */ 689 #define SMS_GPIO_OUTPUT_DRIVING_14mA 6 /* 11xx */ 690 #define SMS_GPIO_OUTPUT_DRIVING_16mA 7 /* 11xx */ 691 u8 OutputDriving; 692 }; 693 694 extern void smscore_registry_setmode(char *devpath, int mode); 695 extern int smscore_registry_getmode(char *devpath); 696 697 extern int smscore_register_hotplug(hotplug_t hotplug); 698 extern void smscore_unregister_hotplug(hotplug_t hotplug); 699 700 extern int smscore_register_device(struct smsdevice_params_t *params, 701 struct smscore_device_t **coredev); 702 extern void smscore_unregister_device(struct smscore_device_t *coredev); 703 704 extern int smscore_start_device(struct smscore_device_t *coredev); 705 extern int smscore_load_firmware(struct smscore_device_t *coredev, 706 char *filename, 707 loadfirmware_t loadfirmware_handler); 708 709 extern int smscore_set_device_mode(struct smscore_device_t *coredev, int mode); 710 extern int smscore_get_device_mode(struct smscore_device_t *coredev); 711 712 extern int smscore_register_client(struct smscore_device_t *coredev, 713 struct smsclient_params_t *params, 714 struct smscore_client_t **client); 715 extern void smscore_unregister_client(struct smscore_client_t *client); 716 717 extern int smsclient_sendrequest(struct smscore_client_t *client, 718 void *buffer, size_t size); 719 extern void smscore_onresponse(struct smscore_device_t *coredev, 720 struct smscore_buffer_t *cb); 721 722 extern int smscore_get_common_buffer_size(struct smscore_device_t *coredev); 723 extern int smscore_map_common_buffer(struct smscore_device_t *coredev, 724 struct vm_area_struct *vma); 725 extern int smscore_get_fw_filename(struct smscore_device_t *coredev, 726 int mode, char *filename); 727 extern int smscore_send_fw_file(struct smscore_device_t *coredev, 728 u8 *ufwbuf, int size); 729 730 extern 731 struct smscore_buffer_t *smscore_getbuffer(struct smscore_device_t *coredev); 732 extern void smscore_putbuffer(struct smscore_device_t *coredev, 733 struct smscore_buffer_t *cb); 734 735 /* old GPIO management */ 736 int smscore_configure_gpio(struct smscore_device_t *coredev, u32 pin, 737 struct smscore_config_gpio *pinconfig); 738 int smscore_set_gpio(struct smscore_device_t *coredev, u32 pin, int level); 739 740 /* new GPIO management */ 741 extern int smscore_gpio_configure(struct smscore_device_t *coredev, u8 PinNum, 742 struct smscore_gpio_config *pGpioConfig); 743 extern int smscore_gpio_set_level(struct smscore_device_t *coredev, u8 PinNum, 744 u8 NewLevel); 745 extern int smscore_gpio_get_level(struct smscore_device_t *coredev, u8 PinNum, 746 u8 *level); 747 748 void smscore_set_board_id(struct smscore_device_t *core, int id); 749 int smscore_get_board_id(struct smscore_device_t *core); 750 751 int smscore_led_state(struct smscore_device_t *core, int led); 752 753 754 /* ------------------------------------------------------------------------ */ 755 756 #define DBG_INFO 1 757 #define DBG_ADV 2 758 759 #define sms_printk(kern, fmt, arg...) \ 760 printk(kern "%s: " fmt "\n", __func__, ##arg) 761 762 #define dprintk(kern, lvl, fmt, arg...) do {\ 763 if (sms_dbg & lvl) \ 764 sms_printk(kern, fmt, ##arg); } while (0) 765 766 #define sms_log(fmt, arg...) sms_printk(KERN_INFO, fmt, ##arg) 767 #define sms_err(fmt, arg...) \ 768 sms_printk(KERN_ERR, "line: %d: " fmt, __LINE__, ##arg) 769 #define sms_warn(fmt, arg...) sms_printk(KERN_WARNING, fmt, ##arg) 770 #define sms_info(fmt, arg...) \ 771 dprintk(KERN_INFO, DBG_INFO, fmt, ##arg) 772 #define sms_debug(fmt, arg...) \ 773 dprintk(KERN_DEBUG, DBG_ADV, fmt, ##arg) 774 775 776 #endif /* __SMS_CORE_API_H__ */ 777