2 * Driver for the Siano SMS1xxx USB dongle
4 * author: Anatoly Greenblat
6 * Copyright (c), 2005-2008 Siano Mobile Silicon, Inc.
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 3 as
10 * published by the Free Software Foundation;
12 * Software distributed under the License is distributed on an "AS IS"
13 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.
15 * See the GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22 #ifndef __smscoreapi_h__
23 #define __smscoreapi_h__
25 #include <linux/version.h>
26 #include <linux/device.h>
27 #include <linux/list.h>
29 #include <asm/scatterlist.h>
34 #include "dvb_demux.h"
35 #include "dvb_frontend.h"
37 #include <linux/mutex.h>
39 typedef struct mutex kmutex_t;
41 #define kmutex_init(_p_) mutex_init(_p_)
42 #define kmutex_lock(_p_) mutex_lock(_p_)
43 #define kmutex_trylock(_p_) mutex_trylock(_p_)
44 #define kmutex_unlock(_p_) mutex_unlock(_p_)
48 #define min(a,b) (((a) < (b)) ? (a) : (b))
51 #define SMS_ALLOC_ALIGNMENT 128
52 #define SMS_DMA_ALIGNMENT 16
53 #define SMS_ALIGN_ADDRESS(addr) ((((u32)(addr)) + (SMS_DMA_ALIGNMENT-1)) & ~(SMS_DMA_ALIGNMENT-1))
55 #define SMS_DEVICE_FAMILY2 1
56 #define SMS_ROM_NO_RESPONSE 2
57 #define SMS_DEVICE_NOT_READY 0x8000000
64 SMS_NUM_OF_DEVICE_TYPES
67 typedef struct _smscore_device smscore_device_t;
68 typedef struct _smscore_client smscore_client_t;
69 typedef struct _smscore_buffer smscore_buffer_t;
71 typedef int (*hotplug_t)(smscore_device_t *coredev, struct device *device, int arrival);
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);
80 typedef int (*onresponse_t)(void *context, smscore_buffer_t *cb);
81 typedef void (*onremove_t)(void *context);
83 typedef struct _smscore_buffer
85 // public members, once passed to clients can be changed freely
86 struct list_head entry;
90 // private members, read-only for clients
93 unsigned long offset_in_common;
96 typedef struct _smsdevice_params
98 struct device *device;
106 setmode_t setmode_handler;
107 detectmode_t detectmode_handler;
108 sendrequest_t sendrequest_handler;
109 preload_t preload_handler;
110 postload_t postload_handler;
113 sms_device_type_st device_type;
114 } smsdevice_params_t;
116 typedef struct _smsclient_params
120 onresponse_t onresponse_handler;
121 onremove_t onremove_handler;
124 } smsclient_params_t;
126 // GPIO definitions for antenna frequency domain control (SMS8021)
127 #define SMS_ANTENNA_GPIO_0 1
128 #define SMS_ANTENNA_GPIO_1 0
134 #define BW_ISDBT_1SEG 4
135 #define BW_ISDBT_3SEG 5
137 #define MSG_HDR_FLAG_SPLIT_MSG 4
139 #define MAX_GPIO_PIN_NUMBER 31
142 #define SMS_HOST_LIB 150
143 #define DVBT_BDA_CONTROL_MSG_ID 201
145 #define SMS_MAX_PAYLOAD_SIZE 240
146 #define SMS_TUNE_TIMEOUT 500
148 #define MSG_SMS_GPIO_CONFIG_REQ 507
149 #define MSG_SMS_GPIO_CONFIG_RES 508
150 #define MSG_SMS_GPIO_SET_LEVEL_REQ 509
151 #define MSG_SMS_GPIO_SET_LEVEL_RES 510
152 #define MSG_SMS_GPIO_GET_LEVEL_REQ 511
153 #define MSG_SMS_GPIO_GET_LEVEL_RES 512
154 #define MSG_SMS_RF_TUNE_REQ 561
155 #define MSG_SMS_RF_TUNE_RES 562
156 #define MSG_SMS_INIT_DEVICE_REQ 578
157 #define MSG_SMS_INIT_DEVICE_RES 579
158 #define MSG_SMS_ADD_PID_FILTER_REQ 601
159 #define MSG_SMS_ADD_PID_FILTER_RES 602
160 #define MSG_SMS_REMOVE_PID_FILTER_REQ 603
161 #define MSG_SMS_REMOVE_PID_FILTER_RES 604
162 #define MSG_SMS_DAB_CHANNEL 607
163 #define MSG_SMS_GET_PID_FILTER_LIST_REQ 608
164 #define MSG_SMS_GET_PID_FILTER_LIST_RES 609
165 #define MSG_SMS_GET_STATISTICS_REQ 615
166 #define MSG_SMS_GET_STATISTICS_RES 616
167 #define MSG_SMS_SET_ANTENNA_CONFIG_REQ 651
168 #define MSG_SMS_SET_ANTENNA_CONFIG_RES 652
169 #define MSG_SMS_GET_STATISTICS_EX_REQ 653
170 #define MSG_SMS_GET_STATISTICS_EX_RES 654
171 #define MSG_SMS_SLEEP_RESUME_COMP_IND 655
172 #define MSG_SMS_DATA_DOWNLOAD_REQ 660
173 #define MSG_SMS_DATA_DOWNLOAD_RES 661
174 #define MSG_SMS_SWDOWNLOAD_TRIGGER_REQ 664
175 #define MSG_SMS_SWDOWNLOAD_TRIGGER_RES 665
176 #define MSG_SMS_SWDOWNLOAD_BACKDOOR_REQ 666
177 #define MSG_SMS_SWDOWNLOAD_BACKDOOR_RES 667
178 #define MSG_SMS_GET_VERSION_EX_REQ 668
179 #define MSG_SMS_GET_VERSION_EX_RES 669
180 #define MSG_SMS_SET_CLOCK_OUTPUT_REQ 670
181 #define MSG_SMS_I2C_SET_FREQ_REQ 685
182 #define MSG_SMS_GENERIC_I2C_REQ 687
183 #define MSG_SMS_GENERIC_I2C_RES 688
184 #define MSG_SMS_DVBT_BDA_DATA 693
185 #define MSG_SW_RELOAD_REQ 697
186 #define MSG_SMS_DATA_MSG 699
187 #define MSG_SW_RELOAD_START_REQ 702
188 #define MSG_SW_RELOAD_START_RES 703
189 #define MSG_SW_RELOAD_EXEC_REQ 704
190 #define MSG_SW_RELOAD_EXEC_RES 705
191 #define MSG_SMS_SPI_INT_LINE_SET_REQ 710
192 #define MSG_SMS_ISDBT_TUNE_REQ 776
193 #define MSG_SMS_ISDBT_TUNE_RES 777
195 #define SMS_INIT_MSG_EX(ptr, type, src, dst, len) do { \
196 (ptr)->msgType = type; (ptr)->msgSrcId = src; (ptr)->msgDstId = dst; \
197 (ptr)->msgLength = len; (ptr)->msgFlags = 0; \
199 #define SMS_INIT_MSG(ptr, type, len) SMS_INIT_MSG_EX(ptr, type, 0, HIF_TASK, len)
203 DEVICE_MODE_NONE = -1,
204 DEVICE_MODE_DVBT = 0,
206 DEVICE_MODE_DAB_TDMB,
207 DEVICE_MODE_DAB_TDMB_DABIP,
208 DEVICE_MODE_DVBT_BDA,
210 DEVICE_MODE_ISDBT_BDA,
212 DEVICE_MODE_RAW_TUNER,
216 typedef unsigned char UINT8;
217 typedef unsigned short UINT16;
218 typedef unsigned int UINT32;
221 typedef struct SmsMsgHdr_S
226 UINT16 msgLength; // Length is of the entire message, including header
230 typedef struct SmsMsgData_S
232 SmsMsgHdr_ST xMsgHeader;
236 typedef struct SmsDataDownload_S
238 SmsMsgHdr_ST xMsgHeader;
240 UINT8 Payload[SMS_MAX_PAYLOAD_SIZE];
241 } SmsDataDownload_ST;
243 typedef struct SmsVersionRes_S
245 SmsMsgHdr_ST xMsgHeader;
247 UINT16 ChipModel; // e.g. 0x1102 for SMS-1102 "Nova"
248 UINT8 Step; // 0 - Step A
249 UINT8 MetalFix; // 0 - Metal 0
251 UINT8 FirmwareId; // 0xFF � ROM, otherwise the value indicated by SMSHOSTLIB_DEVICE_MODES_E
252 UINT8 SupportedProtocols; // Bitwise OR combination of supported protocols
257 UINT8 VersionFieldPatch;
259 UINT8 RomVersionMajor;
260 UINT8 RomVersionMinor;
261 UINT8 RomVersionPatch;
262 UINT8 RomVersionFieldPatch;
267 typedef struct SmsFirmware_S
275 typedef struct SMSHOSTLIB_STATISTICS_S
277 UINT32 Reserved; //!< Reserved
279 /// Common parameters
280 UINT32 IsRfLocked; //!< 0 - not locked, 1 - locked
281 UINT32 IsDemodLocked; //!< 0 - not locked, 1 - locked
282 UINT32 IsExternalLNAOn; //!< 0 - external LNA off, 1 - external LNA on
284 /// Reception quality
286 UINT32 BER; //!< Post Viterbi BER [1E-5]
287 UINT32 FIB_CRC; //!< CRC errors percentage, valid only for DAB
288 UINT32 TS_PER; //!< Transport stream PER, 0xFFFFFFFF indicate N/A, valid only for DVB-T/H
289 UINT32 MFER; //!< DVB-H frame error rate in percentage, 0xFFFFFFFF indicate N/A, valid only for DVB-H
291 INT32 InBandPwr; //!< In band power in dBM
292 INT32 CarrierOffset; //!< Carrier Offset in bin/1024
294 /// Transmission parameters
295 UINT32 Frequency; //!< Frequency in Hz
296 UINT32 Bandwidth; //!< Bandwidth in MHz, valid only for DVB-T/H
297 UINT32 TransmissionMode; //!< Transmission Mode, for DAB modes 1-4, for DVB-T/H FFT mode carriers in Kilos
298 UINT32 ModemState; //!< from SMS_DvbModemState_ET , valid only for DVB-T/H
299 UINT32 GuardInterval; //!< Guard Interval, 1 divided by value , valid only for DVB-T/H
300 UINT32 CodeRate; //!< Code Rate from SMS_DvbModemState_ET, valid only for DVB-T/H
301 UINT32 LPCodeRate; //!< Low Priority Code Rate from SMS_DvbModemState_ET, valid only for DVB-T/H
302 UINT32 Hierarchy; //!< Hierarchy from SMS_Hierarchy_ET, valid only for DVB-T/H
303 UINT32 Constellation; //!< Constellation from SMS_Constellation_ET, valid only for DVB-T/H
305 /// Burst parameters, valid only for DVB-H
306 UINT32 BurstSize; //!< Current burst size in bytes, valid only for DVB-H
307 UINT32 BurstDuration; //!< Current burst duration in mSec, valid only for DVB-H
308 UINT32 BurstCycleTime; //!< Current burst cycle time in mSec, valid only for DVB-H
309 UINT32 CalculatedBurstCycleTime;//!< Current burst cycle time in mSec, as calculated by demodulator, valid only for DVB-H
310 UINT32 NumOfRows; //!< Number of rows in MPE table, valid only for DVB-H
311 UINT32 NumOfPaddCols; //!< Number of padding columns in MPE table, valid only for DVB-H
312 UINT32 NumOfPunctCols; //!< Number of puncturing columns in MPE table, valid only for DVB-H
313 UINT32 ErrorTSPackets; //!< Number of erroneous transport-stream packets
314 UINT32 TotalTSPackets; //!< Total number of transport-stream packets
315 UINT32 NumOfValidMpeTlbs; //!< Number of MPE tables which do not include errors after MPE RS decoding
316 UINT32 NumOfInvalidMpeTlbs; //!< Number of MPE tables which include errors after MPE RS decoding
317 UINT32 NumOfCorrectedMpeTlbs; //!< Number of MPE tables which were corrected by MPE RS decoding
319 UINT32 BERErrorCount; //!< Number of errornous SYNC bits.
320 UINT32 BERBitCount; //!< Total number of SYNC bits.
322 /// Interface information
323 UINT32 SmsToHostTxErrors; //!< Total number of transmission errors.
326 UINT32 PreBER; //!< DAB/T-DMB only: Pre Viterbi BER [1E-5]
328 /// DVB-H TPS parameters
329 UINT32 CellId; //!< TPS Cell ID in bits 15..0, bits 31..16 zero; if set to 0xFFFFFFFF cell_id not yet recovered
331 } SMSHOSTLIB_STATISTICS_ST;
335 UINT32 RequestResult;
337 SMSHOSTLIB_STATISTICS_ST Stat;
339 // Split the calc of the SNR in DAB
340 UINT32 Signal; //!< dB
341 UINT32 Noise; //!< dB
343 } SmsMsgStatisticsInfo_ST;
345 typedef struct SMSHOSTLIB_ISDBT_LAYER_STAT_S
347 // Per-layer information
348 UINT32 CodeRate; //!< Code Rate from SMSHOSTLIB_CODE_RATE_ET, 255 means layer does not exist
349 UINT32 Constellation; //!< Constellation from SMSHOSTLIB_CONSTELLATION_ET, 255 means layer does not exist
350 UINT32 BER; //!< Post Viterbi BER [1E-5], 0xFFFFFFFF indicate N/A
351 UINT32 BERErrorCount; //!< Post Viterbi Error Bits Count
352 UINT32 BERBitCount; //!< Post Viterbi Total Bits Count
353 UINT32 PreBER; //!< Pre Viterbi BER [1E-5], 0xFFFFFFFF indicate N/A
354 UINT32 TS_PER; //!< Transport stream PER [%], 0xFFFFFFFF indicate N/A
355 UINT32 ErrorTSPackets; //!< Number of erroneous transport-stream packets
356 UINT32 TotalTSPackets; //!< Total number of transport-stream packets
357 UINT32 TILdepthI; //!< Time interleaver depth I parameter, 255 means layer does not exist
358 UINT32 NumberOfSegments; //!< Number of segments in layer A, 255 means layer does not exist
359 UINT32 TMCCErrors; //!< TMCC errors
360 } SMSHOSTLIB_ISDBT_LAYER_STAT_ST;
362 typedef struct SMSHOSTLIB_STATISTICS_ISDBT_S
364 UINT32 StatisticsType; //!< Enumerator identifying the type of the structure. Values are the same as SMSHOSTLIB_DEVICE_MODES_E
365 //!< This fiels MUST always first in any statistics structure
367 UINT32 FullSize; //!< Total size of the structure returned by the modem. If the size requested by
368 //!< the host is smaller than FullSize, the struct will be truncated
371 UINT32 IsRfLocked; //!< 0 - not locked, 1 - locked
372 UINT32 IsDemodLocked; //!< 0 - not locked, 1 - locked
373 UINT32 IsExternalLNAOn; //!< 0 - external LNA off, 1 - external LNA on
378 INT32 InBandPwr; //!< In band power in dBM
379 INT32 CarrierOffset; //!< Carrier Offset in Hz
381 // Transmission parameters
382 UINT32 Frequency; //!< Frequency in Hz
383 UINT32 Bandwidth; //!< Bandwidth in MHz
384 UINT32 TransmissionMode; //!< ISDB-T transmission mode
385 UINT32 ModemState; //!< 0 - Acquisition, 1 - Locked
386 UINT32 GuardInterval; //!< Guard Interval, 1 divided by value
387 UINT32 SystemType; //!< ISDB-T system type (ISDB-T / ISDB-Tsb)
388 UINT32 PartialReception; //!< TRUE - partial reception, FALSE otherwise
389 UINT32 NumOfLayers; //!< Number of ISDB-T layers in the network
391 // Per-layer information
393 SMSHOSTLIB_ISDBT_LAYER_STAT_ST LayerInfo[3]; //!< Per-layer statistics, see SMSHOSTLIB_ISDBT_LAYER_STAT_ST
395 // Interface information
396 UINT32 SmsToHostTxErrors; //!< Total number of transmission errors.
398 } SMSHOSTLIB_STATISTICS_ISDBT_ST;
400 typedef struct SMSHOSTLIB_STATISTICS_DVB_S
402 UINT32 StatisticsType; //!< Enumerator identifying the type of the structure. Values are the same as SMSHOSTLIB_DEVICE_MODES_E
403 //!< This fiels MUST always first in any statistics structure
405 UINT32 FullSize; //!< Total size of the structure returned by the modem. If the size requested by
406 //!< the host is smaller than FullSize, the struct will be truncated
408 UINT32 IsRfLocked; //!< 0 - not locked, 1 - locked
409 UINT32 IsDemodLocked; //!< 0 - not locked, 1 - locked
410 UINT32 IsExternalLNAOn; //!< 0 - external LNA off, 1 - external LNA on
414 UINT32 BER; //!< Post Viterbi BER [1E-5]
415 UINT32 BERErrorCount; //!< Number of errornous SYNC bits.
416 UINT32 BERBitCount; //!< Total number of SYNC bits.
417 UINT32 TS_PER; //!< Transport stream PER, 0xFFFFFFFF indicate N/A
418 UINT32 MFER; //!< DVB-H frame error rate in percentage, 0xFFFFFFFF indicate N/A, valid only for DVB-H
420 INT32 InBandPwr; //!< In band power in dBM
421 INT32 CarrierOffset; //!< Carrier Offset in bin/1024
423 // Transmission parameters
424 UINT32 Frequency; //!< Frequency in Hz
425 UINT32 Bandwidth; //!< Bandwidth in MHz
426 UINT32 ModemState; //!< from SMSHOSTLIB_DVB_MODEM_STATE_ET
427 UINT32 TransmissionMode; //!< FFT mode carriers in Kilos
428 UINT32 GuardInterval; //!< Guard Interval, 1 divided by value
429 UINT32 CodeRate; //!< Code Rate from SMSHOSTLIB_CODE_RATE_ET
430 UINT32 LPCodeRate; //!< Low Priority Code Rate from SMSHOSTLIB_CODE_RATE_ET
431 UINT32 Hierarchy; //!< Hierarchy from SMSHOSTLIB_HIERARCHY_ET
432 UINT32 Constellation; //!< Constellation from SMSHOSTLIB_CONSTELLATION_ET
434 // Burst parameters, valid only for DVB-H
435 UINT32 BurstSize; //!< Current burst size in bytes, valid only for DVB-H
436 UINT32 BurstDuration; //!< Current burst duration in mSec, valid only for DVB-H
437 UINT32 BurstCycleTime; //!< Current burst cycle time in mSec, valid only for DVB-H
438 UINT32 CalculatedBurstCycleTime;//!< Current burst cycle time in mSec, as calculated by demodulator, valid only for DVB-H
439 UINT32 NumOfRows; //!< Number of rows in MPE table, valid only for DVB-H
440 UINT32 NumOfPaddCols; //!< Number of padding columns in MPE table, valid only for DVB-H
441 UINT32 NumOfPunctCols; //!< Number of puncturing columns in MPE table, valid only for DVB-H
442 UINT32 ErrorTSPackets; //!< Number of erroneous transport-stream packets
443 UINT32 TotalTSPackets; //!< Total number of transport-stream packets
444 UINT32 NumOfValidMpeTlbs; //!< Number of MPE tables which do not include errors after MPE RS decoding, valid only for DVB-H
445 UINT32 NumOfInvalidMpeTlbs; //!< Number of MPE tables which include errors after MPE RS decoding, valid only for DVB-H
446 UINT32 NumOfCorrectedMpeTlbs; //!< Number of MPE tables which were corrected by MPE RS decoding, valid only for DVB-H
447 UINT32 NumMPEReceived; //!< DVB-H, Num MPE section received
449 // DVB-H TPS parameters
450 UINT32 CellId; //!< TPS Cell ID in bits 15..0, bits 31..16 zero; if set to 0xFFFFFFFF cell_id not yet recovered
451 UINT32 DvbhSrvIndHP; //!< DVB-H service indication info, bit 1 - Time Slicing indicator, bit 0 - MPE-FEC indicator
452 UINT32 DvbhSrvIndLP; //!< DVB-H service indication info, bit 1 - Time Slicing indicator, bit 0 - MPE-FEC indicator
454 // Interface information
455 UINT32 SmsToHostTxErrors; //!< Total number of transmission errors.
457 } SMSHOSTLIB_STATISTICS_DVB_ST;
459 typedef struct SMSHOSTLIB_GPIO_CONFIG_S
461 UINT8 Direction; //!< GPIO direction: Input - 0, Output - 1
462 UINT8 PullUpDown; //!< PullUp/PullDown: None - 0, PullDown - 1, PullUp - 2, Keeper - 3
463 UINT8 InputCharacteristics; //!< Input Characteristics: Normal - 0, Schmitt trigger - 1
464 UINT8 OutputSlewRate; //!< Output Slew Rate: Fast slew rate - 0, Slow slew rate - 1
465 UINT8 OutputDriving; //!< Output driving capability: 4mA - 0, 8mA - 1, 12mA - 2, 16mA - 3
466 } SMSHOSTLIB_GPIO_CONFIG_ST;
468 typedef struct SMSHOSTLIB_I2C_REQ_S
470 UINT32 DeviceAddress; // I2c device address
471 UINT32 WriteCount; // number of bytes to write
472 UINT32 ReadCount; // number of bytes to read
474 } SMSHOSTLIB_I2C_REQ_ST;
476 typedef struct SMSHOSTLIB_I2C_RES_S
478 UINT32 Status; // non-zero value in case of failure
479 UINT32 ReadCount; // number of bytes read
481 } SMSHOSTLIB_I2C_RES_ST;
483 typedef struct _smsdvb_client
485 struct list_head entry;
487 smscore_device_t *coredev;
488 smscore_client_t *smsclient;
490 struct dvb_adapter adapter;
491 struct dvb_demux demux;
492 struct dmxdev dmxdev;
493 struct dvb_frontend frontend;
495 fe_status_t fe_status;
496 int fe_ber, fe_snr, fe_signal_strength;
498 struct completion tune_done, stat_done;
500 // todo: save freq/band instead whole struct
501 struct dvb_frontend_parameters fe_params;
505 extern void smscore_registry_setmode(char *devpath, int mode);
506 extern int smscore_registry_getmode(char *devpath);
508 extern int smscore_register_hotplug(hotplug_t hotplug);
509 extern void smscore_unregister_hotplug(hotplug_t hotplug);
511 extern int smscore_register_device(smsdevice_params_t *params, smscore_device_t **coredev);
512 extern void smscore_unregister_device(smscore_device_t *coredev);
514 extern int smscore_start_device(smscore_device_t *coredev);
515 extern int smscore_load_firmware(smscore_device_t *coredev, char *filename,
516 loadfirmware_t loadfirmware_handler);
518 extern int smscore_load_firmware_from_buffer(smscore_device_t *coredev, u8 *buffer, int size, int new_mode);
520 extern int smscore_set_device_mode(smscore_device_t *coredev, int mode);
521 extern int smscore_get_device_mode(smscore_device_t *coredev);
523 extern int smscore_register_client(smscore_device_t *coredev,
524 smsclient_params_t *params,
525 smscore_client_t **client);
526 extern void smscore_unregister_client(smscore_client_t *client);
528 extern int smsclient_sendrequest(smscore_client_t *client, void *buffer, size_t size);
529 extern void smscore_onresponse(smscore_device_t *coredev, smscore_buffer_t *cb);
531 extern int smscore_get_common_buffer_size(smscore_device_t *coredev);
532 extern int smscore_map_common_buffer(smscore_device_t *coredev,
533 struct vm_area_struct *vma);
535 extern smscore_buffer_t *smscore_getbuffer(smscore_device_t *coredev);
536 extern void smscore_putbuffer(smscore_device_t *coredev, smscore_buffer_t *cb);
539 int smsdvb_register(void);
540 void smsdvb_unregister(void);
543 int smsusb_register(void);
544 void smsusb_unregister(void);
546 #endif // __smscoreapi_h__