#include #include #include #include #include "drxk_type.h" #include "mt2063.h" /* Version of this module */ #define MT2063_VERSION 10018 /* Version 01.18 */ static unsigned int verbose; module_param(verbose, int, 0644); //i2c operation static int mt2063_writeregs(struct mt2063_state *state, u8 reg1, u8 * data, int len) { int ret; u8 buf[60]; /* = { reg1, data }; */ struct i2c_msg msg = { .addr = state->config->tuner_address, .flags = 0, .buf = buf, .len = len + 1 }; msg.buf[0] = reg1; memcpy(msg.buf + 1, data, len); //printk("mt2063_writeregs state->i2c=%p\n", state->i2c); ret = i2c_transfer(state->i2c, &msg, 1); if (ret < 0) printk("mt2063_writeregs error ret=%d\n", ret); return ret; } static int mt2063_read_regs(struct mt2063_state *state, u8 reg1, u8 * b, u8 len) { int ret; u8 b0[] = { reg1 }; struct i2c_msg msg[] = { { .addr = state->config->tuner_address, .flags = I2C_M_RD, .buf = b0, .len = 1}, { .addr = state->config->tuner_address, .flags = I2C_M_RD, .buf = b, .len = len} }; //printk("mt2063_read_regs state->i2c=%p\n", state->i2c); ret = i2c_transfer(state->i2c, msg, 2); if (ret < 0) printk("mt2063_readregs error ret=%d\n", ret); return ret; } //context of mt2063_userdef.c ====================================== //################################################################# //================================================================= /***************************************************************************** ** ** Name: MT_WriteSub ** ** Description: Write values to device using a two-wire serial bus. ** ** Parameters: hUserData - User-specific I/O parameter that was ** passed to tuner's Open function. ** addr - device serial bus address (value passed ** as parameter to MTxxxx_Open) ** subAddress - serial bus sub-address (Register Address) ** pData - pointer to the Data to be written to the ** device ** cnt - number of bytes/registers to be written ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** user-defined ** ** Notes: This is a callback function that is called from the ** the tuning algorithm. You MUST provide code for this ** function to write data using the tuner's 2-wire serial ** bus. ** ** The hUserData parameter is a user-specific argument. ** If additional arguments are needed for the user's ** serial bus read/write functions, this argument can be ** used to supply the necessary information. ** The hUserData parameter is initialized in the tuner's Open ** function. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** N/A 03-25-2004 DAD Original ** *****************************************************************************/ UData_t MT2063_WriteSub(Handle_t hUserData, UData_t addr, U8Data subAddress, U8Data * pData, UData_t cnt) { UData_t status = MT2063_OK; /* Status to be returned */ struct dvb_frontend *fe = hUserData; struct mt2063_state *state = fe->tuner_priv; /* ** ToDo: Add code here to implement a serial-bus write ** operation to the MTxxxx tuner. If successful, ** return MT_OK. */ /* return status; */ //#if !TUNER_CONTROL_BY_DRXK_DRIVER fe->ops.i2c_gate_ctrl(fe, 1); //I2C bypass drxk3926 close i2c bridge //#endif if (mt2063_writeregs(state, subAddress, pData, cnt) < 0) { status = MT2063_ERROR; } //#if !TUNER_CONTROL_BY_DRXK_DRIVER fe->ops.i2c_gate_ctrl(fe, 0); //I2C bypass drxk3926 close i2c bridge //#endif return (status); } /***************************************************************************** ** ** Name: MT_ReadSub ** ** Description: Read values from device using a two-wire serial bus. ** ** Parameters: hUserData - User-specific I/O parameter that was ** passed to tuner's Open function. ** addr - device serial bus address (value passed ** as parameter to MTxxxx_Open) ** subAddress - serial bus sub-address (Register Address) ** pData - pointer to the Data to be written to the ** device ** cnt - number of bytes/registers to be written ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** user-defined ** ** Notes: This is a callback function that is called from the ** the tuning algorithm. You MUST provide code for this ** function to read data using the tuner's 2-wire serial ** bus. ** ** The hUserData parameter is a user-specific argument. ** If additional arguments are needed for the user's ** serial bus read/write functions, this argument can be ** used to supply the necessary information. ** The hUserData parameter is initialized in the tuner's Open ** function. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** N/A 03-25-2004 DAD Original ** *****************************************************************************/ UData_t MT2063_ReadSub(Handle_t hUserData, UData_t addr, U8Data subAddress, U8Data * pData, UData_t cnt) { /* ** ToDo: Add code here to implement a serial-bus read ** operation to the MTxxxx tuner. If successful, ** return MT_OK. */ /* return status; */ UData_t status = MT2063_OK; /* Status to be returned */ struct dvb_frontend *fe = hUserData; struct mt2063_state *state = fe->tuner_priv; UData_t i = 0; //#if !TUNER_CONTROL_BY_DRXK_DRIVER fe->ops.i2c_gate_ctrl(fe, 1); //I2C bypass drxk3926 close i2c bridge //#endif for (i = 0; i < cnt; i++) { if (mt2063_read_regs(state, subAddress + i, pData + i, 1) < 0) { status = MT2063_ERROR; break; } } //#if !TUNER_CONTROL_BY_DRXK_DRIVER fe->ops.i2c_gate_ctrl(fe, 0); //I2C bypass drxk3926 close i2c bridge //#endif return (status); } /***************************************************************************** ** ** Name: MT_Sleep ** ** Description: Delay execution for "nMinDelayTime" milliseconds ** ** Parameters: hUserData - User-specific I/O parameter that was ** passed to tuner's Open function. ** nMinDelayTime - Delay time in milliseconds ** ** Returns: None. ** ** Notes: This is a callback function that is called from the ** the tuning algorithm. You MUST provide code that ** blocks execution for the specified period of time. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** N/A 03-25-2004 DAD Original ** *****************************************************************************/ void MT2063_Sleep(Handle_t hUserData, UData_t nMinDelayTime) { /* ** ToDo: Add code here to implement a OS blocking ** for a period of "nMinDelayTime" milliseconds. */ msleep(nMinDelayTime); } #if defined(MT2060_CNT) #if MT2060_CNT > 0 /***************************************************************************** ** ** Name: MT_TunerGain (MT2060 only) ** ** Description: Measure the relative tuner gain using the demodulator ** ** Parameters: hUserData - User-specific I/O parameter that was ** passed to tuner's Open function. ** pMeas - Tuner gain (1/100 of dB scale). ** ie. 1234 = 12.34 (dB) ** ** Returns: status: ** MT_OK - No errors ** user-defined errors could be set ** ** Notes: This is a callback function that is called from the ** the 1st IF location routine. You MUST provide ** code that measures the relative tuner gain in a dB ** (not linear) scale. The return value is an integer ** value scaled to 1/100 of a dB. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** N/A 06-16-2004 DAD Original ** N/A 11-30-2004 DAD Renamed from MT_DemodInputPower. This name ** better describes what this function does. ** *****************************************************************************/ UData_t MT2060_TunerGain(Handle_t hUserData, SData_t * pMeas) { UData_t status = MT2063_OK; /* Status to be returned */ /* ** ToDo: Add code here to return the gain / power level measured ** at the input to the demodulator. */ return (status); } #endif #endif //end of mt2063_userdef.c //================================================================= //################################################################# //================================================================= //context of mt2063_spuravoid.c ====================================== //################################################################# //================================================================= /***************************************************************************** ** ** Name: mt_spuravoid.c ** ** Description: Microtune spur avoidance software module. ** Supports Microtune tuner drivers. ** ** CVS ID: $Id: mt_spuravoid.c,v 1.3 2008/06/26 15:39:52 software Exp $ ** CVS Source: $Source: /export/home/cvsroot/software/tuners/MT2063/mt_spuravoid.c,v $ ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 082 03-25-2005 JWS Original multi-tuner support - requires ** MTxxxx_CNT declarations ** 096 04-06-2005 DAD Ver 1.11: Fix divide by 0 error if maxH==0. ** 094 04-06-2005 JWS Ver 1.11 Added uceil and ufloor to get rid ** of compiler warnings ** N/A 04-07-2005 DAD Ver 1.13: Merged single- and multi-tuner spur ** avoidance into a single module. ** 103 01-31-2005 DAD Ver 1.14: In MT_AddExclZone(), if the range ** (f_min, f_max) < 0, ignore the entry. ** 115 03-23-2007 DAD Fix declaration of spur due to truncation ** errors. ** 117 03-29-2007 RSK Ver 1.15: Re-wrote to match search order from ** tuner DLL. ** 137 06-18-2007 DAD Ver 1.16: Fix possible divide-by-0 error for ** multi-tuners that have ** (delta IF1) > (f_out-f_outbw/2). ** 147 07-27-2007 RSK Ver 1.17: Corrected calculation (-) to (+) ** Added logic to force f_Center within 1/2 f_Step. ** 177 S 02-26-2008 RSK Ver 1.18: Corrected calculation using LO1 > MAX/2 ** Type casts added to preserve correct sign. ** N/A I 06-17-2008 RSK Ver 1.19: Refactoring avoidance of DECT ** frequencies into MT_ResetExclZones(). ** N/A I 06-20-2008 RSK Ver 1.21: New VERSION number for ver checking. ** *****************************************************************************/ #if !defined(MT2063_TUNER_CNT) #error MT2063_TUNER_CNT is not defined (see mt_userdef.h) #endif #if MT2063_TUNER_CNT == 0 #error MT2063_TUNER_CNT must be updated in mt_userdef.h #endif /* Version of this module */ #define MT2063_SPUR_VERSION 10201 /* Version 01.21 */ /* Implement ceiling, floor functions. */ #define ceil(n, d) (((n) < 0) ? (-((-(n))/(d))) : (n)/(d) + ((n)%(d) != 0)) #define uceil(n, d) ((n)/(d) + ((n)%(d) != 0)) #define floor(n, d) (((n) < 0) ? (-((-(n))/(d))) - ((n)%(d) != 0) : (n)/(d)) #define ufloor(n, d) ((n)/(d)) struct MT2063_FIFZone_t { SData_t min_; SData_t max_; }; #if MT2063_TUNER_CNT > 1 static struct MT2063_AvoidSpursData_t *TunerList[MT2063_TUNER_CNT]; static UData_t TunerCount = 0; #endif UData_t MT2063_RegisterTuner(struct MT2063_AvoidSpursData_t *pAS_Info) { #if MT2063_TUNER_CNT == 1 pAS_Info->nAS_Algorithm = 1; return MT2063_OK; #else UData_t index; pAS_Info->nAS_Algorithm = 2; /* ** Check to see if tuner is already registered */ for (index = 0; index < TunerCount; index++) { if (TunerList[index] == pAS_Info) { return MT2063_OK; /* Already here - no problem */ } } /* ** Add tuner to list - if there is room. */ if (TunerCount < MT2063_TUNER_CNT) { TunerList[TunerCount] = pAS_Info; TunerCount++; return MT2063_OK; } else return MT2063_TUNER_CNT_ERR; #endif } void MT2063_UnRegisterTuner(struct MT2063_AvoidSpursData_t *pAS_Info) { #if MT2063_TUNER_CNT == 1 pAS_Info; #else UData_t index; for (index = 0; index < TunerCount; index++) { if (TunerList[index] == pAS_Info) { TunerList[index] = TunerList[--TunerCount]; } } #endif } /* ** Reset all exclusion zones. ** Add zones to protect the PLL FracN regions near zero ** ** N/A I 06-17-2008 RSK Ver 1.19: Refactoring avoidance of DECT ** frequencies into MT_ResetExclZones(). */ void MT2063_ResetExclZones(struct MT2063_AvoidSpursData_t *pAS_Info) { UData_t center; #if MT2063_TUNER_CNT > 1 UData_t index; struct MT2063_AvoidSpursData_t *adj; #endif pAS_Info->nZones = 0; /* this clears the used list */ pAS_Info->usedZones = NULL; /* reset ptr */ pAS_Info->freeZones = NULL; /* reset ptr */ center = pAS_Info->f_ref * ((pAS_Info->f_if1_Center - pAS_Info->f_if1_bw / 2 + pAS_Info->f_in) / pAS_Info->f_ref) - pAS_Info->f_in; while (center < pAS_Info->f_if1_Center + pAS_Info->f_if1_bw / 2 + pAS_Info->f_LO1_FracN_Avoid) { /* Exclude LO1 FracN */ MT2063_AddExclZone(pAS_Info, center - pAS_Info->f_LO1_FracN_Avoid, center - 1); MT2063_AddExclZone(pAS_Info, center + 1, center + pAS_Info->f_LO1_FracN_Avoid); center += pAS_Info->f_ref; } center = pAS_Info->f_ref * ((pAS_Info->f_if1_Center - pAS_Info->f_if1_bw / 2 - pAS_Info->f_out) / pAS_Info->f_ref) + pAS_Info->f_out; while (center < pAS_Info->f_if1_Center + pAS_Info->f_if1_bw / 2 + pAS_Info->f_LO2_FracN_Avoid) { /* Exclude LO2 FracN */ MT2063_AddExclZone(pAS_Info, center - pAS_Info->f_LO2_FracN_Avoid, center - 1); MT2063_AddExclZone(pAS_Info, center + 1, center + pAS_Info->f_LO2_FracN_Avoid); center += pAS_Info->f_ref; } if (MT2063_EXCLUDE_US_DECT_FREQUENCIES(pAS_Info->avoidDECT)) { /* Exclude LO1 values that conflict with DECT channels */ MT2063_AddExclZone(pAS_Info, 1920836000 - pAS_Info->f_in, 1922236000 - pAS_Info->f_in); /* Ctr = 1921.536 */ MT2063_AddExclZone(pAS_Info, 1922564000 - pAS_Info->f_in, 1923964000 - pAS_Info->f_in); /* Ctr = 1923.264 */ MT2063_AddExclZone(pAS_Info, 1924292000 - pAS_Info->f_in, 1925692000 - pAS_Info->f_in); /* Ctr = 1924.992 */ MT2063_AddExclZone(pAS_Info, 1926020000 - pAS_Info->f_in, 1927420000 - pAS_Info->f_in); /* Ctr = 1926.720 */ MT2063_AddExclZone(pAS_Info, 1927748000 - pAS_Info->f_in, 1929148000 - pAS_Info->f_in); /* Ctr = 1928.448 */ } if (MT2063_EXCLUDE_EURO_DECT_FREQUENCIES(pAS_Info->avoidDECT)) { MT2063_AddExclZone(pAS_Info, 1896644000 - pAS_Info->f_in, 1898044000 - pAS_Info->f_in); /* Ctr = 1897.344 */ MT2063_AddExclZone(pAS_Info, 1894916000 - pAS_Info->f_in, 1896316000 - pAS_Info->f_in); /* Ctr = 1895.616 */ MT2063_AddExclZone(pAS_Info, 1893188000 - pAS_Info->f_in, 1894588000 - pAS_Info->f_in); /* Ctr = 1893.888 */ MT2063_AddExclZone(pAS_Info, 1891460000 - pAS_Info->f_in, 1892860000 - pAS_Info->f_in); /* Ctr = 1892.16 */ MT2063_AddExclZone(pAS_Info, 1889732000 - pAS_Info->f_in, 1891132000 - pAS_Info->f_in); /* Ctr = 1890.432 */ MT2063_AddExclZone(pAS_Info, 1888004000 - pAS_Info->f_in, 1889404000 - pAS_Info->f_in); /* Ctr = 1888.704 */ MT2063_AddExclZone(pAS_Info, 1886276000 - pAS_Info->f_in, 1887676000 - pAS_Info->f_in); /* Ctr = 1886.976 */ MT2063_AddExclZone(pAS_Info, 1884548000 - pAS_Info->f_in, 1885948000 - pAS_Info->f_in); /* Ctr = 1885.248 */ MT2063_AddExclZone(pAS_Info, 1882820000 - pAS_Info->f_in, 1884220000 - pAS_Info->f_in); /* Ctr = 1883.52 */ MT2063_AddExclZone(pAS_Info, 1881092000 - pAS_Info->f_in, 1882492000 - pAS_Info->f_in); /* Ctr = 1881.792 */ } #if MT2063_TUNER_CNT > 1 /* ** Iterate through all adjacent tuners and exclude frequencies related to them */ for (index = 0; index < TunerCount; ++index) { adj = TunerList[index]; if (pAS_Info == adj) /* skip over our own data, don't process it */ continue; /* ** Add 1st IF exclusion zone covering adjacent tuner's LO2 ** at "adjfLO2 + f_out" +/- m_MinLOSpacing */ if (adj->f_LO2 != 0) MT2063_AddExclZone(pAS_Info, (adj->f_LO2 + pAS_Info->f_out) - pAS_Info->f_min_LO_Separation, (adj->f_LO2 + pAS_Info->f_out) + pAS_Info->f_min_LO_Separation); /* ** Add 1st IF exclusion zone covering adjacent tuner's LO1 ** at "adjfLO1 - f_in" +/- m_MinLOSpacing */ if (adj->f_LO1 != 0) MT2063_AddExclZone(pAS_Info, (adj->f_LO1 - pAS_Info->f_in) - pAS_Info->f_min_LO_Separation, (adj->f_LO1 - pAS_Info->f_in) + pAS_Info->f_min_LO_Separation); } #endif } static struct MT2063_ExclZone_t *InsertNode(struct MT2063_AvoidSpursData_t *pAS_Info, struct MT2063_ExclZone_t *pPrevNode) { struct MT2063_ExclZone_t *pNode; /* Check for a node in the free list */ if (pAS_Info->freeZones != NULL) { /* Use one from the free list */ pNode = pAS_Info->freeZones; pAS_Info->freeZones = pNode->next_; } else { /* Grab a node from the array */ pNode = &pAS_Info->MT2063_ExclZones[pAS_Info->nZones]; } if (pPrevNode != NULL) { pNode->next_ = pPrevNode->next_; pPrevNode->next_ = pNode; } else { /* insert at the beginning of the list */ pNode->next_ = pAS_Info->usedZones; pAS_Info->usedZones = pNode; } pAS_Info->nZones++; return pNode; } static struct MT2063_ExclZone_t *RemoveNode(struct MT2063_AvoidSpursData_t *pAS_Info, struct MT2063_ExclZone_t *pPrevNode, struct MT2063_ExclZone_t *pNodeToRemove) { struct MT2063_ExclZone_t *pNext = pNodeToRemove->next_; /* Make previous node point to the subsequent node */ if (pPrevNode != NULL) pPrevNode->next_ = pNext; /* Add pNodeToRemove to the beginning of the freeZones */ pNodeToRemove->next_ = pAS_Info->freeZones; pAS_Info->freeZones = pNodeToRemove; /* Decrement node count */ pAS_Info->nZones--; return pNext; } /***************************************************************************** ** ** Name: MT_AddExclZone ** ** Description: Add (and merge) an exclusion zone into the list. ** If the range (f_min, f_max) is totally outside the ** 1st IF BW, ignore the entry. ** If the range (f_min, f_max) is negative, ignore the entry. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 103 01-31-2005 DAD Ver 1.14: In MT_AddExclZone(), if the range ** (f_min, f_max) < 0, ignore the entry. ** *****************************************************************************/ void MT2063_AddExclZone(struct MT2063_AvoidSpursData_t *pAS_Info, UData_t f_min, UData_t f_max) { struct MT2063_ExclZone_t *pNode = pAS_Info->usedZones; struct MT2063_ExclZone_t *pPrev = NULL; struct MT2063_ExclZone_t *pNext = NULL; /* Check to see if this overlaps the 1st IF filter */ if ((f_max > (pAS_Info->f_if1_Center - (pAS_Info->f_if1_bw / 2))) && (f_min < (pAS_Info->f_if1_Center + (pAS_Info->f_if1_bw / 2))) && (f_min < f_max)) { /* ** 1 2 3 4 5 6 ** ** New entry: |---| |--| |--| |-| |---| |--| ** or or or or or ** Existing: |--| |--| |--| |---| |-| |--| */ /* Check for our place in the list */ while ((pNode != NULL) && (pNode->max_ < f_min)) { pPrev = pNode; pNode = pNode->next_; } if ((pNode != NULL) && (pNode->min_ < f_max)) { /* Combine me with pNode */ if (f_min < pNode->min_) pNode->min_ = f_min; if (f_max > pNode->max_) pNode->max_ = f_max; } else { pNode = InsertNode(pAS_Info, pPrev); pNode->min_ = f_min; pNode->max_ = f_max; } /* Look for merging possibilities */ pNext = pNode->next_; while ((pNext != NULL) && (pNext->min_ < pNode->max_)) { if (pNext->max_ > pNode->max_) pNode->max_ = pNext->max_; pNext = RemoveNode(pAS_Info, pNode, pNext); /* Remove pNext, return ptr to pNext->next */ } } } /***************************************************************************** ** ** Name: MT_ChooseFirstIF ** ** Description: Choose the best available 1st IF ** If f_Desired is not excluded, choose that first. ** Otherwise, return the value closest to f_Center that is ** not excluded ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 117 03-29-2007 RSK Ver 1.15: Re-wrote to match search order from ** tuner DLL. ** 147 07-27-2007 RSK Ver 1.17: Corrected calculation (-) to (+) ** Added logic to force f_Center within 1/2 f_Step. ** *****************************************************************************/ UData_t MT2063_ChooseFirstIF(struct MT2063_AvoidSpursData_t *pAS_Info) { /* ** Update "f_Desired" to be the nearest "combinational-multiple" of "f_LO1_Step". ** The resulting number, F_LO1 must be a multiple of f_LO1_Step. And F_LO1 is the arithmetic sum ** of f_in + f_Center. Neither f_in, nor f_Center must be a multiple of f_LO1_Step. ** However, the sum must be. */ const UData_t f_Desired = pAS_Info->f_LO1_Step * ((pAS_Info->f_if1_Request + pAS_Info->f_in + pAS_Info->f_LO1_Step / 2) / pAS_Info->f_LO1_Step) - pAS_Info->f_in; const UData_t f_Step = (pAS_Info->f_LO1_Step > pAS_Info->f_LO2_Step) ? pAS_Info->f_LO1_Step : pAS_Info-> f_LO2_Step; UData_t f_Center; SData_t i; SData_t j = 0; UData_t bDesiredExcluded = 0; UData_t bZeroExcluded = 0; SData_t tmpMin, tmpMax; SData_t bestDiff; struct MT2063_ExclZone_t *pNode = pAS_Info->usedZones; struct MT2063_FIFZone_t zones[MT2063_MAX_ZONES]; if (pAS_Info->nZones == 0) return f_Desired; /* f_Center needs to be an integer multiple of f_Step away from f_Desired */ if (pAS_Info->f_if1_Center > f_Desired) f_Center = f_Desired + f_Step * ((pAS_Info->f_if1_Center - f_Desired + f_Step / 2) / f_Step); else f_Center = f_Desired - f_Step * ((f_Desired - pAS_Info->f_if1_Center + f_Step / 2) / f_Step); //assert; //if (!abs((SData_t) f_Center - (SData_t) pAS_Info->f_if1_Center) <= (SData_t) (f_Step/2)) // return 0; /* Take MT_ExclZones, center around f_Center and change the resolution to f_Step */ while (pNode != NULL) { /* floor function */ tmpMin = floor((SData_t) (pNode->min_ - f_Center), (SData_t) f_Step); /* ceil function */ tmpMax = ceil((SData_t) (pNode->max_ - f_Center), (SData_t) f_Step); if ((pNode->min_ < f_Desired) && (pNode->max_ > f_Desired)) bDesiredExcluded = 1; if ((tmpMin < 0) && (tmpMax > 0)) bZeroExcluded = 1; /* See if this zone overlaps the previous */ if ((j > 0) && (tmpMin < zones[j - 1].max_)) zones[j - 1].max_ = tmpMax; else { /* Add new zone */ //assert(j=MT2063_MAX_ZONES) //break; zones[j].min_ = tmpMin; zones[j].max_ = tmpMax; j++; } pNode = pNode->next_; } /* ** If the desired is okay, return with it */ if (bDesiredExcluded == 0) return f_Desired; /* ** If the desired is excluded and the center is okay, return with it */ if (bZeroExcluded == 0) return f_Center; /* Find the value closest to 0 (f_Center) */ bestDiff = zones[0].min_; for (i = 0; i < j; i++) { if (abs(zones[i].min_) < abs(bestDiff)) bestDiff = zones[i].min_; if (abs(zones[i].max_) < abs(bestDiff)) bestDiff = zones[i].max_; } if (bestDiff < 0) return f_Center - ((UData_t) (-bestDiff) * f_Step); return f_Center + (bestDiff * f_Step); } /**************************************************************************** ** ** Name: gcd ** ** Description: Uses Euclid's algorithm ** ** Parameters: u, v - unsigned values whose GCD is desired. ** ** Global: None ** ** Returns: greatest common divisor of u and v, if either value ** is 0, the other value is returned as the result. ** ** Dependencies: None. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** N/A 06-01-2004 JWS Original ** N/A 08-03-2004 DAD Changed to Euclid's since it can handle ** unsigned numbers. ** ****************************************************************************/ static UData_t MT2063_gcd(UData_t u, UData_t v) { UData_t r; while (v != 0) { r = u % v; u = v; v = r; } return u; } /**************************************************************************** ** ** Name: umax ** ** Description: Implements a simple maximum function for unsigned numbers. ** Implemented as a function rather than a macro to avoid ** multiple evaluation of the calling parameters. ** ** Parameters: a, b - Values to be compared ** ** Global: None ** ** Returns: larger of the input values. ** ** Dependencies: None. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** N/A 06-02-2004 JWS Original ** ****************************************************************************/ static UData_t MT2063_umax(UData_t a, UData_t b) { return (a >= b) ? a : b; } #if MT2063_TUNER_CNT > 1 static SData_t RoundAwayFromZero(SData_t n, SData_t d) { return (n < 0) ? floor(n, d) : ceil(n, d); } /**************************************************************************** ** ** Name: IsSpurInAdjTunerBand ** ** Description: Checks to see if a spur will be present within the IF's ** bandwidth or near the zero IF. ** (fIFOut +/- fIFBW/2, -fIFOut +/- fIFBW/2) ** and ** (0 +/- fZIFBW/2) ** ** ma mb me mf mc md ** <--+-+-+-----------------+-+-+-----------------+-+-+--> ** | ^ 0 ^ | ** ^ b=-fIFOut+fIFBW/2 -b=+fIFOut-fIFBW/2 ^ ** a=-fIFOut-fIFBW/2 -a=+fIFOut+fIFBW/2 ** ** Note that some equations are doubled to prevent round-off ** problems when calculating fIFBW/2 ** ** The spur frequencies are computed as: ** ** fSpur = n * f1 - m * f2 - fOffset ** ** Parameters: f1 - The 1st local oscillator (LO) frequency ** of the tuner whose output we are examining ** f2 - The 1st local oscillator (LO) frequency ** of the adjacent tuner ** fOffset - The 2nd local oscillator of the tuner whose ** output we are examining ** fIFOut - Output IF center frequency ** fIFBW - Output IF Bandwidth ** nMaxH - max # of LO harmonics to search ** fp - If spur, positive distance to spur-free band edge (returned) ** fm - If spur, negative distance to spur-free band edge (returned) ** ** Returns: 1 if an LO spur would be present, otherwise 0. ** ** Dependencies: None. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** N/A 01-21-2005 JWS Original, adapted from MT_DoubleConversion. ** 115 03-23-2007 DAD Fix declaration of spur due to truncation ** errors. ** 137 06-18-2007 DAD Ver 1.16: Fix possible divide-by-0 error for ** multi-tuners that have ** (delta IF1) > (f_out-f_outbw/2). ** 177 S 02-26-2008 RSK Ver 1.18: Corrected calculation using LO1 > MAX/2 ** Type casts added to preserve correct sign. ** ****************************************************************************/ static UData_t IsSpurInAdjTunerBand(UData_t bIsMyOutput, UData_t f1, UData_t f2, UData_t fOffset, UData_t fIFOut, UData_t fIFBW, UData_t fZIFBW, UData_t nMaxH, UData_t * fp, UData_t * fm) { UData_t bSpurFound = 0; const UData_t fHalf_IFBW = fIFBW / 2; const UData_t fHalf_ZIFBW = fZIFBW / 2; /* Calculate a scale factor for all frequencies, so that our calculations all stay within 31 bits */ const UData_t f_Scale = ((f1 + (fOffset + fIFOut + fHalf_IFBW) / nMaxH) / (MAX_UDATA / 2 / nMaxH)) + 1; /* ** After this scaling, _f1, _f2, and _f3 are guaranteed to fit into ** signed data types (smaller than MAX_UDATA/2) */ const SData_t _f1 = (SData_t) (f1 / f_Scale); const SData_t _f2 = (SData_t) (f2 / f_Scale); const SData_t _f3 = (SData_t) (fOffset / f_Scale); const SData_t c = (SData_t) (fIFOut - fHalf_IFBW) / (SData_t) f_Scale; const SData_t d = (SData_t) ((fIFOut + fHalf_IFBW) / f_Scale); const SData_t f = (SData_t) (fHalf_ZIFBW / f_Scale); SData_t ma, mb, mc, md, me, mf; SData_t fp_ = 0; SData_t fm_ = 0; SData_t n; /* ** If the other tuner does not have an LO frequency defined, ** assume that we cannot interfere with it */ if (f2 == 0) return 0; /* Check out all multiples of f1 from -nMaxH to +nMaxH */ for (n = -(SData_t) nMaxH; n <= (SData_t) nMaxH; ++n) { const SData_t nf1 = n * _f1; md = (_f3 + d - nf1) / _f2; /* If # f2 harmonics > nMaxH, then no spurs present */ if (md <= -(SData_t) nMaxH) break; ma = (_f3 - d - nf1) / _f2; if ((ma == md) || (ma >= (SData_t) (nMaxH))) continue; mc = (_f3 + c - nf1) / _f2; if (mc != md) { const SData_t m = (n < 0) ? md : mc; const SData_t fspur = (nf1 + m * _f2 - _f3); const SData_t den = (bIsMyOutput ? n - 1 : n); if (den == 0) { fp_ = (d - fspur) * f_Scale; fm_ = (fspur - c) * f_Scale; } else { fp_ = (SData_t) RoundAwayFromZero((d - fspur) * f_Scale, den); fm_ = (SData_t) RoundAwayFromZero((fspur - c) * f_Scale, den); } if (((UData_t) abs(fm_) >= f_Scale) && ((UData_t) abs(fp_) >= f_Scale)) { bSpurFound = 1; break; } } /* Location of Zero-IF-spur to be checked */ mf = (_f3 + f - nf1) / _f2; me = (_f3 - f - nf1) / _f2; if (me != mf) { const SData_t m = (n < 0) ? mf : me; const SData_t fspur = (nf1 + m * _f2 - _f3); const SData_t den = (bIsMyOutput ? n - 1 : n); if (den == 0) { fp_ = (d - fspur) * f_Scale; fm_ = (fspur - c) * f_Scale; } else { fp_ = (SData_t) RoundAwayFromZero((f - fspur) * f_Scale, den); fm_ = (SData_t) RoundAwayFromZero((fspur + f) * f_Scale, den); } if (((UData_t) abs(fm_) >= f_Scale) && ((UData_t) abs(fp_) >= f_Scale)) { bSpurFound = 1; break; } } mb = (_f3 - c - nf1) / _f2; if (ma != mb) { const SData_t m = (n < 0) ? mb : ma; const SData_t fspur = (nf1 + m * _f2 - _f3); const SData_t den = (bIsMyOutput ? n - 1 : n); if (den == 0) { fp_ = (d - fspur) * f_Scale; fm_ = (fspur - c) * f_Scale; } else { fp_ = (SData_t) RoundAwayFromZero((-c - fspur) * f_Scale, den); fm_ = (SData_t) RoundAwayFromZero((fspur + d) * f_Scale, den); } if (((UData_t) abs(fm_) >= f_Scale) && ((UData_t) abs(fp_) >= f_Scale)) { bSpurFound = 1; break; } } } /* ** Verify that fm & fp are both positive ** Add one to ensure next 1st IF choice is not right on the edge */ if (fp_ < 0) { *fp = -fm_ + 1; *fm = -fp_ + 1; } else if (fp_ > 0) { *fp = fp_ + 1; *fm = fm_ + 1; } else { *fp = 1; *fm = abs(fm_) + 1; } return bSpurFound; } #endif /**************************************************************************** ** ** Name: IsSpurInBand ** ** Description: Checks to see if a spur will be present within the IF's ** bandwidth. (fIFOut +/- fIFBW, -fIFOut +/- fIFBW) ** ** ma mb mc md ** <--+-+-+-------------------+-------------------+-+-+--> ** | ^ 0 ^ | ** ^ b=-fIFOut+fIFBW/2 -b=+fIFOut-fIFBW/2 ^ ** a=-fIFOut-fIFBW/2 -a=+fIFOut+fIFBW/2 ** ** Note that some equations are doubled to prevent round-off ** problems when calculating fIFBW/2 ** ** Parameters: pAS_Info - Avoid Spurs information block ** fm - If spur, amount f_IF1 has to move negative ** fp - If spur, amount f_IF1 has to move positive ** ** Global: None ** ** Returns: 1 if an LO spur would be present, otherwise 0. ** ** Dependencies: None. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** N/A 11-28-2002 DAD Implemented algorithm from applied patent ** ****************************************************************************/ static UData_t IsSpurInBand(struct MT2063_AvoidSpursData_t *pAS_Info, UData_t * fm, UData_t * fp) { /* ** Calculate LO frequency settings. */ UData_t n, n0; const UData_t f_LO1 = pAS_Info->f_LO1; const UData_t f_LO2 = pAS_Info->f_LO2; const UData_t d = pAS_Info->f_out + pAS_Info->f_out_bw / 2; const UData_t c = d - pAS_Info->f_out_bw; const UData_t f = pAS_Info->f_zif_bw / 2; const UData_t f_Scale = (f_LO1 / (MAX_UDATA / 2 / pAS_Info->maxH1)) + 1; SData_t f_nsLO1, f_nsLO2; SData_t f_Spur; UData_t ma, mb, mc, md, me, mf; UData_t lo_gcd, gd_Scale, gc_Scale, gf_Scale, hgds, hgfs, hgcs; #if MT2063_TUNER_CNT > 1 UData_t index; struct MT2063_AvoidSpursData_t *adj; #endif *fm = 0; /* ** For each edge (d, c & f), calculate a scale, based on the gcd ** of f_LO1, f_LO2 and the edge value. Use the larger of this ** gcd-based scale factor or f_Scale. */ lo_gcd = MT2063_gcd(f_LO1, f_LO2); gd_Scale = MT2063_umax((UData_t) MT2063_gcd(lo_gcd, d), f_Scale); hgds = gd_Scale / 2; gc_Scale = MT2063_umax((UData_t) MT2063_gcd(lo_gcd, c), f_Scale); hgcs = gc_Scale / 2; gf_Scale = MT2063_umax((UData_t) MT2063_gcd(lo_gcd, f), f_Scale); hgfs = gf_Scale / 2; n0 = uceil(f_LO2 - d, f_LO1 - f_LO2); /* Check out all multiples of LO1 from n0 to m_maxLOSpurHarmonic */ for (n = n0; n <= pAS_Info->maxH1; ++n) { md = (n * ((f_LO1 + hgds) / gd_Scale) - ((d + hgds) / gd_Scale)) / ((f_LO2 + hgds) / gd_Scale); /* If # fLO2 harmonics > m_maxLOSpurHarmonic, then no spurs present */ if (md >= pAS_Info->maxH1) break; ma = (n * ((f_LO1 + hgds) / gd_Scale) + ((d + hgds) / gd_Scale)) / ((f_LO2 + hgds) / gd_Scale); /* If no spurs between +/- (f_out + f_IFBW/2), then try next harmonic */ if (md == ma) continue; mc = (n * ((f_LO1 + hgcs) / gc_Scale) - ((c + hgcs) / gc_Scale)) / ((f_LO2 + hgcs) / gc_Scale); if (mc != md) { f_nsLO1 = (SData_t) (n * (f_LO1 / gc_Scale)); f_nsLO2 = (SData_t) (mc * (f_LO2 / gc_Scale)); f_Spur = (gc_Scale * (f_nsLO1 - f_nsLO2)) + n * (f_LO1 % gc_Scale) - mc * (f_LO2 % gc_Scale); *fp = ((f_Spur - (SData_t) c) / (mc - n)) + 1; *fm = (((SData_t) d - f_Spur) / (mc - n)) + 1; return 1; } /* Location of Zero-IF-spur to be checked */ me = (n * ((f_LO1 + hgfs) / gf_Scale) + ((f + hgfs) / gf_Scale)) / ((f_LO2 + hgfs) / gf_Scale); mf = (n * ((f_LO1 + hgfs) / gf_Scale) - ((f + hgfs) / gf_Scale)) / ((f_LO2 + hgfs) / gf_Scale); if (me != mf) { f_nsLO1 = n * (f_LO1 / gf_Scale); f_nsLO2 = me * (f_LO2 / gf_Scale); f_Spur = (gf_Scale * (f_nsLO1 - f_nsLO2)) + n * (f_LO1 % gf_Scale) - me * (f_LO2 % gf_Scale); *fp = ((f_Spur + (SData_t) f) / (me - n)) + 1; *fm = (((SData_t) f - f_Spur) / (me - n)) + 1; return 1; } mb = (n * ((f_LO1 + hgcs) / gc_Scale) + ((c + hgcs) / gc_Scale)) / ((f_LO2 + hgcs) / gc_Scale); if (ma != mb) { f_nsLO1 = n * (f_LO1 / gc_Scale); f_nsLO2 = ma * (f_LO2 / gc_Scale); f_Spur = (gc_Scale * (f_nsLO1 - f_nsLO2)) + n * (f_LO1 % gc_Scale) - ma * (f_LO2 % gc_Scale); *fp = (((SData_t) d + f_Spur) / (ma - n)) + 1; *fm = (-(f_Spur + (SData_t) c) / (ma - n)) + 1; return 1; } } #if MT2063_TUNER_CNT > 1 /* If no spur found, see if there are more tuners on the same board */ for (index = 0; index < TunerCount; ++index) { adj = TunerList[index]; if (pAS_Info == adj) /* skip over our own data, don't process it */ continue; /* Look for LO-related spurs from the adjacent tuner generated into my IF output */ if (IsSpurInAdjTunerBand(1, /* check my IF output */ pAS_Info->f_LO1, /* my fLO1 */ adj->f_LO1, /* the other tuner's fLO1 */ pAS_Info->f_LO2, /* my fLO2 */ pAS_Info->f_out, /* my fOut */ pAS_Info->f_out_bw, /* my output IF bandwidth */ pAS_Info->f_zif_bw, /* my Zero-IF bandwidth */ pAS_Info->maxH2, fp, /* minimum amount to move LO's positive */ fm)) /* miminum amount to move LO's negative */ return 1; /* Look for LO-related spurs from my tuner generated into the adjacent tuner's IF output */ if (IsSpurInAdjTunerBand(0, /* check his IF output */ pAS_Info->f_LO1, /* my fLO1 */ adj->f_LO1, /* the other tuner's fLO1 */ adj->f_LO2, /* the other tuner's fLO2 */ adj->f_out, /* the other tuner's fOut */ adj->f_out_bw, /* the other tuner's output IF bandwidth */ pAS_Info->f_zif_bw, /* the other tuner's Zero-IF bandwidth */ adj->maxH2, fp, /* minimum amount to move LO's positive */ fm)) /* miminum amount to move LO's negative */ return 1; } #endif /* No spurs found */ return 0; } /***************************************************************************** ** ** Name: MT_AvoidSpurs ** ** Description: Main entry point to avoid spurs. ** Checks for existing spurs in present LO1, LO2 freqs ** and if present, chooses spur-free LO1, LO2 combination ** that tunes the same input/output frequencies. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 096 04-06-2005 DAD Ver 1.11: Fix divide by 0 error if maxH==0. ** *****************************************************************************/ UData_t MT2063_AvoidSpurs(Handle_t h, struct MT2063_AvoidSpursData_t * pAS_Info) { UData_t status = MT2063_OK; UData_t fm, fp; /* restricted range on LO's */ pAS_Info->bSpurAvoided = 0; pAS_Info->nSpursFound = 0; if (pAS_Info->maxH1 == 0) return MT2063_OK; /* ** Avoid LO Generated Spurs ** ** Make sure that have no LO-related spurs within the IF output ** bandwidth. ** ** If there is an LO spur in this band, start at the current IF1 frequency ** and work out until we find a spur-free frequency or run up against the ** 1st IF SAW band edge. Use temporary copies of fLO1 and fLO2 so that they ** will be unchanged if a spur-free setting is not found. */ pAS_Info->bSpurPresent = IsSpurInBand(pAS_Info, &fm, &fp); if (pAS_Info->bSpurPresent) { UData_t zfIF1 = pAS_Info->f_LO1 - pAS_Info->f_in; /* current attempt at a 1st IF */ UData_t zfLO1 = pAS_Info->f_LO1; /* current attempt at an LO1 freq */ UData_t zfLO2 = pAS_Info->f_LO2; /* current attempt at an LO2 freq */ UData_t delta_IF1; UData_t new_IF1; /* ** Spur was found, attempt to find a spur-free 1st IF */ do { pAS_Info->nSpursFound++; /* Raise f_IF1_upper, if needed */ MT2063_AddExclZone(pAS_Info, zfIF1 - fm, zfIF1 + fp); /* Choose next IF1 that is closest to f_IF1_CENTER */ new_IF1 = MT2063_ChooseFirstIF(pAS_Info); if (new_IF1 > zfIF1) { pAS_Info->f_LO1 += (new_IF1 - zfIF1); pAS_Info->f_LO2 += (new_IF1 - zfIF1); } else { pAS_Info->f_LO1 -= (zfIF1 - new_IF1); pAS_Info->f_LO2 -= (zfIF1 - new_IF1); } zfIF1 = new_IF1; if (zfIF1 > pAS_Info->f_if1_Center) delta_IF1 = zfIF1 - pAS_Info->f_if1_Center; else delta_IF1 = pAS_Info->f_if1_Center - zfIF1; } /* ** Continue while the new 1st IF is still within the 1st IF bandwidth ** and there is a spur in the band (again) */ while ((2 * delta_IF1 + pAS_Info->f_out_bw <= pAS_Info->f_if1_bw) && (pAS_Info->bSpurPresent = IsSpurInBand(pAS_Info, &fm, &fp))); /* ** Use the LO-spur free values found. If the search went all the way to ** the 1st IF band edge and always found spurs, just leave the original ** choice. It's as "good" as any other. */ if (pAS_Info->bSpurPresent == 1) { status |= MT2063_SPUR_PRESENT_ERR; pAS_Info->f_LO1 = zfLO1; pAS_Info->f_LO2 = zfLO2; } else pAS_Info->bSpurAvoided = 1; } status |= ((pAS_Info-> nSpursFound << MT2063_SPUR_SHIFT) & MT2063_SPUR_CNT_MASK); return (status); } UData_t MT2063_AvoidSpursVersion(void) { return (MT2063_SPUR_VERSION); } //end of mt2063_spuravoid.c //================================================================= //################################################################# //================================================================= /* ** The expected version of MT_AvoidSpursData_t ** If the version is different, an updated file is needed from Microtune */ /* Expecting version 1.21 of the Spur Avoidance API */ #define EXPECTED_MT2063_AVOID_SPURS_INFO_VERSION 010201 #if MT2063_AVOID_SPURS_INFO_VERSION < EXPECTED_MT2063_AVOID_SPURS_INFO_VERSION #error Contact Microtune for a newer version of MT_SpurAvoid.c #elif MT2063_AVOID_SPURS_INFO_VERSION > EXPECTED_MT2063_AVOID_SPURS_INFO_VERSION #error Contact Microtune for a newer version of mt2063.c #endif #ifndef MT2063_CNT #error You must define MT2063_CNT in the "mt_userdef.h" file #endif typedef enum { MT2063_SET_ATTEN, MT2063_INCR_ATTEN, MT2063_DECR_ATTEN } MT2063_ATTEN_CNTL_MODE; //#define TUNER_MT2063_OPTIMIZATION /* ** Constants used by the tuning algorithm */ #define MT2063_REF_FREQ (16000000UL) /* Reference oscillator Frequency (in Hz) */ #define MT2063_IF1_BW (22000000UL) /* The IF1 filter bandwidth (in Hz) */ #define MT2063_TUNE_STEP_SIZE (50000UL) /* Tune in steps of 50 kHz */ #define MT2063_SPUR_STEP_HZ (250000UL) /* Step size (in Hz) to move IF1 when avoiding spurs */ #define MT2063_ZIF_BW (2000000UL) /* Zero-IF spur-free bandwidth (in Hz) */ #define MT2063_MAX_HARMONICS_1 (15UL) /* Highest intra-tuner LO Spur Harmonic to be avoided */ #define MT2063_MAX_HARMONICS_2 (5UL) /* Highest inter-tuner LO Spur Harmonic to be avoided */ #define MT2063_MIN_LO_SEP (1000000UL) /* Minimum inter-tuner LO frequency separation */ #define MT2063_LO1_FRACN_AVOID (0UL) /* LO1 FracN numerator avoid region (in Hz) */ #define MT2063_LO2_FRACN_AVOID (199999UL) /* LO2 FracN numerator avoid region (in Hz) */ #define MT2063_MIN_FIN_FREQ (44000000UL) /* Minimum input frequency (in Hz) */ #define MT2063_MAX_FIN_FREQ (1100000000UL) /* Maximum input frequency (in Hz) */ #define MT2063_MIN_FOUT_FREQ (36000000UL) /* Minimum output frequency (in Hz) */ #define MT2063_MAX_FOUT_FREQ (57000000UL) /* Maximum output frequency (in Hz) */ #define MT2063_MIN_DNC_FREQ (1293000000UL) /* Minimum LO2 frequency (in Hz) */ #define MT2063_MAX_DNC_FREQ (1614000000UL) /* Maximum LO2 frequency (in Hz) */ #define MT2063_MIN_UPC_FREQ (1396000000UL) /* Minimum LO1 frequency (in Hz) */ #define MT2063_MAX_UPC_FREQ (2750000000UL) /* Maximum LO1 frequency (in Hz) */ /* ** Define the supported Part/Rev codes for the MT2063 */ #define MT2063_B0 (0x9B) #define MT2063_B1 (0x9C) #define MT2063_B2 (0x9D) #define MT2063_B3 (0x9E) /* ** The number of Tuner Registers */ static const UData_t MT2063_Num_Registers = MT2063_REG_END_REGS; #define USE_GLOBAL_TUNER 0 static UData_t nMT2063MaxTuners = MT2063_CNT; static struct MT2063_Info_t MT2063_Info[MT2063_CNT]; static struct MT2063_Info_t *MT2063_Avail[MT2063_CNT]; static UData_t nMT2063OpenTuners = 0; /* ** Constants for setting receiver modes. ** (6 modes defined at this time, enumerated by MT2063_RCVR_MODES) ** (DNC1GC & DNC2GC are the values, which are used, when the specific ** DNC Output is selected, the other is always off) ** ** If PAL-L or L' is received, set: ** MT2063_SetParam(hMT2063,MT2063_TAGC,1); ** ** --------------+---------------------------------------------- ** Mode 0 : | MT2063_CABLE_QAM ** Mode 1 : | MT2063_CABLE_ANALOG ** Mode 2 : | MT2063_OFFAIR_COFDM ** Mode 3 : | MT2063_OFFAIR_COFDM_SAWLESS ** Mode 4 : | MT2063_OFFAIR_ANALOG ** Mode 5 : | MT2063_OFFAIR_8VSB ** --------------+----+----+----+----+-----+-----+-------------- ** Mode | 0 | 1 | 2 | 3 | 4 | 5 | ** --------------+----+----+----+----+-----+-----+ ** ** */ static const U8Data RFAGCEN[] = { 0, 0, 0, 0, 0, 0 }; static const U8Data LNARIN[] = { 0, 0, 3, 3, 3, 3 }; static const U8Data FIFFQEN[] = { 1, 1, 1, 1, 1, 1 }; static const U8Data FIFFQ[] = { 0, 0, 0, 0, 0, 0 }; static const U8Data DNC1GC[] = { 0, 0, 0, 0, 0, 0 }; static const U8Data DNC2GC[] = { 0, 0, 0, 0, 0, 0 }; static const U8Data ACLNAMAX[] = { 31, 31, 31, 31, 31, 31 }; static const U8Data LNATGT[] = { 44, 43, 43, 43, 43, 43 }; static const U8Data RFOVDIS[] = { 0, 0, 0, 0, 0, 0 }; static const U8Data ACRFMAX[] = { 31, 31, 31, 31, 31, 31 }; static const U8Data PD1TGT[] = { 36, 36, 38, 38, 36, 38 }; static const U8Data FIFOVDIS[] = { 0, 0, 0, 0, 0, 0 }; static const U8Data ACFIFMAX[] = { 29, 29, 29, 29, 29, 29 }; static const U8Data PD2TGT[] = { 40, 33, 38, 42, 30, 38 }; /* ** Local Function Prototypes - not available for external access. */ /* Forward declaration(s): */ static UData_t MT2063_CalcLO1Mult(UData_t * Div, UData_t * FracN, UData_t f_LO, UData_t f_LO_Step, UData_t f_Ref); static UData_t MT2063_CalcLO2Mult(UData_t * Div, UData_t * FracN, UData_t f_LO, UData_t f_LO_Step, UData_t f_Ref); static UData_t MT2063_fLO_FractionalTerm(UData_t f_ref, UData_t num, UData_t denom); /****************************************************************************** ** ** Name: MT2063_Open ** ** Description: Initialize the tuner's register values. ** ** Parameters: MT2063_Addr - Serial bus address of the tuner. ** hMT2063 - Tuner handle passed back. ** hUserData - User-defined data, if needed for the ** MT_ReadSub() & MT_WriteSub functions. ** ** Returns: status: ** MT_OK - No errors ** MT_TUNER_ID_ERR - Tuner Part/Rev code mismatch ** MT_TUNER_INIT_ERR - Tuner initialization failed ** MT_COMM_ERR - Serial bus communications error ** MT_ARG_NULL - Null pointer argument passed ** MT_TUNER_CNT_ERR - Too many tuners open ** ** Dependencies: MT_ReadSub - Read byte(s) of data from the two-wire bus ** MT_WriteSub - Write byte(s) of data to the two-wire bus ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ******************************************************************************/ UData_t MT2063_Open(UData_t MT2063_Addr, Handle_t * hMT2063, Handle_t hUserData) { UData_t status = MT2063_OK; /* Status to be returned. */ SData_t i; struct MT2063_Info_t *pInfo = NULL; struct dvb_frontend *fe = (struct dvb_frontend *)hUserData; struct mt2063_state *state = fe->tuner_priv; /* Check the argument before using */ if (hMT2063 == NULL) { return MT2063_ARG_NULL; } /* Default tuner handle to NULL. If successful, it will be reassigned */ #if USE_GLOBAL_TUNER *hMT2063 = NULL; /* ** If this is our first tuner, initialize the address fields and ** the list of available control blocks. */ if (nMT2063OpenTuners == 0) { for (i = MT2063_CNT - 1; i >= 0; i--) { MT2063_Info[i].handle = NULL; MT2063_Info[i].address = MAX_UDATA; MT2063_Info[i].rcvr_mode = MT2063_CABLE_QAM; MT2063_Info[i].hUserData = NULL; MT2063_Avail[i] = &MT2063_Info[i]; } } /* ** Look for an existing MT2063_State_t entry with this address. */ for (i = MT2063_CNT - 1; i >= 0; i--) { /* ** If an open'ed handle provided, we'll re-initialize that structure. ** ** We recognize an open tuner because the address and hUserData are ** the same as one that has already been opened */ if ((MT2063_Info[i].address == MT2063_Addr) && (MT2063_Info[i].hUserData == hUserData)) { pInfo = &MT2063_Info[i]; break; } } /* If not found, choose an empty spot. */ if (pInfo == NULL) { /* Check to see that we're not over-allocating */ if (nMT2063OpenTuners == MT2063_CNT) { return MT2063_TUNER_CNT_ERR; } /* Use the next available block from the list */ pInfo = MT2063_Avail[nMT2063OpenTuners]; nMT2063OpenTuners++; } #else if (state->MT2063_init == FALSE) { pInfo = kzalloc(sizeof(struct MT2063_Info_t), GFP_KERNEL); if (pInfo == NULL) { return MT2063_TUNER_OPEN_ERR; } pInfo->handle = NULL; pInfo->address = MAX_UDATA; pInfo->rcvr_mode = MT2063_CABLE_QAM; pInfo->hUserData = NULL; } else { pInfo = *hMT2063; } #endif if (MT2063_NO_ERROR(status)) { status |= MT2063_RegisterTuner(&pInfo->AS_Data); } if (MT2063_NO_ERROR(status)) { pInfo->handle = (Handle_t) pInfo; pInfo->hUserData = hUserData; pInfo->address = MT2063_Addr; pInfo->rcvr_mode = MT2063_CABLE_QAM; status |= MT2063_ReInit((Handle_t) pInfo); } if (MT2063_IS_ERROR(status)) /* MT2063_Close handles the un-registration of the tuner */ MT2063_Close((Handle_t) pInfo); else { state->MT2063_init = TRUE; *hMT2063 = pInfo->handle; } return (status); } static UData_t MT2063_IsValidHandle(struct MT2063_Info_t *handle) { return ((handle != NULL) && (handle->handle == handle)) ? 1 : 0; } /****************************************************************************** ** ** Name: MT2063_Close ** ** Description: Release the handle to the tuner. ** ** Parameters: hMT2063 - Handle to the MT2063 tuner ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** ** Dependencies: mt_errordef.h - definition of error codes ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ******************************************************************************/ UData_t MT2063_Close(Handle_t hMT2063) { struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)hMT2063; if (!MT2063_IsValidHandle(pInfo)) return MT2063_INV_HANDLE; /* Unregister tuner with SpurAvoidance routines (if needed) */ MT2063_UnRegisterTuner(&pInfo->AS_Data); /* Now remove the tuner from our own list of tuners */ pInfo->handle = NULL; pInfo->address = MAX_UDATA; pInfo->hUserData = NULL; #if USE_GLOBAL_TUNER nMT2063OpenTuners--; MT2063_Avail[nMT2063OpenTuners] = pInfo; /* Return control block to available list */ #else //kfree(pInfo); //pInfo = NULL; #endif return MT2063_OK; } /****************************************************************************** ** ** Name: MT2063_GetGPIO ** ** Description: Get the current MT2063 GPIO value. ** ** Parameters: h - Open handle to the tuner (from MT2063_Open). ** gpio_id - Selects GPIO0, GPIO1 or GPIO2 ** attr - Selects input readback, I/O direction or ** output value ** *value - current setting of GPIO pin ** ** Usage: status = MT2063_GetGPIO(hMT2063, MT2063_GPIO_OUT, &value); ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** MT_INV_HANDLE - Invalid tuner handle ** MT_ARG_NULL - Null pointer argument passed ** ** Dependencies: MT_ReadSub - Read byte(s) of data from the serial bus ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ******************************************************************************/ UData_t MT2063_GetGPIO(Handle_t h, enum MT2063_GPIO_ID gpio_id, enum MT2063_GPIO_Attr attr, UData_t * value) { UData_t status = MT2063_OK; /* Status to be returned */ U8Data regno; SData_t shift; static U8Data GPIOreg[3] = { MT2063_REG_RF_STATUS, MT2063_REG_FIF_OV, MT2063_REG_RF_OV }; struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; if (MT2063_IsValidHandle(pInfo) == 0) return MT2063_INV_HANDLE; if (value == NULL) return MT2063_ARG_NULL; regno = GPIOreg[attr]; /* We'll read the register just in case the write didn't work last time */ status = MT2063_ReadSub(pInfo->hUserData, pInfo->address, regno, &pInfo->reg[regno], 1); shift = (gpio_id - MT2063_GPIO0 + 5); *value = (pInfo->reg[regno] >> shift) & 1; return (status); } /**************************************************************************** ** ** Name: MT2063_GetLocked ** ** Description: Checks to see if LO1 and LO2 are locked. ** ** Parameters: h - Open handle to the tuner (from MT2063_Open). ** ** Returns: status: ** MT_OK - No errors ** MT_UPC_UNLOCK - Upconverter PLL unlocked ** MT_DNC_UNLOCK - Downconverter PLL unlocked ** MT_COMM_ERR - Serial bus communications error ** MT_INV_HANDLE - Invalid tuner handle ** ** Dependencies: MT_ReadSub - Read byte(s) of data from the serial bus ** MT_Sleep - Delay execution for x milliseconds ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ UData_t MT2063_GetLocked(Handle_t h) { const UData_t nMaxWait = 100; /* wait a maximum of 100 msec */ const UData_t nPollRate = 2; /* poll status bits every 2 ms */ const UData_t nMaxLoops = nMaxWait / nPollRate; const U8Data LO1LK = 0x80; U8Data LO2LK = 0x08; UData_t status = MT2063_OK; /* Status to be returned */ UData_t nDelays = 0; struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; if (MT2063_IsValidHandle(pInfo) == 0) return MT2063_INV_HANDLE; /* LO2 Lock bit was in a different place for B0 version */ if (pInfo->tuner_id == MT2063_B0) LO2LK = 0x40; do { status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO_STATUS, &pInfo->reg[MT2063_REG_LO_STATUS], 1); if (MT2063_IS_ERROR(status)) return (status); if ((pInfo->reg[MT2063_REG_LO_STATUS] & (LO1LK | LO2LK)) == (LO1LK | LO2LK)) { return (status); } MT2063_Sleep(pInfo->hUserData, nPollRate); /* Wait between retries */ } while (++nDelays < nMaxLoops); if ((pInfo->reg[MT2063_REG_LO_STATUS] & LO1LK) == 0x00) status |= MT2063_UPC_UNLOCK; if ((pInfo->reg[MT2063_REG_LO_STATUS] & LO2LK) == 0x00) status |= MT2063_DNC_UNLOCK; return (status); } /**************************************************************************** ** ** Name: MT2063_GetParam ** ** Description: Gets a tuning algorithm parameter. ** ** This function provides access to the internals of the ** tuning algorithm - mostly for testing purposes. ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** param - Tuning algorithm parameter ** (see enum MT2063_Param) ** pValue - ptr to returned value ** ** param Description ** ---------------------- -------------------------------- ** MT2063_IC_ADDR Serial Bus address of this tuner ** MT2063_MAX_OPEN Max # of MT2063's allowed open ** MT2063_NUM_OPEN # of MT2063's open ** MT2063_SRO_FREQ crystal frequency ** MT2063_STEPSIZE minimum tuning step size ** MT2063_INPUT_FREQ input center frequency ** MT2063_LO1_FREQ LO1 Frequency ** MT2063_LO1_STEPSIZE LO1 minimum step size ** MT2063_LO1_FRACN_AVOID LO1 FracN keep-out region ** MT2063_IF1_ACTUAL Current 1st IF in use ** MT2063_IF1_REQUEST Requested 1st IF ** MT2063_IF1_CENTER Center of 1st IF SAW filter ** MT2063_IF1_BW Bandwidth of 1st IF SAW filter ** MT2063_ZIF_BW zero-IF bandwidth ** MT2063_LO2_FREQ LO2 Frequency ** MT2063_LO2_STEPSIZE LO2 minimum step size ** MT2063_LO2_FRACN_AVOID LO2 FracN keep-out region ** MT2063_OUTPUT_FREQ output center frequency ** MT2063_OUTPUT_BW output bandwidth ** MT2063_LO_SEPARATION min inter-tuner LO separation ** MT2063_AS_ALG ID of avoid-spurs algorithm in use ** MT2063_MAX_HARM1 max # of intra-tuner harmonics ** MT2063_MAX_HARM2 max # of inter-tuner harmonics ** MT2063_EXCL_ZONES # of 1st IF exclusion zones ** MT2063_NUM_SPURS # of spurs found/avoided ** MT2063_SPUR_AVOIDED >0 spurs avoided ** MT2063_SPUR_PRESENT >0 spurs in output (mathematically) ** MT2063_RCVR_MODE Predefined modes. ** MT2063_ACLNA LNA attenuator gain code ** MT2063_ACRF RF attenuator gain code ** MT2063_ACFIF FIF attenuator gain code ** MT2063_ACLNA_MAX LNA attenuator limit ** MT2063_ACRF_MAX RF attenuator limit ** MT2063_ACFIF_MAX FIF attenuator limit ** MT2063_PD1 Actual value of PD1 ** MT2063_PD2 Actual value of PD2 ** MT2063_DNC_OUTPUT_ENABLE DNC output selection ** MT2063_VGAGC VGA gain code ** MT2063_VGAOI VGA output current ** MT2063_TAGC TAGC setting ** MT2063_AMPGC AMP gain code ** MT2063_AVOID_DECT Avoid DECT Frequencies ** MT2063_CTFILT_SW Cleartune filter selection ** ** Usage: status |= MT2063_GetParam(hMT2063, ** MT2063_IF1_ACTUAL, ** &f_IF1_Actual); ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_ARG_NULL - Null pointer argument passed ** MT_ARG_RANGE - Invalid parameter requested ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** See Also: MT2063_SetParam, MT2063_Open ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** 154 09-13-2007 RSK Ver 1.05: Get/SetParam changes for LOx_FREQ ** 10-31-2007 PINZ Ver 1.08: Get/SetParam add VGAGC, VGAOI, AMPGC, TAGC ** 173 M 01-23-2008 RSK Ver 1.12: Read LO1C and LO2C registers from HW ** in GetParam. ** 04-18-2008 PINZ Ver 1.15: Add SetParam LNARIN & PDxTGT ** Split SetParam up to ACLNA / ACLNA_MAX ** removed ACLNA_INRC/DECR (+RF & FIF) ** removed GCUAUTO / BYPATNDN/UP ** 175 I 16-06-2008 PINZ Ver 1.16: Add control to avoid US DECT freqs. ** 175 I 06-19-2008 RSK Ver 1.17: Refactor DECT control to SpurAvoid. ** 06-24-2008 PINZ Ver 1.18: Add Get/SetParam CTFILT_SW ** ****************************************************************************/ UData_t MT2063_GetParam(Handle_t h, enum MT2063_Param param, UData_t * pValue) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; UData_t Div; UData_t Num; if (pValue == NULL) status |= MT2063_ARG_NULL; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status |= MT2063_INV_HANDLE; if (MT2063_NO_ERROR(status)) { switch (param) { /* Serial Bus address of this tuner */ case MT2063_IC_ADDR: *pValue = pInfo->address; break; /* Max # of MT2063's allowed to be open */ case MT2063_MAX_OPEN: *pValue = nMT2063MaxTuners; break; /* # of MT2063's open */ case MT2063_NUM_OPEN: *pValue = nMT2063OpenTuners; break; /* crystal frequency */ case MT2063_SRO_FREQ: *pValue = pInfo->AS_Data.f_ref; break; /* minimum tuning step size */ case MT2063_STEPSIZE: *pValue = pInfo->AS_Data.f_LO2_Step; break; /* input center frequency */ case MT2063_INPUT_FREQ: *pValue = pInfo->AS_Data.f_in; break; /* LO1 Frequency */ case MT2063_LO1_FREQ: { /* read the actual tuner register values for LO1C_1 and LO1C_2 */ status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO1C_1, &pInfo-> reg[MT2063_REG_LO1C_1], 2); Div = pInfo->reg[MT2063_REG_LO1C_1]; Num = pInfo->reg[MT2063_REG_LO1C_2] & 0x3F; pInfo->AS_Data.f_LO1 = (pInfo->AS_Data.f_ref * Div) + MT2063_fLO_FractionalTerm(pInfo->AS_Data. f_ref, Num, 64); } *pValue = pInfo->AS_Data.f_LO1; break; /* LO1 minimum step size */ case MT2063_LO1_STEPSIZE: *pValue = pInfo->AS_Data.f_LO1_Step; break; /* LO1 FracN keep-out region */ case MT2063_LO1_FRACN_AVOID_PARAM: *pValue = pInfo->AS_Data.f_LO1_FracN_Avoid; break; /* Current 1st IF in use */ case MT2063_IF1_ACTUAL: *pValue = pInfo->f_IF1_actual; break; /* Requested 1st IF */ case MT2063_IF1_REQUEST: *pValue = pInfo->AS_Data.f_if1_Request; break; /* Center of 1st IF SAW filter */ case MT2063_IF1_CENTER: *pValue = pInfo->AS_Data.f_if1_Center; break; /* Bandwidth of 1st IF SAW filter */ case MT2063_IF1_BW: *pValue = pInfo->AS_Data.f_if1_bw; break; /* zero-IF bandwidth */ case MT2063_ZIF_BW: *pValue = pInfo->AS_Data.f_zif_bw; break; /* LO2 Frequency */ case MT2063_LO2_FREQ: { /* Read the actual tuner register values for LO2C_1, LO2C_2 and LO2C_3 */ status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2C_1, &pInfo-> reg[MT2063_REG_LO2C_1], 3); Div = (pInfo->reg[MT2063_REG_LO2C_1] & 0xFE) >> 1; Num = ((pInfo-> reg[MT2063_REG_LO2C_1] & 0x01) << 12) | (pInfo-> reg[MT2063_REG_LO2C_2] << 4) | (pInfo-> reg [MT2063_REG_LO2C_3] & 0x00F); pInfo->AS_Data.f_LO2 = (pInfo->AS_Data.f_ref * Div) + MT2063_fLO_FractionalTerm(pInfo->AS_Data. f_ref, Num, 8191); } *pValue = pInfo->AS_Data.f_LO2; break; /* LO2 minimum step size */ case MT2063_LO2_STEPSIZE: *pValue = pInfo->AS_Data.f_LO2_Step; break; /* LO2 FracN keep-out region */ case MT2063_LO2_FRACN_AVOID: *pValue = pInfo->AS_Data.f_LO2_FracN_Avoid; break; /* output center frequency */ case MT2063_OUTPUT_FREQ: *pValue = pInfo->AS_Data.f_out; break; /* output bandwidth */ case MT2063_OUTPUT_BW: *pValue = pInfo->AS_Data.f_out_bw - 750000; break; /* min inter-tuner LO separation */ case MT2063_LO_SEPARATION: *pValue = pInfo->AS_Data.f_min_LO_Separation; break; /* ID of avoid-spurs algorithm in use */ case MT2063_AS_ALG: *pValue = pInfo->AS_Data.nAS_Algorithm; break; /* max # of intra-tuner harmonics */ case MT2063_MAX_HARM1: *pValue = pInfo->AS_Data.maxH1; break; /* max # of inter-tuner harmonics */ case MT2063_MAX_HARM2: *pValue = pInfo->AS_Data.maxH2; break; /* # of 1st IF exclusion zones */ case MT2063_EXCL_ZONES: *pValue = pInfo->AS_Data.nZones; break; /* # of spurs found/avoided */ case MT2063_NUM_SPURS: *pValue = pInfo->AS_Data.nSpursFound; break; /* >0 spurs avoided */ case MT2063_SPUR_AVOIDED: *pValue = pInfo->AS_Data.bSpurAvoided; break; /* >0 spurs in output (mathematically) */ case MT2063_SPUR_PRESENT: *pValue = pInfo->AS_Data.bSpurPresent; break; /* Predefined receiver setup combination */ case MT2063_RCVR_MODE: *pValue = pInfo->rcvr_mode; break; case MT2063_PD1: case MT2063_PD2: { U8Data mask = (param == MT2063_PD1 ? 0x01 : 0x03); /* PD1 vs PD2 */ U8Data orig = (pInfo->reg[MT2063_REG_BYP_CTRL]); U8Data reg = (orig & 0xF1) | mask; /* Only set 3 bits (not 5) */ int i; *pValue = 0; /* Initiate ADC output to reg 0x0A */ if (reg != orig) status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_BYP_CTRL, ®, 1); if (MT2063_IS_ERROR(status)) return (status); for (i = 0; i < 8; i++) { status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_ADC_OUT, &pInfo-> reg [MT2063_REG_ADC_OUT], 1); if (MT2063_NO_ERROR(status)) *pValue += pInfo-> reg[MT2063_REG_ADC_OUT]; else { if (i) *pValue /= i; return (status); } } *pValue /= 8; /* divide by number of reads */ *pValue >>= 2; /* only want 6 MSB's out of 8 */ /* Restore value of Register BYP_CTRL */ if (reg != orig) status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_BYP_CTRL, &orig, 1); } break; /* Get LNA attenuator code */ case MT2063_ACLNA: { U8Data val; status |= MT2063_GetReg(pInfo, MT2063_REG_XO_STATUS, &val); *pValue = val & 0x1f; } break; /* Get RF attenuator code */ case MT2063_ACRF: { U8Data val; status |= MT2063_GetReg(pInfo, MT2063_REG_RF_STATUS, &val); *pValue = val & 0x1f; } break; /* Get FIF attenuator code */ case MT2063_ACFIF: { U8Data val; status |= MT2063_GetReg(pInfo, MT2063_REG_FIF_STATUS, &val); *pValue = val & 0x1f; } break; /* Get LNA attenuator limit */ case MT2063_ACLNA_MAX: { U8Data val; status |= MT2063_GetReg(pInfo, MT2063_REG_LNA_OV, &val); *pValue = val & 0x1f; } break; /* Get RF attenuator limit */ case MT2063_ACRF_MAX: { U8Data val; status |= MT2063_GetReg(pInfo, MT2063_REG_RF_OV, &val); *pValue = val & 0x1f; } break; /* Get FIF attenuator limit */ case MT2063_ACFIF_MAX: { U8Data val; status |= MT2063_GetReg(pInfo, MT2063_REG_FIF_OV, &val); *pValue = val & 0x1f; } break; /* Get current used DNC output */ case MT2063_DNC_OUTPUT_ENABLE: { if ((pInfo->reg[MT2063_REG_DNC_GAIN] & 0x03) == 0x03) { /* if DNC1 is off */ if ((pInfo->reg[MT2063_REG_VGA_GAIN] & 0x03) == 0x03) /* if DNC2 is off */ *pValue = (UData_t) MT2063_DNC_NONE; else *pValue = (UData_t) MT2063_DNC_2; } else { /* DNC1 is on */ if ((pInfo->reg[MT2063_REG_VGA_GAIN] & 0x03) == 0x03) /* if DNC2 is off */ *pValue = (UData_t) MT2063_DNC_1; else *pValue = (UData_t) MT2063_DNC_BOTH; } } break; /* Get VGA Gain Code */ case MT2063_VGAGC: *pValue = ((pInfo->reg[MT2063_REG_VGA_GAIN] & 0x0C) >> 2); break; /* Get VGA bias current */ case MT2063_VGAOI: *pValue = (pInfo->reg[MT2063_REG_RSVD_31] & 0x07); break; /* Get TAGC setting */ case MT2063_TAGC: *pValue = (pInfo->reg[MT2063_REG_RSVD_1E] & 0x03); break; /* Get AMP Gain Code */ case MT2063_AMPGC: *pValue = (pInfo->reg[MT2063_REG_TEMP_SEL] & 0x03); break; /* Avoid DECT Frequencies */ case MT2063_AVOID_DECT: *pValue = pInfo->AS_Data.avoidDECT; break; /* Cleartune filter selection: 0 - by IC (default), 1 - by software */ case MT2063_CTFILT_SW: *pValue = pInfo->ctfilt_sw; break; case MT2063_EOP: default: status |= MT2063_ARG_RANGE; } } return (status); } /**************************************************************************** ** ** Name: MT2063_GetReg ** ** Description: Gets an MT2063 register. ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** reg - MT2063 register/subaddress location ** *val - MT2063 register/subaddress value ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** MT_INV_HANDLE - Invalid tuner handle ** MT_ARG_NULL - Null pointer argument passed ** MT_ARG_RANGE - Argument out of range ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** Use this function if you need to read a register from ** the MT2063. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ UData_t MT2063_GetReg(Handle_t h, U8Data reg, U8Data * val) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status |= MT2063_INV_HANDLE; if (val == NULL) status |= MT2063_ARG_NULL; if (reg >= MT2063_REG_END_REGS) status |= MT2063_ARG_RANGE; if (MT2063_NO_ERROR(status)) { status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, reg, &pInfo->reg[reg], 1); if (MT2063_NO_ERROR(status)) *val = pInfo->reg[reg]; } return (status); } /****************************************************************************** ** ** Name: MT2063_GetTemp ** ** Description: Get the MT2063 Temperature register. ** ** Parameters: h - Open handle to the tuner (from MT2063_Open). ** *value - value read from the register ** ** Binary ** Value Returned Value Approx Temp ** --------------------------------------------- ** MT2063_T_0C 0000 0C ** MT2063_T_10C 0001 10C ** MT2063_T_20C 0010 20C ** MT2063_T_30C 0011 30C ** MT2063_T_40C 0100 40C ** MT2063_T_50C 0101 50C ** MT2063_T_60C 0110 60C ** MT2063_T_70C 0111 70C ** MT2063_T_80C 1000 80C ** MT2063_T_90C 1001 90C ** MT2063_T_100C 1010 100C ** MT2063_T_110C 1011 110C ** MT2063_T_120C 1100 120C ** MT2063_T_130C 1101 130C ** MT2063_T_140C 1110 140C ** MT2063_T_150C 1111 150C ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** MT_INV_HANDLE - Invalid tuner handle ** MT_ARG_NULL - Null pointer argument passed ** MT_ARG_RANGE - Argument out of range ** ** Dependencies: MT_ReadSub - Read byte(s) of data from the two-wire bus ** MT_WriteSub - Write byte(s) of data to the two-wire bus ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ******************************************************************************/ UData_t MT2063_GetTemp(Handle_t h, enum MT2063_Temperature * value) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; if (MT2063_IsValidHandle(pInfo) == 0) return MT2063_INV_HANDLE; if (value == NULL) return MT2063_ARG_NULL; if ((MT2063_NO_ERROR(status)) && ((pInfo->reg[MT2063_REG_TEMP_SEL] & 0xE0) != 0x00)) { pInfo->reg[MT2063_REG_TEMP_SEL] &= (0x1F); status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_TEMP_SEL, &pInfo->reg[MT2063_REG_TEMP_SEL], 1); } if (MT2063_NO_ERROR(status)) status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_TEMP_STATUS, &pInfo->reg[MT2063_REG_TEMP_STATUS], 1); if (MT2063_NO_ERROR(status)) *value = (enum MT2063_Temperature)(pInfo-> reg[MT2063_REG_TEMP_STATUS] >> 4); return (status); } /**************************************************************************** ** ** Name: MT2063_GetUserData ** ** Description: Gets the user-defined data item. ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_ARG_NULL - Null pointer argument passed ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** The hUserData parameter is a user-specific argument ** that is stored internally with the other tuner- ** specific information. ** ** For example, if additional arguments are needed ** for the user to identify the device communicating ** with the tuner, this argument can be used to supply ** the necessary information. ** ** The hUserData parameter is initialized in the tuner's ** Open function to NULL. ** ** See Also: MT2063_Open ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ UData_t MT2063_GetUserData(Handle_t h, Handle_t * hUserData) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status = MT2063_INV_HANDLE; if (hUserData == NULL) status |= MT2063_ARG_NULL; if (MT2063_NO_ERROR(status)) *hUserData = pInfo->hUserData; return (status); } /****************************************************************************** ** ** Name: MT2063_SetReceiverMode ** ** Description: Set the MT2063 receiver mode ** ** --------------+---------------------------------------------- ** Mode 0 : | MT2063_CABLE_QAM ** Mode 1 : | MT2063_CABLE_ANALOG ** Mode 2 : | MT2063_OFFAIR_COFDM ** Mode 3 : | MT2063_OFFAIR_COFDM_SAWLESS ** Mode 4 : | MT2063_OFFAIR_ANALOG ** Mode 5 : | MT2063_OFFAIR_8VSB ** --------------+----+----+----+----+-----+-------------------- ** (DNC1GC & DNC2GC are the values, which are used, when the specific ** DNC Output is selected, the other is always off) ** ** |<---------- Mode -------------->| ** Reg Field | 0 | 1 | 2 | 3 | 4 | 5 | ** ------------+-----+-----+-----+-----+-----+-----+ ** RFAGCen | OFF | OFF | OFF | OFF | OFF | OFF ** LNARin | 0 | 0 | 3 | 3 | 3 | 3 ** FIFFQen | 1 | 1 | 1 | 1 | 1 | 1 ** FIFFq | 0 | 0 | 0 | 0 | 0 | 0 ** DNC1gc | 0 | 0 | 0 | 0 | 0 | 0 ** DNC2gc | 0 | 0 | 0 | 0 | 0 | 0 ** GCU Auto | 1 | 1 | 1 | 1 | 1 | 1 ** LNA max Atn | 31 | 31 | 31 | 31 | 31 | 31 ** LNA Target | 44 | 43 | 43 | 43 | 43 | 43 ** ign RF Ovl | 0 | 0 | 0 | 0 | 0 | 0 ** RF max Atn | 31 | 31 | 31 | 31 | 31 | 31 ** PD1 Target | 36 | 36 | 38 | 38 | 36 | 38 ** ign FIF Ovl | 0 | 0 | 0 | 0 | 0 | 0 ** FIF max Atn | 5 | 5 | 5 | 5 | 5 | 5 ** PD2 Target | 40 | 33 | 42 | 42 | 33 | 42 ** ** ** Parameters: pInfo - ptr to MT2063_Info_t structure ** Mode - desired reciever mode ** ** Usage: status = MT2063_SetReceiverMode(hMT2063, Mode); ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** ** Dependencies: MT2063_SetReg - Write a byte of data to a HW register. ** Assumes that the tuner cache is valid. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** N/A 01-10-2007 PINZ Added additional GCU Settings, FIFF Calib will be triggered ** 155 10-01-2007 DAD Ver 1.06: Add receiver mode for SECAM positive ** modulation ** (MT2063_ANALOG_TV_POS_NO_RFAGC_MODE) ** N/A 10-22-2007 PINZ Ver 1.07: Changed some Registers at init to have ** the same settings as with MT Launcher ** N/A 10-30-2007 PINZ Add SetParam VGAGC & VGAOI ** Add SetParam DNC_OUTPUT_ENABLE ** Removed VGAGC from receiver mode, ** default now 1 ** N/A 10-31-2007 PINZ Ver 1.08: Add SetParam TAGC, removed from rcvr-mode ** Add SetParam AMPGC, removed from rcvr-mode ** Corrected names of GCU values ** reorganized receiver modes, removed, ** (MT2063_ANALOG_TV_POS_NO_RFAGC_MODE) ** Actualized Receiver-Mode values ** N/A 11-12-2007 PINZ Ver 1.09: Actualized Receiver-Mode values ** N/A 11-27-2007 PINZ Improved buffered writing ** 01-03-2008 PINZ Ver 1.10: Added a trigger of BYPATNUP for ** correct wakeup of the LNA after shutdown ** Set AFCsd = 1 as default ** Changed CAP1sel default ** 01-14-2008 PINZ Ver 1.11: Updated gain settings ** 04-18-2008 PINZ Ver 1.15: Add SetParam LNARIN & PDxTGT ** Split SetParam up to ACLNA / ACLNA_MAX ** removed ACLNA_INRC/DECR (+RF & FIF) ** removed GCUAUTO / BYPATNDN/UP ** ******************************************************************************/ static UData_t MT2063_SetReceiverMode(struct MT2063_Info_t *pInfo, enum MT2063_RCVR_MODES Mode) { UData_t status = MT2063_OK; /* Status to be returned */ U8Data val; UData_t longval; if (Mode >= MT2063_NUM_RCVR_MODES) status = MT2063_ARG_RANGE; /* RFAGCen */ if (MT2063_NO_ERROR(status)) { val = (pInfo-> reg[MT2063_REG_PD1_TGT] & (U8Data) ~ 0x40) | (RFAGCEN[Mode] ? 0x40 : 0x00); if (pInfo->reg[MT2063_REG_PD1_TGT] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_PD1_TGT, val); } } /* LNARin */ if (MT2063_NO_ERROR(status)) { status |= MT2063_SetParam(pInfo, MT2063_LNA_RIN, LNARIN[Mode]); } /* FIFFQEN and FIFFQ */ if (MT2063_NO_ERROR(status)) { val = (pInfo-> reg[MT2063_REG_FIFF_CTRL2] & (U8Data) ~ 0xF0) | (FIFFQEN[Mode] << 7) | (FIFFQ[Mode] << 4); if (pInfo->reg[MT2063_REG_FIFF_CTRL2] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_FIFF_CTRL2, val); /* trigger FIFF calibration, needed after changing FIFFQ */ val = (pInfo->reg[MT2063_REG_FIFF_CTRL] | (U8Data) 0x01); status |= MT2063_SetReg(pInfo, MT2063_REG_FIFF_CTRL, val); val = (pInfo-> reg[MT2063_REG_FIFF_CTRL] & (U8Data) ~ 0x01); status |= MT2063_SetReg(pInfo, MT2063_REG_FIFF_CTRL, val); } } /* DNC1GC & DNC2GC */ status |= MT2063_GetParam(pInfo, MT2063_DNC_OUTPUT_ENABLE, &longval); status |= MT2063_SetParam(pInfo, MT2063_DNC_OUTPUT_ENABLE, longval); /* acLNAmax */ if (MT2063_NO_ERROR(status)) { status |= MT2063_SetParam(pInfo, MT2063_ACLNA_MAX, ACLNAMAX[Mode]); } /* LNATGT */ if (MT2063_NO_ERROR(status)) { status |= MT2063_SetParam(pInfo, MT2063_LNA_TGT, LNATGT[Mode]); } /* ACRF */ if (MT2063_NO_ERROR(status)) { status |= MT2063_SetParam(pInfo, MT2063_ACRF_MAX, ACRFMAX[Mode]); } /* PD1TGT */ if (MT2063_NO_ERROR(status)) { status |= MT2063_SetParam(pInfo, MT2063_PD1_TGT, PD1TGT[Mode]); } /* FIFATN */ if (MT2063_NO_ERROR(status)) { status |= MT2063_SetParam(pInfo, MT2063_ACFIF_MAX, ACFIFMAX[Mode]); } /* PD2TGT */ if (MT2063_NO_ERROR(status)) { status |= MT2063_SetParam(pInfo, MT2063_PD2_TGT, PD2TGT[Mode]); } /* Ignore ATN Overload */ if (MT2063_NO_ERROR(status)) { val = (pInfo-> reg[MT2063_REG_LNA_TGT] & (U8Data) ~ 0x80) | (RFOVDIS[Mode] ? 0x80 : 0x00); if (pInfo->reg[MT2063_REG_LNA_TGT] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_LNA_TGT, val); } } /* Ignore FIF Overload */ if (MT2063_NO_ERROR(status)) { val = (pInfo-> reg[MT2063_REG_PD1_TGT] & (U8Data) ~ 0x80) | (FIFOVDIS[Mode] ? 0x80 : 0x00); if (pInfo->reg[MT2063_REG_PD1_TGT] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_PD1_TGT, val); } } if (MT2063_NO_ERROR(status)) pInfo->rcvr_mode = Mode; return (status); } /****************************************************************************** ** ** Name: MT2063_ReInit ** ** Description: Initialize the tuner's register values. ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** ** Returns: status: ** MT_OK - No errors ** MT_TUNER_ID_ERR - Tuner Part/Rev code mismatch ** MT_INV_HANDLE - Invalid tuner handle ** MT_COMM_ERR - Serial bus communications error ** ** Dependencies: MT_ReadSub - Read byte(s) of data from the two-wire bus ** MT_WriteSub - Write byte(s) of data to the two-wire bus ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** 148 09-04-2007 RSK Ver 1.02: Corrected logic of Reg 3B Reference ** 153 09-07-2007 RSK Ver 1.03: Lock Time improvements ** N/A 10-31-2007 PINZ Ver 1.08: Changed values suitable to rcvr-mode 0 ** N/A 11-12-2007 PINZ Ver 1.09: Changed values suitable to rcvr-mode 0 ** N/A 01-03-2007 PINZ Ver 1.10: Added AFCsd = 1 into defaults ** N/A 01-04-2007 PINZ Ver 1.10: Changed CAP1sel default ** 01-14-2008 PINZ Ver 1.11: Updated gain settings ** 03-18-2008 PINZ Ver 1.13: Added Support for B3 ** 175 I 06-19-2008 RSK Ver 1.17: Refactor DECT control to SpurAvoid. ** 06-24-2008 PINZ Ver 1.18: Add Get/SetParam CTFILT_SW ** ******************************************************************************/ UData_t MT2063_ReInit(Handle_t h) { U8Data all_resets = 0xF0; /* reset/load bits */ UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; U8Data *def; U8Data MT2063B0_defaults[] = { /* Reg, Value */ 0x19, 0x05, 0x1B, 0x1D, 0x1C, 0x1F, 0x1D, 0x0F, 0x1E, 0x3F, 0x1F, 0x0F, 0x20, 0x3F, 0x22, 0x21, 0x23, 0x3F, 0x24, 0x20, 0x25, 0x3F, 0x27, 0xEE, 0x2C, 0x27, /* bit at 0x20 is cleared below */ 0x30, 0x03, 0x2C, 0x07, /* bit at 0x20 is cleared here */ 0x2D, 0x87, 0x2E, 0xAA, 0x28, 0xE1, /* Set the FIFCrst bit here */ 0x28, 0xE0, /* Clear the FIFCrst bit here */ 0x00 }; /* writing 0x05 0xf0 sw-resets all registers, so we write only needed changes */ U8Data MT2063B1_defaults[] = { /* Reg, Value */ 0x05, 0xF0, 0x11, 0x10, /* New Enable AFCsd */ 0x19, 0x05, 0x1A, 0x6C, 0x1B, 0x24, 0x1C, 0x28, 0x1D, 0x8F, 0x1E, 0x14, 0x1F, 0x8F, 0x20, 0x57, 0x22, 0x21, /* New - ver 1.03 */ 0x23, 0x3C, /* New - ver 1.10 */ 0x24, 0x20, /* New - ver 1.03 */ 0x2C, 0x24, /* bit at 0x20 is cleared below */ 0x2D, 0x87, /* FIFFQ=0 */ 0x2F, 0xF3, 0x30, 0x0C, /* New - ver 1.11 */ 0x31, 0x1B, /* New - ver 1.11 */ 0x2C, 0x04, /* bit at 0x20 is cleared here */ 0x28, 0xE1, /* Set the FIFCrst bit here */ 0x28, 0xE0, /* Clear the FIFCrst bit here */ 0x00 }; /* writing 0x05 0xf0 sw-resets all registers, so we write only needed changes */ U8Data MT2063B3_defaults[] = { /* Reg, Value */ 0x05, 0xF0, 0x19, 0x3D, 0x2C, 0x24, /* bit at 0x20 is cleared below */ 0x2C, 0x04, /* bit at 0x20 is cleared here */ 0x28, 0xE1, /* Set the FIFCrst bit here */ 0x28, 0xE0, /* Clear the FIFCrst bit here */ 0x00 }; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status |= MT2063_INV_HANDLE; /* Read the Part/Rev code from the tuner */ if (MT2063_NO_ERROR(status)) { status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_PART_REV, pInfo->reg, 1); } if (MT2063_NO_ERROR(status) /* Check the part/rev code */ &&((pInfo->reg[MT2063_REG_PART_REV] != MT2063_B0) /* MT2063 B0 */ &&(pInfo->reg[MT2063_REG_PART_REV] != MT2063_B1) /* MT2063 B1 */ &&(pInfo->reg[MT2063_REG_PART_REV] != MT2063_B3))) /* MT2063 B3 */ status |= MT2063_TUNER_ID_ERR; /* Wrong tuner Part/Rev code */ /* Read the Part/Rev code (2nd byte) from the tuner */ if (MT2063_NO_ERROR(status)) status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_RSVD_3B, &pInfo->reg[MT2063_REG_RSVD_3B], 1); if (MT2063_NO_ERROR(status) /* Check the 2nd part/rev code */ &&((pInfo->reg[MT2063_REG_RSVD_3B] & 0x80) != 0x00)) /* b7 != 0 ==> NOT MT2063 */ status |= MT2063_TUNER_ID_ERR; /* Wrong tuner Part/Rev code */ /* Reset the tuner */ if (MT2063_NO_ERROR(status)) status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2CQ_3, &all_resets, 1); /* change all of the default values that vary from the HW reset values */ /* def = (pInfo->reg[PART_REV] == MT2063_B0) ? MT2063B0_defaults : MT2063B1_defaults; */ switch (pInfo->reg[MT2063_REG_PART_REV]) { case MT2063_B3: def = MT2063B3_defaults; break; case MT2063_B1: def = MT2063B1_defaults; break; case MT2063_B0: def = MT2063B0_defaults; break; default: status |= MT2063_TUNER_ID_ERR; break; } while (MT2063_NO_ERROR(status) && *def) { U8Data reg = *def++; U8Data val = *def++; status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, reg, &val, 1); } /* Wait for FIFF location to complete. */ if (MT2063_NO_ERROR(status)) { UData_t FCRUN = 1; SData_t maxReads = 10; while (MT2063_NO_ERROR(status) && (FCRUN != 0) && (maxReads-- > 0)) { MT2063_Sleep(pInfo->hUserData, 2); status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_XO_STATUS, &pInfo-> reg[MT2063_REG_XO_STATUS], 1); FCRUN = (pInfo->reg[MT2063_REG_XO_STATUS] & 0x40) >> 6; } if (FCRUN != 0) status |= MT2063_TUNER_INIT_ERR | MT2063_TUNER_TIMEOUT; if (MT2063_NO_ERROR(status)) /* Re-read FIFFC value */ status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_FIFFC, &pInfo->reg[MT2063_REG_FIFFC], 1); } /* Read back all the registers from the tuner */ if (MT2063_NO_ERROR(status)) status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_PART_REV, pInfo->reg, MT2063_REG_END_REGS); if (MT2063_NO_ERROR(status)) { /* Initialize the tuner state. */ pInfo->version = MT2063_VERSION; pInfo->tuner_id = pInfo->reg[MT2063_REG_PART_REV]; pInfo->AS_Data.f_ref = MT2063_REF_FREQ; pInfo->AS_Data.f_if1_Center = (pInfo->AS_Data.f_ref / 8) * ((UData_t) pInfo->reg[MT2063_REG_FIFFC] + 640); pInfo->AS_Data.f_if1_bw = MT2063_IF1_BW; pInfo->AS_Data.f_out = 43750000UL; pInfo->AS_Data.f_out_bw = 6750000UL; pInfo->AS_Data.f_zif_bw = MT2063_ZIF_BW; pInfo->AS_Data.f_LO1_Step = pInfo->AS_Data.f_ref / 64; pInfo->AS_Data.f_LO2_Step = MT2063_TUNE_STEP_SIZE; pInfo->AS_Data.maxH1 = MT2063_MAX_HARMONICS_1; pInfo->AS_Data.maxH2 = MT2063_MAX_HARMONICS_2; pInfo->AS_Data.f_min_LO_Separation = MT2063_MIN_LO_SEP; pInfo->AS_Data.f_if1_Request = pInfo->AS_Data.f_if1_Center; pInfo->AS_Data.f_LO1 = 2181000000UL; pInfo->AS_Data.f_LO2 = 1486249786UL; pInfo->f_IF1_actual = pInfo->AS_Data.f_if1_Center; pInfo->AS_Data.f_in = pInfo->AS_Data.f_LO1 - pInfo->f_IF1_actual; pInfo->AS_Data.f_LO1_FracN_Avoid = MT2063_LO1_FRACN_AVOID; pInfo->AS_Data.f_LO2_FracN_Avoid = MT2063_LO2_FRACN_AVOID; pInfo->num_regs = MT2063_REG_END_REGS; pInfo->AS_Data.avoidDECT = MT2063_AVOID_BOTH; pInfo->ctfilt_sw = 0; } if (MT2063_NO_ERROR(status)) { pInfo->CTFiltMax[0] = 69230000; pInfo->CTFiltMax[1] = 105770000; pInfo->CTFiltMax[2] = 140350000; pInfo->CTFiltMax[3] = 177110000; pInfo->CTFiltMax[4] = 212860000; pInfo->CTFiltMax[5] = 241130000; pInfo->CTFiltMax[6] = 274370000; pInfo->CTFiltMax[7] = 309820000; pInfo->CTFiltMax[8] = 342450000; pInfo->CTFiltMax[9] = 378870000; pInfo->CTFiltMax[10] = 416210000; pInfo->CTFiltMax[11] = 456500000; pInfo->CTFiltMax[12] = 495790000; pInfo->CTFiltMax[13] = 534530000; pInfo->CTFiltMax[14] = 572610000; pInfo->CTFiltMax[15] = 598970000; pInfo->CTFiltMax[16] = 635910000; pInfo->CTFiltMax[17] = 672130000; pInfo->CTFiltMax[18] = 714840000; pInfo->CTFiltMax[19] = 739660000; pInfo->CTFiltMax[20] = 770410000; pInfo->CTFiltMax[21] = 814660000; pInfo->CTFiltMax[22] = 846950000; pInfo->CTFiltMax[23] = 867820000; pInfo->CTFiltMax[24] = 915980000; pInfo->CTFiltMax[25] = 947450000; pInfo->CTFiltMax[26] = 983110000; pInfo->CTFiltMax[27] = 1021630000; pInfo->CTFiltMax[28] = 1061870000; pInfo->CTFiltMax[29] = 1098330000; pInfo->CTFiltMax[30] = 1138990000; } /* ** Fetch the FCU osc value and use it and the fRef value to ** scale all of the Band Max values */ if (MT2063_NO_ERROR(status)) { UData_t fcu_osc; UData_t i; pInfo->reg[MT2063_REG_CTUNE_CTRL] = 0x0A; status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_CTUNE_CTRL, &pInfo->reg[MT2063_REG_CTUNE_CTRL], 1); /* Read the ClearTune filter calibration value */ status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_FIFFC, &pInfo->reg[MT2063_REG_FIFFC], 1); fcu_osc = pInfo->reg[MT2063_REG_FIFFC]; pInfo->reg[MT2063_REG_CTUNE_CTRL] = 0x00; status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_CTUNE_CTRL, &pInfo->reg[MT2063_REG_CTUNE_CTRL], 1); /* Adjust each of the values in the ClearTune filter cross-over table */ for (i = 0; i < 31; i++) { pInfo->CTFiltMax[i] = (pInfo->CTFiltMax[i] / 768) * (fcu_osc + 640); } } return (status); } /****************************************************************************** ** ** Name: MT2063_SetGPIO ** ** Description: Modify the MT2063 GPIO value. ** ** Parameters: h - Open handle to the tuner (from MT2063_Open). ** gpio_id - Selects GPIO0, GPIO1 or GPIO2 ** attr - Selects input readback, I/O direction or ** output value ** value - value to set GPIO pin 15, 14 or 19 ** ** Usage: status = MT2063_SetGPIO(hMT2063, MT2063_GPIO1, MT2063_GPIO_OUT, 1); ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** MT_INV_HANDLE - Invalid tuner handle ** ** Dependencies: MT_WriteSub - Write byte(s) of data to the two-wire-bus ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ******************************************************************************/ UData_t MT2063_SetGPIO(Handle_t h, enum MT2063_GPIO_ID gpio_id, enum MT2063_GPIO_Attr attr, UData_t value) { UData_t status = MT2063_OK; /* Status to be returned */ U8Data regno; SData_t shift; static U8Data GPIOreg[3] = { 0x15, 0x19, 0x18 }; struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; if (MT2063_IsValidHandle(pInfo) == 0) return MT2063_INV_HANDLE; regno = GPIOreg[attr]; shift = (gpio_id - MT2063_GPIO0 + 5); if (value & 0x01) pInfo->reg[regno] |= (0x01 << shift); else pInfo->reg[regno] &= ~(0x01 << shift); status = MT2063_WriteSub(pInfo->hUserData, pInfo->address, regno, &pInfo->reg[regno], 1); return (status); } /**************************************************************************** ** ** Name: MT2063_SetParam ** ** Description: Sets a tuning algorithm parameter. ** ** This function provides access to the internals of the ** tuning algorithm. You can override many of the tuning ** algorithm defaults using this function. ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** param - Tuning algorithm parameter ** (see enum MT2063_Param) ** nValue - value to be set ** ** param Description ** ---------------------- -------------------------------- ** MT2063_SRO_FREQ crystal frequency ** MT2063_STEPSIZE minimum tuning step size ** MT2063_LO1_FREQ LO1 frequency ** MT2063_LO1_STEPSIZE LO1 minimum step size ** MT2063_LO1_FRACN_AVOID LO1 FracN keep-out region ** MT2063_IF1_REQUEST Requested 1st IF ** MT2063_ZIF_BW zero-IF bandwidth ** MT2063_LO2_FREQ LO2 frequency ** MT2063_LO2_STEPSIZE LO2 minimum step size ** MT2063_LO2_FRACN_AVOID LO2 FracN keep-out region ** MT2063_OUTPUT_FREQ output center frequency ** MT2063_OUTPUT_BW output bandwidth ** MT2063_LO_SEPARATION min inter-tuner LO separation ** MT2063_MAX_HARM1 max # of intra-tuner harmonics ** MT2063_MAX_HARM2 max # of inter-tuner harmonics ** MT2063_RCVR_MODE Predefined modes ** MT2063_LNA_RIN Set LNA Rin (*) ** MT2063_LNA_TGT Set target power level at LNA (*) ** MT2063_PD1_TGT Set target power level at PD1 (*) ** MT2063_PD2_TGT Set target power level at PD2 (*) ** MT2063_ACLNA_MAX LNA attenuator limit (*) ** MT2063_ACRF_MAX RF attenuator limit (*) ** MT2063_ACFIF_MAX FIF attenuator limit (*) ** MT2063_DNC_OUTPUT_ENABLE DNC output selection ** MT2063_VGAGC VGA gain code ** MT2063_VGAOI VGA output current ** MT2063_TAGC TAGC setting ** MT2063_AMPGC AMP gain code ** MT2063_AVOID_DECT Avoid DECT Frequencies ** MT2063_CTFILT_SW Cleartune filter selection ** ** (*) This parameter is set by MT2063_RCVR_MODE, do not call ** additionally. ** ** Usage: status |= MT2063_SetParam(hMT2063, ** MT2063_STEPSIZE, ** 50000); ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_ARG_NULL - Null pointer argument passed ** MT_ARG_RANGE - Invalid parameter requested ** or set value out of range ** or non-writable parameter ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** See Also: MT2063_GetParam, MT2063_Open ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** 154 09-13-2007 RSK Ver 1.05: Get/SetParam changes for LOx_FREQ ** 10-31-2007 PINZ Ver 1.08: Get/SetParam add VGAGC, VGAOI, AMPGC, TAGC ** 04-18-2008 PINZ Ver 1.15: Add SetParam LNARIN & PDxTGT ** Split SetParam up to ACLNA / ACLNA_MAX ** removed ACLNA_INRC/DECR (+RF & FIF) ** removed GCUAUTO / BYPATNDN/UP ** 175 I 06-06-2008 PINZ Ver 1.16: Add control to avoid US DECT freqs. ** 175 I 06-19-2008 RSK Ver 1.17: Refactor DECT control to SpurAvoid. ** 06-24-2008 PINZ Ver 1.18: Add Get/SetParam CTFILT_SW ** ****************************************************************************/ UData_t MT2063_SetParam(Handle_t h, enum MT2063_Param param, UData_t nValue) { UData_t status = MT2063_OK; /* Status to be returned */ U8Data val = 0; struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status |= MT2063_INV_HANDLE; if (MT2063_NO_ERROR(status)) { switch (param) { /* crystal frequency */ case MT2063_SRO_FREQ: pInfo->AS_Data.f_ref = nValue; pInfo->AS_Data.f_LO1_FracN_Avoid = 0; pInfo->AS_Data.f_LO2_FracN_Avoid = nValue / 80 - 1; pInfo->AS_Data.f_LO1_Step = nValue / 64; pInfo->AS_Data.f_if1_Center = (pInfo->AS_Data.f_ref / 8) * (pInfo->reg[MT2063_REG_FIFFC] + 640); break; /* minimum tuning step size */ case MT2063_STEPSIZE: pInfo->AS_Data.f_LO2_Step = nValue; break; /* LO1 frequency */ case MT2063_LO1_FREQ: { /* Note: LO1 and LO2 are BOTH written at toggle of LDLOos */ /* Capture the Divider and Numerator portions of other LO */ U8Data tempLO2CQ[3]; U8Data tempLO2C[3]; U8Data tmpOneShot; UData_t Div, FracN; U8Data restore = 0; /* Buffer the queue for restoration later and get actual LO2 values. */ status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2CQ_1, &(tempLO2CQ[0]), 3); status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2C_1, &(tempLO2C[0]), 3); /* clear the one-shot bits */ tempLO2CQ[2] = tempLO2CQ[2] & 0x0F; tempLO2C[2] = tempLO2C[2] & 0x0F; /* only write the queue values if they are different from the actual. */ if ((tempLO2CQ[0] != tempLO2C[0]) || (tempLO2CQ[1] != tempLO2C[1]) || (tempLO2CQ[2] != tempLO2C[2])) { /* put actual LO2 value into queue (with 0 in one-shot bits) */ status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2CQ_1, &(tempLO2C[0]), 3); if (status == MT2063_OK) { /* cache the bytes just written. */ pInfo->reg[MT2063_REG_LO2CQ_1] = tempLO2C[0]; pInfo->reg[MT2063_REG_LO2CQ_2] = tempLO2C[1]; pInfo->reg[MT2063_REG_LO2CQ_3] = tempLO2C[2]; } restore = 1; } /* Calculate the Divider and Numberator components of LO1 */ status = MT2063_CalcLO1Mult(&Div, &FracN, nValue, pInfo->AS_Data.f_ref / 64, pInfo->AS_Data.f_ref); pInfo->reg[MT2063_REG_LO1CQ_1] = (U8Data) (Div & 0x00FF); pInfo->reg[MT2063_REG_LO1CQ_2] = (U8Data) (FracN); status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO1CQ_1, &pInfo-> reg[MT2063_REG_LO1CQ_1], 2); /* set the one-shot bit to load the pair of LO values */ tmpOneShot = tempLO2CQ[2] | 0xE0; status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2CQ_3, &tmpOneShot, 1); /* only restore the queue values if they were different from the actual. */ if (restore) { /* put actual LO2 value into queue (0 in one-shot bits) */ status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2CQ_1, &(tempLO2CQ[0]), 3); /* cache the bytes just written. */ pInfo->reg[MT2063_REG_LO2CQ_1] = tempLO2CQ[0]; pInfo->reg[MT2063_REG_LO2CQ_2] = tempLO2CQ[1]; pInfo->reg[MT2063_REG_LO2CQ_3] = tempLO2CQ[2]; } MT2063_GetParam(pInfo->hUserData, MT2063_LO1_FREQ, &pInfo->AS_Data.f_LO1); } break; /* LO1 minimum step size */ case MT2063_LO1_STEPSIZE: pInfo->AS_Data.f_LO1_Step = nValue; break; /* LO1 FracN keep-out region */ case MT2063_LO1_FRACN_AVOID_PARAM: pInfo->AS_Data.f_LO1_FracN_Avoid = nValue; break; /* Requested 1st IF */ case MT2063_IF1_REQUEST: pInfo->AS_Data.f_if1_Request = nValue; break; /* zero-IF bandwidth */ case MT2063_ZIF_BW: pInfo->AS_Data.f_zif_bw = nValue; break; /* LO2 frequency */ case MT2063_LO2_FREQ: { /* Note: LO1 and LO2 are BOTH written at toggle of LDLOos */ /* Capture the Divider and Numerator portions of other LO */ U8Data tempLO1CQ[2]; U8Data tempLO1C[2]; UData_t Div2; UData_t FracN2; U8Data tmpOneShot; U8Data restore = 0; /* Buffer the queue for restoration later and get actual LO2 values. */ status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO1CQ_1, &(tempLO1CQ[0]), 2); status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO1C_1, &(tempLO1C[0]), 2); /* only write the queue values if they are different from the actual. */ if ((tempLO1CQ[0] != tempLO1C[0]) || (tempLO1CQ[1] != tempLO1C[1])) { /* put actual LO1 value into queue */ status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO1CQ_1, &(tempLO1C[0]), 2); /* cache the bytes just written. */ pInfo->reg[MT2063_REG_LO1CQ_1] = tempLO1C[0]; pInfo->reg[MT2063_REG_LO1CQ_2] = tempLO1C[1]; restore = 1; } /* Calculate the Divider and Numberator components of LO2 */ status = MT2063_CalcLO2Mult(&Div2, &FracN2, nValue, pInfo->AS_Data.f_ref / 8191, pInfo->AS_Data.f_ref); pInfo->reg[MT2063_REG_LO2CQ_1] = (U8Data) ((Div2 << 1) | ((FracN2 >> 12) & 0x01)) & 0xFF; pInfo->reg[MT2063_REG_LO2CQ_2] = (U8Data) ((FracN2 >> 4) & 0xFF); pInfo->reg[MT2063_REG_LO2CQ_3] = (U8Data) ((FracN2 & 0x0F)); status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO1CQ_1, &pInfo-> reg[MT2063_REG_LO1CQ_1], 3); /* set the one-shot bit to load the LO values */ tmpOneShot = pInfo->reg[MT2063_REG_LO2CQ_3] | 0xE0; status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2CQ_3, &tmpOneShot, 1); /* only restore LO1 queue value if they were different from the actual. */ if (restore) { /* put previous LO1 queue value back into queue */ status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO1CQ_1, &(tempLO1CQ[0]), 2); /* cache the bytes just written. */ pInfo->reg[MT2063_REG_LO1CQ_1] = tempLO1CQ[0]; pInfo->reg[MT2063_REG_LO1CQ_2] = tempLO1CQ[1]; } MT2063_GetParam(pInfo->hUserData, MT2063_LO2_FREQ, &pInfo->AS_Data.f_LO2); } break; /* LO2 minimum step size */ case MT2063_LO2_STEPSIZE: pInfo->AS_Data.f_LO2_Step = nValue; break; /* LO2 FracN keep-out region */ case MT2063_LO2_FRACN_AVOID: pInfo->AS_Data.f_LO2_FracN_Avoid = nValue; break; /* output center frequency */ case MT2063_OUTPUT_FREQ: pInfo->AS_Data.f_out = nValue; break; /* output bandwidth */ case MT2063_OUTPUT_BW: pInfo->AS_Data.f_out_bw = nValue + 750000; break; /* min inter-tuner LO separation */ case MT2063_LO_SEPARATION: pInfo->AS_Data.f_min_LO_Separation = nValue; break; /* max # of intra-tuner harmonics */ case MT2063_MAX_HARM1: pInfo->AS_Data.maxH1 = nValue; break; /* max # of inter-tuner harmonics */ case MT2063_MAX_HARM2: pInfo->AS_Data.maxH2 = nValue; break; case MT2063_RCVR_MODE: status |= MT2063_SetReceiverMode(pInfo, (enum MT2063_RCVR_MODES) nValue); break; /* Set LNA Rin -- nValue is desired value */ case MT2063_LNA_RIN: val = (pInfo-> reg[MT2063_REG_CTRL_2C] & (U8Data) ~ 0x03) | (nValue & 0x03); if (pInfo->reg[MT2063_REG_CTRL_2C] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_CTRL_2C, val); } break; /* Set target power level at LNA -- nValue is desired value */ case MT2063_LNA_TGT: val = (pInfo-> reg[MT2063_REG_LNA_TGT] & (U8Data) ~ 0x3F) | (nValue & 0x3F); if (pInfo->reg[MT2063_REG_LNA_TGT] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_LNA_TGT, val); } break; /* Set target power level at PD1 -- nValue is desired value */ case MT2063_PD1_TGT: val = (pInfo-> reg[MT2063_REG_PD1_TGT] & (U8Data) ~ 0x3F) | (nValue & 0x3F); if (pInfo->reg[MT2063_REG_PD1_TGT] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_PD1_TGT, val); } break; /* Set target power level at PD2 -- nValue is desired value */ case MT2063_PD2_TGT: val = (pInfo-> reg[MT2063_REG_PD2_TGT] & (U8Data) ~ 0x3F) | (nValue & 0x3F); if (pInfo->reg[MT2063_REG_PD2_TGT] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_PD2_TGT, val); } break; /* Set LNA atten limit -- nValue is desired value */ case MT2063_ACLNA_MAX: val = (pInfo-> reg[MT2063_REG_LNA_OV] & (U8Data) ~ 0x1F) | (nValue & 0x1F); if (pInfo->reg[MT2063_REG_LNA_OV] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_LNA_OV, val); } break; /* Set RF atten limit -- nValue is desired value */ case MT2063_ACRF_MAX: val = (pInfo-> reg[MT2063_REG_RF_OV] & (U8Data) ~ 0x1F) | (nValue & 0x1F); if (pInfo->reg[MT2063_REG_RF_OV] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_RF_OV, val); } break; /* Set FIF atten limit -- nValue is desired value, max. 5 if no B3 */ case MT2063_ACFIF_MAX: if (pInfo->reg[MT2063_REG_PART_REV] != MT2063_B3 && nValue > 5) nValue = 5; val = (pInfo-> reg[MT2063_REG_FIF_OV] & (U8Data) ~ 0x1F) | (nValue & 0x1F); if (pInfo->reg[MT2063_REG_FIF_OV] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_FIF_OV, val); } break; case MT2063_DNC_OUTPUT_ENABLE: /* selects, which DNC output is used */ switch ((enum MT2063_DNC_Output_Enable)nValue) { case MT2063_DNC_NONE: { val = (pInfo->reg[MT2063_REG_DNC_GAIN] & 0xFC) | 0x03; /* Set DNC1GC=3 */ if (pInfo->reg[MT2063_REG_DNC_GAIN] != val) status |= MT2063_SetReg(h, MT2063_REG_DNC_GAIN, val); val = (pInfo->reg[MT2063_REG_VGA_GAIN] & 0xFC) | 0x03; /* Set DNC2GC=3 */ if (pInfo->reg[MT2063_REG_VGA_GAIN] != val) status |= MT2063_SetReg(h, MT2063_REG_VGA_GAIN, val); val = (pInfo->reg[MT2063_REG_RSVD_20] & ~0x40); /* Set PD2MUX=0 */ if (pInfo->reg[MT2063_REG_RSVD_20] != val) status |= MT2063_SetReg(h, MT2063_REG_RSVD_20, val); break; } case MT2063_DNC_1: { val = (pInfo->reg[MT2063_REG_DNC_GAIN] & 0xFC) | (DNC1GC[pInfo->rcvr_mode] & 0x03); /* Set DNC1GC=x */ if (pInfo->reg[MT2063_REG_DNC_GAIN] != val) status |= MT2063_SetReg(h, MT2063_REG_DNC_GAIN, val); val = (pInfo->reg[MT2063_REG_VGA_GAIN] & 0xFC) | 0x03; /* Set DNC2GC=3 */ if (pInfo->reg[MT2063_REG_VGA_GAIN] != val) status |= MT2063_SetReg(h, MT2063_REG_VGA_GAIN, val); val = (pInfo->reg[MT2063_REG_RSVD_20] & ~0x40); /* Set PD2MUX=0 */ if (pInfo->reg[MT2063_REG_RSVD_20] != val) status |= MT2063_SetReg(h, MT2063_REG_RSVD_20, val); break; } case MT2063_DNC_2: { val = (pInfo->reg[MT2063_REG_DNC_GAIN] & 0xFC) | 0x03; /* Set DNC1GC=3 */ if (pInfo->reg[MT2063_REG_DNC_GAIN] != val) status |= MT2063_SetReg(h, MT2063_REG_DNC_GAIN, val); val = (pInfo->reg[MT2063_REG_VGA_GAIN] & 0xFC) | (DNC2GC[pInfo->rcvr_mode] & 0x03); /* Set DNC2GC=x */ if (pInfo->reg[MT2063_REG_VGA_GAIN] != val) status |= MT2063_SetReg(h, MT2063_REG_VGA_GAIN, val); val = (pInfo->reg[MT2063_REG_RSVD_20] | 0x40); /* Set PD2MUX=1 */ if (pInfo->reg[MT2063_REG_RSVD_20] != val) status |= MT2063_SetReg(h, MT2063_REG_RSVD_20, val); break; } case MT2063_DNC_BOTH: { val = (pInfo->reg[MT2063_REG_DNC_GAIN] & 0xFC) | (DNC1GC[pInfo->rcvr_mode] & 0x03); /* Set DNC1GC=x */ if (pInfo->reg[MT2063_REG_DNC_GAIN] != val) status |= MT2063_SetReg(h, MT2063_REG_DNC_GAIN, val); val = (pInfo->reg[MT2063_REG_VGA_GAIN] & 0xFC) | (DNC2GC[pInfo->rcvr_mode] & 0x03); /* Set DNC2GC=x */ if (pInfo->reg[MT2063_REG_VGA_GAIN] != val) status |= MT2063_SetReg(h, MT2063_REG_VGA_GAIN, val); val = (pInfo->reg[MT2063_REG_RSVD_20] | 0x40); /* Set PD2MUX=1 */ if (pInfo->reg[MT2063_REG_RSVD_20] != val) status |= MT2063_SetReg(h, MT2063_REG_RSVD_20, val); break; } default: break; } break; case MT2063_VGAGC: /* Set VGA gain code */ val = (pInfo-> reg[MT2063_REG_VGA_GAIN] & (U8Data) ~ 0x0C) | ((nValue & 0x03) << 2); if (pInfo->reg[MT2063_REG_VGA_GAIN] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_VGA_GAIN, val); } break; case MT2063_VGAOI: /* Set VGA bias current */ val = (pInfo-> reg[MT2063_REG_RSVD_31] & (U8Data) ~ 0x07) | (nValue & 0x07); if (pInfo->reg[MT2063_REG_RSVD_31] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_RSVD_31, val); } break; case MT2063_TAGC: /* Set TAGC */ val = (pInfo-> reg[MT2063_REG_RSVD_1E] & (U8Data) ~ 0x03) | (nValue & 0x03); if (pInfo->reg[MT2063_REG_RSVD_1E] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_RSVD_1E, val); } break; case MT2063_AMPGC: /* Set Amp gain code */ val = (pInfo-> reg[MT2063_REG_TEMP_SEL] & (U8Data) ~ 0x03) | (nValue & 0x03); if (pInfo->reg[MT2063_REG_TEMP_SEL] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_TEMP_SEL, val); } break; /* Avoid DECT Frequencies */ case MT2063_AVOID_DECT: { enum MT2063_DECT_Avoid_Type newAvoidSetting = (enum MT2063_DECT_Avoid_Type)nValue; if ((newAvoidSetting >= MT2063_NO_DECT_AVOIDANCE) && (newAvoidSetting <= MT2063_AVOID_BOTH)) { pInfo->AS_Data.avoidDECT = newAvoidSetting; } } break; /* Cleartune filter selection: 0 - by IC (default), 1 - by software */ case MT2063_CTFILT_SW: pInfo->ctfilt_sw = (nValue & 0x01); break; /* These parameters are read-only */ case MT2063_IC_ADDR: case MT2063_MAX_OPEN: case MT2063_NUM_OPEN: case MT2063_INPUT_FREQ: case MT2063_IF1_ACTUAL: case MT2063_IF1_CENTER: case MT2063_IF1_BW: case MT2063_AS_ALG: case MT2063_EXCL_ZONES: case MT2063_SPUR_AVOIDED: case MT2063_NUM_SPURS: case MT2063_SPUR_PRESENT: case MT2063_ACLNA: case MT2063_ACRF: case MT2063_ACFIF: case MT2063_EOP: default: status |= MT2063_ARG_RANGE; } } return (status); } /**************************************************************************** ** ** Name: MT2063_SetPowerMaskBits ** ** Description: Sets the power-down mask bits for various sections of ** the MT2063 ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** Bits - Mask bits to be set. ** ** See definition of MT2063_Mask_Bits type for description ** of each of the power bits. ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_COMM_ERR - Serial bus communications error ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ UData_t MT2063_SetPowerMaskBits(Handle_t h, enum MT2063_Mask_Bits Bits) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status = MT2063_INV_HANDLE; else { Bits = (enum MT2063_Mask_Bits)(Bits & MT2063_ALL_SD); /* Only valid bits for this tuner */ if ((Bits & 0xFF00) != 0) { pInfo->reg[MT2063_REG_PWR_2] |= (U8Data) ((Bits & 0xFF00) >> 8); status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_PWR_2, &pInfo->reg[MT2063_REG_PWR_2], 1); } if ((Bits & 0xFF) != 0) { pInfo->reg[MT2063_REG_PWR_1] |= ((U8Data) Bits & 0xFF); status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_PWR_1, &pInfo->reg[MT2063_REG_PWR_1], 1); } } return (status); } /**************************************************************************** ** ** Name: MT2063_ClearPowerMaskBits ** ** Description: Clears the power-down mask bits for various sections of ** the MT2063 ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** Bits - Mask bits to be cleared. ** ** See definition of MT2063_Mask_Bits type for description ** of each of the power bits. ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_COMM_ERR - Serial bus communications error ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ UData_t MT2063_ClearPowerMaskBits(Handle_t h, enum MT2063_Mask_Bits Bits) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status = MT2063_INV_HANDLE; else { Bits = (enum MT2063_Mask_Bits)(Bits & MT2063_ALL_SD); /* Only valid bits for this tuner */ if ((Bits & 0xFF00) != 0) { pInfo->reg[MT2063_REG_PWR_2] &= ~(U8Data) (Bits >> 8); status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_PWR_2, &pInfo->reg[MT2063_REG_PWR_2], 1); } if ((Bits & 0xFF) != 0) { pInfo->reg[MT2063_REG_PWR_1] &= ~(U8Data) (Bits & 0xFF); status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_PWR_1, &pInfo->reg[MT2063_REG_PWR_1], 1); } } return (status); } /**************************************************************************** ** ** Name: MT2063_GetPowerMaskBits ** ** Description: Returns a mask of the enabled power shutdown bits ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** Bits - Mask bits to currently set. ** ** See definition of MT2063_Mask_Bits type for description ** of each of the power bits. ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_ARG_NULL - Output argument is NULL ** MT_COMM_ERR - Serial bus communications error ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ UData_t MT2063_GetPowerMaskBits(Handle_t h, enum MT2063_Mask_Bits * Bits) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status = MT2063_INV_HANDLE; else { if (Bits == NULL) status |= MT2063_ARG_NULL; if (MT2063_NO_ERROR(status)) status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_PWR_1, &pInfo->reg[MT2063_REG_PWR_1], 2); if (MT2063_NO_ERROR(status)) { *Bits = (enum MT2063_Mask_Bits)(((SData_t) pInfo-> reg[MT2063_REG_PWR_2] << 8) + pInfo->reg[MT2063_REG_PWR_1]); *Bits = (enum MT2063_Mask_Bits)(*Bits & MT2063_ALL_SD); /* Only valid bits for this tuner */ } } return (status); } /**************************************************************************** ** ** Name: MT2063_EnableExternalShutdown ** ** Description: Enables or disables the operation of the external ** shutdown pin ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** Enabled - 0 = disable the pin, otherwise enable it ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_COMM_ERR - Serial bus communications error ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ UData_t MT2063_EnableExternalShutdown(Handle_t h, U8Data Enabled) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status = MT2063_INV_HANDLE; else { if (Enabled == 0) pInfo->reg[MT2063_REG_PWR_1] &= ~0x08; /* Turn off the bit */ else pInfo->reg[MT2063_REG_PWR_1] |= 0x08; /* Turn the bit on */ status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_PWR_1, &pInfo->reg[MT2063_REG_PWR_1], 1); } return (status); } /**************************************************************************** ** ** Name: MT2063_SoftwareShutdown ** ** Description: Enables or disables software shutdown function. When ** Shutdown==1, any section whose power mask is set will be ** shutdown. ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** Shutdown - 1 = shutdown the masked sections, otherwise ** power all sections on ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_COMM_ERR - Serial bus communications error ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** 01-03-2008 PINZ Ver 1.xx: Added a trigger of BYPATNUP for ** correct wakeup of the LNA ** ****************************************************************************/ UData_t MT2063_SoftwareShutdown(Handle_t h, U8Data Shutdown) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) { status = MT2063_INV_HANDLE; } else { if (Shutdown == 1) pInfo->reg[MT2063_REG_PWR_1] |= 0x04; /* Turn the bit on */ else pInfo->reg[MT2063_REG_PWR_1] &= ~0x04; /* Turn off the bit */ status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_PWR_1, &pInfo->reg[MT2063_REG_PWR_1], 1); if (Shutdown != 1) { pInfo->reg[MT2063_REG_BYP_CTRL] = (pInfo->reg[MT2063_REG_BYP_CTRL] & 0x9F) | 0x40; status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_BYP_CTRL, &pInfo->reg[MT2063_REG_BYP_CTRL], 1); pInfo->reg[MT2063_REG_BYP_CTRL] = (pInfo->reg[MT2063_REG_BYP_CTRL] & 0x9F); status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_BYP_CTRL, &pInfo->reg[MT2063_REG_BYP_CTRL], 1); } } return (status); } /**************************************************************************** ** ** Name: MT2063_SetExtSRO ** ** Description: Sets the external SRO driver. ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** Ext_SRO_Setting - external SRO drive setting ** ** (default) MT2063_EXT_SRO_OFF - ext driver off ** MT2063_EXT_SRO_BY_1 - ext driver = SRO frequency ** MT2063_EXT_SRO_BY_2 - ext driver = SRO/2 frequency ** MT2063_EXT_SRO_BY_4 - ext driver = SRO/4 frequency ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** MT_INV_HANDLE - Invalid tuner handle ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** The Ext_SRO_Setting settings default to OFF ** Use this function if you need to override the default ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** 189 S 05-13-2008 RSK Ver 1.16: Correct location for ExtSRO control. ** ****************************************************************************/ UData_t MT2063_SetExtSRO(Handle_t h, enum MT2063_Ext_SRO Ext_SRO_Setting) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status = MT2063_INV_HANDLE; else { pInfo->reg[MT2063_REG_CTRL_2C] = (pInfo-> reg[MT2063_REG_CTRL_2C] & 0x3F) | ((U8Data) Ext_SRO_Setting << 6); status = MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_CTRL_2C, &pInfo->reg[MT2063_REG_CTRL_2C], 1); } return (status); } /**************************************************************************** ** ** Name: MT2063_SetReg ** ** Description: Sets an MT2063 register. ** ** Parameters: h - Tuner handle (returned by MT2063_Open) ** reg - MT2063 register/subaddress location ** val - MT2063 register/subaddress value ** ** Returns: status: ** MT_OK - No errors ** MT_COMM_ERR - Serial bus communications error ** MT_INV_HANDLE - Invalid tuner handle ** MT_ARG_RANGE - Argument out of range ** ** Dependencies: USERS MUST CALL MT2063_Open() FIRST! ** ** Use this function if you need to override a default ** register value ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ UData_t MT2063_SetReg(Handle_t h, U8Data reg, U8Data val) { UData_t status = MT2063_OK; /* Status to be returned */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) status |= MT2063_INV_HANDLE; if (reg >= MT2063_REG_END_REGS) status |= MT2063_ARG_RANGE; if (MT2063_NO_ERROR(status)) { status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, reg, &val, 1); if (MT2063_NO_ERROR(status)) pInfo->reg[reg] = val; } return (status); } static UData_t MT2063_Round_fLO(UData_t f_LO, UData_t f_LO_Step, UData_t f_ref) { return f_ref * (f_LO / f_ref) + f_LO_Step * (((f_LO % f_ref) + (f_LO_Step / 2)) / f_LO_Step); } /**************************************************************************** ** ** Name: fLO_FractionalTerm ** ** Description: Calculates the portion contributed by FracN / denom. ** ** This function preserves maximum precision without ** risk of overflow. It accurately calculates ** f_ref * num / denom to within 1 HZ with fixed math. ** ** Parameters: num - Fractional portion of the multiplier ** denom - denominator portion of the ratio ** This routine successfully handles denom values ** up to and including 2^18. ** f_Ref - SRO frequency. This calculation handles ** f_ref as two separate 14-bit fields. ** Therefore, a maximum value of 2^28-1 ** may safely be used for f_ref. This is ** the genesis of the magic number "14" and the ** magic mask value of 0x03FFF. ** ** Returns: f_ref * num / denom ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ static UData_t MT2063_fLO_FractionalTerm(UData_t f_ref, UData_t num, UData_t denom) { UData_t t1 = (f_ref >> 14) * num; UData_t term1 = t1 / denom; UData_t loss = t1 % denom; UData_t term2 = (((f_ref & 0x00003FFF) * num + (loss << 14)) + (denom / 2)) / denom; return ((term1 << 14) + term2); } /**************************************************************************** ** ** Name: CalcLO1Mult ** ** Description: Calculates Integer divider value and the numerator ** value for a FracN PLL. ** ** This function assumes that the f_LO and f_Ref are ** evenly divisible by f_LO_Step. ** ** Parameters: Div - OUTPUT: Whole number portion of the multiplier ** FracN - OUTPUT: Fractional portion of the multiplier ** f_LO - desired LO frequency. ** f_LO_Step - Minimum step size for the LO (in Hz). ** f_Ref - SRO frequency. ** f_Avoid - Range of PLL frequencies to avoid near ** integer multiples of f_Ref (in Hz). ** ** Returns: Recalculated LO frequency. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ static UData_t MT2063_CalcLO1Mult(UData_t * Div, UData_t * FracN, UData_t f_LO, UData_t f_LO_Step, UData_t f_Ref) { /* Calculate the whole number portion of the divider */ *Div = f_LO / f_Ref; /* Calculate the numerator value (round to nearest f_LO_Step) */ *FracN = (64 * (((f_LO % f_Ref) + (f_LO_Step / 2)) / f_LO_Step) + (f_Ref / f_LO_Step / 2)) / (f_Ref / f_LO_Step); return (f_Ref * (*Div)) + MT2063_fLO_FractionalTerm(f_Ref, *FracN, 64); } /**************************************************************************** ** ** Name: CalcLO2Mult ** ** Description: Calculates Integer divider value and the numerator ** value for a FracN PLL. ** ** This function assumes that the f_LO and f_Ref are ** evenly divisible by f_LO_Step. ** ** Parameters: Div - OUTPUT: Whole number portion of the multiplier ** FracN - OUTPUT: Fractional portion of the multiplier ** f_LO - desired LO frequency. ** f_LO_Step - Minimum step size for the LO (in Hz). ** f_Ref - SRO frequency. ** f_Avoid - Range of PLL frequencies to avoid near ** integer multiples of f_Ref (in Hz). ** ** Returns: Recalculated LO frequency. ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** ****************************************************************************/ static UData_t MT2063_CalcLO2Mult(UData_t * Div, UData_t * FracN, UData_t f_LO, UData_t f_LO_Step, UData_t f_Ref) { /* Calculate the whole number portion of the divider */ *Div = f_LO / f_Ref; /* Calculate the numerator value (round to nearest f_LO_Step) */ *FracN = (8191 * (((f_LO % f_Ref) + (f_LO_Step / 2)) / f_LO_Step) + (f_Ref / f_LO_Step / 2)) / (f_Ref / f_LO_Step); return (f_Ref * (*Div)) + MT2063_fLO_FractionalTerm(f_Ref, *FracN, 8191); } /**************************************************************************** ** ** Name: FindClearTuneFilter ** ** Description: Calculate the corrrect ClearTune filter to be used for ** a given input frequency. ** ** Parameters: pInfo - ptr to tuner data structure ** f_in - RF input center frequency (in Hz). ** ** Returns: ClearTune filter number (0-31) ** ** Dependencies: MUST CALL MT2064_Open BEFORE FindClearTuneFilter! ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 04-10-2008 PINZ Ver 1.14: Use software-controlled ClearTune ** cross-over frequency values. ** ****************************************************************************/ static UData_t FindClearTuneFilter(struct MT2063_Info_t *pInfo, UData_t f_in) { UData_t RFBand; UData_t idx; /* index loop */ /* ** Find RF Band setting */ RFBand = 31; /* def when f_in > all */ for (idx = 0; idx < 31; ++idx) { if (pInfo->CTFiltMax[idx] >= f_in) { RFBand = idx; break; } } return (RFBand); } /**************************************************************************** ** ** Name: MT2063_Tune ** ** Description: Change the tuner's tuned frequency to RFin. ** ** Parameters: h - Open handle to the tuner (from MT2063_Open). ** f_in - RF input center frequency (in Hz). ** ** Returns: status: ** MT_OK - No errors ** MT_INV_HANDLE - Invalid tuner handle ** MT_UPC_UNLOCK - Upconverter PLL unlocked ** MT_DNC_UNLOCK - Downconverter PLL unlocked ** MT_COMM_ERR - Serial bus communications error ** MT_SPUR_CNT_MASK - Count of avoided LO spurs ** MT_SPUR_PRESENT - LO spur possible in output ** MT_FIN_RANGE - Input freq out of range ** MT_FOUT_RANGE - Output freq out of range ** MT_UPC_RANGE - Upconverter freq out of range ** MT_DNC_RANGE - Downconverter freq out of range ** ** Dependencies: MUST CALL MT2063_Open BEFORE MT2063_Tune! ** ** MT_ReadSub - Read data from the two-wire serial bus ** MT_WriteSub - Write data to the two-wire serial bus ** MT_Sleep - Delay execution for x milliseconds ** MT2063_GetLocked - Checks to see if LO1 and LO2 are locked ** ** Revision History: ** ** SCR Date Author Description ** ------------------------------------------------------------------------- ** 138 06-19-2007 DAD Ver 1.00: Initial, derived from mt2067_b. ** 04-10-2008 PINZ Ver 1.05: Use software-controlled ClearTune ** cross-over frequency values. ** 175 I 16-06-2008 PINZ Ver 1.16: Add control to avoid US DECT freqs. ** 175 I 06-19-2008 RSK Ver 1.17: Refactor DECT control to SpurAvoid. ** 06-24-2008 PINZ Ver 1.18: Add Get/SetParam CTFILT_SW ** ****************************************************************************/ UData_t MT2063_Tune(Handle_t h, UData_t f_in) { /* RF input center frequency */ struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; UData_t status = MT2063_OK; /* status of operation */ UData_t LO1; /* 1st LO register value */ UData_t Num1; /* Numerator for LO1 reg. value */ UData_t f_IF1; /* 1st IF requested */ UData_t LO2; /* 2nd LO register value */ UData_t Num2; /* Numerator for LO2 reg. value */ UData_t ofLO1, ofLO2; /* last time's LO frequencies */ UData_t ofin, ofout; /* last time's I/O frequencies */ U8Data fiffc = 0x80; /* FIFF center freq from tuner */ UData_t fiffof; /* Offset from FIFF center freq */ const U8Data LO1LK = 0x80; /* Mask for LO1 Lock bit */ U8Data LO2LK = 0x08; /* Mask for LO2 Lock bit */ U8Data val; UData_t RFBand; /* Verify that the handle passed points to a valid tuner */ if (MT2063_IsValidHandle(pInfo) == 0) return MT2063_INV_HANDLE; /* Check the input and output frequency ranges */ if ((f_in < MT2063_MIN_FIN_FREQ) || (f_in > MT2063_MAX_FIN_FREQ)) status |= MT2063_FIN_RANGE; if ((pInfo->AS_Data.f_out < MT2063_MIN_FOUT_FREQ) || (pInfo->AS_Data.f_out > MT2063_MAX_FOUT_FREQ)) status |= MT2063_FOUT_RANGE; /* ** Save original LO1 and LO2 register values */ ofLO1 = pInfo->AS_Data.f_LO1; ofLO2 = pInfo->AS_Data.f_LO2; ofin = pInfo->AS_Data.f_in; ofout = pInfo->AS_Data.f_out; /* ** Find and set RF Band setting */ if (pInfo->ctfilt_sw == 1) { val = (pInfo->reg[MT2063_REG_CTUNE_CTRL] | 0x08); if (pInfo->reg[MT2063_REG_CTUNE_CTRL] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_CTUNE_CTRL, val); } val = pInfo->reg[MT2063_REG_CTUNE_OV]; RFBand = FindClearTuneFilter(pInfo, f_in); pInfo->reg[MT2063_REG_CTUNE_OV] = (U8Data) ((pInfo->reg[MT2063_REG_CTUNE_OV] & ~0x1F) | RFBand); if (pInfo->reg[MT2063_REG_CTUNE_OV] != val) { status |= MT2063_SetReg(pInfo, MT2063_REG_CTUNE_OV, val); } } /* ** Read the FIFF Center Frequency from the tuner */ if (MT2063_NO_ERROR(status)) { status |= MT2063_ReadSub(pInfo->hUserData, pInfo->address, MT2063_REG_FIFFC, &pInfo->reg[MT2063_REG_FIFFC], 1); fiffc = pInfo->reg[MT2063_REG_FIFFC]; } /* ** Assign in the requested values */ pInfo->AS_Data.f_in = f_in; /* Request a 1st IF such that LO1 is on a step size */ pInfo->AS_Data.f_if1_Request = MT2063_Round_fLO(pInfo->AS_Data.f_if1_Request + f_in, pInfo->AS_Data.f_LO1_Step, pInfo->AS_Data.f_ref) - f_in; /* ** Calculate frequency settings. f_IF1_FREQ + f_in is the ** desired LO1 frequency */ MT2063_ResetExclZones(&pInfo->AS_Data); f_IF1 = MT2063_ChooseFirstIF(&pInfo->AS_Data); pInfo->AS_Data.f_LO1 = MT2063_Round_fLO(f_IF1 + f_in, pInfo->AS_Data.f_LO1_Step, pInfo->AS_Data.f_ref); pInfo->AS_Data.f_LO2 = MT2063_Round_fLO(pInfo->AS_Data.f_LO1 - pInfo->AS_Data.f_out - f_in, pInfo->AS_Data.f_LO2_Step, pInfo->AS_Data.f_ref); /* ** Check for any LO spurs in the output bandwidth and adjust ** the LO settings to avoid them if needed */ status |= MT2063_AvoidSpurs(h, &pInfo->AS_Data); /* ** MT_AvoidSpurs spurs may have changed the LO1 & LO2 values. ** Recalculate the LO frequencies and the values to be placed ** in the tuning registers. */ pInfo->AS_Data.f_LO1 = MT2063_CalcLO1Mult(&LO1, &Num1, pInfo->AS_Data.f_LO1, pInfo->AS_Data.f_LO1_Step, pInfo->AS_Data.f_ref); pInfo->AS_Data.f_LO2 = MT2063_Round_fLO(pInfo->AS_Data.f_LO1 - pInfo->AS_Data.f_out - f_in, pInfo->AS_Data.f_LO2_Step, pInfo->AS_Data.f_ref); pInfo->AS_Data.f_LO2 = MT2063_CalcLO2Mult(&LO2, &Num2, pInfo->AS_Data.f_LO2, pInfo->AS_Data.f_LO2_Step, pInfo->AS_Data.f_ref); /* ** Check the upconverter and downconverter frequency ranges */ if ((pInfo->AS_Data.f_LO1 < MT2063_MIN_UPC_FREQ) || (pInfo->AS_Data.f_LO1 > MT2063_MAX_UPC_FREQ)) status |= MT2063_UPC_RANGE; if ((pInfo->AS_Data.f_LO2 < MT2063_MIN_DNC_FREQ) || (pInfo->AS_Data.f_LO2 > MT2063_MAX_DNC_FREQ)) status |= MT2063_DNC_RANGE; /* LO2 Lock bit was in a different place for B0 version */ if (pInfo->tuner_id == MT2063_B0) LO2LK = 0x40; /* ** If we have the same LO frequencies and we're already locked, ** then skip re-programming the LO registers. */ if ((ofLO1 != pInfo->AS_Data.f_LO1) || (ofLO2 != pInfo->AS_Data.f_LO2) || ((pInfo->reg[MT2063_REG_LO_STATUS] & (LO1LK | LO2LK)) != (LO1LK | LO2LK))) { /* ** Calculate the FIFFOF register value ** ** IF1_Actual ** FIFFOF = ------------ - 8 * FIFFC - 4992 ** f_ref/64 */ fiffof = (pInfo->AS_Data.f_LO1 - f_in) / (pInfo->AS_Data.f_ref / 64) - 8 * (UData_t) fiffc - 4992; if (fiffof > 0xFF) fiffof = 0xFF; /* ** Place all of the calculated values into the local tuner ** register fields. */ if (MT2063_NO_ERROR(status)) { pInfo->reg[MT2063_REG_LO1CQ_1] = (U8Data) (LO1 & 0xFF); /* DIV1q */ pInfo->reg[MT2063_REG_LO1CQ_2] = (U8Data) (Num1 & 0x3F); /* NUM1q */ pInfo->reg[MT2063_REG_LO2CQ_1] = (U8Data) (((LO2 & 0x7F) << 1) /* DIV2q */ |(Num2 >> 12)); /* NUM2q (hi) */ pInfo->reg[MT2063_REG_LO2CQ_2] = (U8Data) ((Num2 & 0x0FF0) >> 4); /* NUM2q (mid) */ pInfo->reg[MT2063_REG_LO2CQ_3] = (U8Data) (0xE0 | (Num2 & 0x000F)); /* NUM2q (lo) */ /* ** Now write out the computed register values ** IMPORTANT: There is a required order for writing ** (0x05 must follow all the others). */ status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO1CQ_1, &pInfo->reg[MT2063_REG_LO1CQ_1], 5); /* 0x01 - 0x05 */ if (pInfo->tuner_id == MT2063_B0) { /* Re-write the one-shot bits to trigger the tune operation */ status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_LO2CQ_3, &pInfo->reg[MT2063_REG_LO2CQ_3], 1); /* 0x05 */ } /* Write out the FIFF offset only if it's changing */ if (pInfo->reg[MT2063_REG_FIFF_OFFSET] != (U8Data) fiffof) { pInfo->reg[MT2063_REG_FIFF_OFFSET] = (U8Data) fiffof; status |= MT2063_WriteSub(pInfo->hUserData, pInfo->address, MT2063_REG_FIFF_OFFSET, &pInfo-> reg[MT2063_REG_FIFF_OFFSET], 1); } } /* ** Check for LO's locking */ if (MT2063_NO_ERROR(status)) { status |= MT2063_GetLocked(h); } /* ** If we locked OK, assign calculated data to MT2063_Info_t structure */ if (MT2063_NO_ERROR(status)) { pInfo->f_IF1_actual = pInfo->AS_Data.f_LO1 - f_in; } } return (status); } UData_t MT_Tune_atv(Handle_t h, UData_t f_in, UData_t bw_in, enum MTTune_atv_standard tv_type) { UData_t status = MT2063_OK; struct MT2063_Info_t *pInfo = (struct MT2063_Info_t *)h; struct dvb_frontend *fe = (struct dvb_frontend *)pInfo->hUserData; struct mt2063_state *state = fe->tuner_priv; SData_t pict_car = 0; SData_t pict2chanb_vsb = 0; SData_t pict2chanb_snd = 0; SData_t pict2snd1 = 0; SData_t pict2snd2 = 0; SData_t ch_bw = 0; SData_t if_mid = 0; SData_t rcvr_mode = 0; UData_t mode_get = 0; switch (tv_type) { case MTTUNEA_PAL_B:{ pict_car = 38900000; ch_bw = 8000000; pict2chanb_vsb = -1250000; pict2snd1 = 5500000; pict2snd2 = 5742000; rcvr_mode = 1; break; } case MTTUNEA_PAL_G:{ pict_car = 38900000; ch_bw = 7000000; pict2chanb_vsb = -1250000; pict2snd1 = 5500000; pict2snd2 = 0; rcvr_mode = 1; break; } case MTTUNEA_PAL_I:{ pict_car = 38900000; ch_bw = 8000000; pict2chanb_vsb = -1250000; pict2snd1 = 6000000; pict2snd2 = 0; rcvr_mode = 1; break; } case MTTUNEA_PAL_L:{ pict_car = 38900000; ch_bw = 8000000; pict2chanb_vsb = -1250000; pict2snd1 = 6500000; pict2snd2 = 0; rcvr_mode = 1; break; } case MTTUNEA_PAL_MN:{ pict_car = 38900000; ch_bw = 6000000; pict2chanb_vsb = -1250000; pict2snd1 = 4500000; pict2snd2 = 0; rcvr_mode = 1; break; } case MTTUNEA_PAL_DK:{ pict_car = 38900000; ch_bw = 8000000; pict2chanb_vsb = -1250000; pict2snd1 = 6500000; pict2snd2 = 0; rcvr_mode = 1; break; } case MTTUNEA_DIGITAL:{ pict_car = 36125000; ch_bw = 8000000; pict2chanb_vsb = -(ch_bw / 2); pict2snd1 = 0; pict2snd2 = 0; rcvr_mode = 2; break; } case MTTUNEA_FMRADIO:{ pict_car = 38900000; ch_bw = 8000000; pict2chanb_vsb = -(ch_bw / 2); pict2snd1 = 0; pict2snd2 = 0; rcvr_mode = 4; //f_in -= 2900000; break; } case MTTUNEA_DVBC:{ pict_car = 36125000; ch_bw = 8000000; pict2chanb_vsb = -(ch_bw / 2); pict2snd1 = 0; pict2snd2 = 0; rcvr_mode = MT2063_CABLE_QAM; break; } case MTTUNEA_DVBT:{ pict_car = 36125000; ch_bw = bw_in; //8000000 pict2chanb_vsb = -(ch_bw / 2); pict2snd1 = 0; pict2snd2 = 0; rcvr_mode = MT2063_OFFAIR_COFDM; break; } case MTTUNEA_UNKNOWN: break; default: break; } pict2chanb_snd = pict2chanb_vsb - ch_bw; if_mid = pict_car - (pict2chanb_vsb + (ch_bw / 2)); status |= MT2063_SetParam(h, MT2063_STEPSIZE, 125000); status |= MT2063_SetParam(h, MT2063_OUTPUT_FREQ, if_mid); status |= MT2063_SetParam(h, MT2063_OUTPUT_BW, ch_bw); status |= MT2063_GetParam(h, MT2063_RCVR_MODE, &mode_get); status |= MT2063_SetParam(h, MT2063_RCVR_MODE, rcvr_mode); status |= MT2063_Tune(h, (f_in + (pict2chanb_vsb + (ch_bw / 2)))); status |= MT2063_GetParam(h, MT2063_RCVR_MODE, &mode_get); return (UData_t) status; } static int mt2063_init(struct dvb_frontend *fe) { UData_t status = MT2063_ERROR; struct mt2063_state *state = fe->tuner_priv; status = MT2063_Open(0xC0, &(state->MT2063_ht), fe); status |= MT2063_SoftwareShutdown(state->MT2063_ht, 1); status |= MT2063_ClearPowerMaskBits(state->MT2063_ht, MT2063_ALL_SD); if (MT2063_OK != status) { printk("%s %d error status = 0x%x!!\n", __func__, __LINE__, status); return -1; } return 0; } static int mt2063_sleep(struct dvb_frontend *fe) { /* TODO: power down */ return 0; } static int mt2063_get_status(struct dvb_frontend *fe, u32 * status) { int rc = 0; //get tuner lock status return rc; } static int mt2063_get_state(struct dvb_frontend *fe, enum tuner_param param, struct tuner_state *state) { struct mt2063_state *mt2063State = fe->tuner_priv; switch (param) { case DVBFE_TUNER_FREQUENCY: //get frequency break; case DVBFE_TUNER_TUNERSTEP: break; case DVBFE_TUNER_IFFREQ: break; case DVBFE_TUNER_BANDWIDTH: //get bandwidth break; case DVBFE_TUNER_REFCLOCK: state->refclock = (u32_t) MT2063_GetLocked((Handle_t) (mt2063State->MT2063_ht)); break; default: break; } return (int)state->refclock; } static int mt2063_set_state(struct dvb_frontend *fe, enum tuner_param param, struct tuner_state *state) { struct mt2063_state *mt2063State = fe->tuner_priv; UData_t status = MT2063_OK; switch (param) { case DVBFE_TUNER_FREQUENCY: //set frequency status = MT_Tune_atv((Handle_t) (mt2063State->MT2063_ht), state->frequency, state->bandwidth, mt2063State->tv_type); mt2063State->frequency = state->frequency; break; case DVBFE_TUNER_TUNERSTEP: break; case DVBFE_TUNER_IFFREQ: break; case DVBFE_TUNER_BANDWIDTH: //set bandwidth mt2063State->bandwidth = state->bandwidth; break; case DVBFE_TUNER_REFCLOCK: break; case DVBFE_TUNER_OPEN: status = MT2063_Open(MT2063_I2C, &(mt2063State->MT2063_ht), fe); break; case DVBFE_TUNER_SOFTWARE_SHUTDOWN: status = MT2063_SoftwareShutdown(mt2063State->MT2063_ht, 1); break; case DVBFE_TUNER_CLEAR_POWER_MASKBITS: status = MT2063_ClearPowerMaskBits(mt2063State->MT2063_ht, MT2063_ALL_SD); break; default: break; } return (int)status; } static int mt2063_release(struct dvb_frontend *fe) { struct mt2063_state *state = fe->tuner_priv; fe->tuner_priv = NULL; kfree(state); return 0; } static struct dvb_tuner_ops mt2063_ops = { .info = { .name = "MT2063 Silicon Tuner", .frequency_min = 45000000, .frequency_max = 850000000, .frequency_step = 0, }, .init = mt2063_init, .sleep = mt2063_sleep, .get_status = mt2063_get_status, .get_state = mt2063_get_state, .set_state = mt2063_set_state, .release = mt2063_release }; struct dvb_frontend *mt2063_attach(struct dvb_frontend *fe, struct mt2063_config *config, struct i2c_adapter *i2c) { struct mt2063_state *state = NULL; state = kzalloc(sizeof(struct mt2063_state), GFP_KERNEL); if (state == NULL) goto error; state->config = config; state->i2c = i2c; state->frontend = fe; state->reference = config->refclock / 1000; /* kHz */ state->MT2063_init = FALSE; fe->tuner_priv = state; fe->ops.tuner_ops = mt2063_ops; printk("%s: Attaching MT2063 \n", __func__); return fe; error: kfree(state); return NULL; } EXPORT_SYMBOL(mt2063_attach); MODULE_PARM_DESC(verbose, "Set Verbosity level"); MODULE_AUTHOR("Henry"); MODULE_DESCRIPTION("MT2063 Silicon tuner"); MODULE_LICENSE("GPL");