离线语音串口协议(Wi-Fi)

更新时间:2024-06-20 08:28:26下载pdf

离线语音 Wi-Fi 串口协议,是在 涂鸦标准 MCU Wi-Fi 串口协议 的基础上,增加了部分离线语音专用的命令。其架构框如下图所示。

离线语音串口协议(Wi-Fi)

打开附 DP 类型拓展服务

  • 该服务主要拓展 DP(datapoint)下发端来源类型,主要的来源类型分为局域网、广域网、蓝牙等。
  • 该拓展服务打开后附 DP 类型命令下发命令下发呈互斥关系。

MCU发送:

字段 字节数 说明
帧头 2 0x55aa
版本 1 0x03
命令字 1 0x36
数据长度 2 0x0002
数据 1 子命令:0x00
1 0x00:关闭附 DP 类型拓展服务
0x01:开启附 DP 类型拓展服务
-
校验和 1 从帧头开始按字节求和得出的结果对 256 求余

例:0x55aa 03 36 0002 00 01 3c

模组返回:

字段 字节数 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x36
数据长度 2 0x0002
数据 1 子命令:0x00
1 0x00:服务开启/关闭成功
0x01: 服务开启/关闭失败
-
校验和 1 从帧头开始按字节求和得出的 结果对 256 求余

例:0x55aa 00 36 0002 00 00 38

附 DP 类型命令下发

  • 命令下发可含多个 DP命令数据单元
  • 命令下发为异步处理协议,对应于 MCU 的 DP 状态上报
  • 附 DP 下发来源类型需要手动设置,并与命令下发状态上报互斥。
  • Datapoint 下发来源类型除支持的部分外,其他的不支持。

模组发送:

字段 字节数 说明
帧头 2 0x55aa
版本 1 0x00
命令字 1 0x36
数据长度 2 取决于命令数据单元类型以及个数** N+2**
数据 1 子命令:0x01
1 Datapoint 下发来源类型:
0x00:未知来源类型
0x01:局域网
0x02:广域网
0x03:本地定时
0x04:本地联动
0x05:局域网联动
0x06:蓝牙
0x07:离线语音模组
-
N 3.7.1 命令数据单元 -
校验和 1 从帧头开始按字节求和得出的结果对256求余

例:局域网系统开关对应 3 号 DP,使用 bool 型变量,开机数值为 1

0x55aa 00 36 0007 01 01 03 01 0001 01 44

附 DP 类型状态上报

  • 目前仅离线语音模组业务支持,其他业务可直接使用状态上报
  • 状态上报为异步处理协议,状态上报触发机制有三类:
    1. MCU 收到附 DP 类型命令下发处理帧时,正确执行相应 DP 命令,再通过附 DP 类型状态上报帧,将变化后的 DP 状态发送至模组。
    2. MCU 主动检测到 DP 有变化,将变化后的 DP 状态发送至模组。
    3. MCU 收到状态查询帧时,将所有的 DP 状态发送至模组。
  • 状态上报可含多个DP命令数据单元

MCU 发送:

字段 字节数 说明
帧头 2 0x55aa
版本 1 0x03
命令字 1 0x36
数据长度 2 取决于 状态数据单元 类型以及个数 N+3
数据 1 子命令:0x02
1 0x00:MCU 主动上报
0x01:回应 状态查询
0x02:回应 附 DP 类型命令下发
-
1 MCU 主动上报回应状态查询 两种情况下统一使用 0x00
回应 附 DP 类型命令下发 需要返回数据的来源:
0x00:未知来源类型
0x01:局域网
0x02:广域网
0x03:本地定时
0x04:本地联动
0x05:局域网联动
0x06:蓝牙
0x07:离线语音模组
-
N 状态数据单元 -
校验和 1 从帧头开始按字节求和得出的结果对256求余

例:回应广域网下发的湿度对应 5 号 DP,使用 valve 型变量,湿度为 30℃

0x55aa 03 36 000b 02 02 02 05 02 0004 0000001e 6f

模组运行信息字段说明

名称 说明 支持选项 获取 设置
cc 国家码 0:表示 CN,包含区域:中国,韩国,新加坡,澳大利亚,日本(1-13),其他
1:表示 US,包含区域为:美国,中国台湾,加拿大
2:表示 JP,包含区域为:日本(1-14)
3:表示 EU,包含区域为:欧洲
支持 不支持
ap 表示 AP 热点 - 支持 不支持