智能家居开发与设计 01—氦氪 WiFi模块操作演示.pdf

《从零开始学智能家居开发01》-氦氪WiFi模块操作演示

目录：

1、准备工作第2页

2、产品协议第4页

3、操作指令第5页

4、设备演示第11页

5、注意事项第17页

注意：如果你拿到的模块在配网之后，发现设备控制页面和本教程不一样，请参考新版氦氪

通用演示产品使用说明书。

氦氪WiFi模块发货的时候，里面都会默认写入一个产品的PK，这个产品就是氦氪通用演

示。这个产品的功能很简单，就是给大家演示使用氦氪云平台收发数据，在其页面上可以动

态的改写通信协议，根据通信协议生成页面组件。开发者只需要根据通信协议写MCU端的

代码，就可以完成一个简单的物联网作品了。

准备工作：

1.根据氦氪模块硬件说明文档接线，本实验是将模块的串口接到USB转串口模块，然后在

PC端上使用串口助手做收发数据测试。文档中提到的外接WiFi指示灯和按钮是可选的，

因为在我们模块上就有一颗LED是做为WiFi指示灯用的，外接按钮的作用是触发模块进入

配网模式，可以使用串口下发指令4807FE00040051让模块进入配网模式。

2.下载氦氪的官方APP丛云，注册账号，登录APP。

3.模块上电之后，会自动进入WiFi指示灯两秒闪一次的配网状态，然后在APP上添加设备

（根据UI上的提示做就可以，具体步骤在此省略）。

4.设备添加成功之后，会在设备列表页出现一个名为“开发板”的设备，点击该图标进入设

备控制页面。

在console平台氦氪通用演示的产品协议页面如下图所示：

为了通用化，我们设计了4个4字节无符号整数作为参数，这样我们就有了16个字节可以

作为业务数据，命令我们只设计了两种，一种是表示设备上报数据，另外一种是表示APP

下发数据。在设计产品协议的时候，比照面向对象的程序设计方法，参数就相当于对象的属

性，而命令就相当于对象的方法，这里的方法又分为两大类，一类是设备主动发起的，即帧

类型为上报帧，另一类是APP主动发起的，即帧类型为下发帧。

默认的控制页面对应的通信协议如下图所示：

在页面底部的导航栏点击“编辑”可以进入协议编辑页面，在这个页面可以清楚的看到业务

数据中每个字节对应的功能和在“演示”页面中显示的标识名称，在这个页面可以添加和删

除状态和“操作”，点击每行最后面的那个红色图标即可将本行内容删除。添加和删除

状态和“操作”之后必须点击页面右上角的“对号”图标使修改生效。

这里的“命令”指的是协议帧中的第6个字节里的值，取值范围是1~255，“指令”/“指

令位”的取值范围是7~21。

当“命令”的值为“00”时，代表设备上报当前状态，或者APP查询设备的当前状态，不

用在这里手动设定。

操作组件类型及取值：

非回弹式按钮：01:打开开关，02:关闭开关，00:保持不变

回弹式按钮：01:按钮触发，00:保持不变

档位调节式按钮：01:档位1，02:档位2，03:档位3，00：保持不变

滑动条：[0x01,0x64]表示1%-100%，00：保持不变，调节精度为1%

在页面底部的导航栏点击“调试”可以进入串口数据透传收发页面，在“下发”编辑栏中填

写业务数据即可，不用填写整个协议帧。点击“下发”这行后面的红色图标可以清空该行编

辑框中的内容，点击红色图标后面的蓝色圆圈图标会将编辑框中的数据发送给设备；点击

“上传”这行后面的红色图标可以清空该行编辑框中的内容，点击红色图标后面的蓝色圆圈

图标会显示或隐藏下面的数据收发记录。

实际操作示例：

使用串口助手时需要设置16进制显示和16进制发送。

进入设备控制页面：

此时控制页面会下发一个设备当前状态查询帧，即协议帧的第6个字节为00。

设备收到：48160201020000000000000000000000000000000063

设备应答：48160201020000000000000000000000000000000063

设备上报当前状态（见备注1示例）

点击开关1：

设备收到：48160202020101000000000000000000000000000066

设备应答：48160202020101000000000000000000000000000066

设备上报当前状态（见备注1示例）

点击开关2：

设备收到：481