VS350 可配置属性

你可以通过API修改设备的可配置属性，以更新设备的设置。本文档提供了VS350物模型的可配置参数和使用的方法。

使用方法

  1. 参考VS350可配置属性及其默认值。
  2. 复制示例代码，去掉不需要修改的注释和参数。
  3. 根据属性描述编辑所需的属性。
    注： 请确保编辑的示例代码符合JSON格式的要求。
  4. 使用编辑后的示例代码作为主体参数 更新设备属性。

可配置属性

以下代码表示VS350物模型中的所有可配置属性及其默认值。

注：
  • 单击属性可查看其详细说明和有效值。
  • 根据需要配置示例代码，然后将其作为主体参数 更新设备属性 来快速完成配置。
{
    "properties": {
        "reporting_interval": {    // 数据上报周期（分钟）。
            "time": 10
        },
        "enable_cumulative_count": false,    // 禁用上报累计值。
        "enable_interval_reset_cumulative_value": true,    // 启用数据累计值清零功能。
        "reset_cumulative_value_interval": 1440,    // 数据累计值清零周期 (分钟)。
        "enable_temperature_report": false,    // 禁用温度数据上报。
        "temperature_calibrate":{     // 禁用温度校准。
            "enable": false,
            "calibrate_value": 0
        },
        "data_storage_enable": false,    // 禁用数据存储功能。
        "retransmission_enable": false,    // 禁用数据重传功能。
        "retransmission_interval":{    // 数据重传间隔（秒）。
            "interval":600
        },
        "retrival_interval":{   // 数据回传间隔（秒）。
            "interval": 60
        },

        "set_cycle_people_threshold_alarm":{    // 禁用进出人数告警。
            "threshold_condition": 0,    
            "value_less_than": 1,
            "value_greater_than": 1
        },

        "set_cumulative_people_threshold_alarm":{    //禁用累计进出人数阈值告警。
            "threshold_condition": 0,    
            "value_less_than": 1,
            "value_greater_than": 1
        },
        "set_threshold_alarm":{    // 禁用温度阈值告警。
            "threshold_condition": 0,    
            "value_less_than": 0,
            "value_greater_than": 25
        },
        "d2d_enable": false,    // 禁用D2D功能。
        "d2d_key": "5572404c696e6b4c",    
        "someone_enters_triggers_setting":{    // 禁用有人进入D2D联动。
            "enable": false,
            "lora_uplink_enable": false,
            "control_command": "0000",
            "enable_control_time": false,
            "control_time": 5
        },
        "someone_leave_triggers_setting":{    // 禁用有人离开D2D联动。
            "enable": false,
            "lora_uplink_enable": false,
            "control_command": "0001",
            "enable_control_time": false,
            "control_time": 5
        },
        "people_counting_threshold_setting":{    // 禁用人数阈值触发D2D联动。
            "enable": false,
            "lora_uplink_enable": false,
            "control_command": "0002",
            "enable_control_time": false,
            "control_time": 5
        },
        "temperature_threshold_setting":{    // 禁用温度阈值触发D2D联动。
            "enable": false,
            "lora_uplink_enable": false,
            "control_command": "0003",
            "enable_control_time": false,
            "control_time": 5
        },
        "temperature_threshold_released_setting":{    // 禁用温度阈值解除D2D联动。
            "enable": false,
            "lora_uplink_enable": false,
            "control_command": "0004",
            "enable_control_time": false,
            "control_time": 5
        }
    }
}

描述

下表提供了VS350可配置属性的描述和有效值。
参数 类型 描述
reporting_interval Struct

数据上报间隔。
time Integer

指定数据上报的间隔（单位：分钟）。

  • 默认值: 10
  • 有效值: 1 - 1440
enable_cumulative_count Boolean

决定是否在周期数据包中启用累计计数值的上报。

有效值:
  • false: 禁用（默认值）
  • true: 启用
enable_interval_reset_cumulative_value Boolean

决定是否定期启用重置累计计数值。

有效值:
  • 错误: 禁用(默认值)
  • 正确: 启用
reset_cumulative_value_interval Integer

