API 说明

初始化

OneNET 初始化

int onenet_mqtt_init(void);

OneNET 初始化函数，需要在使用 OneNET 功能前调用。

设置命令响应函数

void onenet_set_cmd_rsp_cb(void(*cmd_rsp_cb)(uint8_t *recv_data, size_t recv_size, uint8_t **resp_data, size_t *resp_size));

设置命令响应回调函数。

数据上传

mqtt 上传数据到指定主题

rt_err_t onenet_mqtt_publish(const char *topic, const uint8_t *msg, size_t len);

利用 mqtt 向指定 topic 发送消息。

mqtt 上传字符串到 OneNET

rt_err_t onenet_mqtt_upload_string(const char *ds_name, const char *str);

利用 mqtt 向 OneNET 平台发送字符串数据。

mqtt 上传数字到 OneNET

rt_err_t onenet_mqtt_upload_digit(const char *ds_name, const double digit);

利用 mqtt 向 OneNET 平台发送数字数据。

mqtt 上传二进制文件到 OneNET

rt_err_t onenet_mqtt_upload_bin(const char *ds_name, const uint8_t *bin, size_t len);

利用 mqtt 向 OneNET 平台发送二进制文件。会动态申请内存来保存二进制文件，使用前请确保有足够的内存。

mqtt 通过路径上传二进制文件到 OneNET

rt_err_t onenet_mqtt_upload_bin_by_path(const char *ds_name, const char *bin_path);

利用 mqtt 向 OneNET 平台发送二进制文件。

http 上传字符串到 OneNET

rt_err_t onenet_http_upload_string(const char *ds_name, const char *str);

利用 http 向 OneNET 平台发送字符串数据，不推荐使用，推荐使用mqtt上传。

http 上传数字到 OneNET

rt_err_t onenet_http_upload_digit(const char *ds_name, const double digit);

利用 http 向 OneNET 平台发送数字数据，不推荐使用，推荐使用mqtt上传。

信息获取

获取数据流信息

rt_err_t onenet_http_get_datastream(const char *ds_name, struct rt_onenet_ds_info *datastream);

从 OneNET 平台获取指定数据流信息，并将信息保存在 datastream 结构体中。

获取最后N个数据点信息

cJSON *onenet_get_dp_by_limit(char *ds_name, size_t limit);

从 OneNET 平台获取指定数据流的 n 个数据点信息。

获取指定时间内的数据点信息

cJSON *onenet_get_dp_by_start_end(char *ds_name, uint32_t start, uint32_t end, size_t limit);

从 OneNET 平台获取指定数据流指定时间段内的n个数据点信息。时间参数需要填入Unix时间戳。

获取指定时间n秒的数据点信息

cJSON *onenet_get_dp_by_start_duration(char *ds_name, uint32_t start, size_t duration, size_t limit);

从 OneNET 平台获取指定数据流指定时间后n秒内的n个数据点信息。时间参数需要填入Unix时间戳。

设备管理

注册设备

rt_err_t onenet_http_register_device(const char *dev_name, const char *auth_info);

向 OneNET 平台注册设备，并返回设备 id 和 apikey。设备id 和 apikey 会调用 onenet_port_save_device_info交由用户处理。

保存设备信息

rt_err_t onenet_port_save_device_info(char *dev_id, char *api_key); 

保存注册后返回的设备信息，需要用户实现。

获取设备注册信息

rt_err_t onenet_port_get_register_info(char *dev_name, char *auth_info);

获取注册设备需要的信息，需要用户实现。

获取设备信息

rt_err_t onenet_port_get_device_info(char *dev_id, char *api_key, char *auth_info);

获取设备信息用于登陆 OneNET 平台，需要用户实现。

设备是否注册

rt_bool_t onenet_port_is_registed(void);

判断设备使用已经注册，需要用户实现。