以下作品由安信可社區(qū)用戶

WT_0213制作

關于 FPM383C 指紋模塊 在之前的帖子介紹的已經(jīng)比較詳細了可以看下這個帖子。

【外設移植】FPM383C 指紋模塊 +Ai-M61-32S

https://bbs.ai-thinker.com/forum.php?mod=viewthread&tid=43963&fromuid=15918

這里主要說一下移植 FPM383C 指紋到 Ai-WB2 模塊時遇到的一些問題和移植完成示例。

首先是環(huán)境搭建

【Ai-WB2 入門篇】搭建 windows+eclipse 環(huán)境
https://bbs.ai-thinker.com/forum.php?mod=viewthread&tid=45149&fromuid=15918

跟著園長的教程完成環(huán)境搭建基本不會出現(xiàn)什么意外情況，都可以正常跑起來。

這里有個小坑需要注意：

盡量使用克隆命令克隆項目，不要直接下載 zip
git clone --recursive
https://gitee.com/Ai-Thinker-Open/Ai-Thinker-WB2

如果對配置文件不熟悉的話盡量按照現(xiàn)有的一些目錄接口創(chuàng)建自己的項目這樣可以盡可能少的去修改配置文件。

如果在其他目錄下創(chuàng)建項目，需要注意的是 BL60X_SDK_PATH 這個值要能找到 sdkpath。

編譯過程有一些警告，如果不是自己代碼中的可以忽略。

如果編譯通過的話最終會生成 bin 文件。

Ai-WB2 燒錄軟件
https://docs.ai-thinker.com/_media/bl602_flash_download_tool.zip
燒錄過程參考
【Ai-WB2 入門篇】新建工程和燒錄指導
https://bbs.ai-thinker.com/forum.php?mod=viewthread&tid=45156&fromuid=15918

這里有小坑需要注意一下：

1、如果出現(xiàn) COM 口拒絕訪問，檢查下時候開啟的串口調試工具。

2、如果提示 BFLB IMG LOAD SHAKEHAND FAIL 應該是沒有進入燒錄模式，點擊 Create & Download 然后按住開發(fā)板右側的按鈕，再點按左側 EN 按鈕松手就可以了。

這里有大坑需要注意一下：

燒錄編譯的 bin 的時候需要使用這種燒錄方式進項燒錄，否則燒錄后程序不能正常運行。

序號 1、3、4 選擇的都是燒錄工具目錄下的文件
序號 2 選擇編譯的 bin 即可
燒錄完成后，開啟串口調試工具
波特率設置為 115200

這里日志通過 printf 方法打印出來的，不知道為啥 blog_info 不生效沒有深入去看

然后是代碼部分

#include
#include
#include
#include
#include "fpm383c.h"
#include
int is_register = 1;
int main(void) {
printf("rn");
// 初始化FPM383C指紋模塊
fpm383c_init();
printf("clear rn");
// 清空指紋庫
fpm383c_empty(2000);
printf("random idrn");
// 指紋id
int fpm383cPageId = 10;
while (1) {
if (is_register) {
// 開啟注冊指紋，指紋ID：0—59， 超時時間盡量在 10秒左右，需要錄入四次
fpm383c_enroll(fpm383cPageId, 10000);
// 休息600毫秒進行下次注冊
vTaskDelay(pdMS_TO_TICKS(600));
// 模塊休眠一下
fpm383c_sleep();
is_register = 0;
printf("register OKrn");
} else {
// printf("identifyrn");
// 開啟自動識別
fpm383c_identify();
}
vTaskDelay(pdMS_TO_TICKS(10));
}
return 0;
}

這里值得注意的是 int main(void)函數(shù)是有返回值的，返回值類型為 int

這個函數(shù)會在會執(zhí)行在 FreeRTOS 任務中可以看下這篇分析的帖子

wb2 項目啟動流程分析
https://bbs.ai-thinker.com/forum.php?mod=viewthread&tid=45352&fromuid=15918

fpm383c.h

