Wi-Fi 断电快连

更新时间:2024-08-23 05:39:02下载pdf

概述

涂鸦 Wi-Fi 断电快连串口通用协议为涂鸦定制的 Wi-Fi 模组串口通用协议,主要用于涂鸦 Wi-Fi 模组与其它 MCU 串口直连做串口通信,其架构框图如下所示。

Wi-Fi 断电快连

注意事项

  • 整套协议适用于使用 Wi-Fi 模组且无法使用外电的设备。开发 MCU 程序的时候,断电管理尤为重要。在可以完成功能的前提下,尽量减少 Wi-Fi 模组的上电时间,这是节约设备功耗的关键。

    对于数据上传,涂鸦给出了大体的控制流程图。您可以根据自己设备的特性,选择协议中需要用到的功能。开发过程中,您可以根据自己的需要实时调整相关控制逻辑。

  • 很多日常设备即使不开启 Wi-Fi 功能,也可以正常使用。用户拿到设备时,可能由于种种原因而不使用 Wi-Fi 功能。

    为了防止这种情况下给 Wi-Fi 模组上电而造成电能损耗,在设备端可以设计一个物理按键或者相关选项。只有当用户主动打开该按键或者选项,MCU 才在每次数据变动时给 Wi-Fi 模组上电,传输相关数据。

串口通信约定

  • 波特率:9600
  • 数据位:8
  • 奇偶校验:无
  • 停止位:1
  • 数据流控:无

MCU:用户控制板控制芯片,与涂鸦模组通过串口对接。协议设计上,所有包的交互为全双工通信设计。

帧格式说明

字段 长度(byte) 说明
帧头 2 固定为 0x55aa
版本 1 升级扩展用
命令字 1 具体帧类型
数据长度 2 大端
数据 N -
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

说明:

  • 所有大于 1 个字节的数据均采用大端模式传输。

  • 协议中所有举例说明数据都是十六进制数据。

  • Wi-Fi 模组主动发起的通信发送包超时时间为 1 秒钟,重发机制会重发三包。

  • 一般情况下,采用同命令字一发一收同步机制,即一方发出命令,另一方应答。若发送方超时未收到正确的响应包,则超时传输,如下图所示:

    Wi-Fi 断电快连

    具体通信方式以 协议详述 章节中为准。

  • MCU 状态上报则采用同步模式,MCU 状态上报命令字为 y,如下所示:

    统计数据上报:

    Wi-Fi 断电快连

状态数据单元

  • Data point(DP)命令/状态数据单元如下所示:

    数据段 长度(byte) 说明
    dpid 1 DP 序号
    type 1 对应涂鸦开发者平台上某 DP 具体的数据类型,详细信息见如下 type 字段说明
    len 2 长度对应 value 的字节数,详细信息见如下 type 字段说明
    value 1/2/4/N Hex 表示,大于 1 字节采用大端传输

    type 字段说明:

    type 类型 对应长度 len(字节) 说明
    0x00 raw N 对应于 raw 型 DP(模组透传)
    0x01 bool 1 范围:0x00/0x01
    0x02 value 4 对应 int 类型,大端表示
    0x03 string N 对应于具体字符串
    0x04 enum 1 枚举类型,范围 0-255
    0x05 bitmap 1/2/4 长度大于 1 字节时,大端表示
  • DP 命令/状态数据单元除 raw 类型外,其他类型均属于 obj 型 DP。

  • 状态数据 可含多个 DP 命令数据单元

协议详述

查询产品信息

  • Product ID(PID):产品标识,由涂鸦开发者平台生成,用于云端记录产品相关信息。

  • 产品信息由 PID 和 MCU 软件版本构成。

  • MCU 软件版本号格式定义:采用点分十进制形式,x.x.x(0 ≤ x ≤ 99),x 为十进制数。

模组发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x01
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组发送:

55 aa 00 01 00 00 00

MCU 返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x01
数据长度 2 N
数据 N {“p”:”vHXEcqntLpkAl***”, “v”:”1.0.0”}
校验和 1 从帧头开始按字节求和得出的结果对 256 求余

示例{“p”:”vHXEcqntLpkAl***”,“v”:”1.0.0”}

  • p 表示产品 ID 为 vHXEcqntLpkAl***,参数为用户在涂鸦开发者平台创建的产品 PID。

  • v 表示 MCU 版本为 1.0.0。

MCU 返回示例信息:

55 aa 00 01 00 24 7b 22 70 22 3a 22 76 48 58 45 63 71 6e 74 4c 70 6b 41 6c 4f 73 79 22 2c 22 76 22 3a 22 31 2e 30 2e 30 22 7d bf