指定重置累计计数值的间隔（单位：分钟）。

  • 默认值: 1440
  • 有效值: 1 - 1440
enable_temperature_report Boolean

决定是否在周期数据包中启用温度上报。

有效值:
  • false: 禁用
  • true: 启用（默认值）
temperature_calibrate Struct 温度校准设置。
enable Boolean

决定是否启用温度校准。

有效值:
  • 错误: 禁用（默认值）
  • 正确: 启用
calibrate_value Integer

指定校准值（单位：°C）。

  • 默认值: 0
  • 有效值: -100 - 100
    注： 该值支持设置一位小数。
data_storage_enable Boolean

决定是否启用设备存储数据。

有效值:
  • false: 禁用（默认值）
  • true:启用
retransmission_enable Boolean

决定是否启用数据重传功能，允许设备在网络断开连接期间周期性记录时间点，并在重新连接后重新发送在断开期间累积的数据。

注： 此设置仅在data_storage_enable设置为true时生效。
有效值:
  • false: 禁用（默认值）
  • true:启用
retransmission_interval Struct
注： 此设置仅在retransmission_enable设置为true时生效。
数据重传的间隔。
interval Integer
指定数据重传的间隔（单位：秒）
  • 默认值: 600
  • 有效值: 30 - 1200
retrival_interval Struct 历史数据检索时发送回历史数据的时间间隔。
interval Integer
指定数据检索的时间间隔（单位：秒）。
  • 默认值: 60
  • 有效值: 30 - 1200
set_cycle_people_threshold_alarm Struct

周期性的进出人流统计报警设置。
threshold_condition Enum

指定触发周期性进出人流统计报警的条件。

有效值:
  • 0:不发送报警（默认值）。
  • 2: 周期性进出值 > 周期性进出阈值。
value_greater_than Integer

指定周期性离开计数值的阈值。

  • 默认值: 1
  • 有效值: 1 - 65535
value_less_than Integer

指定周期性进入计数值的阈值。

  • 默认值: 1
  • 有效值: 1 - 65535
set_cumulative_people_threshold_alarm Struct

累计进出人流统计报警设置。
threshold_condition Enum

指定触发累计进出人流统计报警的条件

有效值:
  • 0: 不发送报警（默认值）。
  • 2:累计进出值 >累计进出阈值。
value_greater_than Integer

指定累计离开计数值的阈值。

  • 默认值: 1
  • 有效值: 1 - 65535
value_less_than Integer

指定累计进入计数值的阈值。

  • 默认值: 1
  • 有效值: 1 - 65535
set_threshold_alarm Struct

温度报警设置。
threshold_condition Enum

指定触发温度报警的条件。

有效值:
  • 0: 不发送温度报警（默认值）。
  • 1: 检测到的温度 < 最小阈值。
  • 2: 检测到的温度 >> 最大阈值。
  • 3:最小阈值 < 检测到的温度 < 最大阈值 。
  • 4: 检测到的温度 < 最小阈值或者>最大阈值。
value_greater_than Integer

指定温度报警的最小阈值（单位：°C）。

  • 默认值: 25
  • 有效值: -30 - 70
    注： 该值支持设置一位小数。
value_less_than Integer

指定温度报警的最大阈值（单位：°C）。

  • 默认值: 0
  • 有效值: -30 - 70
    注： 该值支持设置一位小数。
d2d_enable Boolean

决定是否启用设备对设备（D2D）通信功能。

有效值:
  • false: 禁用（默认值）
  • true: 启用
d2d_key String
注： 此设置仅在d2d_enable设置为true时生效。
指定D2D通信的密钥。
  • 默认值: 5572404c696e6b4c
  • 限制: 完整密钥长度为32位，前16位可自定义，后16位默认自动补0。
someone_enters_triggers_setting Struct

当有人进入时的D2D通信设置。
enable Boolean

决定是否在有人进入时启用D2D通信。

有效值:
  • false: 禁用（默认值）
  • true: 启用
    注： 只有当该值设置为true时，以下参数的设置才会生效。
lora_uplink_enable Boolean

决定是否启用LoRa上行功能，即在发送D2D控制命令后发送上行LoRa数据包。

