第四章 通讯协议
通信协议定义了 R308 指纹识别模块与上位机之间信息交换的规则， 指令包/数据包格式： 指令/数据包共分三类 命令包 结束包
包标识=01 包标识=08 数据包，且有后续包 包标识=02 所有的数据包都要加包头：0xEF01 01 命令包格式 字节数 2bytes 4bytes 1byte 2bytes 1byte … … 2bytes 名称 内容 模块地址 包标识 包长度 指令 参数 1 … 参数 n 校验和 01H N= 0xEF01 xxxx 包头 02 数据包格式 N bytes … 字节数 2bytes 4bytes 1byte 2bytes 2bytes 名称 内容 模块地址 包标识 包长度 数据 02H 0xEF01 xxxx 包头 校验和 08 结束包格式
字节数 2bytes 4bytes 1byte 2bytes N bytes … 2bytes 校验和 名称 内容 模块地址 包标识 包长度 数据 0xEF01 xxxx 08H 包头
◇数据包不能单独进入执行流程，必须跟在指令包或应答包后面。 ◇下载或上传的数
据包格式相同。 ◇包长度=包长度至校验和（指令、参数或数据）的总字节数，包含校验和，但不包含
包长度本身的字节数。 ◇校验和是从包标识至校验和之间所有字节之和，超出 2 字节的进位忽略。
◇模块地址在没有生成之前为缺省的 0xFFFFFFFF，一旦上位机通过指令生成了模块地 址，则所有的数据包都必须按照生成的地址收发。模块将拒绝地址错误的数据包。
3.3 指令应答
应答是将有关命令执行情况与结果上报给上位机，应答包含有参数，并可跟后续数据包。上位 机只有在收到模块的应答包后才能确认模块收包情况与指令执行情况， 2bytes 4bytes 1byte 2bytes 1byte N bytes 2bytes 0xEF01 模块地址 包标识 07 包长度 确认码 返回参数 校验和
4
www.hzgrow.com
第五章 模块指令系统
R308 模块专门针对锁具类应用，设计了精简指令。应用程序通过指令的不同组合，实现各种 指纹识别功能。
指令详解
1. 录入图像 GR_GetImage
功能说明： 探测手指，探测到后录入指纹图像存于 ImageBuffer。 输入参数： none 返回参数： 确认字 指令代码： 01H 指令包格式：
2 bytes 4bytes 1 byte 2 bytes 1 byte 2 bytes 校验和 包头 模块地址 包标识 包长度 xxxx 指令码 01H 0xEF01 01H 03H 05H 应答包格式： 2 bytes 4bytes 1 byte 2 bytes 1 byte 2 bytes 包头 模块地址 包长度 确认码 包标识 校验和
0xEF01 xxxx 07H 03H xxH sum 注：确认码=00H表示录入成功； 确认码
=01H表示收包有错； 确认码=02H表示传感器上无手指； 确认码=03H表示录入不成功； sum指校验和
2. 生成特征 GR_GenChar
功能说明： 将 ImageBuffer 中的原始图像生成指纹特征文件存于CharBuffer1
或 CharBuffer2 输入参数：BufferID(特征缓冲区号) 返回参数：确认字 指令代码：02H 指令包格式：
2 bytes
4bytes 1 byte 2 bytes 1 byte 1 byte 2 bytes 校验和 包头 模块地址 包标识 包长度 指令码 缓冲区号 BufferID 0xEF01 xxxx 01H 04H 02H sum
注：缓冲区CharBuffer1、CharBuffer2 的 BufferID 分别为 1h 和2h，如果指定其他值， 按 照CharBuffer2 处理
5
www.hzgrow.com
应答包格式： 2 bytes 4bytes 1 byte 2 bytes 1 byte 2 bytes 校验和 包头 模块地址 包标识 包长度 确认码 xxH 0xEF01
xxxx 07H 03H sum 注：确认码=00H 表示生成特征成功；
确认码=01H表示收包有错；
确认码=06H表示指纹图像太乱而生不成特征；
确认码=07H表示指纹图像正常，但特征点太少而生不成特征； 确认 码=15H表示图像缓冲区内没有有效原始图而生不成图像； sum 指校 验和
3. 搜索指纹 GR_Search
功能说明：以 CharBuffer1 或CharBuffer2中的特征文件搜索整个或部分指纹
库。 若搜索到，则返回页码。 输入参数：BufferID， StartPage(起始页)，PageNum（页数） 返回参数：确认字，页码（相配指纹模板） 指令代码：04H 指令包格式：
2 bytes 4bytes 1 byte 2 bytes
1 byte 1 byte 2 bytes 2 bytes 2 包头 模块地 包标识 包长度 01H 指令码 缓冲区号 参数 参数 校验 0xEF01 xxxx
08H 04H BufferID StartPagePageNum sum 注：缓冲区CharBuffer1、CharBuffer2 的BufferID分别为 1h和2h 应答包格式： 2 bytes 4bytes 1 byte 2 bytes 1 byte 2 bytes 2 bytes 2 bytes 校验和 包 模块地址 包标识 包长度 确认码 页码 得分 0xEF01
xxxx 07 07H xxH PageID MatchScore sum
注：确认码=00H 表示搜索到；
确认码=01H表示收包有错；
确认码=09H表示没搜索到；此时页码与得分为0 sum 指校验和
4. 合并特征（生成模板）GR_RegModel
功能说明：将 CharBuffer1 与CharBuffer2中的特征文件合并生成 模
板， 结果存于CharBuffer1 与CharBuffer2。 输入参数：none
6
www.hzgrow.com
返回参数：确认字 指令代码：05H 指 令包格式：
2 bytes 4bytes 1 byte 2 bytes 1 byte 指令码 2 bytes 包头 模块地址 包标识 包长度 校验和 0xEF01 xxxx 01H 03H 05H 09H 应答包格式：
2 bytes 4bytes 1 byte 2 bytes 1 byte 2 bytes 包头 模块地址 包标识 包长度 确认码 校验和 0xEF01 xxxx 07H 03H xxH sum
注 : 确认码=00H 表示合并成功；
确认码=01H表示收包有错；
确认码=0aH表示合并失败（两枚指纹不属于同一手指））； sum 指校验和
5. 储存模板 GR_StoreChar
功能说明：将 CharBuffer1 或 CharBuffer2 中的模板文件存到 PageID 号flash数
据 库位置。 输入参数：BufferID(缓冲区号)，PageID（指纹库位置号） 返回参数：确认字
指令代码：06H 指令包格式：
2 bytes 4bytes 1 byte 2 bytes 1 byte 1 byte 2 bytes 2 bytes 校验和 包头 模块地址 包标识 包长度 指令码 缓冲区号 位置号 PageID 0xEF01 xxxx 01H 06H 06H BufferID sum
应答包格式： 注：缓冲区 CharBuffer1、CharBuffer2 的BufferID 分别为1h和2h 2 bytes 4bytes 1 byte 2 bytes 1 byte 2 bytes 校验和 包头 模块地址 包标识 包长度 确认码 xxH 0xEF01 xxxx 07H 03H sum
注：确认码=00H 表示储存成功；
确认码=01H表示收包有错；
确认码=0bH表示 PageID超出指纹库范围； 确认码=18H表示写 FLASH出错； sum 指校验和
7
www.hzgrow.com