微耕门禁_开发协议.doc

1、1请仔细阅读以下注意事项： 厂家以 免费 的方式提供如下技术文章中目录中所列功能的门禁控制器的动态连接库及其底层通讯协议的内容供系统集成商进行二次开发，附有简单的编程案例，暂不能提供更多案例。 该通讯协议仅推荐您用于门禁系统和考勤系统，不建议您用于其他应用场合。因为其他场合的干扰源和门禁的使用环境可能有所不同，所以抗干扰设计不太一样，如果强行将门禁控制器用于其他我们未检测的设计的环境，有可能会引起返修率的提高，敬请注意。 厂家只提供底层通讯协议 和 动态连接库，以及简单的案例。 门禁控制器的绝大部分功能都描述在开发包内，有个别功能尚处于测试阶段，暂时不能提供。 动态库只能用于 XP 以上的操作

2、系统，不能用于 Windows2000 及以下操作系统。如果您希望提供更多的内容，或者有更好的建议和意见，请直接发给我们的开发支持人员，在下一年度的版本中我们会考虑是否将您建议的内容补充进去。届时我们会及时通知到您，谢谢！9.1 开发包可实现功能说明 .39.2 接口设计给开发商的协议 （请参考开发案例进行） .49.2.1 S/N 序列号与产品对应关系及卡号说明 .49.2.2 基本格式 .49.2.2.1 短时间格式 .49.2.2.2 记录格式 .59.2.2.3 权限信息 .89.2.2.4 控制时段 .89.2.2.5 首卡开门 .99.2.2.6 多卡开门(含多群组 ).99.2.

3、2.7 扩展板设置 .109.2.3 外部接口 .139.2.3.1 通信基本格式(34 字节帧 ).139.2.3.2 参数修改指令 .139.2.3.3 参数读取指令 .149.2.3.4 读取运行状态信息1081 .159.2.3.5 远程开门109D .169.2.3.6 设置时间108B .179.2.3.7 设置门控制参数(在线 /延时)108F .189.2.3.8 权限处理 .199.2.3.9 时段处理 .229.2.3.10 记录处理 .249.2.3.11 扩展功能 .259.2.3.12 设备基本信息1082 .319.2.3.13 格式化10FF .3229.2.4

4、.NET 控制器搜索及配置协议 .339.2.4.1 搜索.NET 设备1101 .339.2.4.2 配置 TCPIP11F2.3339.1 开发包可实现功能说明读取时间, 校准时间提取记录, 删除记录下传权限, 修改权限, 删除权限, 清空权限, 读取权限修改时段, 读取时段设置门在线, 常开, 常闭设置开门延时搜索 TCPIP 控制器, 配置 IP远程开门启用密码键盘启用报警门磁事件记录单个控制器内的双门或多门互锁首卡开门多卡开门胁迫密码超级密码开门输”*卡号*密码#”开门定时任务扩展板设置控制器恢复出厂化设置(格式化 )测试案例演示如下功能:读取控制器运行信息(时间, 刷卡记录数 ,

5、权限数, 最近一条刷卡记录, 门磁状态, 按钮状态, 故障信息)读取控制器 IP, 设置 IP(仅用于.NET 控制器)校准控制器时间远程开 1 号门提取记录删除已提取的记录发送权限操作(1.先清空权限, 2. 再添加权限)发送控制时段实时监控49.2 接口设计 给开发商的协议（请参考开发案例进行）9.2.1 S/N 序列号与产品对应关系及卡号说明485 控制器: (串口通信速率为 9600,N,8,1)11000-19999 WG2001 单门双向 485 控制器21000-29999 WG2002 双门双向 485 控制器41000-49999 WG2004 四门单向 485 控制器.NE

6、T 控制器: (采用 UDP 通信方式 , 默认端口是 60000)33000-39999WG2002.NET 双门双向.NET 控制器 50000-59999WG2001.NET 单门双向.NET 控制器60000-64999WG2004.NET 四门单向.NET 控制器特别说明: 日常中 ID 卡或 IC 卡的卡号: 在本协议内由两部分组成:区号+ID 号依据 Motorola 卡定义. 以 ID 卡为例, 平常说卡号 25409969, 在协议中区号=254, ID 号=09969.建议: 从”读取运行状态信息”指令开始控制器操作.可参考: 读取运行状态信息1081在开发过程中, 可采用

7、 格式化10FF 指令对设备恢复出厂化设置.9.2.2 基本格式9.2.2.1 短时间格式Time(HMS) /*时分秒 */ Bit Position 0 1 2 3 4 5 6 7 8 9 A B C D E FLength(bit) 5 6 5Contents Hours(时 ) Minutes(分) 2-second increments(2 秒)Value Range 023 059 0-29 in 2-second intervals参考: WComm_UDP.dll 库中的 MSDateHmsToWCDateHms, WCDateToMSDateDate(YMD) /*年月日*/

