智慧消防开放能力说明

更新时间:2024-06-13 10:35:16下载pdf

本文介绍智慧消防开放能力接入的相关说明。

智慧消防设备控制管理

API 名称 接口地址
设备消音 POST:/v1.0/fire-control/{device_id}/actions/silence-enable

智慧消防事件格式

云开发项目 开启消息订阅 后,可以收到消防设备端上报的事件消息。消息队列接入流程的详细介绍,请参考 消息队列

数据格式说明

数据上报通过组合多个 code 来形成事件数据。

数据示例:

{
    "dataId": "AAXRV4BrtW9BRB9A2JYW****",
    "devId": "6ca",
    "productKey": "obxxba9vowgc****",
    "status": [
        {
            "1": "eed6810d-82e1-41cd-ba4a-7664f31942cb",
            "code": "alarm_trace_id",
            "t": 1637548630455,
            "value": "eed6810d-82e1-41cd-ba4a-7664f31942cb"
        },
				{
            "5": "未处理",
            "code": "alarm_result_content",
            "t": 1637548630455,
            "value": "未处理"
        },
      	{
            "6": 4065,
            "code": "alarm_value",
            "t": 1637548630455,
            "value": 4065
        },
      	{
            "4": 1650433413000,
            "code": "alarm_trace_time",
            "t": 1637548630455,
            "value": 1650433413000
        },
      	{
            "2": "上限报警",
            "code": "alarm_event_content",
            "t": 1637548630455,
            "value": "上限报警"
        },
      	{
            "7": "MPa",
            "code": "alarm_unit",
            "t": 1637548630455,
            "value": "MPa"
        },
     	 	{
            "3": "device_alarm",
            "code": "fire_alarm_type",
            "t": 1637548630455,
            "value": "device_alarm"
        }
		]
}

告警数据上报

列举说明:

告警数据 Code 数据说明 数据类型
alarm_trace_id 报警事件 ID String 类型。
alarm_event_content 报警内容 String 类型。
fire_alarm_type 消防设备报警类型 Enum 类型。
  • fire_alarm:火警报警
  • device_alarm:设备报警
  • device_fault:设备故障
  • signal_fault:通信故障
  • upper_alarm:上限报警
  • lower_alarm:下限报警
  • low_battery:低电告警
  • state_fault:状态量告警
  • others:其他
alarm_trace_time 事件发生时间 String 类型。
alarm_result_content 事件处理结果 String 类型。
alarm_value 事件值 Long 类型。上报的值已放大 10000 倍来处理小数点的问题,开发者使用时需除以 10000 来获取真实值。
alarm_unit 报警单位 String 类型。
alarm_process_time 报警处理时间 String 类型。
alarm_level 告警等级 Enum 类型。
  • event:事件
  • secondary:次要
  • important:重要
  • urgent:紧急

监控数据上报

列举说明:

监控数据 Code 数据说明 数据类型
monitor_name 监测项名称 String 类型。
monitor_data 监测项数据 String 类型。
monitor_value 监测值 Long 类型。上报的值已放大 10000 倍来处理小数点的问题,开发者使用时需除以 10000 来获取真实值。
monitor_unit 监测单位 String 类型。
monitor_time 监测时间 String 类型。

智慧消防事件 1.0 格式

设备事件消息兼容 1.0 版本格式。如需开通 1.0 版本格式,请联系涂鸦工作人员。接入流程参考 行业三方设备事件 1.0 版本格式

设备报警

功能描述

消防设备发生报警或者异常时,会以报警消息的方式通知开发者。

参数说明

参数名 类型 说明 必填
bizCode String 事件业务 code,默认 edge_device
eventType String 事件类型,默认 edge_report_data
mode String 事件模式,默认 fire_alarm
deviceId String 涂鸦设备 ID。
alarm_trace_id String 报警事件 ID,用于更新设备报警后的事件处理结果(alarm_result_content)。
alarm_event_content String 报警内容说明。
fire_alarm_type Enum 消防设备报警类型。{“range”:[“fire_alarm”,“device_fault”,“device_alarm”,“others”]}。报警类型包括火警报警、设备故障(电量过低)和设备报警。
alarm_trace_time String 事件发生时间,13 位毫秒时间戳。
alarm_result_content float 事件处理结果描述。由三方平台定义具体内容,文档只是举例。
alarm_value float 事件值。
alarm_unit String 报警的单位。和事件值相关联,比如摄氏度。
alarm_process_time String 报警的处理时间,毫秒。

数据示例

{
	"data": "{\"data\":{\"deviceId\":\"6c0********z\",\"dpData\":{\"alarm_trace_id\":\"87-ebe9-47e1-8bab-66f9***4\",\"alarm_event_content\":\"下限报警\",\"fire_alarm_type\":\"device_alarm\",\"alarm_trace_time\":\"15****87\",\"alarm_result_content\":\"未处理\",\"alarm_value\":\“0.003\”,\"alarm_unit\":\"cm\",\"alarm_process_time\":\"1595495410187\"}},\"mode\":\"fire_alarm\"}",
	"bizCode": "edge_device",
	"eventType": "edge_report_data"
}

设备数据上报

功能描述

消防设备检测到数据变化时会上报消息,会以报警消息的方式通知开发者。

参数说明

参数名 类型 说明 必填
bizCode String 事件业务 code,默认 edge_device
eventType String 事件类型,默认 edge_report_data
mode String 事件模式,默认 fire_monitor
deviceId String 涂鸦设备 ID。
monitor_data String 检测项 code。
monitor_name String 检测项中文名称。
monitor_value 数值 检测数据值。
monitor_unit String 检测项数据单位。
monitor_time_data String 检测项数据产生的时间,13 位毫秒时间戳。

数据示例

{
	"data": "{\"data\":{\"deviceId\":\"6c0********z\",\"dpData\":{\"monitor_data\":\"tem\",\"monitor_name\":\"温度\",\"monitor_value\":0x0502,\"monitor_unit\":\"摄氏度\",\"monitor_time_data\":\"1595****0187\"}},\"mode\":\"fire_monitor\"}",
	"bizCode": "edge_device",
	"eventType": "edge_report_data"
}