TS1060_main

#ifndef _MAIN_H_

#define _MAIN_H_

#define int16 short

#define uint8 unsigned char

#define uint16 unsigned short

#define uint32 unsigned int

#define int32 int

#define uchar unsigned char

#ifdef __cplusplus

extern "C" {

#endif

/*****************以下extern声明函数需lib库调用者实现*******************************/

typedef struct{

/*

功能描述: SPI片选线拉低

*/

void (*Spi_CS_Set_Low)(void);

/*

功能描述: SPI片选线拉高

*/

void (*Spi_CS_Set_High)(void);

/*

功能描述: SPI传输函数，注意此函数不得操作SPI片选线CS的翻转

参数1:  入口参数，填入本次SPI传输master端发送数据，允许out=NULL，驱动自动发送0xff

参数2:  出口参数，用户返回本次SPI传输slave端返回的数据，允许in=NULL,底层不需要返回数据

参数3:  本次SPI传输的字节数

*/

int16 (*spi_transfer)(uint8 *out,uint8 *in,uint16 len);

/*

功能描述: 微秒延时函数

参数1:  入口参数，超时时间

*/

void (*us_delay)(uint32 time);

/*

功能描述: 合并应用层寄存器设置，一次性发往底层执行的专用接口

参数1: 执行动作的命令集

参数2: 执行动作的个数

*/

void (*TS_SpiCmdBuffToDriv)(uchar *pCmdStruct,uint16 uwLen);

/*

功能描述: Android导给LIB库，用来做DEBUG用

*/

void (*print_liblog)(char *pstr);

}FgpFuncImport_t;

/*****************以下函数为LIB库导出****************************************************************/

/*

系统初始化的时候调用即可，用于载入算法库

参数:      无

返回:      TA_SUCCESS

*/

int16 TS10xx_LibInit(FgpFuncImport_t *pFgpFuncImport);

/*

抓取一副指纹图像，并将图像存在LIB缓冲区里面

参数1:      入口参数，最大超时，以帧数计

返回:

TA_SUCCESS[抓取成功] TA_IMAGE_ERROR[指纹传感器硬件错误]

TA_TIME_OUT[超时] TA_RECAP_IMAGE[手指已存在]

*/

int16 TS10xx_CaptureImage(uint32 time_ov);

/*

迅速抓取一副指纹图像，并将图像存在LIB缓冲区里面

参数:      无

返回:

TA_SUCCESS[抓取成功] TA_IMAGE_ERROR[指纹传感器硬件错误]

*/

int16 TS1060_CaptureImgFast(void);

/*

每次进入注册流程，需要重新调用此函数，用来初始化算法资源

参数:      无

返回:      TA_SUCCESS

*/

int16 TS10xx_EnrollStart(void);

/*

注册时，每次按压调用此函数用于提取特征值，注意，特征值会留在后面一次性返回

返回:      TA_SUCCESS[成功注册一次]

EM_EMPTY_IMAGE[图像不合格，重采]

EM_FUNCTION_FAILED[程序调用顺序错误，仅调试]

*/

int16 TS10xx_EnrollImages(void);

/*

注册时，每次TS10xx_EnrollImages后调用此函数以判断信息录入的丰富程度，当>=100时表示注册到了足够信息

参数1:      出口参数，用于返回最后一次Enroll进去的图像和已录入图像的重叠率，0-100计，越大重叠率越高

返回:      EM_FUNCTION_FAILED[程序调用顺序错误，仅调试]

>=0 信息丰富程度

*/

int16 TS10xx_GetEnrollProcess(uint16 *puwMapped);

/*

当TS10xx_GetEnrollProcess的返回值>=100时，表面注册信息足够，方可调用此函数用于返回最终特征值占用的空间大小

返回:

EM_FUNCTION_FAILED[程序调用顺序错误，仅调试]

TA_INFO_NOT_ENOUGH[TS10x/*x_GetEnrollProcess返回小于100，请继续TS10xx_EnrollImages，仅调试]

TA_REENROLL[注册失败，需要重新注册]

其他[注册成功，可调用Finish函数获取最终的特征值]

*/

功能描述: SPI片选线拉低/*

功能描述: SPI片选线拉低

*/

*/

int32 TS10xx_GetEnrollFeaSize(void);

/*

当TS10xx_GetEnrollFeaSize的返回值>=10000时，表面注册成功

/*参数1:  入口+出口参数，应用层读取的已注册特征值缓冲区，返回添加后的特征值

参数2:  入口参数，应用层读取的已注册特征值长度

返回:

EM_FUNCTION_FAILED[程序调用顺序错误，仅调试]

TA_INFO_NOT_ENOUGH[TS10xx_GetEnrollProcess返回小于100，请继续TS10xx_EnrollImages，仅调试]

TA_SUCCESS[获取成功]

*/

功能描述: SPI片选线拉低

*/

int16 TS10xx_StoreEnrollFea(uint8 *fea,uint32 uiFeaLen);

/*

将最后一次抓取的图像和所有用户比对

参数1:  入口参数，应用层读取的已注册特征值缓冲区

参数2:  入口参数，应用层读取的已注册特征值长度

返回:

EM_FUNCTION_FAILED[程序调用顺序错误，仅调试]

EM_EMPTY_IMAGE[最后一次获取的图像质量不合格，重新采集]

>=800[比对成功] 注意，比对成功后可回写fea文件，以达到自学习目的，自学习后fea的长度不变。

0-799[失败，重新采集]

*/

int16 TS10xx_MatchAll(uint8 *fea,uint32 uiFeaLen);

/*

删除特征值数据库中指定用户

参数1:  入口+出口参数，特征值文件输入，删除成功后返回删除了指定用户之后的特征值

参数2:  入口+出口参数，特征值文件长度输入，删除成功后返回删除了指定用户之后的特征值长度

参数3:  入口参数，输入用户编号，从1开始计

返回值: TA_SUCCESS[成功] TA_FAIL[失败]

*/

int16 TS10xx_DeleteUser(uint8 *fea,uint32 *puiFeaLen,uint32 uiIndx);

/*

提取最后一次capture成功后留存的原始图像

参数1:  出口参数，用于返回获取图像的数据

参数2:  出口参数，用于返回获取图像的宽度值

参数3:  出口参数，用于返回获取图像的高度值

返回值: TA_SUCCESS[成功]

*/

int16 TS10xx_GetLastRawImage(uint8 *pucImg,uint16 *puwWidth,uint16 *puwHeight);

/*

功能描述: 在调用TS10xx_CaptureImage等待用户输入指纹的过程中，异步的让TS10xx_CaptureImage退出

*/

void TS10xx_SetBreakFlag(void);

/*

功能描述: 在调用TS1060_read_image前初始化传感器，让传感器自校准

*/

/*int16 TS1060_read_image_init(void);

功能描述: SPI片选线拉低

*/

/*

功能描述:  获取当前图像

参数1:      入口参数，图像缓冲区

返回:      0则调用成功，其他失败

示例:

result=TS1060_read_image_init();

if(result!=0)

报错，返回

while(1)

{

if(TS1060_read_image(IMG_ADDR)==0)

显示图像

}

*/

int16 TS1060_read_image(uint8 *buff);

/*抓图显示*/

int16 TS1060_capture_image_for_display(uint8 *buff,uint32 uiTimeOut);

/*功能描述: SPI通讯测试函数，TS1060_Test返回0表示传感器已经连上，否则表示通讯不上*/

int16 TS1060_Test(void);

/*

功能描述: 进入睡眠模式，同时启动手指判断，手指检测到后会在RESET上检测到一个上升沿跳变

返回:  TA_SUCCESS 设置成功，其他失败

*/

int16 TS1060_SetDeepSleep(void);

/*

功能描述: 系统在进入休眠探测后，如果RESET上升沿调高，那么需要调用TS1060_ExitSleep退出当前探测状态

返回:  TA_SUCCESS 退出成功，其他失败

*/

int16 TS1060_ExitSleep(void);

/*

功能描述: 校准传感器

参数1:  出口参数，用于返回校准数据，大小建议设置为4KByte

返回:  TA_SUCCESS 校准成功，其他失败

*/

int16 A083_Static_Calibrate(uint8 *ucCliData);

/*

功能描述: 每次调用前加载校准数据

参数1:  入口参数，用于给驱动加载校准数据

返回:  TA_SUCCESS 加载成功，其他失败

*/

int16 Load_A083_Static_CalibrateData(uint8 *ucCliData);

//调用出厂调用获取校验的数据A083_Static_Calibrate，每次采图时都要调用Load_A083_Static_CalibrateData

#ifdef __cplusplus

}

#endif

#endif