# BACnet/IP
简述
BACnet/IP DIP插件是一个根据BACnet/IP协议，基于UDP对接楼宇设备的开箱即用DIP插件。
# BACnet/IP配置
- 在配置页面选择BACnet/IP
# DIP实例配置
- 名称：DIP实例名称
# IN配置
- 本机地址 森数据部署所在IP地址，森数据在线版暂不支持体验，森数据离线版中，此配置项就是选用的宿主机所在的服务器IP地址。
- 本机子网掩码 森数据部署所在子网掩码，森数据在线版暂不支持体验，森数据离线版中，此配置项就是选用的宿主机所在的服务器子网掩码。
- BACnet主机地址 BACnet设备服务端所在的IP地址
- BACnet主机子网掩码 BACnet设备服务端所在的子网掩码
- 端口： BACnet设备服务端的端口号，默认为47808
- 字符集： 森数据所在服务器的字符编码集
- 下载模板： 下载BACnet/IP DIP实例所需要配置的标准映射模板
- 配置文件： 通过Excel配置性能指标相关属性，列标题定义如下：
- deviceId：BACnet服务端的device ID
- objectType：BACnet服务端中，要获取的objectType字段
- instance：objectType具体的instance字段
- propertyIdentifier：BACnet服务端中，具体要获取的设备属性
- 设备唯一标识：BACnet端设备对应的VMDB系统中的设备标识
- 指标名称：设备属性对应的名称
- 设备部件：如果系统无法标识到BACnet具体的设备部件，则在此填写具体的设备部件
- 单位：设备属性对应的单位
# Out配置
告警的发送方式选择：点击添加，选择对应的发送方式将数据进行发送
MYSQL
选择此项会将数据保存至mysql库，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| URL（必填项） | 数据库地址 | jdbc:mysql://0.0.0.0:3306/db_vmdb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2b8 |
| 用户名（必填项） | 数据库用户名 | username |
| 密码（必填项） | 数据库密码 | password |
| 是否保存历史数据（必填项） | 默认为是，保存历史数据 | 是 |
ES
选择此项会将数据保存至ES库，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| ES请求地址（必填项） | 数据库地址 | 0.0.0.0:9200 |
| 用户名 | 数据库用户名 | username |
| 密码 | 数据库密码 | password |
| ES性能数据保留天数（必填项） | 默认为7，保存7天内的性能数据 | 7 |
| 数据域 | ThingJS-X数据域ID （可选） |
ACTIVEMQ
选择此项会将数据发送至ActiveMQ，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| URL（必填项） | ActiveMQ地址 | failover://(tcp://0.0.0.0:61616,tcp://0.0.0.0:61616)?randomize=false&timeout=5000&maxReconnectAttempts=-1 |
| 队列名（必填项） | ActiveMQ队列名称 | queue |
| 用户名 | ActiveMQ用户名 | username |
| 密码 | ActiveMQ密码 | password |
RABBITMQ
选择此项会将数据发送至RabbitMQ，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| URL（必填项） | RabbitMQ地址 | 0.0.0.0 |
| 端口（必填项） | RabbitMQ端口号 | 12000 |
| 用户名 | RabbitMQ用户名 | username |
| 密码 | RabbitMQ密码 | password |
| RabbitMq工作模式（必填项） | 共有：简单模式，订阅模式，路由模式和Topic四种模式；默认为简单模式 | 简单模式 |
| RabbitMq交换机或队列名称以及路由键（必填项） | 根据工作模式填写json数据 | 如下表所示 |
| 交换机或队列是否持久化（必填项） | 默认为否，不支持持久化 | 否 |
| 无服务时是否自动删除队列或者交换机（必填项） | 默认为否，不会自动删除队列或交换机 | 否 |
| RabbitMq工作模式 | 对应json |
|---|---|
| 简单模式 | {"name":"交换机名称"} |
| 订阅模式 | {"name":"交换机名称"} |
| 路由模式 | {"name":"交换机名称","routingKey":"路由键"} |
| Topic模式 | {"name":"交换机名称","routingKey":"路由键"} |
注：此处的交换机名称和路由键按照实际情况填写
ROCKETMQ
选择此项会将数据发送至RocketMQ，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| 请求地址（必填项） | RocketMQ地址 | 0.0.0.0:9876;0.0.0.0:9876 |
| 生产者组别 | RocketMQ生产者组别 | producerGroup |
| 消息发送主题 | 消息发送主题 | topicA |
| 消息标签 | 消息标签 | tagA |
| 超时时间 | 消息发送超时时间，单位为毫秒 | 30000 |
| 字符集 | 字符编码集，默认UTF-8 | UTF-8 |
| 消息发送类型 | 分为：异步发送，单向发送，同步发送共三种；默认为异步发送 | 异步发送 |
KAFKA
选择此项会将数据发送至kafka，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| 请求地址（必填项） | kafka地址 | 0.0.0.0:9092;0.0.0.0:9092 |
| 消息发送主题（必填项） | 消息发送主题 | topicA |
| sasl静态认证文件地址（非必填） | sasl conf认证文件位置 | /uinnova/dix/kafka_sasl_jaas.conf |
| 用户名（非必填） | Kafka动态认证用户名 | username |
| 密码（非必填） | Kafka动态认证密码 | password |
| 密码加密算法（非必填） | 对密码进行加密的算法，下拉框中二选一 | SCRAM-SHA-256 或 SCRAM-SHA-512 |
| 延迟（非必填） | 消息发送延迟，单位为秒 | 1 |
MQTT
选择此项会将数据发送至mqtt，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| URL（必填项） | mqtt地址 | tcp://127.0.0.0:1883 |
| MQTT客户端ID（必填项） | mqtt客户端ID | clientID101 |
| 用户名 | mqtt用户名 | username |
| 密码 | mqtt密码 | password |
| 消息发送主题 | 消息发送主题 | topicA |
| 消息发送质量 | 分为：仅分发一次，至少分发一次，最多分发一次共三种；默认仅分发一次 | 仅分发一次 |
| 字符集 | 字符编码集，默认UTF-8 | UTF-8 |
HTTPPOST
选择此项会将数据通过post请求发送至http服务，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| http服务路径（必填项） | http服务地址 | http://0.0.0.0:0000 |
| 请求头 | 填写json格式的参数 | {"key":"value"} |
| 字符集 | 字符编码集，默认utf-8 | utf-8 |
HTTPSPOST
选择此项会将数据通过post请求发送至https服务，配置项如下：
| 配置项名称 | 配置项描述 | 示例 |
|---|---|---|
| http服务路径（必填项） | https服务地址 | https://0.0.0.0:0000 |
| 请求头 | 填写json格式的参数 | {"key":"value"} |
| 字符集 | 字符编码集，默认utf-8 | utf-8 |
DIP实例的保存与启动
- 配置信息填写完成后，点击保存，成功保存后会在森数据DIX的数据集成页面看到新建的DIP实例。
- 点击启动按钮，待启动成功之后，点击日志按钮，查看数据是否能正常接入。
名词解释
已接入：当前数据接口接入到的总数据量
处理中：当前数据接口正在进行处理的数据量
发送中：当前数据接口正在向外部发送的数据量
已发送：当前数据接口发送到外部的总数据量