没有合适的资源?快使用搜索试试~ 我知道了~
首页ZKTeco 2020安防PUSH协议开发V3.1.2文档详解
ZKTeco 2020安防PUSH协议开发V3.1.2文档详解
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
![](https://csdnimg.cn/release/wenkucmsfe/public/img/star.98a08eaa.png)
"ZKTeco门禁安防PUSH协议开发文档(V1.5,2020年版)详细介绍了ZKTeco门禁系统与安防设备之间的通信协议,版本为V3.1.2,该文档包含了一系列关键更新,如混合识别协议、一体化模板管理协议、异常日志处理等。自2018年初始版本以来,不断优化和扩展了功能,以适应不同场景的需求。 文档结构包括概述、特点、编码介绍、HTTP协议基础、协议定义、功能模块以及详细的流程说明。在初始化阶段,涉及信息交互和公钥/因子交换(针对通信加密场景)。接下来是注册、下载配置参数、上传设备参数等核心操作,包括上传多种类型的数据,如用户信息、身份证信息、指纹模板、比对照片、抓拍照片和用户照片等,以及上传一体化模板和异常日志。 授权管理和心跳检测也是协议的一部分,确保系统的正常运行。下载功能则支持缓存命令的执行,服务器命令中详细列出了DATA命令及其子命令,如UPDATE、DELETE、COUNT和QUERY,用于数据的增删查改操作。 该文档不仅提供了技术实现的指南,还反映了ZKTeco在门禁安防领域持续的技术迭代,旨在提升设备间的无缝连接和数据共享能力。对于进行ZKTeco门禁系统二次开发的开发者来说,这份文档是不可或缺的参考资料,它涵盖了从协议设计到实际操作的完整流程,确保了开发工作的高效性和准确性。"
资源详情
资源推荐
![](https://csdnimg.cn/release/download_crawler_static/38630680/bg10.jpg)
15
FirmVer: 固件版本号
PushVersion: push SDK版本号
MAC:设备MAC地址
CommType: 通讯类型,可有以下方式:
ethernet:有线通信
usb-4G-modem:4G网络通信
serial-wireless:wifi(串口和Sdio)通信
MaxPackageSize: 通讯包最大尺寸
LockCount: 门的数量
ReaderCount: 读头数量
AuxInCount: 辅助输入数量
AuxOutCount: 辅助输出数量
MachineType: 机器型号 一体机101
~IsOnlyRFMachine: 是否仅支持射频卡的开关参数
~MaxUserCount: 用户最大容量信息(卡最大容量信息)
~MaxAttLogCount: 考勤记录最大容量信息
~MaxUserFingerCount: 单个用户指纹最大容量
MThreshold: 指纹1:N匹配阈值
IPAddress: 有线网络IP地址
NetMask: 有线网络的子网掩码
GATEIPAddress: 有线网络的网关地址
~ZKFPVersion: 指纹算法版本号
~REXInputFunOn: 出门按钮锁定功能开关参数,一体机未用
~CardFormatFunOn: 韦根读头是否支持自定义卡格式功能开关参数
~SupAuthrizeFunOn: 超级用户功能开关参数
~Ext485ReaderFunOn: 外接485读头
~TimeAPBFunOn: 入反潜时长功能开关参数
~CtlAllRelayFunOn: 开所有继电器功能开关参数
~LossCardFunOn: 丢失卡功能开关参数
SimpleEventType: 事件合并
VerifyStyles: 支持的验证方式,共32位,前16位每个位对应不同的验证方式组合,具体参考【附录3】 【验证方式码 描
述】,对应的位为1表示支 持,为0表示不支持,值为200代表门禁事件。
EventTypes: 支持的事件类型,共32个字节(0~31),每个字节8位(用2个十六进制数表示),共256位(0~255),每个
位对应的 功能参考【附录2】 【实时事件描述】,对应的位为1表示支持,为0表示不支持。
如 BF0FE03D30000100000000007000000000000000000000000077002001000000,其中第0个字节为BF,二进制为11111101
(低位在前),第6位为0,其它位为1,说明前八位控制的功能中,只有第6位表示的联动事件不支持,其他事件都支持。
DisableUserFunOn: 黑名单功能开关参数
DeleteAndFunOn: 且关系的删除功能开关参数
LogIDFunOn: 记录id功能开关参数
DateFmtFunOn: 日期格式功能开关参数(控制用户表中的有效期时间)
DelAllLossCardFunOn: 删除所有黑名单功能开关参数
![](https://csdnimg.cn/release/download_crawler_static/38630680/bg11.jpg)
16
AutoClearDay: 自动清除事件日志的间隔时间
FirstDelayDay: 未认证用户登记后首次授权开门的时间
DelayDay: 未认证用户登记后首次授权开门后追加的授权时间
StopAllVerify: 停止所有的验证功能,禁卡开门功能
FvFunOn: 指静脉识别功能开关参数
FaceFunOn: 人脸识别功能开关参数
FingerFunOn: 指纹识别功能开关参数
CameraOpen: 摄像头功能开关参数
AutoServerFunOn: 后台验证开关功能开关参数
DelayOpenDoorFunOn: 延时开门功能开关,不支持
UserOpenDoorDelayFunOn: 对某用户延长开门时间功能开关,不支持
MultiCardInterTimeFunOn: 可设置多卡刷卡间隔功能开关,不支持
OutRelaySetFunOn: 输出配置功能开关参数,不支持
MachineTZFunOn: 可设置机器时区功能开关参数,不支持
DSTFunOn: 夏令时功能功能开关参数,不支持
CardSiteCodeFunOn:卡的sitecode功能开关。
MulCardUserFunOn:多卡用户功能开关(设备的业务逻辑判断使用)
UserNameFunOn:用户姓名功能开关
StringPinFunOn:支持字符串工号
MaxLockCount:最大门数量
MaxZigbeeCount:最大Zigbee数量
MaxMCUCardBits:最大卡二进制位数
SupportReaderType:支持读头类型
CmdFormat: 命令格式,具体见【附录14】
MultiStageControlFunOn:多级控制参数,具体见【附录15】
MasterControlOn:多级控制参数,具体见【附录15】
SubControlOn:多级控制参数,具体见【附录15】
BioPhotoFun:支持比对照片参数
BioDataFun:支持可见光人脸模板参数
UserPicURLFunOn:支持URL方式下发用户照片参数
MultiBioDataSupport: 支持多模态生物特征模板参数,type类型进行按位定义,不同类型间用:冒号隔开,0:不支持,1表
示支持:支持版本号,如:0:1:1:0:0:0:0:0:0:0,表示支持指纹模板支持和近红外人脸模板支持
MultiBioPhotoSupport:支持多模态生物特征图片参数,type类型进行按位定义,不同类型间用:冒号隔开,0:不支持,1
表示支持:支持版本号,如:0:1:1:0:0:0:0:0:0:0,表示支持指纹图片支持和近红外人脸图片支持
MultiBioVersion: 多模态生物特征数据版本,不同类型间用:冒号隔开,0:不支持,1表示支持:支持版本号,如:
0:10.0:7.0:0:0:0:0:0:0:0,表示支持指纹算法10.0和近红外人脸算法7.0
MaxMultiBioDataCount:支持多模态生物特征数据最大数量,type类型进行按位定义,不同类型间用:冒号隔开,0:不支持,
1表示支持:支持模板最大数量,如:0:10000:2000:0:0:0:0:0:0:0,表示支持指纹最大数量10000和近红外人脸最大数量2000
MaxMultiBioPhotoCount:支持多模态生物特征图片最大数量,type类型进行按位定义,不同类型间用:冒号隔开,0:不支
持,1表示支持:支持照片最大数量,如:0:10000:2000:0:0:0:0:0:0:0,表示支持指纹图片最大数量10000和近红外人脸图
片最大数量2000
authKey:通信秘钥
![](https://csdnimg.cn/release/download_crawler_static/38630680/bg12.jpg)
17
AccSupportFunList:根据位来获取功能支持参数(该参数软件不可修改),如果没传,默认全0
注释:位置值是指AccSupportFunList参数值的字符串位置,从0开始并从左到右数
位置值 备注
0 0不支持;1支持 读头禁用功能
1 0不支持;1支持 485读头加密功能
2 0不支持;1支持 门锁定功能
3 0不支持;1支持 紧急双开、紧急双闭
4 0不支持;1支持 通过门磁及继电器状态对应到Wiegand读头灯的红绿
5 0不支持;1支持 长姓名的功能
6 0不支持;1支持 韦根格式带sitecode
7 0不支持;1支持 一人多卡功能(软件的业务逻辑判断使用,当为1,软件会下发设置设备参数
MulCardUserFunOn=1)
8 0不支持;1支持 辅助输入、出门按钮受时间段控制
9 0不支持;1支持 临时用户每天自动删除功能
10 0不支持;1支持 支持wg test功能
11 0不支持;1支持 支持account命令
12 0不支持;1支持 不同用户不用时间段不同验证方式
13 0不支持;1支持 控制485读头Led
14 0不支持;1支持 门支持多种韦根格式,保留
15 0不支持;1支持 权限表中doorid只表示一个门
16 0不支持;1支持 用户超级权限独立表
17 0不支持;1支持 支持添加门属性功能
18 0不支持;1支持 读头属性功能
19 0不支持;1支持 辅助输入属性表功能
20 0不支持;1支持 辅助输出属性表功能
21 0不支持;1支持 门参数表功能
22 0不支持;1支持 反潜表功能
23 0不支持;1支持 互锁表功能
24 0不支持;1支持 Wireless-serial功能
25 0不支持;1支持 4G-usb通信功能
26 0不支持;1支持 表支持DevID字段(控制协议中是否有DevID字段)
27 0不支持;1支持 是否支持从机
28 0不支持;1支持 是否支持双网卡
29 0不支持;1支持 是否支持授权表
30 0不支持;1支持 是否身份证登记
31 0不支持;1支持 设备是否支持主从切换
32 0不支持;1支持 设备是否支持混合读头,韦根/485读头
33 0不支持;1支持 设备是否支持韦根数据处理 字节交换 位反转 字节交换
34 0不支持;1支持 设备是否支持desfire控卡功能
35 0不支持;1支持 支不支持下发二维码命令
36 0不支持;1支持 是否支持广告下发命令zksq200新增
37 0不支持;1支持 是否支持室内机功能zksq200新增
![](https://csdnimg.cn/release/download_crawler_static/38630680/bg13.jpg)
18
38 0不支持;1支持 设备是否支持上传比对照片功能
39 0不支持;1支持 设备是否支持上传一体化可见光人脸模板功能
40 0 不支持;1 支持 设备是否远程登记
41 0 不支持;1 支持 设备是否支持验证结果风格设置功能
42 0 不支持;1 支持 设备是否支持设置认证服务器功能
43 0 不支持;1 支持 设备是否支持资源文件下发功能(语音文件、开机画面、欢迎页面、屏保页面等)
44 0 不支持;1 支持 设备是否支持对接AI设备(针对inbioPro等不支持读头属性表的非inbio5系列设备)
45 0 不支持;1 支持 设备是否支持扩展板dm10
46 0 不支持;1 支持 设备是否支持扩展板aux485
服务器正常响应:
HTTP/1.1 200 OK
Server: ${XXX}
Set-Cookie: ${XXX}; Path=/; HttpOnly
Content-Type: application/push;charset=UTF-8
Content-Length: ${XXX}
Date: ${XXX}
RegistryCode=${XXX}
注释:
RegistryCode:服务器生成随机数,最长32个字节。
如果注册失败,则不会返回注册码,而是返回“406”
示例:
客户端请求消息:
POST /iclock/registry?SN=3383154200002 HTTP/1.1
Host: 192.168.213.17:8088
User-Agent: iClock Proxy/1.09
Connection: starting
Accept: application/push
Accept-Charset: UTF-8
Accept-Language: zh-CN
Content-Type: application/push;charset=UTF-8
Content-Language: zh-CN
Content-Length: 855
DeviceType=acc,~DeviceName=F20/M,FirmVer=Ver 8.0.1.3-20151229,PushVersion=Ver
2.0.22-20161201,CommType=ethernet,MaxPackageSize=2048000,LockCount=1,ReaderCount=2,AuxInCount=0,AuxOutCoun
t=0,MachineType=101,~IsOnlyRFMachine=0,~MaxUserCount=50,~MaxAttLogCount=10,~MaxUserFingerCount=10,MThresho
![](https://csdnimg.cn/release/download_crawler_static/38630680/bg14.jpg)
19
ld=60,IPAddress=192.168.213.221,NetMask=255.255.255.0,GATEIPAddress=192.168.213.1,~ZKFPVersion=10,IclockSv
rFun=1,OverallAntiFunOn=0,~REXInputFunOn=0,~CardFormatFunOn=0,~SupAuthrizeFunOn=0,~ReaderCFGFunOn=0,~Reade
rLinkageFunOn=0,~RelayStateFunOn=1,~Ext485ReaderFunOn=0,~TimeAPBFunOn=0,~CtlAllRelayFunOn=0,~LossCardFunOn
=0,SimpleEventType=1,VerifyStyles=ff7f0000,EventTypes=BF0FE03D30000100000000007000000000000000000000000077
002001000000,DisableUserFunOn=0,DeleteAndFunOn=0,LogIDFunOn=0,DateFmtFunOn=0,DelAllLossCardFunOn=0,AutoCle
arDay=0,FirstDelayDay=0,DelayDay=0,StopAllVerify=0,FvFunOn=0,FaceFunOn=0,FingerFunOn=1,CameraOpen=1,AccSup
portFunList=0101010000111000000111010100011010,AutoServerFunOn=1,DelayOpenDoorFunOn=1,UserOpenDoorDelayFun
On=1,MultiCardInterTimeFunOn=1,OutRelaySetFunOn=1,MachineTZFunOn=1,DSTFunOn=1,CardSiteCodeFunOn=1,MulCardU
serFunOn=1,UserNameFunOn=1,StringPinFunOn=1,MaxLockCount=4,MaxZigbeeCount=3,MaxMCUCardBits=37,SupportReade
rType=1,authKey=dassas
服务器响应:
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Set-Cookie: JSESSIONID=30BFB04B2C8AECC72C01C03BFD549D15; Path=/; HttpOnly
Content-Type: text/plain;charset=ISO-8859-1
Content-Length: 23
Date: Mon, 09 Jan 2017 01:31:59 GMT
RegistryCode=Uy47fxftP3
7.5
下载配置参数
应用场景:
上一步注册请求成功返回注册码后,需要设备主动获取服务器的配置参数,才算完成整个初始化过程
客户端请求消息:
GET /iclock/push?SN=$(SerialNumber) HTTP/1.1
Cookie: token=${XXX},timestamp=${XXX}
Host: ${ServerIP}:${ServerPort}
……
服务器响应:
HTTP/1.1 200 OK
Server: ${XXX}
Content-Type: application/push;charset=UTF-8
Content-Length: ${XXX}
Date: ${XXX}
……
ServerVersion=${XXX}
剩余149页未读,继续阅读
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://profile-avatar.csdnimg.cn/53b45528f81e4ffca6c6f7889a796d92_u012944110.jpg!1)
追寻QWN
- 粉丝: 7
- 资源: 7
上传资源 快速赚钱
我的内容管理 展开
我的资源 快来上传第一个资源
我的收益
登录查看自己的收益我的积分 登录查看自己的积分
我的C币 登录后查看C币余额
我的收藏
我的下载
下载帮助
![](https://csdnimg.cn/release/wenkucmsfe/public/img/voice.245cc511.png)
最新资源
- 多模态联合稀疏表示在视频目标跟踪中的应用
- Kubernetes资源管控与Gardener开源软件实践解析
- MPI集群监控与负载平衡策略
- 自动化PHP安全漏洞检测:静态代码分析与数据流方法
- 青苔数据CEO程永:技术生态与阿里云开放创新
- 制造业转型: HyperX引领企业上云策略
- 赵维五分享:航空工业电子采购上云实战与运维策略
- 单片机控制的LED点阵显示屏设计及其实现
- 驻云科技李俊涛:AI驱动的云上服务新趋势与挑战
- 6LoWPAN物联网边界路由器:设计与实现
- 猩便利工程师仲小玉:Terraform云资源管理最佳实践与团队协作
- 类差分度改进的互信息特征选择提升文本分类性能
- VERITAS与阿里云合作的混合云转型与数据保护方案
- 云制造中的生产线仿真模型设计与虚拟化研究
- 汪洋在PostgresChina2018分享:高可用 PostgreSQL 工具与架构设计
- 2018 PostgresChina大会:阿里云时空引擎Ganos在PostgreSQL中的创新应用与多模型存储
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
![](https://img-home.csdnimg.cn/images/20220527035711.png)
![](https://img-home.csdnimg.cn/images/20220527035711.png)
![](https://img-home.csdnimg.cn/images/20220527035111.png)
安全验证
文档复制为VIP权益,开通VIP直接复制
![](https://csdnimg.cn/release/wenkucmsfe/public/img/green-success.6a4acb44.png)