# FogCloud 小程序标准产品开发体验指南

# 1. 前言

为方便开发者更快速地一站式开发智能硬件应用，FogCloud 推出了应用（小程序）开发功能。

目前支持微信小程序，后续将进一步支持手机 App、其他系统小程序（支付宝/钉钉/字节跳动）等平台。

本文将介绍如何在 FogCloud 平台和微信小程序中，从零配置一个标准产品的全流程。

说明：标准产品指在云端创建产品时，选择品类模板中已具备完整物模型定义的产品，且产品小程序 UI 已设计并固定，客户无法自行修改的产品。如：品类模板中的智慧生活——>环境电器——>除湿器，即为标准产品。目前支持的标准产品包括：除湿机、净水器、空气净化器。

# 2. 准备

一个 FogCloud 开发者账号 (opens new window)
一个庆科 YAT 模组MXKit (opens new window)开发板，可联系庆科商务申请，获取开发板资料 (opens new window)。
- 若您手上没有开发板，也可直接使用 YAT 模组，焊接电源和串口调试线，连接串口小板调试使用。
一个 PC 机（操作系统： Windows 或 MacOS 均可）
- 安装模组 YAT 调试工具软件： YAT 调试助手 (opens new window)
- 安装模组串口通信驱动软件：USB to UART 驱动 (opens new window)

一个手机（苹果 iOS 或者安卓 Android 均可)
- 一个微信普通账号（用于测试 FogCloud 小程序配网调试功能）

# 3. 开发流程

开发过程涉及三端的操作及交互，包括：FogCloud云端、庆科模组端和微信小程序端。

FogCloud 云端（5 步）

模组端（5 步）：

小程序端（4 步）：

# 4. Fog 云端

# 4.1. 创建项目

# 4.2. 创建标准产品

在项目中创建一个产品，如图：

其中，品类模板采用标准物模型定义，如图：

# 4.3. 添加设备

进入产品的“设备管理”页面，点击右上角“添加设备”，可手动添加调试设备。如图：

选择“所属产品”后“备注名称”，并确认。如图：

接着在“设备列表”中，点开"设备证书" 页面，“一键复制”备用，在模组端写入"设备证书"时使用。

# 4.4. 添加 APP

左边栏“应用”中，点击进入“APP 管理”页面，点击“添加 APP”。

自定义 APP 名称和选择行业分类后确定，如图：

添加完成 APP 后，需为 APP 添加产品，如图：

# 4.5. 配置 OAuth

使用以下 APPID 和 APPSecret，配置 OAuth 参数，如图：

AppID(小程序 ID):wx3fb32254820b8205

AppSecret(小程序密钥):213220f3410c6878121b5b0ac42f69b3

以上，Fog 云端配置完成。

# 5. 模组端

# 5.1. 连接 PC

将 MXKit 开发板或模组，连接至 PC。

开发板通过 USB 线连接，模组焊线后通过串口小板连接。如图：

开发板直接连 PC（左图）模组焊线接串口小板（右图）

# 5.2. 新建项目

在 yat-tools 软件中，新建项目，如图：

# 5.3. 打开串口

注意：请确保 PC 已安装串口驱动。

如成功安装驱动，PC 插入模组后，在设备管理器中会出现 COM 端口。

使用开发板，选择“Standard”串口。使用模组焊线+串口小板，使用仅有唯一的 COM 串口。如图：

PC 机设备管理器中，查看串口号，yat-tools 中下拉选择，如图：连接 COM3，可一键重启模组，查询固件号。

# 5.4. 写入证书

在 FogCloud 端获取的设备证书，写入"配置"框中，点击“设置”，即可一键写入证书，如图：

# 5.5. BLE 配网

在 yat-tools 中，设置超时时间为 0，默认无超时时间，点击 “蓝牙配网”，模组即进入等待配网状态，如图：

以上，模组端配置完成。

# 6. 小程序端

# 6.1. 打开小程序

微信扫描二维码，登录 FogCloud 小程序。

# 6.2. 环境切换

在云端，找到应用 ——> APP 管理 ——> MX 除湿机 APP 的二维码。如图：

在小程序“我的”页面中，点击左上角"扫一扫"，一键切换 APP 环境，保存生效。

“保存”后，点击页面中间的 "添加设备”，会自动退出登录状态。此时，需重新登录小程序。如右图。

# 6.3. 添加设备

小程序中，点击 + “添加设备”，开始搜索附近的设备。

发现设备：

设备配网：

房间分配：

至此，设备添加完成。

# 6.4. 控制设备

点击设备，进入控制页面，如图：

可设置模式、童锁、开关。

# 7. 调试设备

云端、设备端和小程序端，，三端的交互调试，如下：

# 7.1. 小程序下发调试

小程序设置，查看：云端是否有设备下发数据？设备串口是否有收到数据？

如图：

小程序设置如图：设备串口数据如图：

云端上报数据如图：

# 7.2. 设备端下发调试

设备端设置，查看：小程序页面是否有状态变化？云端是否有设备上报数据？

如图：设备串口发设置指令。

小程序设备状态如图：云端上报数据如图：

# 7.3. Fog 云端下发调试

云端设置，查看：小程序页面是否有状态变化？设备串口是否有收到数据？

如图：