一、AS608

1. 简介

2. 工作流程

3. 芯片地址和密码

二、项目-函数库

1. 模块参数变量

// typedef unsigned int uint;
typedef struct AS608_Module_Info {
 uint status; // 状态寄存器 0
 uint model; // 传感器类型 0-15
 uint capacity; // 指纹容量,300
 uint secure_level; // 安全等级 1/2/3/4/5,默认为3
 uint packet_size; // 数据包大小 32/64/128/256 bytes,默认为128
 uint baud_rate; // 波特率系数 
 uint chip_addr; // 设备(芯片)地址 
 uint password; // 通信密码
 char product_sn[12]; // 产品型号
 char software_version[12]; // 软件版本号
 char manufacture[12]; // 厂家名称
 char sensor_name[12]; // 传感器名称
 uint detect_pin; // AS608的WAK引脚连接的树莓派GPIO引脚号
 uint has_password; // 是否有密码
} AS608;
extern AS608 g_as608;

2. 全局变量

g_fd = serialOpen("/dev/ttyAMA0", 9600); // 9600是波特率

3. 函数

4. 如何使用

#include <stdio.h>
#include <wiringPi.h>
#include <wiringSerial.h>
#include "as608.h"			// 包含头文件
// 声明全局变量【定义在as608.c】
extern AS608 g_as608;
extern int g_fd;
extern int g_verbose;
extern char g_error_desc[];
extern uchar g_error_code;
int main() {
 // 给全局变量赋值
 g_as608.detect_pin = 1; 
 g_as608.has_password = 0; // 没有密码
 g_verbose = 0; // 显示少量输出信息
 
 // 初始化wiringPi库
 if (-1 == wiringPiSetup())
 return 1;
 
 // 设置g_detect_pin引脚为输入模式
 pinMode(g_as608.detect_pin, INPUT);
 
 // 打开串口
 if ((g_fd = serialOpen("/dev/ttyAMA0", 9600)) < 0)
 return 2;
 
 // 初始化AS608模块
 if (PS_Setup(0xfffffff, 0x00000000) == 0)
 return 3;
 
 /****************************************/
 
 // do something
 
 /****************************************/
 
 // 关闭串口
 serialClose(g_fd);
 
 return 0;
}

// as608.h 中有一个封装函数
// 检测到手指,返回true,否则返回false
// 前提是配置了 g_as608.detect_pin, 即AS608的WAK引脚
bool PS_DetectFinger();

// 阻塞至检测到手指,最长阻塞wait_time毫秒
bool waitUntilDetectFinger(int wait_time) {
	while (true) {
		if (PS_DetectFinger())
			return true;
		else {
			delay(100);
			wait_time -= 100;
			if (wait_time < 0)
				return false;
		}
	}
}
// 阻塞至检测不到手指,最长阻塞wait_time毫秒
bool waitUntilDetectFinger(int wait_time) {
	while (true) {
		if (PS_DetectFinger())
			return true;
		else {
			delay(100);
			wait_time -= 100;
			if (wait_time < 0)
				return false;
		}
	}
}

bool newFingerprint(int pageID) {
	printf("Please put your finger on the module.\n");
	if (waitUntilDetectFinger(5000)) {
		delay(500);
		PS_GetImage();
		PS_GenChar(1);
	}
	else {
		printf("Error: Didn't detect finger!\n");
		exit(1);
	}
	// 判断用户是否抬起了手指,
	printf("Ok.\nPlease raise your finger!\n");
	if (waitUntilNotDetectFinger(5000)) {
		delay(100);
		printf("Ok.\nPlease put your finger again!\n");
		// 第二次录入指纹
		if (waitUntilDetectFinger(5000)) {
			delay(500);
			PS_GetImage();
			PS_GenChar(2);
		}
		else {
			printf("Error: Didn't detect finger!\n");
			exit(1);
		}
	}
	else {
		printf("Error! Didn't raise your finger\n");
		exit(1);
	}
	int score = 0;
	if (PS_Match(&score)) {
		printf("Matched! score=%d\n", score);
	}
	else {
		printf("Not matched, raise your finger and put it on again.\n");
		exit(1);
	}
	// 合并特征文件
	PS_RegModel();
	PS_StoreChar(2, pageID);
	printf("OK! New fingerprint saved to pageID=%d\n", pageID);
}

