252通信协议(脱机联机)

通信协议是一个以太网通信的门禁控制器，它是基于UDP通信的。为了保证数据传输的可靠性 每一条命令发出都会有返回，用于检测读卡器是否收到命令。读卡器可以存储40000张卡号 ，4000条黑名单，65535条记录。PC机操作命令格式命令头命令类型命令参数命令头：两个字节的AA FF或BB FF（详见命令）命令类型：一个字节，每条命令有唯一的命令类型（详见命令）命令参数：长度和内容跟具体的命令有关（详见命令） 数据格式: 命令中的数据格式如无特殊说明一律为16进制 删除卡号库命令命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型：0x11命令总长度：3命令说明此命令用于删除WM-251的卡号库，删除完成后所有卡号将丢失。此命令的执行时间大约为3秒，期间不能发送其他命令，此命令操作结束后读卡器有返回。返回命令成功返回BB FF 11 FF 例：发送：AA FF 11返回：BB FF 11 FF 卡号库删除成功下载卡号库命令命令格式命令头命令类型卡号数据长度214命令头：固定为2个字节的AA FF命令类型：0x12卡号：要下载的4字节卡号 命令总长度：7命令说明此命令用于将一个4字节的卡号下载到WM-251的卡号库中，卡号格式自左至右，从高到低，此命令读卡器有返回。返回命令成功返回BB FF 12 FF卡号库已满返回BB FF 12 F0 例：卡号为01020304发送：AA FF 12 01 02 03 04返回1：BB FF 12 FF 卡号添加成功返回2：BB FF 12 F0卡号库已满添加失败删除黑名单库命令命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型：0x13命令总长度：3命令说明此命令用于删除WM-251的黑名单库，删除完成后所有卡号将丢失。此命令的执行时间大约为1秒，期间不能发送其他命令，此命令操作结束后读卡器有返回。返回命令成功返回BB FF 13 FF 例：发送：AA FF 13等待返回返回：BB FF 13 FF 黑名单库删除成功下载黑名单库命令命令格式命令头命令类型卡号数据长度214命令头：固定为2个字节的AA FF命令类型：0x14卡号：要下载的4字节卡号 命令总长度：7命令说明此命令用于将一个4字节的卡号下载到WM-251的黑名单库中，卡号格式自左至右，从高到低。此命令读卡器有返回。 返回命令成功返回BB FF 14 FF黑名单库已满返回BB FF 14 F0 例：卡号为01020304发送：AA FF 14 01 02 03 04返回1：BB FF 14 FF黑名单下载成功返回2：BB FF 14 F0黑名单库已满添加失败删除记录库命令命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型：0x15命令总长度：3命令说明此命令用于删除WM-251的记录库，删除完成后所有记录将丢失. 此命令的执行时间大约为16秒，期间不能发送其他命令，此命令操作结束后读卡器有返回。返回命令成功返回BB FF 15 FF例：发送：AA FF 15等待返回返回：BB FF 15 FF 记录库删除成功查询记录条数命令命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型：0x16命令总长度：3命令说明此命令用于查询WM-251的记录条数，然后可以根据该条数来读取记录，此命令读卡器有返回。返回命令成功返回BB FF 16 2字节数据例：记录库中现存有16条记录发送：AA FF 16返回：BB FF 16 00 10 读取记录命令命令格式命令头命令类型记录位置数据长度212命令头：固定为2个字节的AA FF命令类型：0x17记录位置：要读取的2字节记录位置 命令总长度：5 命令说明此命令用于读取WM-251记录库中指定位置的记录，记录位置格式自左至右，从高到低，此命令读卡器有返回。 返回命令没有记录返回BB FF 17 F0读取成功返回BB FF 17 FF 记录数据（见下表） 记录数据格式刷卡头卡片类型卡号刷卡时间1146例：读取第1条记录，第1条记录为卡号为81 05 46 38的有效卡在09-10-12 13:22:52在刷卡头2上的刷卡记录发送：AA FF 17 00 01返回1：BB FF 17 FF 02 01 81 05 46 38 09 0A 0C 0D 16 34成功读取记录返回2：BB FF 17 F0当前位置没有记录设置时钟命令命令格式命令头命令类型时钟参数数据长度216命令头：固定为2个字节的AA FF命令类型：0x18时钟参数：自左至右依次是年，月，日，时，分，秒 命令总长度：9 命令说明此命令用于配置WM-251的时钟 ，此命令读卡器有返回。返回命令配置成功返回BB FF 18 FF例：要设置读卡器的时钟为 09-10-12 13:22:52则发送：AA FF 18 09 0A 0C 0D 16 34返回：BB FF 18 FF时钟配置成功远程开门命令命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型：0x20命令总长度：3命令说明此命令用于远程打开WM-251的门锁，此命令读卡器有返回。返回命令成功返回BB FF 20 FF忙碌返回BB FF 20 F0例：发送：AA FF 20返回1：BB FF 20 FF 操作成功返回2：BB FF 20 F0忙碌，操作失败，稍候请重新发送此命令。获取门磁状态命令命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型：0x21命令总长度：3命令说明此命令用于获取WM-251的门磁状态，实际使用中门磁的状态可能与命令所描述的相反。此命令读卡器有返回返回命令开启返回BB FF 21 FF关闭返回BB FF 21 F0例：发送：AA FF 21返回1：BB FF 21 FF 门磁开启返回2：BB FF 21 F0门磁关闭液晶显示命令命令格式命令头命令类型数据异或检验数据长度21321命令头：固定为2个字节的AA FF命令类型： 0X19数据：32个字节，每个汉字对应的内码异或检验：前35个字节的异或结果命令总长度：36命令说明此命令用于液晶屏信息的显示,空白处用0X20填充,每个汉字对应两个字节,数据为内码，此命令读卡器有返回。返回命令成功返回BB FF 19 FF失败返回BB FF 19 F0例：发送：AA FF 19 A2 B1 A2 B2 A2 B3 A2 B4 A2 B5 A2 B6 A2 B7 A2 B8 A2 B9 A2 BA A2 BB A2 BC A2 BD A2 BE A2 BF A2 C0 3C返回1：BB FF 19 FF 数据接收成功显示结果：第一行行二行返回2：BB FF 19 F0 数据接收失败联机命令命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型： 0X30命令总长度：3命令说明此命令用于将读卡器设为联机状态，刷卡号号数据上传，脱机状态卡号数据记录，比较库中卡号判断卡片类型，此命令读卡器有返回。返回命令成功返回BB FF 30 FF例：PC主动发送联机命令PC机发送：AA FF 30读卡器返回：BB FF 30 FF读取时钟命令命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型： 0X22命令总长度：3命令说明此命令用于读取读卡器当前时间，此命令读卡器有数据返回。返回命令返回BB FF 22 年月日时分秒例：读取读卡器当前时间 发送：AA FF 22返回：bb ff 22 0A 06 1E 09 00 3A当前时间为10/06/3009：00：58控制发光管命令格式命令头命令类型LED延时数据长度211命令头：固定为2个字节的AA FF命令类型： 0X23命令总长度：4时间单位为100ms命令说明PC机控制发光管延时时间，此命令读卡器有数据返回。返回命令成功返回BB FF 23 FF例：控制发光管点亮0.5秒发送：AA FF 23 05 控制发光管，蜂鸣器，继电器命令格式命令头命令类型LED延时蜂鸣次数蜂鸣时间蜂鸣间隔继电器吸合数据长度2111111命令头：固定为2个字节的AA FF命令类型： 同为0X23命令总长度：8时间单位为100ms命令说明PC机控制发光管延时蜂鸣器继电器，此命令读卡器有数据返回。成功返回BB FF 23 FF控制蜂鸣器命令格式命令头命令类型蜂鸣器次数蜂鸣器时间蜂鸣器间隔数据长度21111命令头：固定为2个字节的AA FF命令类型： 0X24命令总长度：6时间单位为100ms命令说明PC机控制蜂鸣器次数，时间，间隔，此命令读卡器有返回命令。返回命令成功返回BB FF 24 FF例：控制蜂鸣器响2声，100MS,间隔100MS发送：AA FF 24 020101 返回：BB FF 24FF 失败返回：忙碌，稍候请重新发送此命令。控制继电器命令格式命令头命令类型继电器吸合时间数据长度211命令头：固定为2个字节的AA FF命令类型： 0X25命令总长度：4时间单位为100ms命令说明PC机控制继电器吸合，此命令读卡器有返回命令。返回命令成功返回BB FF 25 FF例：控制继电器吸合1秒发送：AA FF 25 0A 返回：BB FF 25FF 失败返回：忙碌，稍候请重新发送此命令。读卡器进入脱机状态命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型： 0X26命令总长度：3命令说明使读卡器主动进入脱机状态，此命令读卡器有返回。 返回命令返回BB FF 26 FF例： 发送：AA FF 26 返回：BB FF 26FF 读卡器进入脱机状态。读卡器进入联机状态命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型： 0X30命令总长度：3命令说明使读卡器主动进入联机状态，此命令读卡器有返回。返回命令返回BB FF 30 FF例： 发送：AA FF 30 返回：BB FF 30FF读卡器进入联机状态。黑名单检查命令格式命令头命令类型卡号数据长度214命令头：固定为2个字节的AA FF命令类型： 0X28卡号：要检查的卡号命令总长度：7命令说明检查所发送卡号是否在黑名单中，读卡器返回检查结果。返回命令存在返回BB FF 28 FF不存在返回BB FF 28 F0例： 检查卡号01020304是否在黑名单发送：AA FF 28 01020304存在返回：BB FF 28FF不存在返回：BB FF 28F0白名单检查命令格式命令头命令类型卡号数据长度214命令头：固定为2个字节的AA FF命令类型： 0X29卡号：要检查的卡号命令总长度：7命令说明检查所发送卡号是否在白名单中，读卡器返回检查结果。返回命令存在返回BB FF 29 FF不存在返回BB FF 29 F0例： 检查卡号01020304是否在白名单发送：AA FF 29 01020304存在返回：BB FF 29FF不存在返回：BB FF 29F0读取刷卡次数命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型： 0X31命令总长度：3命令说明读取上电后刷卡次数，断电清0，可用AA FF 32命令清零，此命令读卡器有返回。返回命令返回BB FF 31 2字节数据例：刷卡10次发送：AA FF 31返回：BB FF 31000A刷卡次数记录清零命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型： 0X32命令总长度：3命令说明将刷卡记数器清0，此命令读卡器有返回。返回命令返回BB FF 32 FF例：发送：AA FF 32返回：BB FF 32FF延时时间设定命令格式命令头命令类型延时时间数据长度211命令头：固定为2个字节的AA FF命令类型： 0X33延时时间：1-255命令总长度：4命令说明设定联机查询命令发送时间间隔。返回命令返回成功BB FF 33 FF返回失败BB FF 33 F0联机状态查询是否开启命令格式命令头命令类型状态数据长度211命令头：固定为2个字节的AA FF命令类型： 0X34状态：0X00联机状态查询关闭0XFF联机状态查询打开命令总长度：4命令说明设定联机查询命令是否发送（BB FF 55 AA）。返回命令返回成功BB FF 34 FF返回失败BB FF 34 F0读卡器继电器常开常闭设置命令格式命令头命令类型命令有效位吸合状态数据长度2111命令头：固定为2个字节的AA FF命令类型： 0X35命令有效位：0X00常开常闭无效， 0XFF常开常闭有效状态：0X00不吸合，0XFF吸合状态命令总长度：5命令说明设定读卡器继电器是否保持一状态不变。返回命令返回成功BB FF 35 FF返回失败BB FF 35 F0读卡器联机查询是否开启命令格式命令头命令类型状态数据长度211命令头：固定为2个字节的AA FF命令类型： 0X36状态：0X00为关闭，0XFF为开启命令总长度：4命令说明设定读卡器读到卡是否检测白名单（只能在脱机状态下使用）。返回命令返回成功BB FF 36 FF返回失败BB FF 36 F0说明：刷卡LCD显示为卡号，不在显示卡片类型。上传卡号接收确认命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型： 0X01命令总长度：3命令说明联机状态卡号上传，PC端对读卡器的返回命令，确认卡号接收成功。例：读卡器上传卡号：BB FF 01 01 02 03 04PC发送：AA FF 01门磁状态接收确认命令格式命令头命令类型数据长度21命令头：固定为2个字节的AA FF命令类型： 0X04命令总长度：3命令说明联机状态门磁状态上传，PC端对读卡器的返回命令，确认门磁状态接收成功。例：读卡器上传门磁状态：BB FF 04 FFPC发送：AA FF 04读卡器主动发送命令查询是否联机命令命令格式命令头命令数据长度22命令头：固定为2个字节的BB FF命令类型：固定为55AA命令总长度：4命令说明此命令主动发往PC机，PC机接到命令后发送AA FF 30,读卡器接收到AA FF 30后设读卡器为联机状态，此后5秒当有卡片读取时直接送往PC机指定端口，读卡器不保留记录若一秒钟内没有接到PC数据AA FF 30读卡器进入脱机状态此命令每5秒钟发送一次，成功接收到AA FF 30后5秒钟后再次发送，1秒内没有接收到有效数据进入脱机状态，液晶屏右下角出现一实心五角星此命令改为30秒发送一次例：读卡器发送：BB FF 55 AAPC机发送：AA FF 30读卡器发送：BB FF 30 FF完成以上三步后读卡器5秒内为联机状态PC机发送数据到读卡器也可使读卡器转为联机状态卡号上传命令格式命令头刷卡头卡号异或检验数据长度2141命令头：固定为2个字节的BB FF读卡器编号：0X01或0X02卡号：四字节卡号异或检验：前面字节的异或结果命令总长度：8PC机电脑接收确认AA FF 01接收不到电脑确认信号卡号重发，三次无返回保存记录，重发时间为联机状态查询时间的三分