cmd.h

ce下的指纹识别模块。使用的是瀚兴科技M620V-S指纹模块

//***********************************************************************************************************************************  
//		command list for Bione/M620V-S
//***********************************************************************************************************************************  


/***********************************************************************************************************************************  
	fingerprint identification
***********************************************************************************************************************************/

#define API_ENROLL_RAM	 	0x80   		//采集指纹并生成模板
#define API_VERIFY_RAM	 	0x81		//采集指纹并和RAM中当前指纹模板进行比对
#define API_VERIFY_FLASH	0x82		//采集指纹并和Flash中指定索引号指纹模板进行比对；索引号表示方法：INDEX:0－79
#define API_IDENTIFY_FLASH_ALL	0x83		//采集指纹图像并和Flash中的所有模板进行比对
#define API_GET_IMAGESIZE	0x84		//询问图像数据大小，接收到该命令后，模块会返回一个API_SUCCESS命令，在该返回命令中，
						//INDEX域＝0,PNUM-MSB＝0，PNUM-LSB＝4，数据域1-2Byte表示图像数据的行数，数据域3-4Byte
						//表示图像数据的列数，高Byte在前，在指纹模块中已经设定图像行列数必定为偶数

#define API_GET_IMAGE_DATA 	0x85		//命令指纹模块采集一副图像，需要注意的是：采集图像这几个命令与指纹提取，
						//比对等操作是没有任何关系的，只是用于用户获取指纹图像，与指纹提取，比对等功能是分离的，
						//即进行指纹其他操作的时候是不需要调用获取图像这几个命令的

#define API_UPLOAD_IMAGE 	0x86		//根据指定的行、列数上传图像数据，该命令在API_GET_IMAGE_DATA命令之后调用，
						//模块接收到该命令后，根据命令中指定的行、列数，开始不间断地上传数据。
						
																		
/************************************************************************************************************************************  
	template process command
************************************************************************************************************************************/
#define API_UPLOAD_TEMPLATE_RAM		0xA0	//将RAM中的指纹模板上传到控制主机
#define API_UPLOAD_TEMPLATE_FLASH	0xA1	//将Flash中指定索引号的指纹模板上传到控制主机；索引号表示方法：INDEX:0－79
#define API_DOWNLOAD_TEMPLATE_RAM	0xA2	//从控制主机下载指纹模板到RAM中
#define API_SAVE_TEMPLATE_RAMTOFLASH	0xA3	//将RAM中的指纹模板存储到Flash中并编索引号；索引号表示方法：INDEX:0－79
#define API_GET_TEMPLATELIST_FLASH	0xA4	//将Flash中存储的指纹模板列表信息上传到控制主机
#define API_DELETE_TEMPLATE_FLASH	0xA5	//删除Flash中指定索引号的指纹模板；索引号表示方法：INDEX:0－79；
#define API_DELETE_TEMPLATE_ALL_FLASH	0xA6	//删除Flash中所有的的指纹模板
#define API_MERGE_TEMPLATE_FLASHTORAM	0xA7	//将Flash中指定索引号的指纹模板和RAM中的模板进行合并，合并后的模板存放在RAM中。



/************************************************************************************************************************************  
	security level command
************************************************************************************************************************************/

#define API_SET_SECURITY_LEVEL_RAM	0xB0	//设置安全等级，掉电后安全等级信息不保留；安全等级的定义：
						//INDEX: 0x04 = 易用级 0x05 = 正常级 0x06 = 严格级
#define API_SET_SECURITY_LEVEL_FLASH	0xB1	//设置安全等级，同时安全等级信息被保留到Flash中作为以后系统工作的缺省值使用；安全等级的定义：
						//INDEX: 0x04 = 易用级 0x05 = 正常级（出厂缺省）0x06 = 严格级
#define API_GET_SECURITY_LEVEL 		0xB2	//上传当前安全等级					
		
		
/************************************************************************************************************************************  
	communication command
************************************************************************************************************************************/		

#define API_SET_BAUD_RATE_RAM		0xD0	//设置串口通讯速率，掉电后通讯速率不保留；当控制主机接收到应答之后，设置生效；主机在发送后续命令时，必须采用新的波特率。
						//INDEX:
						//0x10 = 9600
						//0x20 = 14400
						//0x30 = 19200
						//0x40 = 28800
						//0x50 = 38400
						//0x60 = 57600

#define API_SET_BAUD_RATE_FLASH		0xD1	//设置串口通讯速率，同时通讯速率被保留到Flash中作为以后系统工作的缺省值使用；
						//当控制主机接收到应答之后，设置生效；主机在发送后续命令时，必须采用新的波特率。
						
/************************************************************************************************************************************  
	other command
************************************************************************************************************************************/												
#define API_CANCEL			0xE0	//Bione/M620V-S停止处理上次的命令要求并立即应答控制主机。该命令只对如下命令有效：
						//API_ENROL_RAM
						//API_VERIFY_RAM
						//API_VERIFY_ FLASH
						//API_VERIFY_ FLASH_ALL

/************************************************************************************************************************************  
	response list
************************************************************************************************************************************/
#define API_FAILURE			0x00
#define API_SUCCESS			0x01
#define API_NO_TEMPLATE_PRESENT		0x02
#define API_CANCEL_SUCCESS		0x03
#define API_UNKNOWN_COMMAND		0x04

/************************************************************************************************************************************  
	parameter struct
************************************************************************************************************************************/
typedef struct _MAIN_COMMAND {
    BYTE main_stx;          //start sign of communication
    BYTE main_index;		//index, meaning depend by cmd. default is 0
    BYTE main_cmd;		    //the content of command
    BYTE main_pnummsb;		//high byte of data length
    BYTE main_pnumlsb;		//low byte of data length
} MAIN_COMMAND, *PMAIN_COMMAND;

typedef struct _RES_COMMAND {
    BYTE res_stx;          //start sign of communication
    BYTE res_index;		//index, meaning depend by cmd. default is 0
    BYTE res_result;		    //the content of command
    BYTE res_pnummsb;		//high byte of data length
    BYTE res_pnumlsb;		//low byte of data length
} RES_COMMAND, *PRES_COMMAND;


#define MERGE_COUNT 	2


#define FINGER_ENROLL	0x01	//指纹提取
#define FINGER_VERIFY	0x02	//指纹对比
#define FINGER_UNKNOW	0x80