美的IoT开发者平台

# 接入前准备工作

由于选择的硬件接入方式不同，准备工作也不一样。开发者可根据接入方式章节（基于标准模组接入、基于模组SDK接入）的指引，选择性阅读该章节内容。

接入前准备工作列表：（*号表示相关）

序号 准备工作 描述 标准模组接入方式 模组SDK接入方式
1 平台产品信息配置 在开发者平台创建产品和配置产品信息 * *
2 申请SN SN作为设备唯一标识，由开发者平台生成，模组/SDK需要设置SN才能正常运行 * *
3 申请License License用于鉴别美的产品和安全需要 ，(由美的对接人申请) *
4 申请固件标识码 固件标识码用于构建固件版本号，用于模组OTA，(由美的对接人申请) *
5 申请模组SDK 填写SDK申请表并在开发者平台提交工单 *
6 家电端通信协议 美的M-Smart物联网家电中所使用的模组与家电端的通信协议 * *

说明：标准模组出厂前已烧录指定版本固件和License，因此不需要此类准备工作。

# 1. 平台产品信息配置

无论采用哪种硬件接入方式，均需在开发者平台配置产品信息，完成产品创建，配网指引配置等操作。

1.1. 创建产品

2.1.2. 云端配置

在开发者平台设置配网指引，美居APP在配网过程中会根据配网指引执行特定操作，设置方法见： 设置配网指引

# 2. 申请SN

SN是美的IoT云为每台设备分配的唯一身份识别，无论是产品开发、测试还是量产，都需要先将SN烧录到设备电控中，以便和云端交互

image-20200422142913572

SN的生成步骤如下：

(1) 选择一个产品

image-20200422142634474

(2) 进入SN管理

image-20200422142717339

(3) 申请新的SN

image-20250403105535123

(4) 根据业务理解填写申请信息

image-20250403105623426

(5) SN生成成功，点击下载

image-20250403105450117

# 3. 申请License

基于安全考虑，美的IoT模组规定需要烧录License。

美的IoT生产管理平台，又名License系统，可通过此系统申请到MAC地址及对应的License，已有MAC地址或IMEI也可通过此系统申请到对应的License。

需要生产IoT模组的事业部或模组供应商（后文都称为模组厂）需指派一个接口人对接License系统，其他人统一通过接口人申请License。

License系统管理员: lijm37@midea.com，可通过美信或邮件咨询License相关事宜。

# 4. 申请模组固件标识码

模组固件标识码是固件版本号的一部分，用于模组OTA，标准模组/SDK上传版本号给云端，由云端判断固件是否有更新。

注意，申请人需是美的员工，通常由产品经理或项目负责人申请，新固件标识码通过美的内部MIP系统发放给申请人。

4.1. 申请步骤

  1. 下载固件标识码申请表： 事业部固件标识码申请表.xlsx (opens new window)

  2. 填写申请表中的事业部申请信息栏，其中家电品类项推荐写法"品类码-产品名称"；若有多个产品固件版本需求，则按顺序添加到表格。

image-20250403095534065

  1. 通过邮件提交申请表，收件人：maill@midea.com，抄送：yech3@midea.com，fengxm6@midea.com

  2. 新固件标识码分配好后，通MIP系统发放，其中申请人参与审批流程，请及时审批。

    image-20250403101558967

4.2. 模组固件版本号格式说明

固定标识码作为固件版本号的前缀，用于区分不同产品固件，避免开发者平台上出现固件版本号重叠的情况。

完整的固件版本号如下图所示，开发者拿到新的固件标识码后，通过下面规则，定义固件版本号。

image-20250408152914100

Byte[0~2]: 对应固件标识码，此字段由美的AIRC管控，固件标识码相同，则表明软件可以互相替代，不影响基本功能与性能；

Byte[3-5]: 对应软件版本，开发者根据版本规则自行定义，比如若发布软件功能需要迭代升级，版本号在byte[3]字节上加1，初始版本从0x01开始累加；

