开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > MTK > 查看源码
flashtool_handle.h
资源名称：Maui_META_src_v5.0808.0.zip　[点击查看]
上传用户：gelin96
上传日期：2017-01-08
资源大小：20993k
文件大小：24k
源码类别：

MTK

开发平台：

C++ Builder

flashtool_handle.h：源码内容
  1. /*******************************************************************************
  2.  *  Copyright Statement:
  3.  *  --------------------
  4.  *  This software is protected by Copyright and the information contained
  5.  *  herein is confidential. The software may not be copied and the information
  6.  *  contained herein may not be used or disclosed except with the written
  7.  *  permission of MediaTek Inc. (C) 2003
  8.  *
  9.  ******************************************************************************/
  11. /*******************************************************************************
  12.  * Filename:
  13.  * ---------
  14.  *  flashtool_handle.h
  15.  *
  16.  * Project:
  17.  * --------
  18.  *  Flash Download/Readback/Format Library.
  19.  *
  20.  * Description:
  21.  * ------------
  22.  *  The exported C interface APIs to deal with FlashTool handles.
  23.  *
  24.  * Author:
  25.  * -------
  26.  *  Amos Hsu (mtk00539)
  27.  *
  28.  *==============================================================================
  29.  *           HISTORY
  30.  * Below this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
  31.  *------------------------------------------------------------------------------
  32.  * $Revision:   1.13  $
  33.  * $Modtime:   Oct 19 2005 11:01:14  $
  34.  * $Log:   //mtkvs01/vmdata/flash_tool/archives/BootRom/flashtool_handle.h-arc  $
  35.  *
  36.  * Jan 31 2008 mtk01413
  37.  * [STP100001630] [FlashTool] v3.0804.0 release
  38.  * New features:
  39.  *  1. USB Download for End User
  40.  * Enhancements:
  41.  *  1. [DA] Download Optimization with 921k on MT6225/MT6229/MT6230/MT6235/MT6238
  42.  *  2. [DA] Provide two download methodology : Best Effort Erase (default) and Sequential Erase
  43.  *  3. [DA] New CheckID algorithm for all SPANSION MCP series
  44.  *
  45.  * Dec 3 2007 mtk01413
  46.  * [STP100001568] [FlashTool] v3.0748.0 release
  47.  * New features:
  48.  *  1. USB Download on MT6225/MT6226/MT6227 Series BB
  49.  *  2. GPS Download
  50.  *  3. MT6238, MT6235, TK6516 AP/MD  DVT
  51.  *
  52.  * Aug 30 2007 mtk01413
  53.  * [STP100001497] [FlashTool] v3.2.0 release
  54.  * 
  55.  *
  56.  * Mar 12 2007 mtk01413
  57.  * [STP100001329] FlashTool v3.1.04 release
  58.  * Enhancements:
  59.  *  1. [FlashTool/BROM_DLL/DA] Auto-Format when enabling System_Drive_On_NAND
  60.  *  2. [FlashTool] Show Parameter List View automatically when loading secure-on MAUI
  61.  *  3. [FlashTool] Move "Paremeter"/ "File Management"/ "ROM Writer" under "Window" menu item
  62.  *  4. [FlashTool] Show DA version and Build Date in help dialog
  63.  *  
  64.  *
  65.  * Jan 2 2007 mtk01413
  66.  * [STP100001195] FlashTool v3.1.02 release
  67.  * New features:
  68.  *  1. [BROM_DLL/DA] Support FOTA(Firmware update Over The Air) download.
  69.  *  2. [BROM_DLL/DA] Support MT6223  download.
  70.  *  3. [BROM_DLL/DA] Support MT6268T download.
  71.  *  4. [DA] Supports new NOR Flash device
  72.  *  [SPANSION] S29GL128NH
  73.  *  [SPANSION] S29GL128NL
  74.  *  [SPANSION] S29GL256NH
  75.  *  [SPANSION] S29GL256NL
  76.  *  [SPANSION] S29GL512NH
  77.  *  [SPANSION] S29GL512NL
  78.  * 
  79.  * Enhancements:
  80.  *  1. [DA] Support BBC(Blank Block Check) for NOR Flash Format.
  81.  *  2. [BROM_DLL/DA] Support Retransmit mechanism for NAND Readback operation.
  82.  *  3. [BROM_DLL] Enhance E-NFB Check.
  83.  * 
  84.  *
  85.  * Nov 2 2006 mtk01413
  86.  * [STP100001195] FlashTool v3.1.02 release
  87.  * New features:
  88.  *  1. [BROM_DLL/DA] E-NFB (Enhanced NFB) Download.
  89.  * 
  90.  *
  91.  * Sep 27 2006 mtk00539
  92.  * [STP100001145] FlashTool v3.1.01 release
  93.  * 
  94.  *
  95.  * Aug 16 2006 mtk00539
  96.  * [STP100001057] FlashTool v3.1.00 release
  97.  * Add new function DL_GetProjectId().
  98.  *
  99.  * Aug 14 2006 mtk00539
  100.  * [STP100001057] FlashTool v3.1.00 release
  101.  * 
  102.  *
  103.  * Jun 12 2006 mtk01413
  104.  * [STP100000922] FlashTool v2.9.1001 release
  105.  * New features:
  106.  *  1. [FlashTool/BROM_DLL] Support Multi-Load Autodetection Download.
  107.  * 
  108.  *
  109.  * May 24 2006 mtk01413
  110.  * [STP100000879] FlashTool v2.8.1001 release
  111.  *  1. [BROM_DLL][NEW] Support 6229 Download, add m_emi_gen_c in DRAM setting
  112.  *
  113.  * Feb 23 2006 mtk00539
  114.  * [STP100000625] FlashTool v2.7.1016
  115.  * 
  116.  * 
  117.  *    Rev 1.13   Oct 19 2005 14:44:44   mtk00539
  118.  *  1. [BROM_DLL&DA][New] New H/W devices detection architecture including NOR, NAND, SRAM and DRAM detection. 
  119.  *  2. [BROM_DLL&DA][New] DA partial download technic, that overcomes DA size exceeds MT6205B internal SRAM (32KB).
  120.  *  3. [BROM_DLL&DA][New] Format verification option, each byte should be 0xFF after erasure. 
  121.  *  4. [BROM_DLL&DA][New] DA validation to ensure invalid binary could not be loaded.
  122.  *  5. [BROM_DLL&DA][New] Support NFB download. 
  123.  *  6. [BROM_DLL&DA][New] Support NAND flash format with 3 method, NORMAL, FORCEDLY ERASE and MARK AS BAD BLOCK. 
  124.  *  7. [BROM_DLL&DA][New] Support NAND flash read back with 4 methods, PAGE+ECC, PAGE ONLY, SPARE ONLY and PAGE+SPARE. 
  125.  * Resolution for 140: [BROM_DLL v2.7.1008][New] Support NFB download and many new features.
  126.  * 
  127.  *    Rev 1.12   May 24 2005 19:54:24   mtk00539
  128.  *  1. [BROM_DLL][New] Add DA_cmd::CMD_EnableWatchDog() to enable watchdog after download process. 
  129.  *  2. [BROM_DLL][New] Add DL_ResourceProjectIdComparisonSetting() API to enable/disable resource project id comparison. 
  130.  *  3. [BROM_DLL][New] Add callback function in Boot_META() series API to do extra process after BootROM start command passed.
  131.  *  4. [BROM_DLL][BUG FIX] Fix com port error after using HyperTerminal.
  132.  *  5. [BROM_DLL][BUG FIX] Fix m_boot_timeout takes no effect in BRom_AutoBoot::BRom_StartCmd().
  133.  *  6. [BROM_DLL][Change Behavior] Stop download process while CALLBACK_BEFORE_PROCESS return non-zero value. 
  134.  *  7. [BROM_DLL][Change Behavior] Skip resource table size and content size checking for CustPack project.
  135.  * Resolution for 115: [BROM_DLL v2.4.1012][New] Support new flash devices and bug fix.
  136.  * 
  137.  *    Rev 1.11   Nov 22 2004 14:27:54   mtk00539
  138.  *  1. [BROM_DLL][BUG FIX] Add baudrate sync procedure for BootROM stage baudrate change for Prolific convertor.
  139.  *  2. [BROM_DLL][BUG FIX] Fix ReadData() delay time too long problem in DA_cmd::CMD_ChangeUartSpeed() while target is running at 13MHz.
  140.  *  3. [BROM_DLL][BUG FIX] DO NOT use while loop in reading BootROM ack in BRom_AutoBoot::BRom_StartCmd(), it will cause BootROM timeout.
  141.  *  4. [BROM_DLL][Enhance] Extend the read timeout waiting time in DA_cmd::CMD_WriteData, because SHARP flash program time is slow.
  142.  *  5. [BROM_DLL][Enhance] Add m_speedup_brom_baudrate flag to enable/disable speed-up baudrate in BootROM stage.
  143.  * Resolution for 99: [BROM_DLL v2.4.1008][New] Support INTEL family flash Buffered-Program method.
  144.  * 
  145.  *    Rev 1.10   May 21 2004 15:44:40   mtk00539
  146.  *  1. [brom.dll][New] add J2ME_ROM resource for w04.21 load.
  147.  *  2. [brom.dll][New] add MT6217 BootROM.
  148.  *  3. [brom.dll][New] add Brom_DownloadData API.
  149.  *  4. [brom.dll][New] remove Brom_Verify relative APIs.
  150.  *  5. [brom.dll][Enhance] move region overlap checking from Rom_Load() to IsReady() for more convenience.
  151.  * Resolution for 70: [BROM_DLL v2.3.1003][New] add J2ME_ROM resource for w04.21 load.
  152.  * 
  153.  *    Rev 1.9   May 14 2004 17:01:28   mtk00539
  154.  *  1. [brom.dll][BUG FIX] fix DA_cmd::CMD_WriteData() buffer overrun problem.
  155.  *  2. [brom.dll][BUG FIX] remove DA_HANDLE & DL_HANDLE rwlock_writer_sentry for multi-thread download.
  156.  *  3. [brom.dll][BUG FIX] fix download address remap problem for Multi-Bin download on MT6218B series projects.
  157.  *  4. [brom.dll][Enhance] for the unknown bbchip_name just bypass ECO checking, don't stop process.
  158.  *  5. [brom.dll][New] add FAT auto format mechanism, parse the embedded FAT range info from the end of the ROM file.
  159.  *  6. [brom.dll][New] add DA auto selection mechanism, parse the embedded custom_bane info from the end of the DA file.
  160.  *  7. [brom.dll][New] add _ByhCOM interface to let users to control com port handle.
  161.  *  8. [brom.dll][New] add BootROM start command retry mechanism to prevent cable TX/RX cross over.
  162.  *  9. [brom.dll][New] add MT6219_AV, MT6219_BV and MT6218B_FN support.
  163.  * 10. [DA][New] add DA auto selection mechanism, append custom_name at the end of DA.
  164.  * 11. [DA][New] add FAT auto format mechanism, report flash manufacture id and device code to PC side.
  165.  * Resolution for 67: [BootRom v2.3.1001][New] add FAT auto format, DA auto selection mechanism and bug fix.
  166.  * 
  167.  *    Rev 1.8   Mar 29 2004 13:59:24   mtk00539
  168.  *  1. [brom.dll][New] add baseband chip ECO revision checking flag for FlashDownload.
  169.  *  2. [brom.dll][Enhance] replace port_no with unsigned int instead of COM_PORT_NO enum.
  170.  *  3. [brom.dll][Enhance] add new member p_bbchip_name in FLASHTOOL_ARG to report target baseband chip name.
  171.  *  4. [brom.dll][Enhance] enumerate com port from registry and also check whether if its property is PST_RS232.
  172.  *  5. [brom.dll][Enhance] change com_sentry::Open() procedure to use SetCommConfig() like HyperTerminal.
  173.  * Resolution for 64: [BootRom v2.2.1013][New] add baseband chip ECO revision checking flag for FlashDownload.
  174.  * 
  175.  *    Rev 1.7   Mar 15 2004 12:00:42   mtk00539
  176.  * fix FTHND_UNKNOWN_BBCHIP_TYPE error code value
  177.  * Resolution for 59: [BootRom v2.2.1011][Enhance] split get firmware version to external imported library.
  178.  * 
  179.  *    Rev 1.6   Mar 02 2004 00:19:06   mtk00539
  180.  * 1. [brom.dll][Enhance] add resource and jump table consistency detection.
  181.  * 2. [brom.dll][Enhance] read back target's jump table layout and compare before download.
  182.  * 3. [brom.dll][Enhance] automatically load all the resource files.
  183.  * 4. [brom.dll][Enhance] add target bbchip id detection.
  184.  * 5. [brom.dll][Enhance] add ini module.
  185.  * 6. [brom.dll][Enhance] add MT6219 support.
  186.  * Resolution for 53: [BootRom v2.2.1007][Enhance] resource layout error detection.
  187.  * 
  188.  *    Rev 1.5   Feb 11 2004 17:52:16   mtk00539
  189.  * [Enhance] support selectable download
  190.  * Resolution for 51: [BootRom v2.2.1003][Enhance] selectable download.
  191.  * 
  192.  *    Rev 1.4   Feb 05 2004 14:13:54   mtk00539
  193.  * supposupport multiple concatanated bin files download.
  194.  * Resolution for 46: [BootRom v2.2.1001][New] support multiple concatanated bin files download.
  195.  * 
  196.  *    Rev 1.3   Oct 02 2003 00:51:46   mtk00539
  197.  * Fix return code.
  198.  * Resolution for 28: [BootRom v2.1.1001][New] See the reasons below.
  199.  * 
  200.  *    Rev 1.2   Oct 01 2003 23:34:06   mtk00539
  201.  * Add packet length in DA_WRITE_CMD and DA_READ_CMD.
  202.  * Resolution for 28: [BootRom v2.1.1001][New] See the reasons below.
  203.  * 
  204.  *    Rev 1.1   Sep 25 2003 13:57:54   mtk00539
  205.  * brom.dll v2.1.1001, please see SCR(28) for more details.
  206.  * Resolution for 28: [BootRom v2.1.1001][New] See the reasons below.
  207.  * 
  208.  *    Rev 1.0   Jun 30 2003 18:13:58   admin
  209.  * Initial revision.
  210.  * 
  211.  *------------------------------------------------------------------------------
  212.  * Upper this line, this part is controlled by PVCS VM. DO NOT MODIFY!!
  213.  *==============================================================================
  214.  *******************************************************************************/
  215. #ifndef _FLASHTOOL_HANDLE_H_
  216. #define _FLASHTOOL_HANDLE_H_
  218. #include "mtk_mcu.h"
  219. #include "mtk_status.h"
  220. #include "mtk_resource.h"
  221. #include "DOWNLOAD.H"
  223. #ifdef __cplusplus
  224. extern "C" {
  225. #endif
  227. //------------------------------------------------------------------------------
  228. // Boolean                                                                      
  229. //------------------------------------------------------------------------------
  230. typedef enum {
  231. _FALSE = 0,
  232. _TRUE = 1
  233. } _BOOL;
  235. //------------------------------------------------------------------------------
  236. // prototype of remote file operation method callback                           
  237. //------------------------------------------------------------------------------
  238. typedef int (__stdcall *CALLBACK_REMOTE_GET_FILE_LEN)(const char *filepath, unsigned int * const p_file_length, void *user_arg);
  239. typedef int (__stdcall *CALLBACK_REMOTE_READ_FILE)(const char *filepath, unsigned char * const p_file_content, unsigned int file_length, void *user_arg);
  241. //------------------------------------------------------------------------------
  242. // prototype of remote file's signature operation method callback                           
  243. //------------------------------------------------------------------------------
  244. typedef int (__stdcall *CALLBACK_REMOTE_GET_SIG_LEN)(const char *filepath, unsigned int * const p_sig_length, void *user_arg);
  245. typedef int (__stdcall *CALLBACK_REMOTE_READ_SIG)(const char *filepath, unsigned char * const p_sig_content, unsigned int sig_length, void *user_arg);
  247. //------------------------------------------------------------------------------
  248. // prototype of customized file integrity check callback                        
  249. //------------------------------------------------------------------------------
  250. typedef int (__stdcall *CALLBACK_FILE_INTEGRITY_CHECK)(unsigned char * const p_file_content, unsigned int * const p_file_length, void *user_arg);
  252. //------------------------------------------------------------------------------
  253. // BL_HANDLE: Exported Functions                                                
  254. //------------------------------------------------------------------------------
  256. typedef struct {
  257. _BOOL m_valid; // _TRUE -> dram setting is valid 
  258. unsigned int m_emi_gen_a;
  259. unsigned int m_emi_gen_b;
  260. unsigned int m_emi_gen_c;
  261. unsigned int m_emi_gen_d;
  262. unsigned int m_emi_con_i;
  263. unsigned int m_emi_con_i_ext;
  264. unsigned int m_emi_con_j;
  265. unsigned int m_emi_con_k;
  266. unsigned int m_emi_con_l;
  267. unsigned int m_emi_con_m;
  268. unsigned int m_emi_con_n;
  269. } DRAM_SETTING;
  271. typedef struct {
  272. char m_version[5];
  273. char m_filepath[512];
  274. unsigned int m_filesize;
  275. unsigned int m_start_addr;
  276. unsigned int m_chksum_seed;
  277. unsigned int m_chksum;
  278. DRAM_SETTING m_dram_cfg;
  279. _BOOL m_enable; // _FALSE -> disbale 
  280. // _TRUE  -> enable  
  281. } BL_INFO;
  283. //------------------------------------------------------------------------------
  284. // DL_HANDLE: Exported Functions                                                
  285. //------------------------------------------------------------------------------
  286. typedef enum {
  287. ABSOLUTE_ADDR = 0,
  288. OFFSET_VALUE
  289. } REGION_ADDR_TYPE;
  291. typedef enum {
  292. NORMAL_ROM  = 0x01,
  293. RESOURCE_BIN  = 0x02,
  294. JUMPTABLE_BIN  = 0x03,
  295. ENFB_BIN  = 0x04,
  296. UA_BIN  = 0x05,
  297. BL_BIN  = 0x06,
  298. //
  299. UNKNOWN_BIN  = 0xFFF
  300. } ROM_TYPE;
  302. typedef struct {
  303. char  name[64];
  304. unsigned int  region_addr;
  305. REGION_ADDR_TYPE addr_type; // ABSOLUTE_ADDR -> region_addr is absolute address 
  306. // OFFSET_VALUE  -> region_addr is offset value 
  307. unsigned int  begin_addr;
  308. unsigned int  end_addr;
  309. char  filepath[256];
  310. unsigned int  filesize;
  311. unsigned short  index;
  313. ROM_TYPE rom_type;
  315. _BOOL enable; // _FALSE -> disbale 
  316. // _TRUE  -> enable  
  317. }ROM_INFO;
  319. typedef struct {
  320. unsigned int m_is_nfb:1;
  321. unsigned int m_security_supported:1;
  322. unsigned int m_cust_para_supported:1;
  323. unsigned int m_system_drive_on_nand:1;
  324. unsigned int m_fota_full:1;
  325. } DL_Config_T;
  327. typedef struct {
  328. DL_Config_T m_config;
  329. } DL_INFO;
  331. struct DL_HANDLE;
  332. typedef struct DL_HANDLE * DL_HANDLE_T;
  333. extern int __stdcall DL_Create(DL_HANDLE_T  *p_dl_handle);
  334. extern int __stdcall DL_Destroy(DL_HANDLE_T  *p_dl_handle);
  335. extern int __stdcall DL_LoadScatter(DL_HANDLE_T  dl_handle, const char *scatter_filepath);
  336. extern int __stdcall DL_SetPacketLength(DL_HANDLE_T  dl_handle, unsigned short length);
  337. extern int __stdcall DL_GetCount(DL_HANDLE_T  dl_handle, unsigned short *p_rom_count);
  338. extern int __stdcall DL_GetInfo(DL_HANDLE_T  dl_handle, DL_INFO  *p_dl_info);
  339. extern int __stdcall DL_IsReady(DL_HANDLE_T  dl_handle, ROM_INFO  *p_rom_info, BL_INFO  *p_bl_info, _BOOL  check_if_updated);
  340. extern int __stdcall DL_GetJumpTableInfo(DL_HANDLE_T  dl_handle, MTK_JumpTable  *p_jmptbl_info);
  341. extern int __stdcall DL_GetProjectId(DL_HANDLE_T  dl_handle, char *buf, unsigned int buf_len);
  342. extern int __stdcall DL_ResourceProjectIdComparisonSetting(DL_HANDLE_T  dl_handle, _BOOL  enable);
  343. extern int __stdcall DL_AutoLoadByScatRegionName(DL_HANDLE_T  dl_handle, const char *full_filepath, unsigned char allow_rom_type);
  344. extern int __stdcall DL_GetBBChipType(DL_HANDLE_T  dl_handle, BBCHIP_TYPE  *p_bbchip);
  345. extern int __stdcall DL_GetBBChipName(DL_HANDLE_T  dl_handle, char *buf, unsigned int buf_len);
  346. extern int __stdcall DL_GetCustomName(DL_HANDLE_T  dl_handle, char *buf, unsigned int buf_len);
  347. extern int __stdcall DL_Rom_GetInfo(DL_HANDLE_T  dl_handle, unsigned short index, ROM_INFO  *p_rom_info);
  348. extern int __stdcall DL_Rom_GetInfoAll(DL_HANDLE_T  dl_handle, ROM_INFO  *p_rom_info, unsigned short max_rom_count);
  349. extern int __stdcall DL_Rom_GetResInfo(DL_HANDLE_T  dl_handle, unsigned short index, MTK_Resource  *p_res_info);
  350. extern int __stdcall DL_Rom_Load(DL_HANDLE_T  dl_handle, unsigned short index, const char *rom_filepath);
  351. extern int __stdcall DL_Rom_Unload(DL_HANDLE_T  dl_handle, unsigned short index);
  352. extern int __stdcall DL_Rom_UnloadAll(DL_HANDLE_T  dl_handle);
  353. extern int __stdcall DL_Rom_SetEnableAttr(DL_HANDLE_T  dl_handle, unsigned short index, _BOOL  attr);
  354. extern int __stdcall DL_IsNFB(DL_HANDLE_T  dl_handle, _BOOL  *p_is_nfb);
  355. extern int __stdcall DL_SetCallback(DL_HANDLE_T  dl_handle, 
  356. CALLBACK_REMOTE_GET_FILE_LEN cb_remote_get_file_len,
  357. void * cb_remote_get_file_len_arg,
  358. CALLBACK_REMOTE_READ_FILE cb_remote_read_file,
  359. void * cb_remote_read_file_arg,
  360. CALLBACK_REMOTE_GET_SIG_LEN cb_remote_get_sig_len,
  361. void * cb_remote_get_sig_len_arg,
  362. CALLBACK_REMOTE_READ_SIG cb_remote_read_sig,
  363. void * cb_remote_read_sig_arg,
  364. CALLBACK_FILE_INTEGRITY_CHECK cb_file_integrity_check,
  365. void * cb_file_integrity_check_arg);
  366. // BL_HANDLE related 
  367. extern int __stdcall DL_BL_IsReady(DL_HANDLE_T  dl_handle, BL_INFO  *p_bl_info, _BOOL  check_if_updated);
  368. extern int __stdcall DL_BL_Load(DL_HANDLE_T  dl_handle, const char *bl_filepath);
  369. extern int __stdcall DL_BL_GetInfo(DL_HANDLE_T  dl_handle, BL_INFO  *p_bl_info);
  370. extern int __stdcall DL_BL_SetEnableAttr(DL_HANDLE_T  dl_handle, _BOOL  attr);
  372. //------------------------------------------------------------------------------
  373. // DL_HANDLE_LIST: Exported Functions                                           
  374. //------------------------------------------------------------------------------
  375. struct DL_HANDLE_LIST;
  376. typedef struct DL_HANDLE_LIST * DL_HANDLE_LIST_T;
  377. extern int __stdcall DL_CreateList(DL_HANDLE_LIST_T * dl_handle_list);
  378. extern int __stdcall DL_DestroyList(DL_HANDLE_LIST_T * dl_handle_list);
  379. extern int __stdcall DL_AddHandleToList(DL_HANDLE_LIST_T dl_handle_list, DL_HANDLE_T dl_handle);
  380. extern int __stdcall DL_DeleteHandleFromList(DL_HANDLE_LIST_T dl_handle_list, DL_HANDLE_T dl_handle);
  381. extern int __stdcall DL_GetHandleNumber(DL_HANDLE_LIST_T dl_handle_list, int * HandleNumber);
  382. extern int __stdcall DL_CheckHandleInList(DL_HANDLE_LIST_T dl_handle_list, DL_HANDLE_T dl_handle);
  383. extern int __stdcall DL_CheckHandleSameSWVersionInList(DL_HANDLE_LIST_T dl_handle_list, DL_HANDLE_T dl_handle);
  385. //------------------------------------------------------------------------------
  386. // DA_HANDLE: Exported Functions                                                
  387. //------------------------------------------------------------------------------
  389. typedef struct {
  390. char filepath[256];
  391. unsigned int start_addr;
  392. unsigned char *buf;
  393. unsigned int buf_len;
  394. unsigned int main_prog_size;
  395. char version[13];
  396. char last_modified_date[256];
  397. }DA_INFO;
  399. struct DA_HANDLE;
  400. typedef struct DA_HANDLE * DA_HANDLE_T;
  401. extern int __stdcall DA_Create(DA_HANDLE_T  *p_da_handle);
  402. extern int __stdcall DA_Destroy(DA_HANDLE_T  *p_da_handle);
  403. extern int __stdcall DA_IsReady(DA_HANDLE_T  da_handle, DA_INFO  *p_da_info, _BOOL  check_if_updated);
  404. extern int __stdcall DA_GetInfo(DA_HANDLE_T  da_handle, DA_INFO  *p_da_info);
  405. extern int __stdcall DA_SetDefaultStartAddr(DA_HANDLE_T  da_handle, unsigned int da_start_addr);
  406. extern int __stdcall DA_Load(DA_HANDLE_T  da_handle, const char *da_filepath, _BOOL  bDA_Validation);
  407. extern int __stdcall DA_Unload(DA_HANDLE_T  da_handle);
  408. extern int __stdcall DA_SetCallback(DL_HANDLE_T  dl_handle, 
  409. CALLBACK_REMOTE_GET_FILE_LEN cb_remote_get_file_len,
  410. void * cb_remote_get_file_len_arg,
  411. CALLBACK_REMOTE_READ_FILE cb_remote_read_file,
  412. void * cb_remote_read_file_arg,
  413. CALLBACK_REMOTE_GET_SIG_LEN cb_remote_get_sig_len,
  414. void * cb_remote_get_sig_len_arg,
  415. CALLBACK_REMOTE_READ_SIG cb_remote_read_sig,
  416. void * cb_remote_read_sig_arg,
  417. CALLBACK_FILE_INTEGRITY_CHECK cb_file_integrity_check,
  418. void * cb_file_integrity_check_arg);
  420. //------------------------------------------------------------------------------
  421. // RB_HANDLE: Exported Functions                                                
  422. //------------------------------------------------------------------------------
  423. typedef struct {
  424. char filepath[256];
  425. unsigned int readback_addr;
  426. unsigned int readback_len;
  427. _BOOL enable; // _FALSE -> disbale 
  428. // _TRUE  -> enable  
  430. unsigned short index;
  432. NUTL_ReadFlag_E m_read_flag;
  434. }RB_INFO;
  436. struct RB_HANDLE;
  437. typedef struct RB_HANDLE * RB_HANDLE_T;
  438. extern int __stdcall RB_Create(RB_HANDLE_T  *p_rb_handle);
  439. extern int __stdcall RB_Destroy(RB_HANDLE_T  *p_rb_handle);
  440. extern int __stdcall RB_SetPacketLength(RB_HANDLE_T  rb_handle, unsigned short length);
  441. extern int __stdcall RB_GetCount(RB_HANDLE_T  rb_handle, unsigned short *p_rb_count);
  442. extern int __stdcall RB_IsReady(RB_HANDLE_T  rb_handle, RB_INFO  *p_rb_info);
  443. extern int __stdcall RB_GetInfo(RB_HANDLE_T  rb_handle, unsigned short index, RB_INFO  *p_rb_info);
  444. extern int __stdcall RB_GetInfoAll(RB_HANDLE_T  rb_handle, RB_INFO  *p_rb_info, unsigned short max_rb_count);
  445. extern int __stdcall RB_Append(RB_HANDLE_T  rb_handle, const char *rb_filepath, unsigned int rb_addr, unsigned int rb_len);
  446. extern int __stdcall RB_Append_ReadToBuf(RB_HANDLE_T  rb_handle, unsigned int rb_addr, unsigned int rb_len, char *buf, unsigned int buf_len);
  447. extern int __stdcall RB_Delete(RB_HANDLE_T  rb_handle, unsigned short index);
  448. extern int __stdcall RB_SetFilepath(RB_HANDLE_T  rb_handle, unsigned short index, const char *rb_filepath);
  449. extern int __stdcall RB_SetReadbackFlag(RB_HANDLE_T  rb_handle, unsigned short index, NUTL_ReadFlag_E  flag);
  450. extern int __stdcall RB_SetReadbackAddr(RB_HANDLE_T  rb_handle, unsigned short index, unsigned int rb_addr);
  451. extern int __stdcall RB_SetReadbackLength(RB_HANDLE_T  rb_handle, unsigned short index, unsigned int rb_len);
  452. extern int __stdcall RB_ClearAll(RB_HANDLE_T  rb_handle);
  453. extern int __stdcall RB_SetEnableAttr(RB_HANDLE_T  rb_handle, unsigned short index, _BOOL  attr);
  454. extern int __stdcall RB_EnableReadbackFAT(RB_HANDLE_T  rb_handle, unsigned short index, _BOOL  attr);
  456. //------------------------------------------------------------------------------
  457. // AUTH_HANDLE: Exported Functions                                              
  458. //------------------------------------------------------------------------------
  460. typedef struct {
  461. unsigned int m_version;
  462. char m_filepath[512];
  463. unsigned char m_secure_custom_name[32];
  464. unsigned char m_description[512];
  465. } AUTH_INFO;
  467. struct AUTH_HANDLE;
  468. typedef struct AUTH_HANDLE * AUTH_HANDLE_T;
  469. extern int __stdcall AUTH_Create(AUTH_HANDLE_T  *p_auth_handle);
  470. extern int __stdcall AUTH_Destroy(AUTH_HANDLE_T  *p_auth_handle);
  471. extern int __stdcall AUTH_IsReady(AUTH_HANDLE_T  auth_handle, AUTH_INFO  *p_auth_info, _BOOL  bCheckIfUpdated);
  472. extern int __stdcall AUTH_GetInfo(AUTH_HANDLE_T  auth_handle, AUTH_INFO  *p_auth_info);
  473. extern int __stdcall AUTH_Load(AUTH_HANDLE_T  auth_handle, const char *auth_filepath);
  474. extern int __stdcall AUTH_Unload(AUTH_HANDLE_T  auth_handle);
  475. extern int __stdcall AUTH_SetCallback(AUTH_HANDLE_T  auth_handle, 
  476. CALLBACK_REMOTE_GET_FILE_LEN cb_remote_get_file_len,
  477. void * cb_remote_get_file_len_arg,
  478. CALLBACK_REMOTE_READ_FILE cb_remote_read_file,
  479. void * cb_remote_read_file_arg,
  480. CALLBACK_REMOTE_GET_SIG_LEN cb_remote_get_sig_len,
  481. void * cb_remote_get_sig_len_arg,
  482. CALLBACK_REMOTE_READ_SIG cb_remote_read_sig,
  483. void * cb_remote_read_sig_arg,
  484. CALLBACK_FILE_INTEGRITY_CHECK cb_file_integrity_check,
  485. void * cb_file_integrity_check_arg);
  487. #ifdef __cplusplus
  488. }
  489. #endif
  491. #endif