当前位置：首页 > news >正文

Onenet_ESP32移植手册

news 2025/10/27 15:27:44

Onenet_ESP32移植手册

本手册为读者移植我们的Onenet组件的一些方法，如有不对的地方，请包含与谅解！

————by wsoz/OHB666

Onenet组件库

进入到我工程的 sample_project\components\onenet_esp32将整个组件移植到自己的工程同时需要将my_wifi组件一起移植为我们提供wifi连接，然后需要注意的是组件中的tm_user.c和tm_user.h需要替换为自己产品设备的特定文件，具体方法如下：

下载官方的SDK，然后解压出来替换我原本工程中的SDK即可

在这里插入图片描述

Onenet数据连接和上传

此处可以进入到我们的一个应用层main\myapp中的文件，将my_wifi_app以及my_onenet文件移植到自己工程，前者提供的是wifi的连接功能，后者主要为我们提供Onetnet的相关操作。

配置：

修改my_onenet.c文件中宏定义替换自己的产品密钥等
进入menuconfig配置我们的wifi初始化项

我目前在my_wifi_app中实现的就是数据上行，主要依靠一个发送线程来实现，目前我写了一个temperature的模型上云进行操作，后续如果在自己工程中不同的可以自己修改，如果有多个数据需要上云的话，我推荐多开线程进行处理以适应不同模型数据上云的频率。

然后对于相关的数据发送频率等我们也可以在文件修改

#define CONNECT_TIMEOUT         30000     // 连接超时时间 (增加到30秒)
#define SEND_TIMEOUT    1000   // 数据发送时间

然后对于其中的一些Onenet应用层API如果不懂得可以自行在查询官方文档，我这里只作简介

设备上线

int32_t tm_login(const char *product_id, const char *dev_name,const char *access_key, uint64_t expire_time,uint32_t timeout_ms)

创建模型实例

void *tm_data_create()

为模型赋值

int32_t tm_data_set_float(void *data, const int8_t *name, float32_t val,uint64_t timestamp)
int32_t tm_data_set_int32(void *data, const int8_t *name, int32_t val,uint64_t timestamp)
int32_t tm_data_set_bool(void *data, const int8_t *name, boolean val,uint64_t timestamp)

数据上传

int32_t tm_post_property(void *prop_data, uint32_t timeout_ms)

Onenet接收命令

对于接收命令，我们无需额外的一个接收线程，Onenet的架构会自动处理云端的下发，通过回调函数的形式进行触发，这也是我为什么在开头需要让你们替换tm_user.c和tm_user.h的原因。

进入到我工程的代码里可以看见我云端定义的一些物理模型全都通过回调函数的形式进行了触发。我的工程目前就是实现的接收云端上下发的设置物理模型期望值。

int32_t tm_prop_temperature_wr_cb(void *data)
{// 增强调试信息 - 检查数据指针有效性if (data == NULL) {ESP_LOGE("TM", "rec:temperature: data pointer is NULL!");return -1;}// 正确的cJSON解析方式// OneNET SDK传递的是cJSON对象，需要解析其中的value字段float64_t temp_value = 0.0;// 检查是否是cJSON对象格式if (((cJSON *)data)->type == cJSON_Object) {cJSON *value_item = cJSON_GetObjectItem((cJSON *)data, "value");if (value_item != NULL) {temp_value = value_item->valuedouble;ESP_LOGI("TM", "rec:temperature: parsed from cJSON object value = %.6f", temp_value);} else {ESP_LOGE("TM", "rec:temperature: cJSON object has no 'value' field!");return -1;}} // 打印cJSON对象信息ESP_LOGI("TM", "rec:temperature: cJSON type = %d, string = %s",((cJSON *)data)->type,((cJSON *)data)->string ? ((cJSON *)data)->string : "NULL");ESP_LOGI("TM", "rec:temperature: Final parsed value = %.6f", (float32_t)temp_value);return 0;
}