报告设备联网状态

设备联网状态 描述 状态值
状态 1 Wi-Fi 快连模式(EZ)配置状态 0x00
状态 2 Wi-Fi 热点模式(AP)配置状态 0x01
状态 3 Wi-Fi 已配置但未连上路由器 0x02
状态 4 Wi-Fi 已配置且连上路由器 0x03
状态 5 已连上路由器且连接到云端 0x04

说明

  • 当模组的 Wi-Fi 状态发生变化,则会主动下发 Wi-Fi 状态至 MCU。

  • 状态包用于 MCU 设备得知模组目前的状态,两种配置状态需要 MCU 进行相关的配网显示。

  • 原则上要求用户实现两种配网方式,EZ 配网方式存在少部分路由兼容性问题,AP 配网方式是确保设备可以联网成功的保障。

模组发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x02
数据长度 2 0x0001
数据 1 指示 Wi-Fi 工作状态
  • 0x00:状态 1
  • 0x01:状态 2
  • 0x02:状态 3
  • 0x03:状态 4
  • 0x04:状态 5
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组发送:

55 aa 00 02 00 01 04 06 (已连上路由器且连接到云端)

MCU 返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x02
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 返回:

55 aa 00 02 00 00 01

重置 Wi-Fi

重置 Wi-Fi 状态转化如下图所示:

Wi-Fi 断电快连

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x03
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 发送:

55 aa 00 03 00 00 02

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x03
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组返回:

55 aa 00 03 00 00 02

重置 Wi-Fi-选择配置模式

  • 相对于 重置 Wi-Fi 而言,此帧可以使 MCU 根据自身需求,选择是否设置重置 Wi-Fi 后的配置方式。

  • MCU 接入用户可选择是否实现该协议。

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x04
数据长度 2 0x0001
数据 1
  • 0x00:进入 EZ 配置模式
  • 0x01:进入 AP 配置模式
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 发送命令,控制模组进入 AP 配置模式:

55 aa 00 04 00 01 01 05

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x04
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组返回:

55 aa 00 04 00 00 03

实时状态上报

使用场景:对于类似报警器要求实时推送的设备,可以通过该命令上报相关状态数据。

当 MCU 需要上报实时状态的数据时,可通过该命令上报数据。

  • 状态数据会直接上报到云端,故设备联网状态必须为已连接到云端,否则数据上报失败。

  • 该命令为同步命令,MCU 数据上报后需等待模组返回上报结果,等待超时的时间为 7 秒。

  • 需要等待模组发送连接上服务器的网络状态包,MCU 再发送需要发送的统计数据包,这里的数据上传没有储存功能。如果 MCU 等待一段时间后还没收到连接上服务器的网络状态包,也强制给设备断电。等待时间受网络环境和是否是第一次配网影响。

    • 如果是第一次配网,从 Wi-Fi 已配置(状态 3)到连接到云端(状态 5)时间较长,原因是设备需要激活、初始化等配置,网络差的情况下会更长,建议等待 120 秒。
    • 如果不是第一次配网(已配网),考虑到网络差的环境下,等待时间会变长,所以建议等待 30 秒。
  • 模组可以支持多个数据单元上报和单个数据单元上报,用户根据自己的需要来选择发送组包的方式。具体数据包可以参考以下示例。

大致操作的流程图:

Wi-Fi 断电快连

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x05
数据长度 2 取决于 状态数据单元 类型以及个数
数据 N 一个或多个组合 状态数据单元
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x05
数据长度 2 0x0001
数据 1
  • 0x00:成功
  • 0x01:失败
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

单个状态数据单元 上报示例:

DP 109,Bool 型变量,数值为 1

55 aa 00 05 00 05 6d 01 00 01 01 79

多个状态数据单元 上报示例:

DP 109,Bool 型变量,数值为 1

DP 102,String 型变量,201804121507(具体传输对应 ASCII 值)

55 aa 00 05 00 15 6d 01 00 01 01 66 03 00 0c 32 30 31 38 30 34 31 32 31 35 30 37 5d

记录型状态上报(带记录储存功能)

使用场景:对于类似门锁等记录型的设备,包含多个 DP 数据需要服务端作为整条记录处 理,在短暂断网的情况下本条命令会保存无法上报成功的数据,满足记录型设备的上报需求。