三、命令行程序

1. 编译运行

cd example
make
./fp # 第一次使用,让程序初始化
alias fp=./fp # 以后可以使用fp,而不用加前缀"./"

2. 修改配置文件

address=0xffffffff
password=none
baudrate=9600
detect_pin=1
serial=/dev/ttyAMA0

3. 如何使用

A command line program to interact with AS608 module.
Usage:
 ./fp [command] [param] [option]
Available Commands:
-------------------------------------------------------------------------
 command | param | description
-------------------------------------------------------------------------
 cfgaddr [addr] Config address in local config file
 cfgpwd [pwd] Config password in local config file
 cfgserial [serialFile] Config serial port in local config file. Default:/dev/ttyAMA0
 cfgbaud [rate] Config baud rate in local config file
 cfgpin [GPIO_pin] Config GPIO pin to detect finger in local confilg file
 add [pID] Add a new fingerprint to database. (Read twice) 
 enroll [] Add a new fingerprint to database. (Read only once)
 delete [pID {count}] Delete one or contiguous fingerprints.
 empty [] Empty the database.
 search [] Collect fingerprint and search in database.
 identify [] Search
 count [] Get the count of registered fingerprints.
 list [] Show the registered fingerprints list.
 info [] Show the basic parameters of the module.
 random [] Generate a random number.(0~2^32)
 getimage [] Collect a fingerprint and store to ImageBuffer.
 upimage [filename] Download finger image to ras-pi in ImageBuffer of the module
 downimage [filename] Upload finger image to module
 genchar [cID] Generate fingerprint feature from ImageBuffer.
 match [] Accurate comparison of CharBuffer1 and CharBuffer2
 feature files.
 regmodel [] Merge the characteristic file in CharBuffer1 and
 CharBuffer2 and then generate the template, the
 results are stored in CharBuffer1 and CharBuffer2.
 storechar [cID pID] Save the template file in CharBuffer1 or CharBuffer2
 to the flash database location with the PageID number
 loadchar [cID pID] Reads the fingerprint template with the ID specified
 in the flash database into the template buffer,
 CharBuffer1 or CharBuffer2
 readinf [filename] Read the FLASH Info Page (512bytes), and save to file
 writenote [page {note}] Write note loacted in pageID=page
 readnote [page] Read note loacted in pageID=page
 upchar [cID filename] Download feature file in CharBufferID to ras-pi
 downchar [cID filename] Upload feature file in loacl disk to module
 setpwd [pwd] Set password
 vfypwd [pwd] Verify password
 packetsize [{size}] Show or Set data packet size
 baudrate [{rate}] Show or Set baud rate
 level [{level}] Show or Set secure level(1~5)
 address [{addr}] Show or Set secure level(1~5)
Avaiable options:
 -h Show help
 -v Shwo details while excute the order
Usage:
 ./fp [command] [param] [option]

4. 示例

# 录指纹(采集两次),保存到指纹库的第7号位置
fp add 7
# 录指纹(采集一次),返回保存的位置id号
fp enroll
# 删除指纹库中第5号指纹
fp delete 5
# 删除指纹库中第0号至第19号(共20个)
fp delete 0 20
# 采集并比对指纹,以下3条均可
fp search
fp hsearch # high speed search
fp identity
# 列出指纹库中的指纹ID
fp list
# 显示当前的芯片地址
fp address
# 设置芯片地址为0xefefefef
fp address 0xefefefef # 前缀0x可省略
# 设置密码为0xcc0825cc
fp setpwd 0xcc0825cc

END