有效值:
  • false: 禁用（默认值）
  • true: 启用
control_command String

指定有人进入时的D2D通信控制命令。

  • 默认值: 0000
  • 限制: 控制命令长度为4个字符。
enable_control_time Boolean

决定是否启用控制时间来指定D2D通信中执行控制操作的持续时间。

有效值:
  • false:禁用（默认值）
  • true:启用
control_time Integer

指定控制时间（单位：分钟）。

默认值: 5

someone_leave_triggers_setting Struct

有人离开时的D2D通信设置。
enable Boolean

决定是否在有人离开时启用D2D通信。

有效值:
  • false: 禁用（默认值）
  • true: 启用
    注： 只有当该值设置为true时，以下参数的设置才会生效。
lora_uplink_enable Boolean

决定是否启用LoRa上行功能，即在发送D2D控制命令后发送上行LoRa数据包。

有效值:
  • false: 禁用（默认值）
  • true:启用
control_command String

指定有人离开时的D2D通信控制命令。

  • 默认值: 0001
  • 限制:控制命令长度为4个字符。
enable_control_time Boolean

决定是否启用控制时间来指定D2D通信中执行控制操作的持续时间。

有效值:
  • false: 禁用（默认值）
  • true: 启用
control_time Integer

指定控制时间（单位：分钟）。

默认值: 5

people_counting_threshold_setting Struct 人流统计达到阈值时的D2D通信设置。
enable Boolean

决定是否启用人流统计达到阈值时触发的D2D通信。

有效值:
  • false: 禁用（默认值）
  • true: 启用
    注： 只有当该值设置为true时，以下参数的设置才会生效。
lora_uplink_enable Boolean

决定是否启用LoRa上行功能，即在发送D2D控制命令后发送上行LoRa数据包。

有效值:
  • false: 禁用（默认值）
  • true: 启用
control_command String

当人数计数达到阈值时触发的 D2D 通信控制命令。

  • 默认值: 0002
  • 限制: 控制命令长度为4个字符。
enable_control_time Boolean

决定是否启用控制时间来指定D2D通信中执行控制操作的持续时间。

有效值:
  • false: 禁用（默认值）
  • true: 启用
control_time Integer

指定控制时间（单位：分钟）。

默认值: 5

temperature_threshold_setting Struct 温度达到阈值触发的 D2D 通信设置。
enable Boolean

决定是否启用温度达到阈值时触发的 D2D 通信。

有效值:
  • false: 禁用（默认值）
  • true: 启用
  • 注： 只有当该值设置为true时，以下参数的设置才会生效。
lora_uplink_enable Boolean

决定是否启用 LoRa 上行通信，发送 D2D 控制命令后会发送一个上行 LoRa 数据包。

有效值:
  • false: 禁用（默认值）
  • true: 启用
control_command String

温度达到阈值触发的 D2D 通信的控制命令。

  • 默认值: 0003
  • 限制: 控制命令长度为4个字符。
enable_control_time Boolean

决定是否启用控制时间来指定D2D通信中执行控制操作的持续时间。

有效值:
  • false: 禁用（默认值）
  • true: 启用
control_time Integer

指定控制时间（单位：分钟）。

默认值: 5

temperature_threshold_released_setting Struct 触发温度超出阈值的 D2D 通信设置。
enable Boolean

决定在检测到的温度超出阈值时是否触发 D2D 通信。

有效值:
  • false: 禁用（默认值）
  • true: 启用
  • 注： 只有当该值设置为true时，以下参数的设置才会生效。
lora_uplink_enable Boolean

决定是否启用LoRa上行链路，发送D2D控制命令后将发送上行LoRa数据包。

有效值:
  • false: 禁用（默认值）
  • true: 启用
control_command String

温度超出阈值而触发的D2D通信的控制命令。

  • 默认值: 0004
  • 限制: 控制命令长度为4个字符。
enable_control_time Boolean

决定是否启用控制时间来指定D2D通信中执行控制操作的持续时间。

有效值:
  • 错误: 禁用（默认值）
  • 正确: 启用
control_time Integer

指定控制时间（单位：分钟）。

默认值: 5