跳到主要内容

时间序列使用指南

about

时间序列是 ESP RainMaker 的一个功能，能够随时间记录和存储带有时间戳的数据点。这允许用户跟踪温度、湿度或能耗等参数的变化，实现历史分析和趋势监控。

要了解有关时间序列及其变体的更多信息，请查阅此文档。

使用指南​

启用时间序列​

要使用时间序列数据，只需在创建 RainMaker 参数时，在 properties 中包含 PROP_FLAG_TIME_SERIES （全功能时间序列） 或 PROP_FLAG_SIMPLE_TIME_SERIES （简单时间序列） 标志。

例如
esp_rmaker_param_t *param = esp_rmaker_param_create("Temperature", ESP_RMAKER_PARAM_TEMPERATURE,
             esp_rmaker_float(15.5), PROP_FLAG_READ | PROP_FLAG_TIME_SERIES);
esp_rmaker_param_t *param = esp_rmaker_param_create("Mode", ESP_RMAKER_PARAM_MODE,
             esp_rmaker_int(1), PROP_FLAG_READ | PROP_FLAG_SIMPLE_TIME_SERIES);

将这些参数添加到设备后，相应的节点配置将如下所示（请注意 properties 字段）：

[
    {
        "name": "Temperature",
        "type": "esp.param.temperature",
        "data_type": "float",
        "properties": [
            "read",
            "time_series"
        ]
    },
    {
        "name": "Mode",
        "type": "esp.param.mode",
        "data_type": "int",
        "properties": [
            "read",
            "simple_ts"
        ]
    }
]
重要说明

请使用 esp_rmaker_param_update_and_report() 同时更新参数的瞬时值和时间序列值。

技术详情​

要查看这些时间序列变体的 MQTT 主题详情，请参考此文档。

On this page