Byte[6-8]: 对应开发记录小版本号，开发时用于标识不同代码版本，此字段不被云端OTA识别记录，即OTA服务器不会判断该字段以判断固件新旧，但是串口和网络端指令支持读取此信息；

电控及智能系统固件识别码规范可参考：固件OTA配置与发布

4.3. OTA固件打包工具

在使用模组OTA功能时，新固件需先使用美的专用的固件打包工具打包后，再上传到开发者平台中。

工具由美的内部对接人提供。

# 5. 申请模组SDK

当采用基于模组SDK接入方式时，需要填写SDK申请表，并在开发者平台提交工单，下面是详细操作步骤。

5.1. 填写申请表

  • 下载SDK申请表： 模组SDK需求文档模板-20250401.xlsx (opens new window)

  • 详细填写申请表中的项目信息，选择SDK方案并勾选想要的功能，填写步骤如下：(下面以WIFI_SDK方案为例，实际SDK申请表会不定时更新，截图供参考）

    • 填写基本信息页面，该页面通常由产品经理/项目负责人填写，在方案列表下拉框中勾选想要的方案，各项内容需详细填写（如产品名称、价值描述、需求时间）

image-20250402165404882

  • 填写方案页面，根据前面勾选的方案，填写相应的方案页面。填写前请仔细阅读示例和说明，特别是编译选项和编译参数的说明。最后在功能定制表中选择需要的功能，若无明确的特殊功能要求，请勾选默认值，默认值选择的是SDK基础功能，满足大部分产品要求。

image-20250402165631292

image-20250402171600934

5.2. 提交工单

在开发者平台填写并提交模组SDK申请工单，平台详细操作请参考： 如何提交工单 (opens new window) 。在填写信息页面中，填写详细的项目背景、芯片型号等信息，并把SDK申请表添加到附件。

image-20250402172642875

image-20250402173334517

5.3. 获取SDK及使用说明

SDK制作完成后，SDK和使用说明书等资料，将通过邮件发给该项目的事业部对接人。

# 6. 家电端通信协议

  • 《家电端通信协议》又称为电控串口协议，规定美的M-Smart物联网家电中所使用的模组与家电端的通信协议，家电开发人员按此文档开发通讯接口与模组进行通讯。

  • M-Smart串口调试工具，一款PC工具软件，支持《家电端通信协议》，用于把电脑模拟成家电电控，通过串口连接/控制美的IoT模组，可快速验证模组基础功能。

  • 拓扑图（以标准模组/WIFI_SDK/蜂窝SDK为例，BLE_SDK不适用）

    image-20250408150750044

6.1. 下载协议和工具

由美的内部对接人提供。

6.2. 串口调试工具使用方法

  • 用USB转串口工具把IoT模组连接到电脑

  • 打开M-smart串口调试工具

  • 选择串口号，波特率默认9600

  • 点击"打开串口'"，通常能收到模组上报的“SN请求”帧。

  • 发送命令：遵循《家电端通信协议》完成填写设备类型、消息类型、消息体，点击"计算"，然后点击"发送"

image-20210525144450054

6.3. 常用指令及用法示例

常用指令列表：

指令 指令码 用法示例
云端透传控制指令 0x02
云端透传查询指令 0x03
家电运行参数上报（无应答） 0x04
家电运行参数上报（需应答） 0x05
家电设备SN获取 0x07 上电后模组/SDK主动向电控请求SN
模组联网状态通知 0x0D 实时上报连蓝牙、连路由、连云端等状态，含连接过程错误码
模组入网方法切换 0x64 进入配网模式，起AP/BLE热点
模组重新启动 0x82
模组恢复出厂设置 0x83
家电型号及基本信息查询 0xA0
家电网络功能查询 0xE1

更多命令请参考M-Smart串口调试工具包中的《参考脚本.json》，或按照《家电端通信协议》构建。

用法示例： （后面将“模组/SDK”简称为“SDK”）

  • 模组/SDK上电后与家电端的指令交互流程：

    1. 07-请求SN指令：

      设备上电后，SDK开始运行，SDK周期性自动发送 07-请求SN指令给电控，并等待电控应答SN后，SDK才能继续执行之后的流程（流程阻塞）。

      SDK连续发送多次07指令后，若都没收到电控的应答，则调用适配层reboot接口来重启设备，以此往复，直到收到有效的应答帧。

      指令示例：

      SDK->家电：0xAA, 0x0B, 0xFF, 0xF4, 0x00, 0x00, 0x01, 0x00, 0x00, 0x07, 0x00, 0xFA

家电->SDK(应答): 0xAA, 0x2A, 0xFC, 0xD6, 0x00, 0x00, 0x00, 0x00, 0x00, 0x07, 0x30, 0x30, 0x30, 0x30, 0x46, 0x43, 0x32, 0x31, 0x31, 0x31, 0x38, 0x32, 0x37, 0x33, 0x36, 0x34, 0x35, 0x31, 0x37, 0x35, 0x30, 0x37, 0x32, 0x39, 0x42, 0x4B, 0x30, 0x36, 0x30, 0x30, 0x30, 0x30, 0x5A

    2. A0-家电型号及基本信息查询指令：

      SDK收到 07-请求SN应答后，继续发送 A0-家电型号及基本信息查询 指令，查询家电的基本信息。

      SDK连续发送3次后，若都没有收到电控的回复，则按SDK内部默认值继续执行其他流程。

      指令示例：

      SDK->家电：0xAA, 0x1E, 0xFC, 0xE2, 0x00, 0x00, 0x00, 0x00, 0x00, 0xA0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x64

家电->SDK(应答): 0xaa, 0x25, 0xfc, 0xd9, 0x00, 0x00, 0x00, 0x00, 0x02, 0xa0, 0x00, 0xfc, 0x08, 0x00, 0x16, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x4a

    3. 0D-模组联网状态通知指令：

      这是一条很实用的指令，当网络状态发送变化时，SDK主动发起0D指令通知家电端，比如蜂窝链路建立成功或失败、是否连上美的云服务中心及连接失败的原因、信号强度变化等；

      家电端需根据返回状态做相应的处理，比如收到 已连接美的云服务中心状态，此后，家电可以使用数据上报指令如 04/05指令，将家电数据发送给云端/美居APP。

      指令示例：

      SDK->家电：AA 1E AC B2 00 00 08 00 00 0D 01 03 00 01 01 A8 C0 00 01 01 00 00 00 00 00 00 01 00 00 00 FE 
家电->SDK: 无应答

  • 数据透传：

    1. 当SDK连接云端后，家电与云端/美居APP之间可通过SDK的数据透传相关指令交换数据，家电端可以主动发送数据帧给云端/美居APP，也可能收云端/美居APP主动发来的数据帧，且需要应答。

    2. 根据发起方不同，指令可分为2类：

      • 由云端/美居APP主动发起的：02-云端透传控制指令（需应答）、03-云端透传查询指令（需应答）。

      举例：用户在美居APP的空调页面上执行 打开空调，美居APP/云端将相关指令帧发送给SDK，SDK转发 02-云端透传控制指令给家电空调，家电端解析和处理该指令并应答SDK，SDK转发应答帧给云端/美居APP，美居APP提示用户空调打开成功或失败。

      • 由家电端主动发起的：04-家电运行参数上报（无应答）、05-家电运行参数上报（需应答）、06-家电异常事件上报（无应答）。

      其用法跟第1类类似，仅是发起方不同。

    3. SDK仅负责转发透传帧，不解析其内容。各家电实际控制协议（如开关机控制）、格式（lua、json、物模型）等内容均与SDK无关，由开发者自行开发。

最后修改于: 2025-04-27

← 1. 云产品接入流程 →