虚拟数据接入与数据上报

DTS 支持多种方式进行数据模拟接入。在此，我们利用 APIFox (或其他 HTTP/MQTT 工具) 来模拟物理传感器，向 DTS 上传测点数据以进行接入测试。

接入网关

  1. 进入实体管理模块，选择网关。
  2. 选择“BV通用网关”，点击编辑进入BV通用网关的详情页面->选择网关信息 Tab页面。
  3. 点击编辑，进入网关信息编辑页面。
  4. 修改关联产品，勾选中温湿度传感器产品。将新创建的产品加入到BV通用网关下。

BV通用网关为系统内置的网关，可支持加入HTTP协议接入的实体。

null

实体上报注册

  1. 若数据格式为BV JSON，根据HTTP协议实体接入(BV JSON数据格式)-设备上报接口，在APIFox中编写温湿度传感器设备上报数据接口。
  2. 接口准备完毕后，向DTS发送实体上报注册的请求。
  3. 返回成功，表示实体上报注册完成，便可在DTS 实体页面查找到对应实体。

productId需要从DTS平台产品信息详情中获取。deviceId deviceName 为温湿度传感器设备的设备ID和设备名称。

BV JSON发送请求体示例

[
    {
        "productId": "MNGRcylFFmLxxvJh",
        "deviceId": "2d4523e5-cd85-436d-818a-c5629a180349",
        "deviceName": "温湿度传感器1751884069",
        "deviceStatus": 0,
        "payload": {
            "humidity": 0.7952224183,
            "temperature": 0.552,
            "batteryLevel":85
        }
    }
]

若数据格式为透传/自定义，则需根据 HTTP协议实体接入(透传/自定义)-设备上报接口进行实体上报注册。

透传/自定义发送请求体示例

[
    {
        "guid": "970bdf41-7818-4718-b00e-eb14a08b6372",
        "name": "温湿度传感器1751939165",
        "status": 1,
        "humidity": 34.54,
        "temperature": 9.38,
        "batteryLevel": 81
    }
]

null

数据上报：属性上报

  1. 若数据格式为BV JSON，根据HTTP协议实体接入(BV JSON数据格式)-属性上报接口，在APIFox中编写温湿度传感器设备属性上报数据接口。
  2. 接口准备完毕后，向DTS发送属性上报的请求。
  3. 返回码200表示成功，表示属性上报成功。其他错误码需根据返回提示进行修改后再次上报。

productId需要从DTS平台产品信息详情中获取。

BV JSON发送请求体示例

{
    "method": 0,
    "productId": "MNGRcylFFmLxxvJh",
    "deviceId": "2d4523e5-cd85-436d-818a-c5629a180349",
    "deviceStatus": 1,
    "payload": {
            "humidity": 3.14,
            "temperature": 19.95,
            "batteryLevel":31
    }
}

若数据格式为透传/自定义，则需根据HTTP协议实体接入(透传/自定义)-属性上报接口进行属性上报。 透传/自定义发送请求体示例

{
       "guid": "970bdf41-7818-4718-b00e-eb14a08b6372",
        "status": 1,
        "humidity": 44.97,
        "temperature": 19.05,
        "batteryLevel": 62
}

状态查看

  1. 进入实体管理模块，选择实体。
  2. 选择“温湿度传感器1751884069”，点击编辑进入实体详情页—>选择产品profile Tab页；
  3. 选择运行状态 Tab页，进入属性值的查看。检查设备属性内容是否一致。

null

数据上报：事件上报

  1. 若数据格式为BV JSON，根据HTTP协议实体接入(BV JSON数据格式)-事件上报接口，在APIFox中编写温湿度传感器设备事件上报数据接口。
  2. 接口准备完毕后，向DTS发送事件上报的请求。

productId需要从DTS平台产品信息详情中获取。 identifier为产品Profile定义事件时，设置的事件标识符。

BV JSON发送请求体示例

{
    "method": 1,
    "productId": "MNGRcylFFmLxxvJh",
    "deviceId": "2d4523e5-cd85-436d-818a-c5629a180349",
    "identifier": "lowTemperatureAlarm",
    "deviceStatus": 0,
    "payload": {
        "temperature": -3.56
    }
}

若数据格式为透传/自定义，则需根据HTTP协议实体接入(透传/自定义)-事件上报接口。

透传/自定义发送请求体示例

{
    "deviceType": "SmartRefrigerator",
    "guid": "970bdf41-7818-4718-b00e-eb14a08b6372",
    "notificationType": "lowTemperatureAlarm",
    "content": {
        "temperature":-11.95
    },
    "timestamp":1751941555991
}

附件 * 温湿度传感器.txt

作者：北京-产品-yantings  创建时间：2025-03-06 09:56
最后编辑：北京-产品-yantings  更新时间：2026-07-16 17:09
上一篇：
下一篇：