# 模组使用说明

# 一、术语表

术语	备注
模块	M-Smart无线模块，电控可通过该模块接入M-Smart智能家居系统
MSDK	M-Smart SDK，含M-Smart配网、局域网和广域网功能组件
电控	执行家电自身功能逻辑的处理器，若使用MSDK，则也可将电控功能集成到模块
SN	产品序列号，是物联网家电产品的唯一标识
电控型号码	电控型号码，由两个字节表示，见0xA0串口命令
7变3	AP配网流程优化功能

# 二、 拓扑结构

无线模块一方面通过UART通信接口与家电电控系统相连，这一侧称为家电端，或UART端。另一方

面，模块通过无线连接与路由器相连而加入局域网或广域网，也可通过AP直连方式与手机等移动终端连接，

这一侧称为网络端，在不引起歧义的情况下，也称为无线端。

​

# 三、 输入/输出接口

无线模块与家电端电控系统的通信采用标准的异步串行通信（UART）。UART通信配置：波特率9600 bit/s，数据位8位，校验位无，停止位1位，全双工。

无线模块输入电源分为5V、3.3V两种规格，其中5V为常用规格。

无线模块的调试接口为LOG_TX、LOG_RX，不同芯片方案的波特率会有所区别，常用的芯片及波特率

对应表如下。

序号	芯片	波特率（bps）
1	RTL8711AM	38400
2	RTL8710BN	115200
3	BK7231U	115200
4	MT7697D/N	921600

# 四、 通讯协议

无线模块与家电端通信的最小单元为数据包，或称数据帧，是按一定格式排列的多个字节组成的集合。

数据包的总长度应小于等于256个字节。

通讯协议详见《 无线模块M-Smart串口通讯协议 》。

# 五、模块软件功能

# 5.1、上电获取信息

模块上电后将获取电控信息，包含SN、型号代码、0XE1、0xE3（若支持第三方协议）和0xE5（若支持

第三方协议或使用MSDK）。

模块的上电流程图如下所示：

# 5.2、AP配网

# 5.2.1、SoftAP名称

设备名：midea_xx_YYYY

1）设备上电读取SN成功后，xx为品类码，YYYY为SN中第25~28byte

2）设备上电读取SN失败（10s内没有回复），设备重启。

# 5.2.2、SoftAP持续时间

通过0x64进入SoftAP，其持续时间为0xE1设定值（不带7变3）或固定10分钟（带7变3）；

电控不回复0xE1，上电默认起SoftAP，其持续时间为永久（不带7变3）或60分钟（带7变3）。

电控回复0xE1，则将0xE1设置值做为持续时间，但不可超过可支持的最大值。

# 5.2.3、配网流程

# 5.3、数据透传

# 5.3.1、概述

无线模块是网络端和家电端之间的桥梁，承担将一端的数据包转发到另一端的任务，此项功能称为数

据透明传输。数据透传时要求无线端数据包中的消息体符合UART端协议，因此，模块在转发数据前会先检

查消息体的合法性。

# 5.3.2、从网络端到家电端的数据透传

对应的串口消息类型：

0x02：设备控制

0x03：设备查询

0xA0：家电型号代码查询

家电端接收到此类请求命令后，需在1秒内进行应答，否则模块将做超时丢弃处理。

家电端应答的合法性须同时满足以下条件：

l 应答帧符合UART端数据包格式；

l 应答帧的消息类型标识 = 请求帧的消息类型标识；

l 应答帧的消息标识 = 请求帧的消息标识。

# 5.3.3、从家电端到网络端的数据透传（要求应答）

对应的串口消息类型：

0x05：设备运行参数上报（需应答）

0x0A：设备异常事件上报（需应答）

# 5.3.4从家电端到网络端的数据透传（无需应答）

对应的串口消息类型：

0x04：设备运行参数上报（无需应答）

0x06：设备异常事件上报（无需应答）

# 5.4 局域网

支持的功能为：设备发现、设备控制和设备状态同步。

# 5.4.1、设备发现

模块侦听局域网内手机发出的UDP设备发现广播包，并做UDP单播应答，App可根据接收到的应答包

判断当前网络是否存有美的智能家电。

# 5.4.2、设备控制

模块做为TCP Server可接受来自局域网手机App的TCP连接，从而实现App在局域网内对设备的

功能。

# 5.4.3、设备状态同步

模块可将设备状态报文上报给局域网内所有的TCP Client，从而保证App与设备状态的同步。

# 5.5、广域网

支持的功能为：云端登陆认证、远程控制设备和设备状态同步。

# 5.5.1、云端登陆认证

设备登陆到服务器，并完成在服务器的安全认证。该功能为家电可以被远程控制，并将设备状态同步到

远程控制端的先决条件。

# 5.5.2、远程控制设备

远程控制端可以通过服务器向设备下发控制指令，并接收设备的应答报文。

# 5.5.3、设备状态同步

模块可将设备状态报文上报给服务器，服务器将此信息推送到相应的远程控制端。

# 5.6、自检

电控可通过0x16命令触发模块进入自检模式。

单无线自检模式：模块扫描固定的路由SSID，并通过串口命令0x0D将自检结果通知电控；

单无线+BLE自检模式：模块扫描固定的路由SSID和BLE名称，并通过串口命令0x0D将自检结果

通知电控。

退出自检的方式为断电。

# 5.7、服务器指向

模块与App均分SIT测试平台与PRO生产平台，新开发的产品需先在SIT测试平台测试通过之后，才

可转PRO生产平台。

# 5.8、OTA

无线模块支持局域网和广域网OTA功能。

局域网OTA功能使用的协议为TFTP或HTTP，其中2017之后开发的新模块均采用HTTP。升级包文件

名命令固定为“ota_appliances.bin”。

# 附：串口指令集

电控需支持的串口指令集：

* 指令类型*	* 序号*	* 指令*	* 说明*
设备主动上报云端命令集	1	0X04	可与0x06选其一
2	0X05	可与0x0A选其一
3	0X06	可与0x04选其一
4	0X0A	可与0x05选其一
5	0X61	电控决定
设备查询无线模块配置命令集	1	0X13
2	0X87
3	0X63
通讯模块工作模式切换命令集	1	0X64
2	0X82
3	0X83
4	0X84	选配[linkkit/京东支持]
5	0X14
家电配置查询与写入命令集	1	0X07	与0x65选其一
2	0X65	与0x07选其一
3	0XE1
4	0XA0
5	0XE3	选配[京东支持]
6	0XE5	选配 [linkkit/京东/MSDK支持]
7	0X18	选配[linkkit支持]
云端透传查询与控制命令集	1	0X02
2	0X03
模块状态上报给设备命令集	1	0X0D
2	0X0E	7变3支持