13.腾讯云物联网设备端学习---数据模板功能及实现

2021-10-24 20:30:50 浏览数 (2)

本系列主要目的在于记录腾讯云物联网设备端的学习笔记,并且对设备端SDK进行补充说明。

简介

数据模板相关概念和消息格式在之前的文章中已经介绍过了,这里不再赘述,请参见数据模板

数据模板设计如下:

数据模板设计与实现数据模板设计与实现

设计思路

根据数据模板协议,分为5个文件:

  • data_template_mqtt.c:实现mqtt相关功能,如订阅,取消订阅,发布等。
  • data_template_client.c:实现对外API接口
  • data_template_property.c:包含属性下行以及上行处理
  • data_template_event.c:包含事件下行以及上行处理
  • data_template_action.c:包含行为下行以及上行处理

上行消息

主要通过publish进行发送,这里不做赘述。其中属性会涉及到多种上行消息,这里可以通过联合类型来统一接口:

代码语言:javascript复制
typedef union {
 const char *json;
 int code;
 struct {
 int code;
 UtilsJsonValue client_token;
    } control_reply;
} PropertyPublishParams;

下行消息

其中,每个不同topic(property/event/action)将注册一个context用作管理下行消息的上下文,设计如下:

代码语言:javascript复制
typedef struct {
 union {
 PropertyMessageCallback property_callback;
 EventMessageCallback event_callback;
 ActionMessageCallback action_callback;
    };
 void *usr_data;
} DataTemplateContext;

主要包括相应的回调以及回调需要使用的用户数据,这里使用了联合类型,从而避免了出现过多的形参类型。

内存优化

重构前的版本,在使用中,由于每次json解析都是动态申请来传递节点,对于资源受限的设备将带来很大的内存消耗和开发上的困难。

相比于重构前的版本,该版本主要对json库进行了改造,将相应的消息传递给上层时,采用指针 长度的方式替代了之前的动态申请的方式,从而降低了内存。原因如下:

  1. 实际应用中,大部分消息在回调中就被消耗完了,所以完全可以利用mqtt包本身的存储空间
  2. 在处理字符串数据的时候,目前CI工具推荐使用安全函数如(strncpy等),所以使用指针 长度更为方便
  3. 对于回调结束后保留的数据最好交给用户处理,而不是sdk内部申请来释放,从而减少内存泄漏风险

具体实现可以参见utils_json_value_get

0 人点赞