微耕门禁开发协议.docx
- 文档编号:24245436
- 上传时间:2023-05-25
- 格式:DOCX
- 页数:72
- 大小:44.94KB
微耕门禁开发协议.docx
《微耕门禁开发协议.docx》由会员分享,可在线阅读,更多相关《微耕门禁开发协议.docx(72页珍藏版)》请在冰豆网上搜索。
微耕门禁开发协议
请仔细阅读以下注意事项:
厂家以免费的方式提供如下技术文章中目录中所列功能的门禁控制器的动态连接库及其底层通讯协议的内容供系统集成商进行二次开发,附有简单的编程案例,暂不能提供更多案例。
该通讯协议仅推荐您用于门禁系统和考勤系统,不建议您用于其他应用场合。
因为其他场合的干扰源和门禁的使用环境可能有所不同,所以抗干扰设计不太一样,如果强行将门禁控制器用于其他我们未检测的设计的环境,有可能会引起返修率的提高,敬请注意。
厂家只提供底层通讯协议和动态连接库,以及简单的案例。
门禁控制器的绝大部分功能都描述在开发包内,有个别功能尚处于测试阶段,暂时不能提供。
动态库只能用于XP以上的操作系统,不能用于Windows2000及以下操作系统。
如果您希望提供更多的内容,或者有更好的建议和意见,请直接发给我们的开发支持人员,在下一年度的版本中我们会考虑是否将您建议的内容补充进去。
届时我们会及时通知到您,谢谢!
9.1开发包可实现功能说明
读取时间,校准时间
提取记录,删除记录
下传权限,修改权限,删除权限,清空权限,读取权限
修改时段,读取时段
设置门在线,常开,常闭
设置开门延时
搜索TCPIP控制器,配置IP
远程开门
启用密码键盘
启用报警门磁事件记录
单个控制器内的双门或多门互锁
首卡开门
多卡开门
胁迫密码
超级密码开门
输”*卡号*密码#”开门
定时任务
扩展板设置
控制器恢复出厂化设置(格式化)
测试案例演示如下功能:
读取控制器运行信息(时间,刷卡记录数,权限数,最近一条刷卡记录,门磁状态,按钮状态,故障信息)
读取控制器IP,设置IP(仅用于.NET控制器)
校准控制器时间
远程开1号门
提取记录
删除已提取的记录
发送权限操作(1.先清空权限,2.再添加权限)
发送控制时段
实时监控
9.2接口设计[给开发商的协议](请参考开发案例进行)
9.2.1S/N序列号与产品对应关系及卡号说明
485控制器:
(串口通信速率为9600,N,8,1)
11000-19999[WG2001单门双向485控制器]
21000-29999[WG2002双门双向485控制器]
41000-49999[WG2004四门单向485控制器]
.NET控制器:
(采用UDP通信方式,默认端口是60000)
33000-39999[WG2002.NET双门双向.NET控制器]
50000-59999[WG2001.NET单门双向.NET控制器]
60000-64999[WG2004.NET四门单向.NET控制器]
特别说明:
日常中ID卡或IC卡的卡号:
在本协议内由两部分组成:
区号+ID号[依据Motorola卡定义].以ID卡为例,平常说卡号25409969,在协议中区号=254,ID号=09969.
建议:
从”读取运行状态信息”指令开始控制器操作.[可参考:
读取运行状态信息[1081]]
在开发过程中,可采用格式化[10FF]指令对设备恢复出厂化设置.
9.2.2基本格式
9.2.2.1短时间格式
Time(HMS)/*时分秒*/
BitPosition
01234
56789A
BCDEF
Length(bit)
5
6
5
Contents
Hours(时)
Minutes(分)
2-secondincrements(2秒)
ValueRange
0–23
0–59
0-29in2-secondintervals
参考:
WComm_UDP.dll库中的MSDateHmsToWCDateHms,WCDateToMSDate
Date(YMD)/*年月日*/
BitPosition
0123456
789A
BCDEF
Length(bit)
7
4
5
Contents
Year(年)
Month(月)
Day(日)
ValueRange
0–119(relativeto2000)
1–12
1–31
参考:
WComm_UDP.dll库中的MSDateYmdToWCDateYmd,WCDateToMSDate
总共32个BITS,合4个字节。
范例:
[B3020D5D]
02B3[年月日]5D0D[时分秒]--2001年5月19日11时40分26秒
9.2.2.2记录格式
ID号
(2)+区号
(1)+记录状态
(1)+刷卡年月日
(2)+刷卡时分秒
(2)
说明:
总共占8个字节
刷卡年月日时分秒按短时间格式记录
ID号,区号及刷卡状态描述如下:
日常中ID卡或IC卡的卡号:
在本协议内由两部分组成:
区号+ID号[依据Motorola卡定义].以ID卡为例,平常说卡号25409969,在协议中区号=254,ID号=09969.
以下所说的完整卡号=[区号,ID号]组成(其值为8位号码)
对于单门双向或双门双向控制器,1/2号读卡器对应1号门,3/4号读卡器对应2号门
对于四门单向控制器,读卡器与控制器一一对应.
(完整卡号大于100表示正常的刷卡操作记录)
[特殊说明:
为了显示禁止通过时具体原因,请将地址位0x37的参数值设为01]
完整卡号
记录状态(16进制)
正常操作
代表意义
大于100
00
允许通过
1号读卡器刷卡开门
大于100
01
允许通过
2号读卡器刷卡开门
大于100
02
允许通过
3号读卡器刷卡开门
大于100
03
允许通过
4号读卡器刷卡开门
大于100
80
禁止通过
(1)号读卡器刷卡禁止通过:
原因不明
大于100
81
禁止通过
(2)号读卡器刷卡禁止通过:
原因不明
大于100
82
禁止通过
(3)号读卡器刷卡禁止通过:
原因不明
大于100
83
禁止通过
(4)号读卡器刷卡禁止通过:
原因不明
大于100
90
禁止通过
(1)号读卡器刷卡禁止通过:
没有权限
大于100
91
禁止通过
(2)号读卡器刷卡禁止通过:
没有权限
大于100
92
禁止通过
(3)号读卡器刷卡禁止通过:
没有权限
大于100
93
禁止通过
(4)号读卡器刷卡禁止通过:
没有权限
大于100
A0
禁止通过
(1)号读卡器刷卡禁止通过:
密码不对
大于100
A1
禁止通过
(2)号读卡器刷卡禁止通过:
密码不对
大于100
A2
禁止通过
(3)号读卡器刷卡禁止通过:
密码不对
大于100
A3
禁止通过
(4)号读卡器刷卡禁止通过:
密码不对
大于100
B0
禁止通过
(1)号读卡器刷卡禁止通过:
系统有故障
大于100
B1
禁止通过
(2)号读卡器刷卡禁止通过:
系统有故障
大于100
B2
禁止通过
(3)号读卡器刷卡禁止通过:
系统有故障
大于100
B3
禁止通过
(4)号读卡器刷卡禁止通过:
系统有故障
大于100
C0
禁止通过
(1)号读卡器刷卡禁止通过:
反潜回,多卡开门或多门互锁
大于100
C1
禁止通过
(2)号读卡器刷卡禁止通过:
反潜回,多卡开门或多门互锁
大于100
C2
禁止通过
(3)号读卡器刷卡禁止通过:
反潜回,多卡开门或多门互锁
大于100
C3
禁止通过
(4)号读卡器刷卡禁止通过:
反潜回,多卡开门或多门互锁
大于100
C4
禁止通过
(1)号读卡器刷卡禁止通过:
反潜回
大于100
C5
禁止通过
(2)号读卡器刷卡禁止通过:
反潜回
大于100
C6
禁止通过
(3)号读卡器刷卡禁止通过:
反潜回
大于100
C7
禁止通过
(4)号读卡器刷卡禁止通过:
反潜回
大于100
C8
禁止通过
(1)号读卡器刷卡禁止通过:
多卡
大于100
C9
禁止通过
(2)号读卡器刷卡禁止通过:
多卡
大于100
CA
禁止通过
(3)号读卡器刷卡禁止通过:
多卡
大于100
CB
禁止通过
(4)号读卡器刷卡禁止通过:
多卡
大于100
CC
禁止通过
(1)号读卡器刷卡禁止通过:
首卡
大于100
CD
禁止通过
(2)号读卡器刷卡禁止通过:
首卡
大于100
CE
禁止通过
(3)号读卡器刷卡禁止通过:
首卡
大于100
CF
禁止通过
(4)号读卡器刷卡禁止通过:
首卡
大于100
D0
禁止通过
(1)号读卡器刷卡禁止通过:
门为常闭
大于100
D1
禁止通过
(2)号读卡器刷卡禁止通过:
门为常闭
大于100
D2
禁止通过
(3)号读卡器刷卡禁止通过:
门为常闭
大于100
D3
禁止通过
(4)号读卡器刷卡禁止通过:
门为常闭
大于100
D4
禁止通过
(1)号读卡器刷卡禁止通过:
互锁
大于100
D5
禁止通过
(2)号读卡器刷卡禁止通过:
互锁
大于100
D6
禁止通过
(3)号读卡器刷卡禁止通过:
互锁
大于100
D7
禁止通过
(4)号读卡器刷卡禁止通过:
互锁
大于100
E0
禁止通过
(1)号读卡器刷卡禁止通过:
卡过期或不在有效时段
大于100
E1
禁止通过
(2)号读卡器刷卡禁止通过:
卡过期或不在有效时段
大于100
E2
禁止通过
(3)号读卡器刷卡禁止通过:
卡过期或不在有效时段
大于100
E3
禁止通过
(4)号读卡器刷卡禁止通过:
卡过期或不在有效时段
(完整卡号小于100表示特殊操作记录)
完整卡号
记录状态(16进制)
正常操作
代表意义
0
00
按钮
1号门按钮动作
1
00
按钮
2号门按钮动作
2
00
按钮
3号门按钮动作
3
00
按钮
4号门按钮动作
0
03
远程开门
1号门远程开门动作
1
03
远程开门
2号门远程开门动作
2
03
远程开门
3号门远程开门动作
3
03
远程开门
4号门远程开门动作
5
00
超级密码开门
1号读卡器超级密码开门
5
01
超级密码开门
2号读卡器超级密码开门
5
02
超级密码开门
3号读卡器超级密码开门
5
03
超级密码开门
4号读卡器超级密码开门
8
00
门打开
1号门打开[门磁信号]
9
00
门打开
2号门打开[门磁信号]
10
00
门打开
3号门打开[门磁信号]
11
00
门打开
4号门打开[门磁信号]
12
00
门关闭
1号门关闭[门磁信号]
13
00
门关闭
2号门关闭[门磁信号]
14
00
门关闭
3号门关闭[门磁信号]
15
00
门关闭
4号门关闭[门磁信号]
0
81
胁迫报警
1号读卡器胁迫报警
1
81
胁迫报警
2号读卡器胁迫报警
2
81
胁迫报警
3号读卡器胁迫报警
3
81
胁迫报警
4号读卡器胁迫报警
0
82
门长时间未关报警
1号门长时间未关报警
1
82
门长时间未关报警
2号门长时间未关报警
2
82
门长时间未关报警
3号门长时间未关报警
3
82
门长时间未关报警
4号门长时间未关报警
0
84
非法闯入报警
1号门非法闯入报警
1
84
非法闯入报警
2号门非法闯入报警
2
84
非法闯入报警
3号门非法闯入报警
3
84
非法闯入报警
4号门非法闯入报警
4
A0
火警
火警动作[针对整个控制器]
6
A0
强制
强制锁门[针对整个控制器]
9.2.2.3权限信息
每个权限占16个字节〔预设3万个权限〕
格式:
ID号
(2)+区号
(1)+门号
(1)+卡起始年月日
(2)+卡截止年月日
(2)+控制时段索引号
(1)+密码(3)+备用1+备用2+备用3+备用4
说明:
权限发送时,必须先发1号门(门号相同的,先发卡号小的,再发卡号大的),再发2号门…
门号:
从01开始,最大为04;
卡起始年月日:
按短时间格式中的年月日进行定义,默认用[2100]=2000年01月01日填入。
卡截止年月日:
按短时间格式中的年月日进行定义,默认用[9F29]2020年12月31日
控制时段索引号:
00—禁止;01—表示在有效期内,任意时间有效;
密码用3个字节:
默认为123456[等于十六进制的40E201]
备用1:
=1表示此权限是首卡用户,=0表示不是首卡用户(适用于首卡开门)
备用2:
=0表示普通用户组;>0表示此权限所属的特殊群组(适用于多卡开门用户)
9.2.2.4控制时段
分为256个组,每组占24个字节
每组格式如下:
星期控制(1字节,缺省值为7F)+下一个链接时段(缺省为0)+保留(2字节,用0填充)+
起始时分秒1(2字节)+终止时分秒1(2字节)+
起始时分秒2(2字节)+终止时分秒2(2字节)+
起始时分秒3(2字节)+终止时分秒3(2字节)
起始日期(2字节)+终止日期(2字节)+
保留(4字节,用0填充)
说明:
(1-星期有效;0-当前星期无效)
*有效索引号的值范围(0--255)[在用户权限中使用到]。
第0个控制时段组始终作为禁止刷卡时段组,第1个控制时段组始终作为任意时间有效组(0,1修改值无效)。
2—255用户可自行修改
*星期控制:
(1-星期有效;0-当前星期无效)
Bit位
7
6
5
4
3
2
1
0
说明
0--表示受到时段控制
1--表示任意时间有效,即不受时段控制;
日
六
五
四
三
二
一
如果七天都有效,则为7F,
如果只有星期一到星期五有效,则为1F
*“保留”字节缺省值等于0
控制时段的功能:
用于核实刷卡是否处于有效时间内进行。
必须先满足起始日期和截止日期控制,再满足星期控制(当日有效),再核时分秒控制;必须完全满足3个控制(日期控制,星期控制,3个时分秒控制中的任意一个)才可通过。
下一个链接时段用于并列时段,如果此时段号不为FF或0,则引入相应号的时段来对刷卡操作作相应权限检查.当此时段不允许通过时,可以再查并列时段.
起始日期(年月日):
按短时间格式中的年月日进行定义,默认用[2100]=2000年01月01日
终止日期(年月日):
按短时间格式中的年月日进行定义,默认用[9F29]=2020年12月31日
9.2.2.5首卡开门
1.首卡开门的实现通过定时任务来完成
2.在设置权限时,要对拥有首卡权限的用户进行设置,请参考:
权限信息(备用1的值=1)
3.首卡使用的状态:
0x00刷首卡后作按正常处理
0x11刷首卡后,门切换到常开;
0x12刷首卡后,门切换到常闭,
0x13刷首卡后,门切换到在线;
0x14只许首卡才能开门,刷首卡后,不切换
例如:
对于1号门早上8:
00允许首卡刷卡后,其他人才能刷卡开门;下午18:
30之后,只有首卡才能开门,刷首卡后,不切换
操作:
先发送2条指令:
F410360001[启用定时任务指令]
F3100001指令
再发送:
F510000100000600407F9B1300[第一个任务0040表示8点,7F-星期全部,9B13一号门刷首卡后,门切换到在线.9B表示一号门,如果2号门则是9C,3号门是9D,4号门是9E]
F510000106000600987F9B1400[第二个任务0098表示18:
30,7F-星期全部,9B14一号门只能首卡刷卡才能开门]
9.2.2.6多卡开门(含多群组)
对总的要求数(不分所属的群组):
地址位
说明
默认值
默认值说明
0xB8
1号读卡器同时要到人数
00
00=[无多卡要求];大于0表示要求到的人数
0xB9
2号读卡器同时要到人数
00
00=[无多卡要求];大于0表示要求到的人数
0xBA
3号读卡器同时要到人数
00
00=[无多卡要求];大于0表示要求到的人数
0xBB
4号读卡器同时要到人数
00
00=[无多卡要求];大于0表示要求到的人数
对群的设置
地址位
1号读卡器同时要到人数
地址位
2号读卡器同时要到人数
地址位
3号读卡器同时要到人数
地址位
4号读卡器同时要到人数
0xBC
群1
0xC4
群1
0xCC
群1
0xD4
群1
0xBD
群2
0xC5
群2
0xCD
群2
0xD5
群2
0xBE
群3
0xC6
群3
0xCE
群3
0xD6
群3
0xBF
群4
0xC7
群4
0xCF
群4
0xD7
群4
0xC0
群5
0xC8
群5
0xD0
群5
0xD8
群5
0xC1
群6
0xC9
群6
0xD1
群6
0xD9
群6
0xC2
群7
0xCA
群7
0xD2
群7
0xDA
群7
0xC3
群8
0xCB
群8
0xD3
群8
0xDB
群8
缺省情况下:
各个群要到的人数=0,也就是只要是合法用户刷卡就可以开门.
通过”参数修改指令”设置各个群要求到的人数.
说明:
举例:
要求1号读卡器同时要3个人刷卡,其中必须有1人是主任.
则可将主任设为1号读卡器的群1成员,
在设置权限时,主任的权限备用2的值=1[请参考权限信息]
发送指令
F410B800033个人同时刷卡
F410BC00011号读卡器的1号群必须要有1人到场
9.2.2.7扩展板设置
通过”参数修改指令”设置地址位的值
地址位
说明
默认值(需要设置的值)
默认值说明
0x98
1号扩展口的报警源或者联动源
1
默认报警源1号门
0x99
1号扩展口的控制位
0
0x9A
1号扩展口的事件类型1
0x27
默认为胁迫/门开未关闭/非法闯入/火警
0x9B
1号扩展口的事件类型2
0
0x9C
1号扩展口的动作延时[低位]
0x64
动作延时10秒
0x9D
1号扩展口的动作延时[高位]
0x9C和0x9D组成一个双字节数.单位是0.1秒.
0x00
0x9E
2号扩展口的报警源或者联动源
2
默认报警源2号门
0x9F
2号扩展口的控制位
0
硬件驱动V16才支持
0xA0
2号扩展口的事件类型1
0x27
默认为胁迫/门开未关闭/非法闯入/火警
0xA1
2号扩展口的事件类型2
0
0xA2
2号扩展口的动作延时[低位]
0x64
动作延时10秒
0xA3
2号扩展口的动作延时[高位]
0xA2和0xA3组成一个双字节数.单位是0.1秒.
0x00
0xA4
3号扩展口的报警源或者联动源
4
默认报警源3号门
0xA5
3号扩展口的控制位
0
硬件驱动V16才支持
0xA6
3号扩展口的事件类型1
0x27
默认为胁迫/门开未关闭/非法闯入/火警
0xA7
3号扩展口的事件类型2
0
0xA8
3号扩展口的动作延时[低位]
0x64
动作延时10秒
0xA9
3号扩展口的动作延时[高位]
0xA8和0xA9组成一个双字节数.单位是0.1秒.
0x00
0xAA
4号扩展口的报警源或者联动源
8
默认报警源4号门
0xAB
4号扩展口的控制位
0
硬件驱动V16才支持
0xAC
4号扩展口的事件类型1
0x27
默认为胁迫/门开未关闭/非法闯入/火警
0xAD
4号扩展口的事件类型2
0
0xAE
4号扩展口的动作延时[低位]
0x64
动作延时10秒
0xAF
4号扩展口的动作延时[高位]
0xAE和0xAF组成一个双字节数.单位是0.1秒.
0x00
说明:
报警源或触发源通过位来指源头:
Bit0=1表示1号门,Bit1=1表示2号门;Bit2=1表示3号门,Bit3=1表示4号门,这4个门可组合作为触发源,但组合时一定要注意合理性.也就实际使用,不能随意操作.
报警源/触发源
Bit7
6
5
4
3
2
1
0
说明
对应Bit位=1时表示来源于
4号门
3号门
2号门
1号门
扩展口的控制位
控制位
Bit7
6
5
4
3
2
1
0
说明
对应Bit位=1时表示
如果此端口作为门未关闭报警输出时,门未关闭报警复位则输出立即停止(无延时)
如果此端口作为门未关闭报警输出时,有门未关闭报警则一直输出(时间不少于最小延时)
如果此端口作为非法闯入报警输出时,有非法闯入报警则一直输出
Bit2的优先级高过bit1.也就是说两个同时设为1,则按bit2的执行.
事件类型1
Bit7
6
5
4
3
2
1
0
备注
对应Bit位=1时表示
火警
非法卡刷卡
联动
非法闯入
门开未关闭
胁迫
这些信号来自设定的门
事件类型2
Bit7
6
5
4
3
2
1
0
备注
说明[只能选择其中一个为1]
按钮互动
门磁互动
继电器互动
互动意思是保持一致的状态,不受延时限制
通过”参数修改指令”设置地址位的值.
9.2.3外部接口
9.2.3.1通信基本格式(34字节帧)
485控制器:
(串口通信速率为9600,N,8,1)
.NET控制器:
(采用UDP通信方式,默认端口是60000)
PC与控制器采用固定帧长(34字节)通信。
每个帧包含帧头(5字节)、数据帧(26字节)、帧尾(3字节)三部分。
总序号(BYTE)
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
各字节位
说明
起始
位
板地址
LH
功能位
LH
数据帧(无数据时用00填充)
值(hex)
7E
XX
XX
XX
XX
00
00
00
00
00
00
00
00
00
00
00
00
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 门禁 开发 协议