RT-Thread-新版OneNet的星火1号开发板例程适配（上）RT-Thread问答社区

新版OneNet的星火1号开发板例程适配（上）

发布于 2025-05-19 17:22:19 浏览：590 订阅该版

[tocm]

OneNet平台更新后，许多操作都发生了变化，导致星火1号的开发板例程也需要变化，今天我们基于原有例程做少量修改，来适配新版OneNet平台。

# 创建例程

![1.png](https://oss-club.rt-thread.org/uploads/20250519/743fa6c22302641d728a8ac36bc71a4d.png.webp)
根据图上顺序依次点击后进入项目创建窗口。

![2.png](https://oss-club.rt-thread.org/uploads/20250519/b2f95dd047358d4007135ee41dc89b1c.png)
按照图中依次选择，点击完成即可创建基于星火1号开发板的OneNet例程。

# 创建云平台设备

![3.png](https://oss-club.rt-thread.org/uploads/20250519/72e954fd109757e03b577b56e35c628a.png)
来到OneNet物联网平台完成登录后，点击右上角“开发者中心”。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/d5f2edcae39126395fc0ba6f924279a3.png.webp)
点击左上角的“产品开发”，再点击右上角的“创建产品”。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/8435edf2a3e66a778c6afcce2784eedc.png.webp)
进入“创建产品”界面后，产品品类随意填写，智能化方式选择“设备接入”。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/954a880f4e3d8bc049c3d275c9736506.png)
除了“产品名称”和“所属城市”，其他都需要按照图上选择。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/b0226bfd6f43835a63fffc186ea15bb6.png)
创建完成后，点击右边的“产品开发”操作。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/7e9f081588577d97da52f27011f5d622.png.webp)
点击“设置物模型”进入配置。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/c616c18d66c61349794bec6f0fc09d2f.png)
点击“添加自定义功能点”。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/d12eb752c571d5be3238b22629d50dfe.png)
参考上图来创建，注意：“标识符”与“数据类型”必须与设备端保持一致。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/aa8c0ad21d6077fdfb0e6d1714bb485a.png)
随后添加控制板载LED功能点。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/797029839535cef362f1fd3276be0bec.png)
完成后点击保存即可发布到产品。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/438345d248fa9bfc02b553d1c8f71ceb.png.webp)
回到“产品开发”页面，点击右侧“设备管理”。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/bb6f7d770e9b9a1a8e5fa17364b4af48.png.webp)
点击右侧“添加设备”。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/4dc6d1bcef6ea4e816402fd11a5d9a44.png.webp)
填入名称后点击确定即可完成创建。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/506d56909b8c85bdd5e8db0874b6ec77.png.webp)
点击右侧“详情”进入设备详细页面。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/7f28b3ecef5c4b058ffa32c99f734195.png.webp)
来到gitee页面下载token工具，链接地址如下： https://gitee.com/RT-Thread-Mirror/onenet/blob/1.2.0/tools/token.exe

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/63fbb2e9b6f01237b670a3258ca7eb2f.png.webp)
打开token工具，依照图上来填入信息，随后点击“Generate”进行生成。
注意：et要填写一个大一点的时间戳来防止失效。

