meta.h

MTK 最新的flashtool工具的源代码

/*****************************************************************************
*  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  $
 *
 * May 17 2007 MTK01569
 * [STP100001394] [Meta] Release MetaDLL_v5.3.08
 * 
 *
 * Apr 20 2007 mtk01370
 * [STP100001370] [META]Release Meta DLL 5.3.07
 * 
 *
 * Feb 6 2007 mtk01370
 * [STP100001303] [META_DLL]V5.3.06
 * 
 *
 * Feb 2 2007 mtk01370
 * [STP100001303] [META_DLL]V5.3.06
 * 
 *
 * Jan 9 2007 mtk01370
 * [STP100001286] [META_DLL]V.5.3.05
 * 
 *
 * Nov 22 2006 mtk01370
 * [STP100001229] [Meta]Release 5.3.04
 * 
 *
 * Nov 2 2006 mtk01370
 * [STP100001193] [META_DLL]V.5.3.03
 * 
 *
 * Oct 11 2006 mtk01370
 * [STP100001168] [META_DLL]V.5.3.02
 * 
 *
 * Sep 27 2006 mtk01370
 * [STP100001158] [Meta] Add NVRAM_r meta handle for parameter
 * 
 *
 * Sep 27 2006 mtk00539
 * [STP100001144] META_DLL v5.3.01
 *  1. [UTIL] Add META_QueryIfTargetIsLowCostSingleBankFlash to query if target is Single-Bank-Flash solution.
 *  2. [UTIL] Add META_GetDLLVer and META_GetDLLInfo to get DLL's build information.
 *  3. [RF] Add META_Rf_GetAfcDacValueAtRTXOffsetCal to get AFC dac value in RTX offset calibration.
 *  4. [FAT] Add META_FAT_RemoveDir to remove directory on FAT.
 * 
 *
 * Sep 11 2006 mtk01370
 * [STP100001140] [MetaDLL]Add BT cancel command and Check maui and DB comparison
 * 
 *
 * Aug 23 2006 mtk01370
 * [STP100001094] [MetaDll] Compose IMEI 14 digit without CheckSum
 * 
 *
 * Aug 18 2006 mtk00539
 * [STP100001063] META_DLL v5.3.00
 * Fix META_EnableWatchDogTimer() always timeout bug.
 *
 * Aug 16 2006 mtk00539
 * [STP100001063] META_DLL v5.3.00
 * Add new function META_GetDLLInfo().
 *
 * Aug 14 2006 mtk00539
 * [STP100001063] META_DLL v5.3.00
 * 
 *
 * Jul 23 2006 mtk00539
 * [STP100001013] META_DLL v5.0.0007
 * 
 *
 * Jul 19 2006 mtk01370
 * [STP100001013] META_DLL v5.0.0007
 * 
 *
 * Jun 8 2006 mtk00539
 * [STP100000916] META_DLL_v5.0.0006
 * 
 *
 * May 29 2006 mtk01370
 * [STP100000885] MetaDll BT and WatchDog
 * 
 *
 * Apr 3 2006 mtk00539
 * [STP100000731] META_DLL v5.0.0004
 *  1. [BT] Add META_BT_QueryModuleID() to query BT module id.
 *  2. [CCT] Add OQC tool related calibration functions
 * 			META_CCT_DefectTable_OnOff()
 * 			META_CCT_DefectTableBypassAndBackupSetting()
 * 			META_CCT_DefectTableRestoreSetting()
 * 			META_CCT_AF_OnOff()
 * 			META_CCT_AF_LensOffsetCalibration()
 * 
 *
 * 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.
 *