8、参考: WComm_UDP.dll 库中的 MSDateYmdToWCDateYmd, WCDateToMSDateBit Position 0 1 2 3 4 5 6 7 8 9 A B C D E FLength(bit) 7 4 5Contents Year(年) Month(月) Day(日)Value Range 0119(relative to 2000) 112 1315总共 32 个 BITS，合 4 个字节。范例：B3 02 0D 5D02B3年月日 5D0D时分秒-2001 年 5 月 19 日 11 时 40 分 26 秒9.2.2.2 记录格式ID 号（ 2）+区号（1

9、）+记录状态（1）+刷卡年月日（2）+刷卡时分秒（2）说明： 总共占 8 个字节刷卡年月日 时分秒按短时间格式记录ID 号,区号及刷卡状态描述如下:日常中 ID 卡或 IC 卡的卡号: 在本协议内由两部分组成:区号+ID 号依据 Motorola 卡定义. 以 ID 卡为例, 平常说卡号 25409969, 在协议中区号=254, ID 号=09969.以下所说的完整卡号=区号,ID 号 组成 (其值为 8 位号码)对于单门双向或双门双向控制器, 1/2 号读卡器对应 1 号门, 3/4 号读卡器对应 2 号门对于四门单向控制器, 读卡器与控制器一一对应.(完整卡号大于 100 表示正常的刷卡

10、操作记录 )特殊说明: 为了显示禁止通过时具体原因, 请将地址位 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)号读卡器刷卡

11、禁止通过: 原因不明大于 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)

12、号读卡器刷卡禁止通过: 系统有故障大于 100 B1 禁止通过 (2)号读卡器刷卡禁止通过: 系统有故障大于 100 B2 禁止通过 (3)号读卡器刷卡禁止通过: 系统有故障大于 100 B3 禁止通过 (4)号读卡器刷卡禁止通过: 系统有故障6完整卡号 记录状态(16 进制) 正常操作 代表意义大于 100 C0 禁止通过 (1)号读卡器刷卡禁止通过: 反潜回, 多卡开门或多门互锁大于 100 C1 禁止通过 (2)号读卡器刷卡禁止通过: 反潜回, 多卡开门或多门互锁大于 100 C2 禁止通过 (3)号读卡器刷卡禁止通过: 反潜回, 多卡开门或多门互锁大于 100 C3 禁止通过 (4)号

13、读卡器刷卡禁止通过: 反潜回, 多卡开门或多门互锁大于 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 禁止通过

14、(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)号

15、读卡器刷卡禁止通过: 互锁大于 100 D6 禁止通过 (3)号读卡器刷卡禁止通过: 互锁大于 100 D7 禁止通过 (4)号读卡器刷卡禁止通过: 互锁大于 100 E0 禁止通过 (1)号读卡器刷卡禁止通过: 卡过期或不在有效时段大于 100 E1 禁止通过 (2)号读卡器刷卡禁止通过: 卡过期或不在有效时段大于 100 E2 禁止通过 (3)号读卡器刷卡禁止通过: 卡过期或不在有效时段大于 100 E3 禁止通过 (4)号读卡器刷卡禁止通过: 卡过期或不在有效时段7(完整卡号小于 100 表示特殊操作记录 )完整卡号记录状态(16 进制 ) 正常操作 代表意义0 00 按钮 1 号门按钮

16、动作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

17、号门打开门磁信号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 非法闯入报

18、警 2 号门非法闯入报警2 84 非法闯入报警 3 号门非法闯入报警3 84 非法闯入报警 4 号门非法闯入报警4 A0 火警 火警动作针对整个控制器6 A0 强制 强制锁门针对整个控制器89.2.2.3 权限信息每个权限占 16 个字节预设 3 万个权限格式：ID 号（ 2）+区号（1）+门号（1）+卡起始年月日（2）+卡截止年月日（2）+ 控制时段索引号（1）+密码（3）+备用 1+备用 2+备用 3+备用 4说明： 权限发送时，必须先发号门（门号相同的，先发卡号小的，再发卡号大的） ，再发号门门号：从 01 开始，最大为 04；卡起始年月日：按短时间格式中的年月日进行定义，默认用21 0

19、0 =2000 年 01 月 01 日填入。卡截止年月日：按短时间格式中的年月日进行定义，默认用9F 29 2020 年 12 月 31 日控制时段索引号： 00禁止；01表示在有效期内，任意时间有效；密码用 3 个字节：默认为 123456 等于十六进制的 40E201 备用 1: =1 表示此权限是首卡用户, =0 表示不是首卡用户 (适用于首卡开门)备用 2: =0 表示普通用户组 ; 0 表示此权限所属的特殊群组 (适用于多卡开门用户)9.2.2.4 控制时段分为 256 个组，每组占 24 个字节每组格式如下： 星期控制（1 字节, 缺省值为 7F）+ 下一个链接时段( 缺省为 0)

20、 + 保留（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 修改值无效） 。2255 用户可自行修改*星期控制: (1-星期有效;0- 当前星期无效)Bit 位 7 6 5 4 3 2 1

