软件协议文档
终端设备协议文档
功能&协议池(所有功能协议)
MQTT协议文档
HTTP协议文档
微光TLV协议文档
微光卡&码协议
功能模块&UI文档
人脸机
VF105
门禁标品MQTT协议文档(DejaOS版本)
Access control standard MQTT protocol document
VF系列HTTP协议接口文档V1.0.28(Vbar版本)
VF系列MQTT协议文档V1.37.0(Vbar版本)
VF系列-协议模式下通讯协议文档V1.0.4(Vbar版本)
VF203
门禁标品MQTT协议文档(DejaOS版本)
Access control standard MQTT protocol document
VF系列HTTP协议接口文档V1.0.28(Vbar版本)
VF系列-协议模式下通讯协议文档V1.0.4(Vbar版本)
VF系列-MQTT协议文档V1.37.2(Vbar版本)
VF 系列 HTTP 协议接口文档-V1.37.1(Vbar版本)
VF106
门禁标品MQTT协议文档(Android版本)
Access control standard MQTT protocol document
VF114
门禁标品MQTT协议文档(DejaOS版本)
Access control standard MQTT protocol document
VF系列HTTP协议接口文档V1.0.28(Vbar版本)
VF系列-协议模式下通讯协议文档V1.0.4(Vbar版本)
VF205
门禁标品MQTT协议文档(DejaOS版本)
VF系列HTTP协议接口文档V1.0.28(Vbar版本)
VF系列-协议模式下通讯协议文档V1.0.4(Vbar版本)
读头
EE200
读头标品TLV通讯协议
Read header standard TLV communication protocol
读头标品TLV通讯协议V3.10(Vbar版本)
TX200
读头标品TLV通讯协议
Read header standard TLV communication protocol
QT960
读头标品TLV通讯协议
Read header standard TLV communication protocol
QT660
读头标品TLV通讯协议
Read header standard TLV communication protocol
Q340
读头标品TLV通讯协议
Read header standard TLV communication protocol
M300
读头标品TLV通讯协议
Read header standard TLV communication protocol
读头标品TLV通讯协议V3.10(Vbar版本)
JL7000
读头标品TLV通讯协议
Read header standard TLV communication protocol
Q350
读头标品TLV通讯协议
Read header standard TLV communication protocol
MU86
读头标品TLV通讯协议
Read header standard TLV communication protocol
读头标品TLV通讯协议V3.10(Vbar版本)
MET
读头标品TLV通讯协议
Read header standard TLV communication protocol
扫码器TCP/HTT通讯协议V1.0(Vbar版本)
读头标品TLV通讯协议V3.10(Vbar版本)
M350
读头标品TLV通讯协议
Read header standard TLV communication protocol
读头标品TLV通讯协议V3.10(Vbar版本)
扫码器TCP/HTT通讯协议V1.0(Vbar版本)
DW200
读头标品TLV通讯协议(DejaOS版本)
Read header standard TLV communication protocol
读头标品HTTP&TCP协议文档(DejaOS版本)
读头标品HTTP&TCP协议文档(Vbar版本)
读头标品TLV通讯协议V3.10(Vbar版)
读头标品RS485一拖多协议V0.7(Vbar版本)
M340
读头标品TLV通讯协议
Read header standard TLV communication protocol
CR90
刷卡模块通信协议v3.0
CR90指令文档
微光指令:0x60 蓝牙设备控制
1.7/2.x扫码器配置字段说明文档
门禁
DW200
门禁标品MQTT协议文档(DejaOS版本)
Access control standard MQTT protocol document
门禁扫码器MQTT协议文档(Vbar版本)
MU86
门禁标品MQTT协议文档
Access control standard MQTT protocol document
门禁20180820 MQTT协议文档V1.0.2(Vbar版)
Q350
门禁标品MQTT协议文档
Access control standard MQTT protocol document
门禁20180820 MQTT协议文档V1.0.2(Vbar版)
MET
门禁标品MQTT协议文档
Access control standard MQTT protocol document
门禁20180820 MQTT协议文档V1.0.2(Vbar版)
M350
门禁标品MQTT协议文档
Access control standard MQTT protocol document
门禁20180820 MQTT协议V1.0.1(Vbar版本)
门禁20180820 MQTT协议文档V1.0.2(Vbar版本)
MP86
门禁20180820 MQTT协议文档V1.0.2(Vbar版本)
控制板
CC104
控制板标品MQTT协议文档
Control board standard MQTT protocol documentation
CC101
控制板标品MQTT协议文档
Control board standard MQTT protocol documentation
CC101标品20211101MQTT协议V3.6(Vbar版本)
平台服务协议文档
网关服务接口定义
门禁应用接口定义
工具文档
多弦产品API签名安全规则
海外锁
app和后台的mqtt协议
文档
-
+
首页
门禁标品MQTT协议文档
# 云设备接口文档 ## 文件版本变更记录表 | 版本号 | 变更内容 | 审核人 | 批准人 | 备注 | |--------|----------|--------|--------|------| | V_3.0 | 新增 | | | | | V_3.1 | 1. 秘钥增加开始时间<br>2. 查询设备增加下位机扫码器版本号<br>3. 设置设备状态增加DeviceStatus字段,devGroup 和 DeviceId 改为数字类型 | | | | | V_3.2 | 1. 查询\设置设备状态增加设置设备名称 | | | | | V_3.3 | 1. 通行记录增加子设备ID,DeviceId | | | | | V_3.4 | | | | | ## 免责声明 使用设备前请务必认真阅读云设备接口文档中的所有内容,以保障正确安全有效的使用。 本手册的一切解释权与修改权归北京微光互联科技有限公司。 ## 目录 1. [概述](#1-概述) - [应用场景](#11-应用场景) - [特点](#12-特点) 2. [接口文档](#2-接口文档) - [说明](#21-说明) - [接口列表](#22-接口列表) - [心跳接口](#221-心跳接口) - [报警接口](#222-报警接口) - [写标签](#223-写标签) - [读标签](#224-读标签) - [同步秘钥](#225-同步秘钥) - [同步白名单(100条)](#226-同步白名单100条) - [查询白名单](#227-查询白名单) - [上报通行记录](#228-上报通行记录) - [在线验证](#229-在线验证) - [控制设备](#2210-控制设备) - [查询设备状态](#2211-查询设备状态) - [设置设备状态](#2212-设置设备状态) - [同步时钟](#2213-同步时钟) - [更新固件](#2214-更新固件) - [查询设备日志](#2215-查询设备日志) ## 1. 概述 接口概述:本文档提供一套直接访问设备的接口,用于推送获取设备信息,使用者购买设备后,就可以直接根据接口说明进行自定义开发整套门禁或相关应用系统。接口使用MQTT通信协议,可以对接各种通用的MQTT代理,也可使用我们推荐的MQTT代理。 ### 1.1 应用场景 应用场景:当需要对接自己的业务系统时,可以通过使用接口通过MQTT协议直接与设备通讯。 ### 1.2 特点 接口简单,功能全面,适应绝大部分门禁的应用情景。 ## 2. 接口文档 ### 2.1 说明 接口使用MQTT协议,分为上行与下行: 上行:是指设备上发消息给后台或应用。 下行:是指后台或应用下发消息给设备。 通信中间通过MQTT代理,消息包含消息topic与消息内容,格式如下: 1. 消息topic 消息标题,不管是上行还是下行,发送指令和返回指令的规则是”指令”和”指令_reply”。格式如下: - 下行:`20211101/cmd/{#DeviceAddr}/xxxx` 对应的返回指令(上行):`20211101/cmd/xxxx_reply` - 上行:`20211101/event/yyyy` 对应的返回指令(下行):`20211101/event/{#DeviceAddr}/yyyy_reply` 注:`20211101`是接口版本的特定标识,`cmd`表示由后台或应用主动给设备发送指令,`event`表示设备主动给后台或应用发送消息或触发事件。 2. 消息内容 文本格式的消息内容,内容为Json格式 - 发送消息 发送指令的格式固定,都包含`SerianNo`、`DeviceAddr`、`Data`,如: ```json { "SerialNo" : "6w8keif5g6", //消息序列号,10位字符串,包含的小写字母和数字,必需的, "DeviceAddr" : "xxxxxxxx", //设备地址,设备的唯一地址用于通讯时保证设备是有效的设备 "Data" : //不同的指令对应的Data内容不一样,可以是任何类型,不是必填 } ``` - 返回消息 返回消息格式固定都包含`SerianNo`、`DeviceAddr`、`Result`、`Message`、`Data`,如: ```json { "SerialNo" : "6w8keif5g6", //消息序列号,10位字符串,包含的小写字母和数字,必需的,用于通讯时确保同步 "DeviceAddr" : "xxxxxxxx", //设备地址,设备的唯一地址用于通讯时保证设备是有效的设备 "Result" : 0, //0表示成功,非0表示失败 "Message" : "出错的原因信息或成功的提示信息", //不是必填 "Data" : //不同的指令对应的Data内容不一样,可以是任何类型,不是必填 } ``` ### 2.2 接口列表 #### 2.2.1 心跳接口 - 设备到后台或应用 消息topic: `20211101/event/heartbeat` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "DeviceStatus" : 1, //0-未激活,1-正常,2-禁用 "DeviceTime" : 1596277728 //设备时间,时间戳(秒) } } ``` - 后台或应用回馈到设备 消息topic: `20211101/event/{#DeviceAddr}/heartbeat_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.2 报警接口 - 设备到后台或应用 消息topic: `20211101/event/alarm` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "AlarmType" : 1, //报警类型,1:异常开门报警。2:火警,3:开门超时 "DeviceTime" : 1596277728 //设备时间,时间戳(秒) } } ``` - 后台或应用回馈到设备 消息topic: `20211101/event/{#DeviceAddr}/alarm_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.3 写标签 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/tagwrite` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "tag0" :"标签1的值", "tag1" :"标签2的值", "tag2" :"标签3的值", "tag3" :"标签4的值", "tag4" :"标签5的值", "tag5" :"标签6的值", "tag6" :"标签7的值", "tag7" :"标签8的值", "tag8" :"标签9的值", "tag9" :"标签10的值" } } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/tagwrite_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.4 读标签 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/tagread` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx" //设备地址 } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/tagread_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "", //原因(可选) "Data": { "tag0" :"标签1的值", "tag1" :"标签2的值", "tag2" :"标签3的值", "tag3" :"标签4的值", "tag4" :"标签5的值", "tag5" :"标签6的值", "tag6" :"标签7的值", "tag7" :"标签8的值", "tag8" :"标签9的值", "tag9" :"标签10的值" } } ``` #### 2.2.5 同步秘钥 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/secretsync` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "SyncFlag" : 1, //同步标识,1-全量,2-增量 "SecretKeys" :[ //密钥数组 { "SecretKeyType" : "xxxx", //密钥类型,如RSA, AES等 "SecretKeyCode" : "xxxx", //密钥编码,对应密钥编码,如vguang "SecretKeyValue" : "xxxx", //密钥值 "SecretKeyStartTime" : 1566277728, //密钥开始时间,时间戳(秒) "SecretKeyExpirytime" : 1596277728, //密钥过期时间,时间戳(秒) "SyncType" : 1 //同步类型,当SyncFlag=2时有效,1-增加,2-修改,3-删除 }, ... ] } } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/secretsync_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.6 同步白名单(100条) - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/whitelistsync` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "SyncFlag" : 1, //同步标识,1-全量,2-增量 "WhiteLists" :[ //白名单数组 { "IdentityType" : 101, //身份类型 "IdentityCode" : "xxxxxxxx", //身份标识 "OrgId" : 100, //组织编号,删除白名单时校验 "BeginTime" : 1596277728, //开始时间,时间戳(秒) "EndTime" : 1596277728, //结束时间,时间戳(秒) "Times" : 0, //次数(数字),0-不限,>0,限制次数 "SyncType" : 1 //同步类型,当SyncFlag=2时有效,1-增加,2-修改,3-删除 }, ... ] } } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/whitelistsync_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` 注:身份类型,101-普通二维码,102-微光门禁动态码1, 以&mj开头,103-微光门禁动态码2, 以vg://v103开头,104-微光门禁动态码3, 以vg://v104开头,201-Mifare_UltraLight卡,202-Mifare_One(S50) 卡,203-Mifare_One(S70) 卡,204-Mifare_Pro(X) 卡,205-Mifare_DESFire卡,206-身份证,238-其他卡,505-应急码,以&em开头的二维码。客户可根据自己情况选择101、102、103,或定制专用码制(定制码类型4XX)。 Message:失败原因 0:成功 -1:JSON字符串错误 -2:磁盘空间不足 -3:数据库开启事务失败 -4:清空数据库失败 -5:保存失败 -6:修改失败 -7:删除失败 -8:写入数据库出错 #### 2.2.7 查询白名单 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/whitelistquery` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "IdentityType" : 101, //身份类型,可选,如果有则只查询此类 "IdentityCode" : "xxxxxxxx", //身份标识,可选,如果有则只查询此身份标识对应的 "OrgId" : 100, //组织编号,可选,如果有则只查询此类 "BeginTime" : 1596277728, //开始时间,时间戳(秒),可选,如果有则只查询此时间后的 "EndTime" : 1596277728, //结束时间,时间戳(秒),可选,如果有则只查询此时间前的 "PageSize" : 50, //查询每页记录条数(最大100) "CurrentPage" : 1 //查询当前页数,从第0页开始 } } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/whitelistquery_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "", //原因(可选) "Data": { "PageSize" : 50, //查询结果每页记录条数 "CurrentPage" : 50, //查询结果当前页数 "PageCount" : 3, //查询结果总页数 "Total" : 150, //查询结果记录总条数 "WhiteLists" :[ { //白名单数组 "IdentityType" : 101, //身份类型,505:应急码 "IdentityCode" : "xxxxxxxx", //身份标识 "OrgId" : 100, //组织编号 "BeginTime" : 1596277728, //开始时间,时间戳(秒) "EndTime" : 1596277728, //结束时间,时间戳(秒) "Times" : 0 //次数(数字),0-不限,>0,限制次数 }, ... ] } } ``` #### 2.2.8 上报通行记录 - 设备到后台或应用 消息topic: `20211101/event/reportrecord` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": [ { "IdentityType" : 101, //身份类型 "IdentityCode" : "xxxxxxxx", //身份标识 "OriginalCode" : "xxxxxxxx", //原始数据 "PassTime" : 1596277728, //通行时间,时间戳(秒) "DeviceId" : "001-A", //设备标识 "Result" : 0, //通行验证结果,=0-成功 <0失败 "Message": "xxx" //1表示常开状态,2表示常闭状态,扫描没通过 }, ... ] } ``` - 后台或应用回馈到设备 消息topic: `20211101/event/{#DeviceAddr}/reportrecord_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.9 在线验证 - 设备到后台或应用 消息topic: `20211101/event/onlinecheck` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "IdentityType" : 101, //身份类型 "IdentityCode" : "xxxxxxxx", //身份标识 "OriginalCode" : "xxxxxxxx", //原始数据 "PassTime" : 1596277728 //通行时间,时间戳(秒) } } ``` - 后台或应用回馈到设备 消息topic: `20211101/event/{#DeviceAddr}/onlinecheck_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.10 控制设备 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/controldevice` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "HintType" : 1 //控制类型,1-开门, 100-重启 } } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/controldevice_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.11 查询设备状态 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/getstatus` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx" //设备地址 } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/getstatus_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "", //原因(可选) "Data": { "DeviceName" :"001-A", //设备名称 "DeviceMode" : "xxxxxxxx", //设备型号 "Scanner1Ver" : "xxxxxxxx", //设备型号 "Scanner2Ver" : "xxxxxxxx", //设备型号 "DeviceNetType" : 1, //设备网络类型,1-WIFI "DeviceVer" : "xxxxxxxx", //设备版本 "OpenMode" :0, //设备开门模式,0-正常,1-常开模式,2-常闭模式 "OpenTime" : 5, //开门时长,单位秒 "HeartbeatInterval" : 60, //心跳间隔,小于等于0,表示关闭心跳 "TimeSyncInterval" : 43200, //主动时钟更新间隔时间,单位秒,缺省43200秒(12小时),如果小于等于0,表示不主动更新 "DeviceStatus" : 1, //0-未激活,1-正常,2-禁用 "DeviceTime" : 1596277728, //设备时间,时间戳(秒) "DeviceSpace" : 1000000 ,//设备剩余空间(单位字节) "DeviceWhitelistCount" : 5000 ,//白名单总数量 "DevicePassRecordCount" : 5000 ,//未上传通行记录总数 "ScanInterval" : 1000, //扫码间隔单位毫秒(ms) "RecordUploadStrategy" : 0, //0:通行优先, 1:上传优先 "CheckMode" : 0, //0:只离线验证,1:先离线验证失败后走在线验证 "FaultTolerantTimeInterval" : 5, //容错时间间隔小时(h)为0时表示禁用动态调整,如每隔5h时间容错增加1秒 "MaxFaultTolerantTime" :60, //最大容错时间秒(s),如当容错时间达到60s时停止增加 "AnalogCard" :1, //1:屏蔽手机模拟卡, 0:不屏蔽手机模拟卡 "DevGroup" : 123, //设备分组用于应急码组校验 "DeviceId" :123, //设备ID用于应急码设备ID校验 "EmKey" : "078571e7c65de78e818ff3083a4814e2", //应急码秘钥 "MotorKeepTime" :0, //持续工作时间(毫秒) "BlockNum" :0, //读取的块 "BlockKey" :"", //扇区秘钥 "BlockKeyType" : 96 //扇区秘钥类型 } } ``` #### 2.2.12 设置设备状态 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/setstatus` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "DeviceName" :"001-A", //设备名称 "DeviceStatus" : 1, //0-未激活,1-正常,2-禁用 "OpenMode" :0, //设备开门模式,0-正常,1-常开模式,2-常闭模式,3-任意码(卡)开门 "OpenTime" : 1000, //开门时长,单位毫秒 "OpenTimeout" : 30, //开门超时时长,单位秒 "HeartbeatInterval" : 60, //心跳间隔,小于等于0,表示关闭心跳 "TimeSyncInterval" : 43200, //主动时钟更新间隔时间,单位秒,缺省43200秒(12小时),如果小于等于0,表示不主动更新 "ScanInterval" : 1000, //扫码间隔单位毫秒(ms) "RecordUploadStrategy" : 0, //0:通行优先, 1:上传优先 "CheckMode" : 0, //0:只离线验证1:先离线验证失败后走在线验证 "FaultTolerantTimeInterval" : 5, //容错时间间隔小时(h)为0时表示禁用动态调整,如每隔5h时间容错增加1秒 "MaxFaultTolerantTime" :60, //最大容错时间秒(s),如当容错时间达到60s时停止增加 "AnalogCard" :1, //1:屏蔽手机模拟卡, 0:不屏蔽手机模拟卡 "DevGroup" : 123, //设备分组用于应急码组校验 "DeviceId" : 123, //设备ID用于应急码设备ID校验 "EmKey" : "078571e7c65de78e818ff3083a4814e2", //应急码秘钥 "MotorKeepTime" :0, //持续工作时间(毫秒) "BlockNum" :0, //读取的块 "BlockKey" :"FFFFFFFFFFFF", //扇区秘钥 "BlockKeyType" : 96 //扇区秘钥类型 } } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/setstatus_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.13 同步时钟 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/timesync` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "DeviceTime" : 1596277728 //设备时间,时间戳(秒) } } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/timesync_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.14 更新固件 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/updatefirmware` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Data": { "FirmwareType" : 1, //固件类型,1:控制板,2:下位机1(扫码器),3:下位机2(扫码器) "FirmwareUrl" : "http://xxx.xxx.xxx/", //固件文件下载地址 "FirmwareMd5" : "xxxxxxxxxx" //固件文件MD5值 } } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/updatefirmware_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "" //原因(可选) } ``` #### 2.2.15 查询设备日志 - 后台或应用到设备 消息topic: `20211101/cmd/{#DeviceAddr}/extractlog` 消息内容: ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx" //设备地址 } ``` - 设备回馈到后台或应用 消息topic: `20211101/cmd/extractlog_reply` ```json { "SerialNo" : "6w8keif5g6", //消息序列号 "DeviceAddr" : "xxxxxxxx", //设备地址 "Result": 0, //执行结果,0-成功,非0失败 "Message": "", //原因(可选) "Data": "Feb 5 09:16:58 vbar: verify_analysis_nfc_offline_check()|82| ERR: nfc offline check failed, identityType: 204, identityCode: cdb332be\n" } ```
马志祥
2025年2月23日 13:58
17
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
Word文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期