当 MCU 需要记录型数据是由多个 DP 组合的整条数据,需要整体上报,便可以通过本条命令往 Wi-Fi 模组发送,并且在有数据上报,而此时设备断网了的情况下,这条数据会储存下来。当下次有数据上报的时候,模组再上传这条数据,并把之前的储存数据上报成功。

  • 当有滞留记录每次上报成功一条,模组就会主动发送一条 0x09 命令字数据为 0x01 的回复包。MCU 可以根据这个回复做超时断电处理。当发送一条记录后,强制等待 7s。如果没有收到模组任何回复,则认为模组异常也要断电模组。

  • 网络正常的情况下,模组上电后,正常需要 4 秒左右连接上服务器。每当有记录产生给设备上电后,可以等 Wi-Fi 模组发送协议文档所描述的的 设备联网状态包。等待时间受网络环境和是否是第一次配网影响:

    • 如果是第一次配网,从 Wi-Fi 已配置(状态 3)到连接到云端(状态 5)时间较长,原因是设备需要激活、初始化等配置,网络差的情况下会更长,建议等待 120 秒。
    • 如果不是第一次配网(已配网),考虑到网络差的环境下,等待时间会变长,所以建议等待 30 秒。
    • 当等待时间已到但是还没收到模组连接上服务器的包,也将该条命令上报,MCU 数据上报后需等待模组返回上报结果。
  • 单次记录上报的数据区域(多个状态数据单元)最大长度为 80 字节,根据实际的 DP 的数据,最后组合实际储存的长度会有所变化。当没有网络的状态下,超过限制长度,Wi-Fi 模组会返回记录发送失败的结果。

  • 最多可以储存 20 条历史记录。当历史记录超过 20 条,从最早储存的记录开始覆盖,如此循环覆盖。

  • 当 Wi-Fi 模组接收到一条数据成功推送,或者当没有网络状态下,记录成功存储进 Flash 中,也会当做推送成功(0x00)。当有网络时推送成功一条,还有滞留记录的话,会返回 0x01。其他的情况均返回推送失败 0x02

  • 时间数据:当需要服务器显示上传数据的时间,以本地上传的时间为准,MCU 在发送的时候把本地时间数据带上,把本地时间协议中的 Data[0] 时间标志位设置为 1,并按协议要求传输相关数据。当 Wi-Fi 模组检测到时间标志位为 1,便会以 MCU 传输的时间为准。注意保证时间数据正确

上报大致操作流程图:

Wi-Fi 断电快连

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x08
数据长度 2 取决于 状态数据单元 类型以及个数类型以及个数
数据 7 数据长度为 7 字节
Data[0] 为这条数据传输是否带本地时间标志位:
  • 0:表示这条数据不带本地时间,模组认为后面的时间数据无效,不处理
  • 1:表示后面的时间数据有效
    Data[1] 为年份,0x00 表示 2000 年
    Data[2] 为月份,从 1 开始到 12 结束
    Data[3] 为日期,从 1 开始到 31 结束
    Data[4] 为时钟,从 0 开始到 23 结束
    Data[5] 为分钟,从 0 开始到 59 结束
    Data[6] 为秒钟,从 0 开始到 59 结束
N 一个或多个组合 状态数据单元
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x08
数据长度 2 0x0001
数据 1
  • 0x00:上报成功
  • 0x01:当前记录上报成功,并且还有滞留记录需要上报
  • 0x02:上报失败
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

单个状态数据单元 上报示例:DP 109,Bool 型变量,数值为 1

  • 55 aa 00 08 00 0c 01 12 04 13 0d 03 1d 6d 01 00 01 01 da //本地时间为准

  • 55 aa 00 08 00 0c 00 12 04 13 0d 04 14 6d 01 00 01 01 d1 //服务端时间为准

多个状态数据单元 上报示例:

  • DP 109,Bool 型变量,数值为 1

  • DP 102,String 型变量,201804121507(具体传输对应 ASCII 值)

  • 55 aa 00 08 00 1c 00 12 04 13 0d 06 04 6d 01 00 01 01 66 03 00 0c 32 30 31 38 30 34 31 32 31 35 30 37 a7 //服务端时间为准

  • 55 aa 00 08 00 1c 01 12 04 13 0d 08 2e 6d 01 00 01 01 66 03 00 0c 32 30 31 38 30 3431 32 31 35 30 37 d4 //本地时间为准

模组命令下发

命令下发 为异步处理协议。MCU 收到相关控制包,确认接收到回复下发包后,完成相关的控制动作,MCU 状态反馈通过 MCU 的状态上报来实现。

模组发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x09
数据长度 2 取决于 命令数据单元 类型以及个数
数据 N 状态数据单元
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组下发控制命令: 系统开关对应 DP 3,使用 Bool 型变量,开机数值为 1

55 aa 00 09 00 05 03 01 00 01 01 13

MCU 回复:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x09
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 确认回复:

55 aa 00 09 00 00 08

获取本地时间

  • 需要等待设备连接上网络(也就是收到 设备联网状态 命令状态 5)后,开始发送获取本地时间的数据包。

  • 在设备连接上服务器后,在网络情况非常差的情况下,有可能会获取时间数据失败。对于依赖时间的设备(例如门锁),如果本地时间没有校准过,当获取时间数据失败时,需要做一个间隔 3s 的获取时间值,确保时间数据获取成功。

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x06
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 获取本地时间:

55 aa 00 06 00 00 05

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x06
数据长度 2 0x0008
数据 Data 数据长度为 8 字节:
Data[0] 为是否获取时间成功 标志,为 0 表示失败,为 1 表示成功
Data[1] 为年份,0x00 表示 2000 年
Data[2] 为月份,从 1 开始到 12 结束
Data[3] 为日期,从 1 开始到 31 结束
Data[4] 为时钟,从 0 开始到 23 结束
Data[5] 为分钟,从 0 开始到 59 结束
Data[6] 为秒钟,从 0 开始到 59 结束
Data[7] 为星期,从 1 开始到 7 结束,1 代表星期一
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组返回本地时间数据:

55 aa 00 06 00 08 01 12 09 11 10 09 05 01 59

本地时间:18 年 9 月 17 日 16 时 9 分 5 秒星期一

  • 如果设备在国内激活使用,则当地时间为北京时间东 8 区
  • 如果设备在国外激活使用,则当地时间为设备所处时区时间

Wi-Fi 功能性测试

  • 扫描指定的 SSID:tuya_mdev_test,返回扫描结果和信号强度百分比。

  • 产测指令需要在 Wi-Fi 上电工作完成初始化流程以后发送(回复 查询产品信息 的数据包),否则导致产测失败或无结果。

  • 本条命令多用于设备量产时的产品整机测试。

  • 产测路由器密码可随意设置,需采用 2.4 GHz 信号的路由器。

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x07
数据长度 2 0x0000
数据 Data
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 触发模组功能性测试:

55 aa 00 07 00 00 06

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x07
数据长度 2 0x0002
数据 2 数据长度为 2 字节:
Data[0]:0x00 表示失败,0x01 表示成功
  • 当 Data[0] 为 0x01,即成功:
    Data[1] 表示信号强度,范围 0-100,0 表示信号最差,100 表示信号最强
  • 当 Data[0] 为 0x00,即失败:
    • Data[1]为 0x00,表示未扫描到指定的 SSID
    • Data[1]为 0x01,表示模组未烧录授权 Key
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组返回测试结果:

55 aa 00 07 00 02 01 50 59

Wi-Fi 功能性测试成功,信号强度为 80。

固件升级

请求 Wi-Fi 模组固件升级

Wi-Fi 模组的电源通断是由 MCU 控制的,当 MCU 需要升级 Wi-Fi 模组的固件,便可以通过本命令拉取最新固件。

MCU 主板根据 Wi-Fi 模组的回复包,决定是否需要给 Wi-Fi 模组断电。

  • 当 MCU 发送 0x0a 命令等待 5 秒没有收到相关回复,便给 Wi-Fi 模组断电。
  • 当模组回复正在更新固件,MCU 也需要发起一个定时,当处于正在更新固件状态超过 60 秒而没有收到固件升级成功,也强制认为固件升级失败,给 Wi-Fi 模组断电。

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0a
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 请求 Wi-Fi 固件升级:

55 aa 00 0a 00 00 09

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0a
数据长度 2 0x0001
数据 1
  • 0x00:开始检测固件更新,不可断电
  • 0x01:已经是最新固件,断电
  • 0x02:正在更新固件,不可断电
  • 0x03:固件更新成功,断电
  • 0x04:固件更新失败,断电
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组升级状态返回:

  • 55 aa 00 0a 00 01 00 0a:收到升级请求包,立刻返回该数据

  • 55 aa 00 0a 00 01 01 0b:拉取服务端信息,返回没有固件需要更新

请求 MCU 固件升级

  • 当 MCU 收到模组返回固件更新完成的信息之后,说明服务端 MCU 的升级文件已经全部拉取完成并且完成了串口数据传输。注意 MCU 在收到完整升级文件后,确认拉取文件没有问题,此时模组重新发送查询信息,MCU 需要返回相关产品信息,以及在升级服务器后台填写的、新的软件版本号。

  • 目前,支持最大为 480KB 的 MCU 文件的 OTA 升级。

  • 用户在涂鸦开发者平台配置时,配置 MCU 升级方式为 App 静默升级。

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0c
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 请求 MCU 固件升级:

