更新时间:2023-09-05 06:49:19下载pdf
LTE Cat.1 模组串口通用协议适用于涂鸦 LTE Cat.1 模组与其它 MCU 串口直连,做串口通信的场景。连接方式如下图所示:
下表介绍了目前主要提供的几款 LTE Cat.1 模组的功能和服务支持情况。
Y 表示支持
N 表示不支持
O 表示需要额外设备支持
功能 | LZ201CN LZ501CN |
LZ211CN | LZ201EU | LZ211EU | TCS600U | TCS600E TCS800E |
NL668 AM | MA510 | MC665eu |
---|---|---|---|---|---|---|---|---|---|
基础服务 | Y | Y | Y | Y | Y | Y | Y | Y | Y |
DP 服务 | Y | Y | Y | Y | Y | Y | Y | Y | Y |
MCU 升级 | Y | Y | Y | Y | Y | Y | Y | Y | Y |
蜂窝服务 | Y | Y | Y | Y | Y | Y | Y | Y | Y |
密码及天气服务 | Y | Y | Y | Y | Y | Y | Y | Y | N |
低功耗蓝牙搭配 LTE Cat.1 | Y | Y | Y | Y | Y | Y | Y | Y | Y |
定位服务 | O | Y | O | Y | O | O | Y | O | N |
AGNSS 服务 | N | Y | N | Y | N | N | N | N | N |
电话服务 | Y | Y | Y | Y | Y | N | N | N | N |
短信服务 | Y | Y | Y | Y | Y | N | Y | N | N |
电池服务 | Y | Y | Y | Y | Y | N | N | N | N |
音频服务 | Y | Y | Y | Y | Y | N | N | N | N |
蓝牙服务 | Y | Y | N | N | N | N | N | N | N |
功能控制服务 | Y | Y | Y | Y | Y | Y | Y | Y | Y |
扩展服务 | Y | Y | Y | Y | Y | Y | Y | Y | Y |
当模组有串口数据需要发送 MCU 的时候,模组的一个引脚会产生一个持续默认 60ms 的低电平。下表为不同模组的默认的的管脚。
模组型号 | WAKEOUT 默认管脚 | 通用对接串口 | 备注 |
---|---|---|---|
|
|
UART1 |
|
L610EU | 通用对接默认管脚 37 | UART1 |
|
MA510GL | 通用对接默认管脚 61 | UART3 | UART3_TXD 高电平时无法开机 |
NL668AM | 通用对接默认管脚 62 | 129(TX) 130(RX) | - |
TCS800E | 通用对接默认管脚 20 | UART1(RX17,TX18) | - |
TCS600E | 通用对接默认管脚 20 | UART1(RX31,TX32) | - |
MC665EU | 通用对接默认管脚 61 | UART1(RX18,TX19) |
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 固定为 0x55aa |
版本 | 1 | 升级扩展用 |
命令字 | 1 | 具体帧类型 |
数据长度 | 2 | 大端 |
数据 | N | - |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
所有大于一个字节的数据均采用大端模式传输。
一般情况下,采用同命令字一发一收同步机制,即一方发出命令,另一方应答,如下图所示。若发送方超时未收到正确的响应包,则超时传输。
具体通信方式以 协议 相关章节中描述为准。
模组控制命令下发,及 MCU 状态上报则采用异步模式。假设模组控制命令下发 命令字 为 x,MCU 状态上报 命令字 为 y,如下所示:
模组下发控制命令:
MCU 上报状态:
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0xFF |
数据长度 | 2 | 2+N(版本信息长度) |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:55 AA 00 FF 00 07 70 24 31 2E 30 2E 31 87
以 15s 的间隔定期发送心跳。若在超时时间(90s)内,未收到 MCU 的任何回应,则认为与 MCU 通信异常模组自动内部软件重启复位。
MCU 也可依据此心跳定期检测模组是否正常工作。若模组无心跳下发,则 MCU 可通过模组提供的硬件复位引脚复位模组。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x00 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 00 0000 ff
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x00 |
数据长度 | 2 | 0x0001 |
数据 | 1 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:
产品信息由 PID(product ID)、MCU 软件版本构成:
"x.x.x"
(0<=x<=99),x 为十进制数。模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x01 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 01 0000 00
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x01 |
数据长度 | 2 | N |
数据 | N | {“p”:“AIp08kLIftb8x2x0”, “v”:“1.0.0”, “m”:1, “apn”:“cniot”, “mht”:60, “qr”:1, “slave”:1, “ext_ota”:[ { “ch”:1, “v”:“0.1.1” }, … { “ch”:n, “v”:“0.1.n” }], “U”:0, “dp_cache”:1, “cops”:“xxx” “dp_ack”:1, “online_tts”:0 } 其中 apn 是可选项。如果没有 apn ,系统自动配置 apn 。mht 、qr 、slave 是可选项。 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:{"p":"AIp08kLIftb8x2x0", "v":"1.0.0", "m":1}
qr
字段设置为 1 时,会获取二维码短码。v
版本信息最大 10 字节,最多支持 6 组。但是,应用固件和基础固件占用的通道不能用。cops:"20416"
,该字段等同于 AT 指令:AT+COPS=1,2, "xxxxx"
。1
为开启,开启后下发 DP 数据给 MCU,会进行 ACK 确认,未收到 ACK 会进行重发。最多重发三次、每次等待 ACK 为 500ms。1
的时候,表示支持涂鸦在线 TTS(Text-to-Speech)音频功能。该功能只有在模组支持音频服务时才有效。模组工作模式区分设置模组的工作状态以及重置模组方式,分两种情况:
MCU 与模组配合处理:
模组自处理:
NET_MODE
引脚驱动 LED 状态显示。模组自处理模式下。LED 灯只支持 NET_MODE
指示灯。此时,模组不上报设备联网状态。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x02 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 02 0000 01
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x02 |
数据长度 | 2 | 0x0000/0x0002
|
数据 | 0/2 | 数据长度为 2,首字节为模组状态指示 GPIO 序号(固定值为 0)。次字节为模组重置按键 GPIO 序号。 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:
设备联网状态 | 描述 | 状态值 |
---|---|---|
状态 1 | SIM 卡未连接 | 0x00 |
状态 2 | 搜索网络中 | 0x01 |
状态 3 | 已成功注册未联网 | 0x02 |
状态 4 | 联网成功并获取到 IP | 0x03 |
状态 5 | 设备已连接到云端 | 0x04 |
状态 6 | SIM 基站注册被拒绝,可能是 SIM 当前的业务未开通 | 0x05 |
状态 7 | 设备待配网 | 0x06 |
状态 8 | 未知状态 | 0xFF |
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x03 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 参考 状态说明 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 03 0001 00 03
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x03 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 03 03 0000 05
LTE Cat.1 模组接收到重置命令后,解除设备和云端绑定。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x04 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 03 04 0000 06
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x04 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 04 0000 03
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x41 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+n |
数据 | n |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
命令数据单元和状态数据单元(datapoint
)如下所示:
数据段 | 字节数 | 说明 |
---|---|---|
dpid | 1 | datapoint 序号 |
type | 1 | 对应 涂鸦 IoT 开发平台 上一个 DP 具体的数据类型,参考下表中 type 字段中表示值说明 |
len | 2 | 长度对应 value 的字节数,参考下表中 type 字段说明 |
value | 1/2/4/N | 用 16 进制表示,大于 1 字节采用大端传输 |
datapoint
中的 type
字段说明:
type |
数据类型 | 字节数 | 说明 |
---|---|---|---|
0x00 | Raw | N | 对应于 Raw 型 datapoint ,采用模组透传的方式传输 |
0x01 | Bool | 1 | 范围:0x00 或 0x01 |
0x02 | Value | 4 | 又称 Integer 类型,采用大端表示 |
0x03 | String | N | 对应于具体字符串 |
0x04 | Enum | 1 | 枚举类型,范围为 0-255 |
0x05 | Bitmap | 1/2/4 | 长度大于 1 字节时,采用大端传输 |
datapoint
命令/状态数据单元中,除 Raw 类型外,其他类型均属于 Object 数据类型。datapoint
命令数据单元。datapoint
状态上报。模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x06 |
数据长度 | 2 | 取决于 命令数据单元 类型以及个数 |
数据 | N | 命令数据单元 组 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:系统开关对应 3 号 DP,使用 bool 型变量,开机数值为 1 0x55aa 00 06 0005 03 01 0001 01 10
datapoint 状态数据单元,说明详见 数据单元 章节。
状态上报为异步处理协议,状态上报触发机制有三类:
MCU 收到命令下发处理帧时,正确执行相应 datapoint 命令,再通过状态上报帧,将变化后的 datapoint 状态发送至模组。
MCU 主动检测到 datapoint 有变化,将变化后的 datapoint 状态发送至模组。
MCU 收到 状态查询 帧时,将所有的 datapoint 状态发送至模组。
状态上报可含多个 datapoint 命令数据单元。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x07 |
数据长度 | 2 | 取决于状态数据单元类型以及个数 |
数据 | N | 状态数据单元 组 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:湿度对应 5 号 DP,使用 value 型变量,湿度为 30% 0x55aa 03 07 0008 05 02 0004 0000001e 3a
状态查询为异步处理协议,主要用于模组查询 MCU 所有的 Object 类型的 datapoint 状态,当 MCU 收到此帧时,通过 状态上报 章节状态上报帧上报 datapoint 状态。
状态查询发送时机主要有两种:
模组首次上电,通过心跳与 MCU 建立连接后,当设备连接到涂鸦 IoT 开发平台后查询发送。
模组工作过程中检测到 MCU 重启或发生了离线再上线的过程,查询发送。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x08 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 08 0000 07
此命令为同步指令,MCU 数据状态上报后,需要等待模组返回结果。
每次发送模组都会有响应,模组未响应前不可多次上报。
网络较差,数据难以及时上报时,模组会在 5 后返回失败,MCU 需要等待大于 5 秒。
datapoint 状态数据单元说明详见 状态数据单元。
状态上报可含多个 datapoint 命令数据单元。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x22 |
数据长度 | 2 | 取决于状态数据单元类型以及个数 |
数据 | N | 状态数据单元 组 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x23 |
数据长度 | 2 | 0x01 |
数据 | 1 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
此命令为同步指令,MCU 数据状态上报后,需要等待模组返回结果。
每次发送模组都会有响应,模组未响应前不可多次上报。
网络不好,数据难以及时上报时,模组会在 5 后返回失败,MCU 需要等待大于 5 秒。
datapoint 状态数据单元说明详见 状态数据单元。
状态上报可含多个 datapoint 命令数据单元。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x26 |
数据长度 | 2 | 取决于 状态数据单元 类型以及个数 + 7 |
时间标签 | 7 |
|
数据 | N | 状态数据单元 组 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x26 |
数据长度 | 2 | 0x0001 |
数据 | 1 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
升级时,您可以在涂鸦 IoT 开发平台上的产品页面配置相关升级选项触发。模组仅作为支持 MCU 升级的数据传输通道,不对数据内容做任何解析。
目前,支持四种 MCU 升级方式的配置:
App 提醒升级:用户每次进入设备控制面板都会收到升级提醒的弹窗,是否确认升级由用户自己在 App 确认。
App 静默升级:App 不会有任何提醒弹窗,固件上电后一分钟内会去自动去检测升级发现有高版本的升级包会自动开始获取相关升级包,第一次上电后模组会间隔 24 小时去云端检测一次是否有升级包配置。
App 强制升级:App 端会有升级提醒弹窗,如果用户不确认升级用户就没法正常使用这个产品的控制面板。
App 检测升级:App 端不会有任何升级提醒的弹窗,必须要用户在 App 端自己去单击相关固件版本检测,如果有高版本的固件配置才会显示升级提示信息。
MCU 升级相关流程:
模组发送完所有的升级包,重新发送 01 命令字(查询产品信息)。MCU 需要在一分钟内回复产品信息中的软件版本号,带上升级后的 MCU 版本号,版本号需要和在涂鸦 IoT 开发平台配置升级的版本号保持一致。
升级启动方式含自动及手动升级。
模组发送
U: 0 协议版本:0x00
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x0a |
数据长度 | 2 | 0x0004 |
数据 | 4 | 固件包字节数,类型为 unsigned int,采用大端传输 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 0a 0004 00006800 75(固件包长度 26624,即 26KB)
U: 1 协议版本:0x01
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x01 |
命令字 | 1 | 0x0a |
数据长度 | 2 | 0x004F |
数据 | 40 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x0a |
数据长度 | 2 | 0x0001 |
数据 | 1 | 升级包分包传输大小:
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 03 0a 0001 00 0d
升级包传输数据格式为:
通道号(协议版本 01) + 包偏移(unsigned short) + 包数据
MCU 若收到该帧数据长度为 4,且包偏移大于等于固件大小,则包传输结束。
最后一包,包偏移为固件大小,数据包长度为 0。
模组发送
U: 0 协议版本 0x00:
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x0b |
数据长度 | 2 | 0x0004+数据包长度 |
数据 | 4+N | 前四字节,固定为包偏移,后面为数据包内容 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
U: 1 协议版本 0x01:
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x01 |
命令字 | 1 | 0x0b |
数据长度 | 2 | 0x0005+数据包长度 |
数据 | 5+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:若要升级的文件大小 530 Byte,最后一包数据可不回复。
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x0b |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 03 0b 0000 0d
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x34 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x34 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 0x09(子命令) |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x0c |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 03 0c 0000 0e
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x0c |
数据长度 | 2 | 0x0007 |
数据 | 7 | 数据长度为 7 字节:
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 0c 0007 01 10 04 13 05 06 07 4c(格林时间 2016 年 4 月 19 日 5 时 6 分 7 秒)
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x0e |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x0e |
数据长度 | 2 | 0x0004 |
数据 | 4 | 数据长度为 4 字节:
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x1c |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x1c |
数据长度 | 2 | 0x0008 |
数据 | 8 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:
获取模组剩余内存,返回 -1 表示不支持获取内存。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x0f |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x0f |
数据长度 | 2 | 0x0004 |
数据 | 4 | 采用大端格式,如 0x00 0x00 0x28 0x00 代表剩余 10240 字节内存 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x1B |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x1B |
数据长度 | 2 | N |
数据 | N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
暂不支持夏令时获取。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x24 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x24 |
数据长度 | 2 | 0x0001 |
数据 | 1 | RSSI 值的范围为 0~31,值越大,信号越好。
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
03 版本:
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x25 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
04 版本:
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x04 |
命令字 | 1 | 0x25 |
数据长度 | 2 | 0x0001 |
数据 | 1 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x25 |
数据长度 | 2 | 0x0000 或 0x0001 |
数据 | 0 或 1 个字节 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
对于需要休眠降低功耗的 MCU,可在休眠前发送该指令关闭模组心跳,方便进入休眠状态。该指令请勿在设备刚上电时发送,模组上电后需要和 MCU 建立心跳连接。
设备联网状态 | 描述 | 状态值 |
---|---|---|
状态 1 | SIM 卡未连接 | 0x00 |
状态 2 | 搜索网络中 | 0x01 |
状态 3 | 已成功注册未联网 | 0x02 |
状态 4 | 联网成功并获取到 IP | 0x03 |
状态 5 | 已连接到云端 | 0x04 |
状态 6 | SIM 拒绝注册 | 0x05 |
与 报告设备联网状态 章节中保持一致。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x2b |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x2b |
数据长度 | 2 | 0x0001 |
数据 | 1 | 参考 状态说明 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x2d |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x2d |
数据长度 | 2 | 0x0007 |
数据 | 7 |
|
模组有全功能工作模式,飞行模式两种。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x05 |
数据长度 | 2 | 0x0001 |
数据 | 1 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 03 04 0000 06
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x05 |
数据长度 | 2 | 0x0001 |
数据 | 1 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:0x55aa 00 04 0000 03
模组有全功能工作模式,飞行模式两种。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x01 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:55 AA 03 71 00 01 01 75
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
本命令可以由 MCU 控制主动发送一个 IMSI 获取包,可用于获取模组的国际移动用户识别码。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x02 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0010 |
数据 | 16 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:
55 AA 00 71 00 10 02 34 36 30 31 31 33 30 31 32 34 36 37 33 34 30 7C
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x03 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0015 |
数据 | 21 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:
55 AA 00 71 00 15 03 38 39 38 36 31 31 31 38 32 34 39 30 30 30 33 36 33 34 39 30 9A
MCU 主动下发给模组获取 IMEI 指令,模组将 IMEI(长度 15 的字串)返回给 MCU。本命令可以由 MCU 控制,主动发送 IMEI 获取包,以用于获取设备的 IMEI 码。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x04 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0010 |
数据 | 16 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:
55 AA 00 71 00 10 04 38 36 34 32 33 37 30 34 30 30 31 34 37 33 33 88
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x43 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
该命令只支持 MA510 模组,并且只有在产品信息返回里有设置 COPS 才支持。
该命令需要注网成功后,才能获取到 PLMN(Public Land Mobile Network)。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 3 | Data[0] 子命令:0x48 |
校验和 | 1 | 从帧头开始按字节求和得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N*PLMN |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和得出的结果对 256 求余 |
例:
55 AA 03 71 00 01 48 BC
55 AA 00 71 00 12 48 01 00 04 BA FC 00 04 BA FC 00 04 BC 8A 00 04 BB F4 3C
设备长时间不联网也可使用的动态密码。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x16 |
数据长度 | 2 | N |
数据 | 7+N | Year(1) + mon(1) + day(1) + hour(1) + min(1) + sec(1) + code_len(1) + code(N)。表示格林时间 + 密码长度 + 密码。 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例:
模组回复
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x16 |
数据长度 | 2 | N |
数据 | 3+N | Result(1) + type(1) + decode_len(1) + decode(N):
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组给门锁给的相关时间数据都是基于格林时间,请门锁本地通过获取格林时间的接口同步自己的时钟数据。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x14 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
门锁获取当前生效临时密码:
55 aa 00 14 00 00 13
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x14 |
数据长度 | 2 | 0x0001+N(临时密码) |
数据 | 1+N | 数据长度为 1+N 字节:
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
密码进制指连续的密码数字按键范围,包含以下两个概念:
进制:表示所有密码数字的个数,支持 4-10。
起始值:表示数字开始的数值,仅支持 0 和 1。
密码进制对应密码按键数 | 密码按键从 1/0 开始 | 是否支持动态密码 | 是否支持离线密码 | 在线密码最小长度 | 安全等级 | 在线密码多语言配置 |
---|---|---|---|---|---|---|
4 | 可选 | 不支持 | 不支持 | 8 | 1/29W | 支持 8-12 位密码 |
5 | 可选 | 支持 | 不支持 | 8 | 1/39W | 支持 8-12 位密码 |
6 | 可选 | 支持 | 不支持 | 8 | 1/100W | 支持 8-12 位密码 |
7 | 可选 | 支持 | 支持 | 8 | 1/100W | 支持 8-11 位密码 |
8 | 可选 | 支持 | 支持 | 7 | 1/100W | 支持 7-11 位密码 |
9 | 可选 | 支持 | 支持 | 7 | 1/100W | 支持 7-10 位密码 |
10 | 不可选 | 支持 | 支持 | 7 | 1/100W | 默认支持 7 位密码 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x17 |
数据长度 | 2 | 0x0002 |
数据 | 2 | Data[0] 为进制值,Data[1] 为起始值 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
举例:
配置数字 12345,分别配置进制为 5,起始值为 1。
配置数字 012345,分别配置进制为 6,起始值为 0。
密码进制 0x17 设置,需要在获取信息查询产品信息 0x01 之后进行设置,并在密码操作前设置。
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x17 |
数据长度 | 2 | 0x0001 |
数据 | 1 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x14 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
门锁获取当前生效临时密码:
55 aa 00 14 00 00 13
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x14 |
数据长度 | 2 | 0x0001+N(临时密码) |
数据 | 1+N | 数据长度为 1+N 字节:
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x20 |
数据长度 | 2 | N((L+K)+(L+K)…) |
数据 | N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x20 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
下发天气数据,在打开天气数据功能后模组定时下发。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x21 |
数据长度 | 2 | N((LKTLV)(LKTLV)…) |
数据 | N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x21 |
数据长度 | 2 | 0x0000 |
数据 | 0 | 无 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
请求参数表如果为 w.temp,w.pm25
但返回 w.temp
,返回参数少于请求参数请仔细检查请求参数名是否正确。
授权信息储存在低功耗蓝牙芯片内部,如果 Cat.1 模组接入,低功耗蓝牙通过 UART 将授权信息和激活信息传输到 Cat.1 模组。Cat.1 不支持主动绑定云端,也不支持从云端解绑。当低功耗蓝牙设备进行解绑的时候,需要发送命令给 Cat.1 通知已经解绑。
基本交互:
低功耗蓝牙发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0xD0 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令 0x00 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组回复
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0xD0 |
数据长度 | 2 | N |
数据 | 1 | 子命令 0x00 |
1 |
|
|
1 | 模组绑定状态,0 表示未绑定,1 表示绑定 | |
1 | Type 表示模组类型
|
|
N | XXX (模组的唯一标识) | |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
低功耗蓝牙发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0xD0 |
数据长度 | 2 | N |
数据 | N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组回复
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0xD0 |
数据长度 | 2 | 0x0002 |
数据 | 35 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
低功耗蓝牙发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0xD0 |
数据长度 | 2 | N |
数据 | 1+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组回复
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0xD0 |
数据长度 | 2 | 1 |
数据 | 1 子命令 | 0x02 |
Result | 0 表示收到激活信息,正在激活中(激活成功可按 状态上报命令,其它结果表示激活失败 | |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
低功耗蓝牙发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0xD0 |
数据长度 | 2 | 0x42 (66) |
数据 | 66 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组回复
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0xD0 |
数据长度 | 2 | 0x42 (66) |
数据 | 66 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 主动下发给模组设置 GNSS 启动或者关闭定位功能。该功能由于 GNSS 模组的处理事务比较多,应答的消息超时时间最大为 3 秒。
定位类型字段在 GNSS 定位开启的情况下其值才有效。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 3 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002/0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
LZ211 模组 定位类型只支持 GPS 搭配 BD,不可更改。
MCU 主动下发给模组设置 GNSS 启动或者关闭定位功能。该功能由于 GNSS 模组的处理事务比较多,应答的消息超时时间最大为 3 秒。启用该功能,需要首先开启 GNSS 定位功能。
定位类型字段在 GNSS 定位开启的情况下其值才有效。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0004 |
数据 | 4 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 主动下发给模组根据设置的 DPID 和上报间隔,模组自动上报 GPS 定位信息到云端。启动 Wi-Fi 定位功能后,蓝牙会被关闭。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 主动下发给模组根据设置的 DPID 和上报间隔,模组自动上报定位信息到云端。启用该功能,需要首先开启 Wi-Fi 定位功能。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0004 |
数据 | 4 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 主动下发给模组根据设置的 DPID 和上报间隔,模组自动上报定位信息到云端。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0004 |
数据 | 4 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
LZ211 模组内置了 GNSS 设备,每次在 GNSS 设备上电时会自动复位一次。
MCU 主动下发给模组获取 GNSS 定位信息。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x10 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回的定位信息为字符串类型,MCU 在获取到后定位信息后,按照 状态上报 章节把模组返回的定位信息上报给云端。如果云端的 DP 是要求纬经度格式,则 MCU 需要将收到的定位信息转为纬经度。
MCU 主动下发给模组获取 GNSS 定位信息。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x29 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回的定位信息为字符串类型,MCU 在获取到后定位信息后,按照 状态上报 章节把模组返回的定位信息上报给云端。
MCU 主动下发给模组获取 GNSS 信号强度。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x11 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 主动下发给模组获取 GNSS 瞬时速度。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x12 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0004 |
数据 | 4 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 主动下发给模组获取 Wi-Fi 定位信息。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x20 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回的定位信息为字符串类型,MCU 在获取到后定位信息后,按照 状态上报 章节把模组返回的定位信息上报给云端。
目前定位信息只上报最多 10 个最好信号的 AP 信息。
MCU 发送命令给模组,获取定位信息。
一般来说某些基站编号只有 2 个字节,也就是 04ba。但是设计上涂鸦支持 4 字节的基站编号,所以可能出现 04ba0000 的情况,请在上报 LBS 的 DP 信息的时候,去掉 0000。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x21 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回示例:
55 AA 00 71 00 1A 21 01 34 36 30 2C 30 30 2C 36 31 36 36 2C 32 37 35 35 36 31 33 30 2C 2D 37 35 5F
MCU 发送命令给 LZ211 模组控制 GNSS 电源。LZ211 模组内置 GNSS 芯片,GNSS 备用电源处于常供电,主电源属于可控制模式,主电源上电属于热启动。
GNSS 上电过程中,会加载 GNSS 固件,需要 4 秒左右。GNSS 关闭主电源后,重新打开电源后,需要重新启动 GNSS 定位功能(参考章节 启动或关闭设备 GNSS 定位功能)。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送命令查询 LZ211 模组的 GNSS 电源状态。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x22 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x15 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
获取是否启动 GNSS、Wi-Fi、LBS 定位功能。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x30 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0004 |
数据 | 4 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
由于 MCU 与模组属于一问一答交互方式,故 MCU 收到电话呼入提醒时,应予以答复,3 秒内 MCU 不做对应指令响应,呼入即被挂断。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N(电话号码) |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例如:55 aa 00 71 00 0D 23 00 31 35 38 39 30 39 38 36 37 36 37 F2
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
例如:55 aa 03 71 00 02 23 00 98
呼出返回成功仅代表指令下发成功。具体对方是否收到,需要通过电话状态查询。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N(电话号码) |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 03 71 00 07 23 01 31 30 30 38 36 9D
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 00 71 00 03 23 01 01 98
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 03 71 00 02 23 02 9A
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 00 71 00 03 23 02 00 9A
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 03 71 00 02 23 03 9B
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 00 71 00 03 23 03 00 99
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 03 71 00 02 23 04 9C
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 00 71 00 03 23 04 01 9B
在模组通话状态发生改变时,自动上报通话状态,避免反复查询通话状态占用资源。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
示例:55 aa 00 71 00 03 23 04 01 9B
设置 VOLTE 开关,打开时,支持 4G 模式下语音通话功能。否则,语音通话时,网络制式将自动切换到 2G。在 SIM 卡支持语音业务的情况下,如果运营商网络不支持 2G,需要打开此开关,才能支持通话功能。如果运营商网络同时支持 2G、4G 语音,用户可以自由选择是否开启 VOLTE。VOLTE 的开关设置掉电会保存。
LZxxx-CN 模组目前仅支持 4G 网络,系统默认开启 VOLTE。LZ211-EAU 模组同时支持 2G、4G 网络,系统默认开启 VOLTE。如果用户不希望开启 VOLTE,可通过该接口关闭 VOLTE 功能。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
用于实现 10086 之类的语音交互,语音提示后,用户操作按键,调用该接口将按键音频发送到语音通道,该函数只能在通话状态后调用,否则将调用失败。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | n |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | n |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002/0x0003 |
数据 | 2 | 子命令:Data[0] 子命令:0x46 查询命令:Data[1] 0 查询 设置设置命令: Data[1] 1 – 设置 Data[2] 设置值 0~30(0 静音) |
校验和 | 1 | 从帧头开始按字节求和得出的结果对 256 求余 |
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003/0x0004 |
数据 | 2 | 子命令:0x46 查询 命令: Data[1] 0 查询 Data[2] 0 失败 1 成功 Data[3] 设置值 0~30(0 静音) 设置命令: Data[1] 1 设置 Data[2] 0 失败 1 成功 |
校验和 | 1 | 从帧头开始按字节求和得出的结果对 256 求余 |
数据设置后会保存在 FLASH 中,在进入通话模式后,会根据设置的值自动设置增益到 MIC 驱动中。如果设置的时候在通话模式中会实时设置的 MIC 驱动中。
未设置会报查询失败。
示例:
查询命令:55 aa 03 71 00 02 46 00 BB
设置命令: 55 aa 03 71 00 03 46 01 10 CD
该命令需要在通话过程中才有效。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002/0x0003 |
数据 | 3 | Data[0] 子命令:0x47 查询命令:Data[1] 0 – 查询 设置设置命令: Data[1] 1 – 设置 Data[2] 0~100 |
校验和 | 1 | 从帧头开始按字节求和得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0004/0x0003 |
数据 | 3 | 子命令:0x47 Data[1]类型选择: Data[1] 0 查询 Data[2] 0 失败 1 成功 Data[3] 设置值 0~100 设置命令: Data[1] 1 设置 Data[2] 0 失败 1 成功 |
校验和 | 1 | 从帧头开始按字节求和得出的结果对 256 求余 |
数据设置后会保存在 FLASH 中,在进入通话模式后,会根据设置的值自动设置侧音增益到驱动中。如果设置的时候在通话模式中会实时设置到驱动中。
未设置会报查询失败。
示例:
查询命令:55 aa 03 71 00 02 47 00 BC
设置命令: 55 aa 03 71 00 03 47 01 05 C3
模组收到短信后,会主动上报给 MCU,MCU 接收到短信后,模组会把收到的短信删除。以防止 SIM 中短信满后,无法接收到新的信息。
如果不设置短信收发格式,收是默认 JSON 格式。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
上报的短信内容为 JSON 格式,其那 n
表示电话号码,t
表示时间,c
表示短信中的具体内容,编码格式为 GB2312。
如果不设置短信收发格式,发短信是版本 03 为 JSON 格式,版本 04 为 HEX 格式。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002+N |
数据 | 2+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
以中文短信发送 您好 为例:
55aa037100202401 7b226e223a223135383930393836373533222c2263223a22c4e3bac3227d A2
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
以中文短信发送 您好 为例:
55aa00710003240101 99
设置收发短信的编码方式。LZ211-EAU 模组的短信默编码是 UTF-8,CN 模组的短信默认编码均为 CP936。该设置掉电后失效。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x25 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x26 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
本功能是需要 SD 卡支持。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0004+N |
数据 | 4+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0005 |
数据 | 5 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x28 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
在本地音乐播放完成后,模组会主动上报播放完成的状态给 MCU。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
opt
:表示模式选择。支持 play
和 query
两种模式。
play
模式:蜂窝模组获取到音频后,直接由蜂窝模组播放。
timeout
字段表示从云端获取音频的超时时间。音频播放时间不包含在内。默认为 10s,最低不能低于 5s。query
模式:查询当前的 TTS 播放状态。当选择 query
的时候,context
和 timeout
字段可以不填。
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | N |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
result
result | 含义 |
---|---|
-7 | 语音服务器未连接 |
-6 | 参数错误 |
-5 | 文本编码错误 |
-4 | 网络异常 |
-3 | 设备忙 |
-2 | 获取失败 |
-1 | 超时 |
0 | 请求成功 |
1 | TTS 服务空闲中 |
2 | TTS 信息获取成功 |
3 | TTS 音频数据请求中 |
4 | TTS 音频数据下载中 |
5 | TTS 音频数据播放中 |
6 | TTS 音频数据请求失败 |
7 | TTS 音频数据下载失败 |
8 | TTS 请求超时 |
9 | TTS 音频数据播放完成 |
本功能是用来传输、控制一段内存音频数据。当前的模组支持最多 4 个音频 ID,每个音频 ID 最多 16K 字节。
音频数据保存在模组的内存中,设备重启就会丢失。随后,MCU 需要重新传输内存数据给模组。
增加音频数据的时候,单个传输包音频数据长度不能超过 1024 字节。
MCU 发送:
字段 | 长度(byte) | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 00009+N(增加音频数据)/0004(播放)/0003(删除、停止)/0002(查询) |
数据 | Data |
|
校验和 | 1 | 从帧头开始按字节求和得出的结果对 256 求余 |
控制字
控制字 | 组合内容 |
---|---|
1 | 音频 ID、音频格式、total_size 、offset 、音频数据 |
2 | 音频 ID |
3 | 音频 ID、端口 |
4 | 音频 ID |
5 | 无 |
模组返回
字段 | 长度(byte) | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0004/0x0005 |
数据 | 5 |
|
校验和 | 1 | 从帧头开始按字节求和得出的结果对 256 求余 |
状态值
含义 | |
---|---|
0 | 成功 |
1 | 超过限制 16K |
2 | 音频 ID 忙 |
3 | 内存音频 ID 存储已满 |
4 | 该音频 ID 不存在 |
5 | 该音频 ID 数据不完整 |
6 | 音频设备忙 |
7 | 该音频 ID 播放失败 |
8 | 单个数据包超过 1024 字节 |
示例
播放音频 ID
55 AA 03 71 00 04 49 03 01 00 C4
在设备注册后,可以启动或关闭蓝牙连接。默认启动蓝牙连接。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
启动或关闭电池供电情况下低电压关机功能,默认处于关闭状态。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
设备从云端获取二维码短连接后,主动发送给 MCU。该功能一般使用在有屏的设备且需要在屏幕上显示绑定二维码。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0001+N |
数据 | 1+N |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
用于模组网络在连续一定时间内,无法驻网、拨号成功,执行设备重启。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0001 |
数据 | 1 | Data[0] 子命令:0x98 |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组自动直接重启。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x71 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
针对新增模组外部唤醒管脚变化时进行配置。
目前使用 LZ501、LZ201、LZ211 已经默认配置,不需要使用此命令。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0003 |
数据 | 3 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
默认关闭,记录到 KV 存储中。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 | 子命令:0x9C
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
只支持 MA510 模组。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 子命令:0x9D |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组默认关闭,开启后会保存到 KV 存储。
MCU 发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0001 |
数据 | 1 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x72 |
数据长度 | 2 | 0x0002 |
数据 | 2 |
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
目前模组支持本地移除、App 移除、App 恢复出厂设置但是 MCU 没有办法知道模组这些
状态的通知这个服务用于有需要的用户打开模组状态通知。
MCU 发送
字段 | 长度 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x34 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 0x04(子命令) |
校验和 | 1 | 从帧头开始按字节求和得出的 结果对 256 求余 |
模组返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x34 |
数据长度 | 2 | 0x0002 |
数据 | 1 | 0x04(子命令) |
数据 | 1 | 执行结果:
|
校验和 | 1 | 从帧头开始按字节求和得出的 结果对 256 求余 |
设备重置状态 | 描述 | 状态值 |
---|---|---|
状态 1 | 模组本地重置 | 0x00 |
状态 2 | App 远程重置 | 0x01 |
状态 3 | App 恢复出厂重置 | 0x02 |
重置状态的发送最多也会重发两次,重发间隔保持 1 秒。
模组发送
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x00 |
命令字 | 1 | 0x34 |
数据长度 | 2 | 0x0002 |
数据 | 1 | 0x05(子命令) |
数据 | 1 | 重置状态:
|
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
MCU 返回
字段 | 字节数 | 说明 |
---|---|---|
帧头 | 2 | 0x55aa |
版本 | 1 | 0x03 |
命令字 | 1 | 0x34 |
数据长度 | 2 | 0x0001 |
数据 | 1 | 0x05(子命令) |
校验和 | 1 | 从帧头开始按字节求和,得出的结果对 256 求余 |
文档版本 | 修订说明 |
---|---|
1.1.0 |
|
1.0.20 |
|
1.0.19 | 增加升级状态通知 |
1.0.18 | 增加重置状态通知的命令 |
1.0.17 |
|
1.0.16 |
|
1.0.15 |
|
1.0.14 |
|
1.0.13 |
|
1.0.12 |
|
1.0.1 | LTE Cat.1 特有命令采用子命令方式:
|
1.0.0 |
|
该内容对您有帮助吗?
是意见反馈该内容对您有帮助吗?
是意见反馈