21、0说明 0-表示受到时段控制1-表示任意时间有效,即不受时段控制; 日 六 五 四 三 二 一如果七天都有效，则为 7F,如果只有星期一到星期五有效, 则为 1F*“保留”字节缺省值等于 09控制时段的功能：用于核实刷卡是否处于有效时间内进行。必须先满足起始日期和截止日期控制, 再满足星期控制（当日有效） ，再核时分秒控制；必须完全满足 3 个控制（日期控制, 星期控制，3 个时分秒控制中的任意一个）才可通过。下一个链接时段用于并列时段, 如果此时段号不为 FF 或 0, 则引入相应号的时段来对刷卡操作作相应权限检查. 当此时段不允许通过时, 可以再查并列时段.起始日期(年月日)：按短时间格式

22、中的年月日进行定义，默认用 21 00= 2000 年 01 月 01 日终止日期(年月日)：按短时间格式中的年月日进行定义，默认用 9F 29= 2020 年 12 月 31 日9.2.2.5 首卡开门1. 首卡开门的实现通过定时任务来完成2. 在设置权限时, 要对拥有首卡权限的用户进行设置, 请参考:权限信息(备用 1 的值=1)3. 首卡使用的状态:0x00 刷首卡后作按正常处理0x11 刷首卡后,门切换到常开; 0x12 刷首卡后,门切换到常闭, 0x13 刷首卡后,门切换到在线; 0x14 只许首卡才能开门, 刷首卡后,不切换例如: 对于 1 号门早上 8:00 允许首卡刷卡后, 其

23、他人才能刷卡开门 ;下午 18:30 之后, 只有首卡才能开门, 刷首卡后,不切换操作:先发送 2 条指令： F410360001 启用定时任务指令F3100001 指令再发送： F510000100000600407F9B1300 第一个任务 0040 表示 8 点， 7F-星期全部， 9B13 一号门刷首卡后,门切换到在线. 9B 表示一号门, 如果 2 号门则是 9C, 3 号门是 9D, 4 号门是 9EF510000106000600987F9B1400 第二个任务 0098 表示 18:30， 7F-星期全部，9B14 一号门只能首卡刷卡才能开门9.2.2.6 多卡开门(含多群组)

24、对总的要求数(不分所属的群组 ):地址位 说明 默认值 默认值说明0xB8 1 号读卡器同时要到人数 00 00=无多卡要求; 大于 0 表示要求到的人数0xB9 2 号读卡器同时要到人数 00 00=无多卡要求; 大于 0 表示要求到的人数0xBA 3 号读卡器同时要到人数 00 00=无多卡要求; 大于 0 表示要求到的人数0xBB 4 号读卡器同时要到人数 00 00=无多卡要求; 大于 0 表示要求到的人数10对群的设置地址位 1 号读卡器同时要到人数地址位 2 号读卡器同时要到人数地址位 3 号读卡器同时要到人数地址位 4 号读卡器同时要到人数0xBC 群 1 0xC4 群 1 0x

25、CC 群 1 0xD4 群 10xBD 群 2 0xC5 群 2 0xCD 群 2 0xD5 群 20xBE 群 3 0xC6 群 3 0xCE 群 3 0xD6 群 30xBF 群 4 0xC7 群 4 0xCF 群 4 0xD7 群 40xC0 群 5 0xC8 群 5 0xD0 群 5 0xD8 群 50xC1 群 6 0xC9 群 6 0xD1 群 6 0xD9 群 60xC2 群 7 0xCA 群 7 0xD2 群 7 0xDA 群 70xC3 群 8 0xCB 群 8 0xD3 群 8 0xDB 群 8缺省情况下: 各个群要到的人数 =0, 也就是只要是合法用户刷卡就可以开门.通过

26、”参数修改指令” 设置各个群要求到的人数.说明：举例:要求 1 号读卡器同时要 3 个人刷卡, 其中必须有 1 人是主任.则可将主任设为 1 号读卡器的群 1 成员, 在设置权限时, 主任的权限备用 2 的值=1 请参考权限信息发送指令F410B80003 3 个人同时刷卡F410BC0001 1 号读卡器的 1 号群必须要有 1 人到场9.2.2.7 扩展板设置通过”参数修改指令” 设置地址位的值地址位 说明 默认值(需要设置的值) 默认值说明0x98 1 号扩展口的报警源或者联动源 1 默认报警源 1 号门0x99 1 号扩展口的控制位 00x9A 1 号扩展口的事件类型 1 0x27 默认为胁迫/门开未关闭/非法闯入/火警0x9B 1 号扩展口的事件类型 2 00x9C 1 号扩展口的动作延时 低位 0x64 动作延时 10 秒0x9D 1 号扩展口的动作延时 高位 0x9C 和 0x9D 组成一个双字节数. 单位是 0.1 秒.0x000x9E 2 号扩展口的报警源或者联动源 2 默认报警源 2 号门0x9F 2 号扩展口的控制位 0 硬件驱动 V16 才支持0xA0 2 号扩展口的事件类型 1 0x27 默认为胁迫/门开未关闭/