VDM 视觉位移计

VDM 视觉位移计设备数据格式

VDM（Visual Displacement Meter）视觉位移计是 Inteagle 核心监测设备，支持多标靶位移测量。

遥测数据

视觉位移计设备遥测数据包含位移、环境、状态信息：

{
  "type": "telemetry",
  "ts": 1735560000000,
  "payload": {
    "entity": {
      "type": "DEVICE",
      "id": "dev_001"
    },
    "disp": {
      "1": {
        "dx": 0.05,
        "dy": 0.02,
        "dz": 0.01,
        "tilt": 0.05
      },
      "2": {
        "dx": 0.03,
        "dy": 0.01
      }
    },
    "env": {
      "temperature": 25.5,
      "humidity": 60.0,
      "pressure": 101.3
    },
    "status": {
      "signal": {
        "type": "4G",
        "rssi": -75
      },
      "pwr": {
        "battery": 3.7,
        "inputDC": 12.1
      },
      "storage": {
        "percent": 45
      }
    }
  }
}

位移数据 (disp)

字段	类型	说明
`disp`	Object	按标靶 ID 组织的位移数据
`dx`, `dy`, `dz`	Number	累积位移变化 (mm)
`tilt`	Number	倾斜变化角度（″ 角秒）

环境数据 (env)

部分 VDM 型号支持环境数据采集：

字段	类型	单位	说明
`temperature`	Number	°C	温度
`humidity`	Number	%RH	相对湿度
`pressure`	Number	kPa	大气压

状态数据 (status)

字段	类型	说明
`signal.type`	String	网络类型：`4G`, `Ethernet`
`signal.rssi`	Integer	信号强度 (dBm)
`pwr.battery`	Number	电池电压 (V)
`pwr.inputDC`	Number	DC 输入电压 (V)
`storage.percent`	Integer	存储使用率 (%)

告警

设备告警格式参见告警消息。

视觉位移计设备告警示例

{
  "type": "3A",
  "ts": 1735560000000,
  "payload": {
    "id": "alm_20251230_001",
    "alarmType": "TARGET_LOST",
    "severity": "alarm",
    "status": "ACTIVE_UNACK",
    "originator": {
      "type": "DEVICE",
      "id": "dev_001"
    },
    "detail": {
      "metric": "target_1_status",
      "message": "标靶1丢失"
    }
  }
}

VDM 常见告警类型

alarmType	说明	metric
`TARGET_LOST`	标靶丢失	`target_{n}_status`
`LOW_BATTERY`	电池电压低	`pwr.battery`
`LOW_VOLTAGE`	DC输入电压低	`pwr.inputDC`
`STORAGE_FULL`	存储空间不足	`storage.percent`

事件

事件分为通用事件（所有设备）和设备事件（取决于设备能力）。

通用事件

平台为所有设备提供在线/离线状态推送：

{
  "type": "event",
  "ts": 1735560000000,
  "payload": {
    "entity": {
      "type": "DEVICE",
      "id": "dev_001"
    },
    "eventType": "DEVICE_ONLINE",
    "data": {}
  }
}

eventType	说明
`DEVICE_ONLINE`	设备上线
`DEVICE_OFFLINE`	设备离线

视觉位移计设备事件

VDM 特有的事件类型：

{
  "type": "event",
  "ts": 1735560000000,
  "payload": {
    "entity": {
      "type": "DEVICE",
      "id": "dev_001"
    },
    "eventType": "TARGET_LOST",
    "data": {
      "targetId": "1"
    }
  }
}

eventType	说明	data
`TARGET_LOST`	标靶丢失	`{"targetId": "1"}`
`TARGET_RECOVERED`	标靶恢复	`{"targetId": "1"}`
`CALIBRATION_COMPLETE`	标定完成	`{"targetId": "1"}`
`STORAGE_FULL`	存储空间已满	`{}`

图像

VDM 支持图像采集：

{
  "type": "image",
  "ts": 1735560000000,
  "payload": {
    "entity": {
      "type": "DEVICE",
      "id": "dev_001"
    },
    "sensorId": 0,
    "trigger": "snapshot",
    "url": "https://storage.inteagle.com/images/...",
    "ttl": 86400
  }
}

字段	类型	说明
`entity`	EntityRef	实体引用
`sensorId`	Integer	视觉传感器 ID（0 或 1）
`trigger`	String	触发类型
`url`	String	图片下载 URL
`ttl`	Integer	URL 有效期（秒）

触发类型

trigger	说明
`snapshot`	手动快照
`3A`	告警触发
`periodic`	定时拍照

属性变更

{
  "type": "attributes",
  "ts": 1735560000000,
  "payload": {
    "entity": {
      "type": "DEVICE",
      "id": "dev_001"
    },
    "measureFrequency": 10,
    "irLightEnabled": true
  }
}

VDM 常见属性

属性	类型	说明
`measureFrequency`	Integer	测量频率 (Hz)
`irLightEnabled`	Boolean	红外补光灯开关
`targetCount`	Integer	标靶数量
`firmwareVersion`	String	固件版本