/*****************************************************************************
*  Copyright Statement:
*  --------------------
*  This software is protected by Copyright and the information contained
*  herein is confidential. The software may not be copied and the information
*  contained herein may not be used or disclosed except with the written
*  permission of MediaTek Inc. (C) 2001
*
*****************************************************************************/

/*******************************************************************************
* Filename:
* ---------
* meta.h
*
* Project:
* --------
*   META
*
* Description:
* ------------
*   This module contains the definitions for using META_DLL.dll.
*
* Author:
* -------
*  CH Liang (mtk00419)
*
*==============================================================================
*           HISTORY
* Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
*------------------------------------------------------------------------------
* $Revision:   1.36  $
* $Modtime:   Jan 16 2006 17:47:32  $
* $Log:   //mtkvs01/vmdata/meta_dll/archives/maui/META_DLL/meta.h-arc  $
 *
 * Mar 13 2006 mtk00539
 * [STP100000683] [META_DLL][WiFi] Revise MCR, BB and EEPROM read/write functions
 * 
 *
 * Mar 7 2006 mtk00539
 * [STP100000551] [META][CCT] Add defect-pixel calibration functions.
 * 
 *
 * Feb 21 2006 mtk00539
 * [STP100000613] [META][NVRAM] Add META_NVRAM_LockDown() function to lock down NVRAM.
 * 
 *
 * Jan 23 2006 mtk00539
 * [STP100000549] [META][WiFi] Add new functions to query target side WiFi interface.
 * 
 * 
 *    Rev 1.36   Jan 18 2006 18:11:40   mtk00539
 * New features:
 *  1. [CCT] Export META_CCT_ReadReg() and META_CCT_WriteReg() functions.
 *  2. [RF] Merge EDGE calibration functions.
 *  3. [WiFi] Merge WiFi calibration functions.
 *  4. [MONZA] Merge MONZA project calibration functions.
 * Resolution for 160: [META_DLL v5.0.0000]
 * 
 *    Rev 1.35   Dec 29 2005 21:39:56   mtk00539
 *  1. [CCT] Fast capture via USB.
 * Resolution for 157: [META_DLL v3.7.0010][New][CCT] Fast capture via USB.
 * 
 *    Rev 1.34   Nov 18 2005 10:21:54   mtk00539
 *  1. [L1AUD][Enhance] New software architecture for DSP's Speech Enhancement functions.
 *  2. [CCT][New] Add ISP shading and auto-defect compensation.
 * Resolution for 148: [META_DLL v3.7.0008][L1AUD][Enhance] New software architecture for DSP's Speech Enhancement functions.
 * 
 *    Rev 1.33   Nov 01 2005 10:20:54   mtk00539
 *  1. [CCT][New] Add sensor engineer mode parameter read/write functions.
 * Resolution for 146: [META_DLL v3.7.0007][CCT][New] Add sensor engineer mode parameter read/write functions.
 * 
 *    Rev 1.32   Oct 18 2005 16:35:06   mtk00539
 *  1. [RF][New] Add Skyworks 74117 RF module support.
 * Resolution for 139: [META_DLL v3.7.0006][RF][New] Add Skyworks 74117 RF module support.
 * 
 *    Rev 1.31   Aug 10 2005 13:31:24   mtk00539
 *  1. [CCT][New] Add META_QueryIfTargetSupportISP() function.
 *  2. [CCT][New] Add new CCT_VAR_TO_K tag.
 *  3. [CCT][New] Add META_CCT_GetGammaTable(), META_CCT_SetGammaTable() functions.
 * Resolution for 126: [META_DLL v3.7.0003][New] Support MT6229 and MT6227 ISP.
 * 
 *    Rev 1.30   Jun 17 2005 17:09:54   mtk00539
 *  1. [CCT][New] Add META_CCT_MainLCDBackLight_TurnOn() and META_CCT_MainLCDBackLight_TurnOff(). 
 *  2. [CCT][New] Add META_CCT_GetBandingFactor().
 *  3. [CCT][New] Add META_CCT_GetSensorPregain() and META_CCT_SetSensorPregain().
 *  4. [RF][IP2] Add META_Rf_GetRFID(), META_Rf_SetRFImmediateBSI() and META_Rf_GetRFImmediateBSI().
 *  5. [RF][IP2] Add META_Rf_SKY74045_SetSpecialCoef(), META_Rf_MT6139B_SetSpecialCoef() and META_Rf_BRIGHT5P_SetSpecialCoef().
 *  6. Increase META_MAX_CONCURRENT_THREADS to 32.
 * Resolution for 120: [META_DLL v3.7.0001][CCT][New] Add CCT for SOP new functions.
 * 
 *    Rev 1.29   May 24 2005 22:36:26   mtk00539
 *  1. [NVRAM][New] Add META_NVRAM_ResetToFactoryDefault() to reset NVRAM to factory default setting. 
 *  2. [RF][New] Add META_Rf_QueryIfTwoApcDCOffsetSupport() to query if two APC DC offset supported in target.
 *  3. [New] Add callback function in META_ConnectWithTarget() to do extra process after BootROM start command passed.
 * Resolution for 114: [META_DLL v3.7.0000][NVRAM][New] Add META_NVRAM_ResetToFactoryDefault() to reset NVRAM to factory default setting.
 * 
 *    Rev 1.28   Apr 18 2005 09:44:08   mtk00539
 *  1. [New] Add META_CancelAllBlockingCall(): CCT and all the reset of APIs share the same cancel event.
 *  2. [New] Add META_QueryIfFunctionSupportedByTarget() to query whether if the function is supported in target side.
 *  3. [New] Add META_BaudrateEnumToName() to translate META baudrate enum to string.
 *  4. [New] Add META_ConnectInMetaMode() and META_DisconnectInMetaMode() to skip BootROM and connect with target which is already in META mode.
 *  5. [Enhance] Reduce max threads from 16 to 4 to increase META_DLL initialization speed.
 *  6. [Enhance] Modify DecodeST module to report error from callback function.
 *  7. [RF][New] Add META_Rf_QueryMSCapability() to query target's RF bands and GSM/GPRS/EDGE capability.
 *  8. [RF][New] Add META_Rf_SetAfcSinWaveDetection() to allow sin wave input while doing AFC calibration.
 *  9. [RF][New] Add META_Rf_SetRampTable() to modify ramp table without updating NVRAM.
 * 10. [CCT][New] Add new capture APIs, META_CCT_SingleShotCaptureEx() and META_CCT_MultiShotCaptureEx().
 * 11. [CCT][Enhance] Change CCT_VAR_ATTR to only three category RW, RO and WO.
 * 12. [CCT][Enhance] Add bNoConfirm flag to ignore confirm in META_CCT_ResumeAeAwbPreviewFromUnfinishedCapture().
 * 13. [CCT][BUG FIX] Fix META_CCT_CaptureEx() memory heap access violation problem.
 * Resolution for 111: [META_DLL v3.6.0000] New RF APIs and CCT bug fixs.
 * 
 *    Rev 1.27   Dec 15 2004 17:45:40   mtk00539
 * modify baudrate enum META_BAUD56000 to META_BAUD57600
 * Resolution for 101: [META_DLL v3.5.0602][Enhance] Reset p_imeisv->imei to zero in META_NVRAM_Decompose_IMEISV().
 * 
 *    Rev 1.26   Dec 15 2004 14:49:42   mtk00539
 * [Enhance] Enhance Compose/Decompose IMEI string.
 * Resolution for 101: [META_DLL v3.5.0602][Enhance] Reset p_imeisv->imei to zero in META_NVRAM_Decompose_IMEISV().
 * 
 *    Rev 1.25   Dec 13 2004 12:00:40   mtk00539
 *  1. [Enhance] Reset p_imeisv->imei to zero in META_NVRAM_Decompose_IMEISV() to prevent incorrect stored value.
 *  2. [New] Add FAT Quota-Management return value.
 * Resolution for 101: [META_DLL v3.5.0602][Enhance] Reset p_imeisv->imei to zero in META_NVRAM_Decompose_IMEISV().
 * 
 *    Rev 1.24   Nov 01 2004 09:35:20   mtk00539
 *  1. [RF][New] Calibration of TXOffsetI/Q, TrimI/Q and TXgain on META mdoe.
 *  2. [New] Adapt BROM_DLL v2.4.1006 for base band chip auto-detection.
 * Resolution for 95: [META_DLL v3.5.0600][New] Calibration of TXOffsetI/Q, TrimI/Q and TXgain on META mdoe.
 * 
 *    Rev 1.23   Aug 17 2004 14:52:52   mtk00539
 *  1. [CCT][New] Add set/get manual shutter functions.
 *  2. [CCT][New] Add META_CCT_GenCameraParaTable to dynamically generate camera_para struct default values.
 *  3. [RF][New] Add META_Rf_SetCrystalCapId API to setup crystal cap_id directly without update NVRAM.
 * Resolution for 85: [META_DLL v3.5.0500][New] Add CCT & RF new functions.
 * 
 *    Rev 1.22   Aug 04 2004 12:03:40   mtk00539
 *  1. [BUG FIX] Use PulseEvent to signal cancel event instead of SetEvent, so that the cancel state won't keep signal and cause next CCT command skip.
 *  2. [BUG FIX] Not only disable unreferenced registers but also disable unreferenced variables in CCT_RegDB::EnableDevice().
 *  3. [BUG FIX] Only return the enabled device id in META_CCT_GetDeviceIds().
 *  4. [BUG FIX] Only count the enabled variables in META_CCT_GetNumOfVar().
 * Resolution for 80: [META_DLL v3.5.0401][BUG FIX] Fix CCT cancel event problem.
 * 
 *    Rev 1.21   Jun 23 2004 10:55:46   mtk00539
 * [Enhance] Add BootROM timeout argument in META_ConnectWithTarget function.
 * 
 *    Rev 1.20   Jun 21 2004 09:42:00   mtk00539
 *  1. [New] add new BBTXCFG command.
 *  2. [New] additional 8k speech output FIR in normal mode.
 *  3. [Enhance] add callback lock to prevent callback and cancel race-condition.
 * Resolution for 79: [META_DLL v3.5.04][New] add new BBTXCFG command and additional 8k speech output FIR in normal mode.
 * 
 *    Rev 1.19   May 28 2004 21:19:38   mtk00539
 * 1. [New] Add AE initial shutter command.
 * 2. [New] Send twice cancel primitive to target, because in FT task, canceling capture detection is no longer by checking if msg queue is empty, instead of checking if msg queue is increasing.
 * 3. [BUG FIX] Fix race-condition when capture was canceled, uninstall capture callback before leaving m_CCT_Confirm_Lock.
 * 4. [Enhance] Change enum type to unsigned type.
 * 5. [Enhance] Modify white-balance interface for more meaningful.
 * Resolution for 66: [META_DLL v3.5.03][New] add camera calibration.
 * 
 *    Rev 1.18   Apr 28 2004 11:47:22   mtk00539
 *  1. [New] add camera calibration function.
 *  2. [New] add META_ConnectWithTarget and META_DisconnectWithTarget for easier usage of target boot up.
 * Resolution for 66: [META_DLL v3.5.03][New] add camera calibration.
 * 
 *    Rev 1.17   Mar 29 2004 21:36:02   mtk00539
 * Check data type in GetMemberValue
 * Resolution for 63: [META_DLL v3.5.02][New] add FIR for WB-AMR and 64 tone polyphony.
 * 
 *    Rev 1.16   Mar 29 2004 09:59:10   mtk00539
 *  1. [New] add FIR for WB-AMR and 64 tone polyphony.
 *  2. [New] Add FAT get disk info command so that users can retrieve total size and free space from any drive you specify.
 * Resolution for 63: [META_DLL v3.5.02][New] add FIR for WB-AMR and 64 tone polyphony.
 * 
 *    Rev 1.15   Mar 19 2004 18:54:54   mtk00539
 *  1. [Enhance] Extend all FAT APIs timeout to 120 seconds.
 *  2. [BUG FIX] change func() to func(void) to fix header file compatibility for LabView.
 *  3. [BUG FIX] set default value to zero in GetMemberValue().
 * Resolution for 62: [META_DLL v3.5.01][Enhance] Extend all FAT APIs timeout to 120 seconds.
 * 
 *    Rev 1.14   Mar 12 2004 19:52:28   mtk00539
 * [META_DLL v3.5.00][New]
 *  1. [BUG FIX] Fix FAT unicode filename issue.
 *  2. [Enhance] Extend FAT delete/read/write timeout to 120 seconds.
 *  3. [Enhance] Extend max concurrent handle to 16.
 *  4. [New] Add APC temperature compensation.
 *  5. [New] Add Power off command.
 *  6. [New] Add META_DLL version sync command.
 *  7. [New] Move out the calibration structure definition from InternalDB, they will be imported by NVRAM database.
 *  8. [New] Change MP3 play interface to MEDIA play interface.
 * Resolution for 60: [META_DLL v3.5.00][New] Add APC temperature compensation and so on.
 * 
 *    Rev 1.13   Feb 07 2004 01:04:00   mtk00539
 * [META_DLL][New] Add new api for custom acoustic volume compose/decompose function
 * Resolution for 48: [META_DLL v3.4.1003][New] Add new api for custom acoustic volume compose/decompose function
 * 
 *    Rev 1.12   Jan 18 2004 17:22:22   mtk00539
 *  1. [New] Agilent requests for a multithread safe META_DLL that use concurrently open different comp ports.
 *  2. [New] merge new CatcherTran.
 *  3. [RF][New] add set afc dac value api.
 * Resolution for 44: [META_DLL v3.4.1002][New] Modify for multithread safe.
 * 
 *    Rev 1.11   Dec 03 2003 16:52:44   mtk00539
 * Add META_NVRAM_SWC_Enable_ForceUpgrade and META_NVRAM_SWC_Disable_ForceUpgrade
 * Resolution for 38: [META_DLL v3.4.1001][New] NVRAM S/W change support.
 * 
 *    Rev 1.10   Nov 28 2003 23:09:18   mtk00539
 * [New] NVRAM S/W change mechanism.
 * Resolution for 38: [META_DLL v3.4.1001][New] NVRAM S/W change support.
 * 
 *    Rev 1.9   Nov 18 2003 13:45:08   mtk00539
 * [BUG FIX] Sync NVRAM_EF_AUDIO_PARAM_LID struct after 0339
 * Resolution for 32: [META_DLL v3.3.1001][New] See the details below.
 * 
 *    Rev 1.8   Oct 23 2003 23:01:30   mtk00539
 * add new return value in case of FAT find not found.
 * Resolution for 32: [META_DLL v3.3.1001][New] See the details below.
 * 
 *    Rev 1.7   Oct 21 2003 18:56:26   mtk00539
 * 1. add META_WaitForTargetReady api.
 * 2. add META_SetSysTraceCallback api for gather assert info.
 * 3. add ok flag in pm and afc result.
 * Resolution for 32: [META_DLL v3.3.1001][New] See the details below.
 * 
 *    Rev 1.6   Sep 26 2003 17:03:30   mtk00539
 * 1. [NVRAM] Add META_NVRAM_Calculate_IMEI_Spare function.
 * 2. [NVRAM] Modify META_NVRAM_Compose_IMEISV function to automatically calculate spare digit.
 * Resolution for 30: [META_DLL v3.2.1002][Add Feature] Add META_NVRAM_Calculate_IMEI_Spare function.
 * 
 *    Rev 1.5   Sep 18 2003 10:45:32   mtk00539
 * extend com port number
 * Resolution for 27: [META_DLL v3.2.1001][New] Adapt new CatcherTran database format
 * 
 *    Rev 1.4   Sep 02 2003 14:52:04   mtk00539
 * 1. [AUDIO] Switch audio testing to L4AUD instead of L1Audio.
 * 2. [FAT] Add MOVE, DELETE and FIND function for FAT operation.
 * 3. [RF] Add new api META_Rf_SetRampApcLevel().
 * 4. [NVRAM] Add IMEISV and L1audio parameter compose/decompose functions.
 * 5. Enlarge VerInfo_Cnf member.
 * Resolution for 26: [META_DLL v3.1.1001][Add Feature] See the reasons below.
 * 
 *    Rev 1.3   Aug 03 2003 13:34:14   mtk00539
 * 1. UART S/W flow control support.
 * 2. FAT operation.
 * 3. GPRS MultiSlot TX and InterRamp calibration data.
 * 4. Crystal calibration data.
 * 5. Target S/W, H/W and Melody version retrieval.
 * 6. Runtime debug log turn on/off in both release and debug version of DLL.
 * 7. [BUG FIX] Fix META_GetVersion() memory leak.
 * 8. [Enhance] Fixed ordinal number of each APIs META_DLL.dll exported.
 * Resolution for 23: [META_DLL v3.0.1001][AddFeature] S/W flow control support, FAT Read/Write, GPRS MultiSlot TX and Crystal Calibration Data, and bug fixed.
 * 
 *    Rev 1.2   May 20 2003 15:21:44   mtk00539
 * modify for new interface for VB
 * Resolution for 5: [META_DLL v2.2][AddFeature] Modify META_DLL for both C/C++ and VB support.
 * 
 *    Rev 1.1   Apr 01 2003 09:42:36   mtk00539
 * 1. add description for error code
 * 2. BUG: change RfTestResultAfc.fcb_ok to RfTestResultAfc.fcb_ok_number
 * 3. add NVRAM Editor relative APIs.
 * 4. add L1SP audio coefficient compose/decompose APIs
 * 5. change baseband status from kal_bool to kal_uint8
 * 6. change enum META_ERR_CODE to META_CNF_ERR_CODE.
 * 7. use unsigned char instead of BOOL.
 * 8. BUG: fix type inconsistent with primitive.sel
 * 9. export CatcherTran pointer instead of InternalDB for META_NVRAM_Init()
 * 10. add META_NVRAM_SetRecFieldBitValue() and META_NVRAM_GetRecFieldBitValue().
 * Resolution for 3: [META_DLL v2.0][AddFeature] Add new features for META_DLL v2.0
 * 
 *    Rev 1.0   Feb 25 2003 13:24:20   admin