55 aa 00 0c 00 00 0b

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0c
数据长度 2 0x0001
数据 1
  • 0x00:开始检测固件更新,不可断电
  • 0x01:已经是最新固件,断电
  • 0x02:正在更新固件,不可断电
  • 0x03:固件更新成功,断电
  • 0x04:固件更新失败,断电
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组升级状态返回:

  • 55 aa 00 0c 00 01 00 0c:收到升级请求包,立刻返回

  • 55 aa 00 0c 00 01 01 0d:拉取服务端信息,返回没有固件需要更新

MCU 升级包大小通知

当 MCU 收到升级启动包,可以知道需要升级的文件大小。此时模组开始去服务端拉取 MCU 的升级包,之后发送升级包传输的相关数据包。

模组发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0d
数据长度 2 0x0004
数据 4 固件包字节数,unsigned int,大端
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组发送文件包大小:

55 aa 00 0d 00 04 00 00 68 00 78:固件包长度 26624,即 26KB

MCU 返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0d
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 确认包回复:

55 aa 00 0d 00 00 0c

升级包传输

  • 升级包传输数据格式:包偏移(unsigned short) + 包数据。

  • MCU 若收到该帧数据长度为 4 且包偏移 ≥ 固件大小,则包传输结束。

模组发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0e
数据长度 2 0x0004+数据包长度
数据 N 前四字节,固定为包偏移,后面为数据包内容
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组发送文件数据:

若要升级的文件大小 530 字节,(最后一包数据可不回复)

  1. 第一包数据,包偏移为 0x00000000,数据包长度为 256 字节:

    55aa 00 0e 0104 00000000 xx…xx XX

  2. 第二包数据,包偏移为 0x00000100,数据包长度为 256 字节:

    55aa 00 0e 0104 00000100 xx…xx XX

  3. 第三包数据,包偏移为 0x00000200,数据包长度为 18 字节:

    55aa 00 0e 0016 00000200 xx…xx XX

  4. 最后一包,包偏移为 0x00000212,数据包长度为 0 字节:

    55aa 00 0e 0004 00000212 xx...xx XX

MCU 返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0e
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 每包数据包确认:

55 aa 00 0e 00 00 0d

查询当前连接路由信号强度

通过本命令,查询设备当前所连接路由器的信号强度。前提是收到设备的网络状态包,得知设备已经成功连接上路由器,否则发送本命令将返回失败的结果。

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0b
数据长度 2 0x0000
数据 0
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

MCU 获取查询设备连接的路由器强度:

55 aa 00 0b 00 00 0a

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x0b
数据长度 2 0x0002
数据 2 数据长度为 2 字节:
Data[0]:0x00 表示失败,0x01 表示成功
  • 当 Data[0] 为 0x01,即成功:
    Data[1] 表示信号强度,范围 0-100,0 表示信号最差,100 表示信号最强
  • 当 Data[0] 为 0x00,即失败:
    Data[1]为 0x00,表示设备未连接上路由器
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组返回当前强度值 80:

55 aa 00 0b 00 02 01 50 5D

获取 DP 缓存命令

对于某些带设置或控制功能的传感器,需要新增 DP 下发功能。当设备离线时,面板有命令下发,该命令会缓存在云端,等待设备主动获取。缓存命令为增量方式,对于已经获取过的命令,再次获取时不会下发。

MCU 发送:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x10
数据长度 2 N
数据 dp_num (1 byte) + dp_1 (1 byte)+ … + dp_n (1 byte) 如果 dp_num0,则认为查询所有 DP
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

门锁获取 DP115、114 和 113 的缓存指令:

55 AA 00 10 00 04 03 73 72 71 6C

模组返回:

字段 长度(byte) 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x10
数据长度 2 取决于 状态数据单元 类型以及个数
数据 result (1byte) + dp_num (1byte) + dp_1 (1 byte) + … + dp_n(1 byte) 状态数据单元 组,返回有缓存命令的 DP 数据
  • result:获取指令成功标志
    • 0:表示失败,后面不会带上相关 DP 数据,数据内容长度为 1
    • 1:表示成功
  • dp_num0 表示当前没有缓存命令
校验和 1 从帧头开始,按字节求和得出的结果对 256 求余

模组返回:

DP 115 自动关门(布尔型,代表是否要执行自动关门)+ DP 114 延时门锁选择(枚举型,立即锁门或继续计时)+ DP 113(数值型,单位 s),下列返回数据代表延时 30s 关门

55 AA 00 10 00 14 01 03 73 01 00 01 01 72 04 00 01 01 71 02 00 04 00 00 00 1E AA