# 例程文件修改

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/dacc2cc5e5ef91869c4cc24cb2a18803.png.webp)
回到RT-Thread Studio，双击例程的RT-Thread Settings，随后选择OneNet软件版的配置项。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/8cf2a2d1e45e88dcb58db657eacf90d3.png)
下滑到此处，将框中信息更新，“身份验证信息”留空，按下Ctrl+S保存到工程中。
注意：版本务必切换成latest来下载最新版软件包。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/727049f5a56f086c6b6d691a9a6c3387.png.webp)
双击左侧工程中的rtconfig.h，可以看到信息都已经更新完毕，手动将生成的token复制到文件中。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/c5c9c1793c0d576a64eaf4433f5827ae.png)
在右侧项目资源管理器中依次点开packages/onenet-latest/src文件夹，双击onenet_mqtt.c文件，找到mqtt_usr_callback函数进行编辑。
具体代码如下：
```c
static void mqtt_usr_callback(MQTTClient *c, MessageData *msg_data)
{
    LOG_D("Enter mqtt_usr_callback!");

// 打印接收到的主题和消息
    LOG_D("topic %.*s receive a message",
        msg_data->topicName->lenstring.len,
        msg_data->topicName->lenstring.data);
    LOG_D("message: %.*s",
        msg_data->message->payloadlen,
        (char*)msg_data->message->payload);

// 检查是否是属性设置命令
    if (strstr((const char*)msg_data->topicName->lenstring.data, "/thing/property/set"))
    {
        // 解析JSON
        cJSON *root = cJSON_Parse((const char *)msg_data->message->payload);
        if (!root) {
            LOG_E("Invalid JSON");
            return;
        }

// 获取params中的LED命令
        cJSON *params = cJSON_GetObjectItem(root, "params");
        if (!params) {
            LOG_E("No params field");
            cJSON_Delete(root);
            return;
        }

cJSON *led = cJSON_GetObjectItem(params, "LED");
        if (!led || !cJSON_IsString(led)) {
            LOG_E("No valid LED field in params");
            cJSON_Delete(root);
            return;
        }

// 获取LED命令字符串 - 例如"00 01"
        char *led_value = led->valuestring;
        LOG_D("LED command: %s", led_value);

uint8_t recv_data[2] = {0};

// 手动解析字符串
        if (strlen(led_value) >= 4 && led_value[2] == ' ') {
            // 解析第一个字节 (例如 "00")
            char byte1[3] = {led_value[0], led_value[1], '\0'};
            // 解析第二个字节 (例如 "01")
            char byte2[3] = {led_value[3], led_value[4], '\0'};

recv_data[0] = strtol(byte1, NULL, 16);
            recv_data[1] = strtol(byte2, NULL, 16);

LOG_D("Parsed LED command: %02x %02x", recv_data[0], recv_data[1]);

// 准备响应数据的指针
            uint8_t *resp_data = NULL;
            size_t resp_size = 0;

// 调用现有回调函数处理命令
            if (onenet_mqtt.cmd_rsp_cb) {
                onenet_mqtt.cmd_rsp_cb(recv_data, 2, &resp_data, &resp_size);
            }

// 释放资源
            if (resp_data) {
                ONENET_FREE(resp_data);
            }
        } else {
            LOG_E("Invalid LED command format");
        }

cJSON_Delete(root);
    }
}
```

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/1820b177d6755f6cc924ae74883b649e.png)
完成后编译并烧录到星火1号开发板中。

# 功能调试

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/451d66e1caa6cf84598bc6f97f1f6b7b.png)
点击工具栏的窗口并打开终端。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/6e010e42808cba6af5c576232b051c74.png.webp)
下方已经打开终端，点击右侧图标打开串口。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/1b7dc010dbb16c19ff4a792a9720b48a.png)
确认端口与波特率无误后点击确认即可打开。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/5f6c29c2d907717d4f0fbff68b1e7efe.png)
信息都已在终端窗口中打印，单击Enter键调出msh，如图输入命令“wifi join (WiFi名称) (WiFi密码)”。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/0ed47e90f511863c1241ce500be2d375.png)
再输入命令“mqtt_online_callback”，打印出的信息显示连接成功。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/aac4e713451c33657431fc92e99d6baf.png.webp)
回到OneNet平台，此时设备已经显示在线。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/825b0560e42751aa7897b9e6db85d6dd.png.webp)
输入命令“onenet_set_cmd_rsp”，终端没有打印返回信息，但是星火1号开发板上的LED已经被点亮。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/66afbab2f829f0be79d9059f5456b8cd.png)
回到OneNet平台设备界面，按照上图依次点击。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/773270e71a675e6e5c64339dc63e2e2c.png)
在LED控制功能处输入“01 01”，然后点击下方属性设置，将命令从云平台发送到设备终端。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/06f30ed7bc3d9ca6771661961ec99235.png.webp)
可以看到星火1号开发板上的LED从橙色变成了黄色，说明红色LED已经成功关闭。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/4dc26d13aad5fae1434f6628ba7ce333.png.webp)
再次发送“00 01”，黄色LED也被关闭。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/8b3ae41d3544a28131f565fb19a067cf.png.webp)
发送“01 00”，红色LED被打开。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/4582d17f78f6560e6dbf3fc62c49b878.png)
回到RT-Thread Studio的终端窗口，输入命令“onenet_upload_cycle”，温度数据已经开始上传。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/7799178bdee5ea7c22f097d260be31e4.png)
在OneNet云平台设备界面点击“属性”，可以看到温度数据已经获取到，再点击属性栏右上角的“历史数据”。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/43d135a0a1cd127b8cc1904c5660aa34.png.webp)
历史数据已经图表化显示。

至此，例程中的基本功能都已经调试完毕。

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250519/59b54ade4f2c8d2600abe68a8bfef1e6.png)
但是，新版OneNet要求设备每次收到指令都要返回消息，不然就会像上图这样，每次发送命令都报返回信息错误，而且在等在设备回复期间无法进行连续指令下达。
下一篇，我们就来着手解决这个问题，并且接入星火1号开发板上的AHT10外设，来传输实时温湿度数据。

后续已更新：https://club.rt-thread.org/ask/article/4f0e54302d0d614e.html