人脸识别机与服务器访问协议,人脸识别终端485通信协议.doc

人脸识别终端485通信协议

人脸识别终端485通信协议

(波特率为57600bps；8个数据位，1个停止位，无奇偶校验位)

目 录

一．协议描述3

二．数据包格式3

三．包类型及子类型定义4

四．各命令及其数据结构详细描述5

1.连接与用户认证5

2.识别结果通知7

3.查询系统时间信息7

4.查询部门列表信息8

5.查询用户信息9

6.提取用户特征码10

7.设置系统时间信息11

8.增加、修改或删除部门信息11

9.增加、修改或删除用户信息12

10.修改用户特征码13

11.用户注册13

12.用户识别14

13.强制开门请求15

14.查询门禁记录15

15.删除门禁记录17

16.查询系统日志18

五．错误响应NAK数据格式19

六．其它20

本协议为嵌入式人脸识别终端与第三方系统(门禁控制器、访问系统或签到系统等)对接的协议，支持经过认证的第三方系统可以对门禁终端进行用户管理、记录管理以及操作控制等。

用户管理主要包括查询、增加、修改、删除用户。(用户模板必须在终端注册)

记录管理主要包括记录查询以及删除。

操作控制主要包括远程控制注册登记及注册资料及结果上传、远程控制识别及识别结果上传等。

协议描述

客户端发送请求命令CMD，成功会收到确认响应ACK，如果是请求记录则可以继续发送提取下一条记录请求命令GET-NEXT，成功将收到相应的记录信息，所有请求失败均会收到错误响应NAK。

数据包格式

数据包包括包标识、包序号、包类型、数据长度、数据内容共五个字段，定义如下：

包标识包序号包类型子类型数据长度数据内容整个数据包均按1字节对齐。

多字节字段按网络字节序(高字节在前低字节在后)传输。

各字段描述如下：

包标识：包头标识(2字节，固定为0x6666)

包序号：包序列号(2字节，值域0-65535)，不强制从0开始，但响应包必须与对应的请求包的包序号相同

包类型：请求或响应命令(1字节)，详见下表描述。

子类型：命令对应的数据类型(1字节)详见下表描述。

数据长度：包数据内容长度(4字节)，不包括本字段及前面各字段(单位：字节)

数据内容：请求或响应数据的内容(当数据长度为0时本字段不存在)，具体格式依不同包类型不同，详见各种包类型描述。

包类型及子类型定义

包类型包括认证请求(AUTH)、查询请求(GET)、查询下一条记录(GET-NEXT)、修改请求(PUT)、修改下一条记录(GET-NEXT)、响应(RESPONSE)、通知(TRAP)等，如下表所示：

包类型包类型描述备注0认证请求(AUTH)建立连接并认证1查询请求(GET)发起查询请求2查询下一条记录(GET-NEXT)查询下一条记录3修改请求(PUT)增加、修改或删除操作请求4修改下一条记录(PUT-NEXT)修改下一条记录5响应(RESPONSE)对请求的响应6通知(TRAP)无需请求直接发送事件通知如状态报告或警报等子类型定义依赖各类型定义，数据长度及格式依赖各类型及子类型定义，具有较强的扩展性。

认证请求(AUTH)的子类型定义如下表所示：

子类型子类型描述备注0申请用户认证随机数(RANDOM)提供用户名称发起用户认证请求以获得认证随机数1发起用户认证(AUTHENTICATE)根据终端返回的认证随机数及用户密码进行认证查询请求(GET)的子类型定义如下表所示：

子类型子类型描述备注0查询系统时间信息(TIME)查询终端当前时间信息1查询部门列表(DEP)查询部门列表信息2查询用户信息(USER)查询部分或所有用户信息3(过时)查询某用户的人脸特征(已过时)4查询门禁记录(ACCESS)查询指定时间段内的部分或所有门禁记录5查询系统日志(LOG)查询系统日志6查询用户特征码(FEATURE)查询某用户的人脸特征查询下一条记录(GET-NEXT)的子类型无意义(保留为0)。

修改请求(PUT)的子类型定义如下表所示：

子类型子类型描述备注0设置系统时间信息(TIME)设置终端系统时间信息1更新部门列表(DEP)添加或修改或删除某部门信息2更新用户信息(USER)添加或修改或删除某用户信息3(过时)更新某用户特征码请求(已过时)4删除门禁记录(ACCESS)删除指定时间以前的所有记录6更新用户特征码(FEATURE)更新某用户特征码请求7用户注册(ENROLL)注册新用户或登记用户特征码并将用户信息返回8用户识别(VERIFY)人脸识别并将识别结果返