#ifndef __FPM383C_H
#define __FPM383C_H
#include "stdint.h"
void fpm383c_init(void);
void fpm383c_senddata(int length, uint8_t buffer[]);
void fpm383c_sleep(void);
uint8_t fpm383c_getimage(uint32_t timeout);
uint8_t fpm383c_genchar(uint32_t timeout);
uint8_t fpm383c_search(uint32_t timeout);
uint8_t fpm383c_empty(uint32_t timeout);
uint8_t fpm383c_delete(uint16_t pageID,uint32_t timeout);
uint8_t fpm383c_controlled(uint8_t PS_ControlLEDBuf[],uint32_t timeout);
void fpm383c_identify(void);
void fpm383c_enroll(uint16_t pageID,uint16_t timeout);
#endif

fpm383c.c

#include "stdlib.h"
#include "string.h"
#include "bl_sys.h"
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include "fpm383c.h"
#define GPIO_LED_PIN 14
/**
* 控制模塊LED燈顏色
*/
uint8_t ps_blueledbuf[16] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x07,0x3C,0x03,0x01,0x01,0x00,0x00,0x49};
uint8_t ps_redledbuf[16] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x07,0x3C,0x02,0x04,0x04,0x02,0x00,0x50};
uint8_t ps_greenledbuf[16] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x07,0x3C,0x02,0x02,0x02,0x02,0x00,0x4C};
/**
* 休眠指令-設置傳感器進入休眠模式
*/
uint8_t ps_sleepbuf[12] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x03,0x33,0x00,0x37};
/**
* 清空指紋庫-刪除 flash 數(shù)據(jù)庫中所有指紋模板。
*/
uint8_t ps_emptybuf[12] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x03,0x0D,0x00,0x11};
/**
* 取消指令-取消自動注冊模板和自動驗證指紋。如表 2-1 中加密等級設置為 0 或 1 情況下支持此功能
*/
uint8_t ps_cancelbuf[12] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x03,0x30,0x00,0x34};
/**
* 自動注冊模板-一站式注冊指紋，包含采集指紋、生成特征、組合模板、存儲模板等功能。加密等級設置為 0 或 1 情況下支持此功能。
*/
uint8_t ps_autoenrollbuf[17] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x08,0x31,'','',0x04,0x00,0x16,'',''};
/**
* 驗證用獲取圖像-驗證指紋時，探測手指，探測到后錄入指紋圖像存于圖像緩沖區(qū)。返回確認碼表示：錄入成功、無手指等。
*/
uint8_t ps_getimagebuf[12] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x03,0x01,0x00,0x05};
/**
* 生成特征值-將圖像緩沖區(qū)中的原始圖像生成指紋特征文件存于模板緩沖區(qū)
*/
uint8_t ps_getcharbuf[13] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x04,0x02,0x01,0x00,0x08};
/**
* 搜索指紋-以模板緩沖區(qū)中的特征文件搜索整個或部分指紋庫。若搜索到，則返回頁碼。加密等級設置為 0 或 1 情況下支持
*/
uint8_t ps_searchbuf[17] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x08,0x04,0x01,0x00,0x00,0xFF,0xFF,0x02,0x0C};
/**
* 刪除模板-刪除 flash 數(shù)據(jù)庫中指定 ID 號開始的N 個指紋模板
*/
uint8_t ps_deletebuf[16] = {0xEF,0x01,0xFF,0xFF,0xFF,0xFF,0x01,0x00,0x07,0x0C,'','',0x00,0x01,'',''};
/**
* 設置名為fpm383c_uart的外設句柄,用來執(zhí)行串口指令的發(fā)送
*/
hosal_uart_dev_t fpm383c_uart = {
.config = {
.uart_id = 1,
.tx_pin = 4, // TXD GPIO
.rx_pin = 3, // RXD GPIO
.baud_rate = 57600,
.data_width = HOSAL_DATA_WIDTH_8BIT,
.parity = HOSAL_NO_PARITY,
.stop_bits = HOSAL_STOP_BITS_1,
.mode = HOSAL_UART_MODE_POLL,
},
};
/**
* 指紋ID和驗證指紋的分數(shù)
*/
uint16_t pageID,score;
/**
* USART串口接收緩沖數(shù)組
*/
uint8_t uart_receivebuf[20];
/**
* 主循環(huán)狀態(tài)標志位
*/
uint8_t scanstatus = 0;
/**
* @brief 獲取狀態(tài)
*
* @param timeout
*/
void fpm383c_receivedata(uint16_t timeout, uint8_t lenght)
{
// 輪詢fpm383c_uart接收到的字符
int ret;
uint8_t uart_receive_len = 0;
uint8_t receivebuf_cache[20];
memset(uart_receivebuf, 0xFF, sizeof(uart_receivebuf));
while(true){
ret = hosal_uart_receive(&fpm383c_uart, receivebuf_cache, sizeof(receivebuf_cache));
if (ret > 0) {
memcpy(uart_receivebuf + uart_receive_len, receivebuf_cache, ret);
uart_receive_len += ret;
/* Uart send poll */
if(uart_receive_len >= lenght){
uart_receive_len=0;
break;
}
}
vTaskDelay(1);
}
}
/**
* 初始化FPM383C指紋模塊
*/
void fpm383c_init(){
/* Uart init device */
hosal_uart_init(&fpm383c_uart);
printf("fpm383c_initrn");
}
/**
* USART串口發(fā)送數(shù)據(jù)
* @param length 發(fā)送數(shù)組長度
* @param fpm383c_databuf 需要發(fā)送的功能數(shù)組
*/
void fpm383c_senddata(int length, uint8_t fpm383c_databuf[])
{
hosal_uart_send(&fpm383c_uart, fpm383c_databuf, length);
}
/**
* 發(fā)送休眠指令 確認碼=00H 表示休眠設置成功。確認碼=01H 表示休眠設置失敗。
*/
void fpm383c_sleep(void)
{
fpm383c_senddata(12, ps_sleepbuf);
}
/**
* 驗證用獲取圖像
* @param timeout接收數(shù)據(jù)的超時時間
* @return 確認碼
*/
uint8_t fpm383c_getimage(uint32_t timeout)
{
uint8_t tmp;
fpm383c_senddata(12,ps_getimagebuf);
fpm383c_receivedata(timeout, 12);
tmp = (uart_receivebuf[6] == 0x07 ? uart_receivebuf[9] : 0xFF);
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
return tmp;
}
/**
* 將圖像緩沖區(qū)中的原始圖像生成指紋特征文件存于模板緩沖區(qū)
* @param timeout 接收數(shù)據(jù)的超時時間
* @return 確認碼
*/
uint8_t fpm383c_genchar(uint32_t timeout)
{
uint8_t tmp;
fpm383c_senddata(13,ps_getcharbuf);
fpm383c_receivedata(timeout, 12);
tmp = (uart_receivebuf[6] == 0x07 ? uart_receivebuf[9] : 0xFF);
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
return tmp;
}
/**
* 發(fā)送搜索指紋指令
* @param timeout 接收數(shù)據(jù)的超時時間
* @return 確認碼
*/
uint8_t fpm383c_search(uint32_t timeout)
{
fpm383c_senddata(17,ps_searchbuf);
fpm383c_receivedata(timeout, 16);
return (uart_receivebuf[6] == 0x07 ? uart_receivebuf[9] : 0xFF);
}
/**
* 刪除指定指紋指令
* @param pageID 需要刪除的指紋
* @param timeout 接收數(shù)據(jù)的超時時間
* @return 確認碼
*/
uint8_t fpm383c_delete(uint16_t pageID,uint32_t timeout)
{
uint8_t tmp;
ps_deletebuf[10] = (pageID>>8);
ps_deletebuf[11] = (pageID);
ps_deletebuf[14] = (0x15+ps_deletebuf[10]+ps_deletebuf[11])>>8;
ps_deletebuf[15] = (0x15+ps_deletebuf[10]+ps_deletebuf[11]);
fpm383c_senddata(16,ps_deletebuf);
fpm383c_receivedata(timeout, 12);
tmp = (uart_receivebuf[6] == 0x07 ? uart_receivebuf[9] : 0xFF);
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
return tmp;
}
/**
* 清空指紋庫
* @param timeout 接收數(shù)據(jù)的超時時間
* @return 確認碼
*/
uint8_t fpm383c_empty(uint32_t timeout)
{
uint8_t tmp;
fpm383c_senddata(12,ps_emptybuf);
fpm383c_receivedata(timeout, 12);
tmp = (uart_receivebuf[6] == 0x07 ? uart_receivebuf[9] : 0xFF);
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
return tmp;
}
/**
* 發(fā)送控制燈光指令
* @param ps_controlledbuf 不同顏色的協(xié)議數(shù)據(jù)
* @param timeout 接收數(shù)據(jù)的超時時間
* @return 確認碼
*/
uint8_t fpm383c_controlled(uint8_t ps_controlledbuf[],uint32_t timeout)
{
uint8_t tmp;
fpm383c_senddata(16,ps_controlledbuf);
fpm383c_receivedata(timeout, 12);
tmp = (uart_receivebuf[6] == 0x07 ? uart_receivebuf[9] : 0xFF);
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
return tmp;
}
/**
* 驗證指紋是否注冊
*/
void fpm383c_identify(void)
{
if(fpm383c_getimage(2000) == 0x00)
{
if(fpm383c_genchar(2000) == 0x00)
{
bl_gpio_enable_output(GPIO_LED_PIN, 0, 0);
bl_gpio_output_set(GPIO_LED_PIN, 0);
if(fpm383c_search(2000) == 0x00)
{
score = (int)((uart_receivebuf[10] << 8) + uart_receivebuf[11]);
printf("success ID: %d rn",(int)score);
fpm383c_controlled(ps_greenledbuf,1000);
bl_gpio_output_set(GPIO_LED_PIN, 1);
vTaskDelay(pdMS_TO_TICKS(1000));
bl_gpio_output_set(GPIO_LED_PIN, 0);
// 重置接收數(shù)據(jù)緩存
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
return;
}else{
printf("fail rn");
bl_gpio_output_set(GPIO_LED_PIN, 1);
vTaskDelay(pdMS_TO_TICKS(1000));
bl_gpio_output_set(GPIO_LED_PIN, 0);
// 重置接收數(shù)據(jù)緩存
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
return;
}
}
}
}
/**
* 自動注冊
* @param pageID 輸入需要注冊的指紋ID號，取值范圍0—59
* @param timeout 設置注冊指紋超時時間，因為需要按壓四次手指，建議大于10000（即10s）
*/
void fpm383c_enroll(uint16_t pageID,uint16_t timeout)
{
blog_info("注冊指紋ID: %drn", pageID);
ps_autoenrollbuf[10] = (pageID>>8);
ps_autoenrollbuf[11] = (pageID);
ps_autoenrollbuf[15] = (0x54+ps_autoenrollbuf[10]+ps_autoenrollbuf[11])>>8;
ps_autoenrollbuf[16] = (0x54+ps_autoenrollbuf[10]+ps_autoenrollbuf[11]);
fpm383c_senddata(17,ps_autoenrollbuf);
fpm383c_receivedata(timeout, 14);
if(uart_receivebuf[9] == 0x00)
{
blog_info("指紋注冊完成rn");
// 亮綠燈2秒
fpm383c_controlled(ps_greenledbuf,2000);
// 重置接收數(shù)據(jù)緩存
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
return;
}
else if(timeout == 0)
{
// 超時取消注冊
fpm383c_senddata(12,ps_cancelbuf);
vTaskDelay(pdMS_TO_TICKS(50));
// 重置接收數(shù)據(jù)緩存
memset(uart_receivebuf,0xFF,sizeof(uart_receivebuf));
}
// 亮紅燈2秒
fpm383c_controlled(ps_redledbuf,2000);
}

以上就是主要邏輯代碼

接線方式

由于復用的 IO3 所以藍燈會亮

其他 Ai-WB2 相關知識可以看看社區(qū)整理的這篇文章

【Ai-WB2 教程合集】看這一篇就夠了?。?/p>

https://bbs.ai-thinker.com/foru

審核編輯 黃宇