BACnet/IP
BACnet（Building Automation and Control Networks）是一种用于智能建筑的通信协议，它是由国际标准化组织（ISO）、美国国家标准协会（ANSI）和美国采暖、制冷与空调工程师学会（ASHRAE）定义的通信协议。BACnet 是专门为智能建筑及控制系统设计的通信协议，可用于暖通空调系统（HVAC）、照明控制、门禁系统、火警侦测系统以及其相关设备。其优点在于可降低维护系统所需成本，并且安装比一般工业通信协议更为简易。此外，BACnet 还提供了五种业界常用的标准协议，可以防止设备和系统供应商的垄断，从而增加未来系统的扩展性和兼容性。BACnet 协议支持多种通信方式，包括串口、IP、Ethernet、ZigBee 等。
BACnet/IP 驱动以单播方式与一台地址已知的设备通信，读取使用 ReadPropertyMultiple，写入使用 WriteProperty。它本身不做设备发现：Who-Is/I-Am 广播、经 BBMD（BACnet Broadcast Management Device）跨子网发现，由 设备扫描 插件负责。两者配合使用是推荐的做法 —— 先用扫描插件发现网络中的设备和点位，再由它直接生成一个配置好的 BACnet/IP 节点。
添加插件
在 配置 -> 南向设备，点击添加设备来创建设备节点，输入插件名称，插件类型选择 BACnet/IP 启用插件。
设备配置
点击插件卡片或插件列，进入设备配置页。配置 Neuron 与设备建立连接所需的参数，下表为插件相关的配置项。
| 字段 | 说明 |
|---|---|
| 目标设备 IP 地址 | BACnet 设备的 IP。设备在 BACnet 路由器后面时，此处填路由器的 IP |
| 目标设备端口号 | BACnet 设备的端口号，默认为 47808 |
| 目标设备网络 | 设备所在 BACnet 网络的网络号（DNET），取值 0 - 65534。仅在填写了目标设备 MAC 时生效，设备可直接访问时保持 0 |
| 目标设备 MAC | 路由器后面那台设备的 MAC（DADR），十六进制无分隔符。设备在本网络时留空 |
跨 BACnet 网络访问
跨 IP 子网和跨 BACnet 网络是两件不同的事，配置方式也不同：
- 跨 IP 子网，但仍属同一个 BACnet/IP 网络 —— 只影响广播，单播读写不受影响。本驱动直接填设备自己的 IP 即可，不需要 BBMD。
- 跨 BACnet 网络，设备挂在 BACnet 路由器后面的 MS/TP 网络或另一个 B/IP 网络上 —— 设备没有可直接到达的 IP，报文必须经路由器转发。这时才需要填写目标设备网络和目标设备 MAC。
MAC 的长度取决于设备所在网络的类型：MS/TP 站号为一字节（如 05），B/IP 地址为六字节的 IP 加端口（如 C0A80164BAC0 表示 192.168.1.100:47808）。
| 场景 | 目标设备 IP 地址 | 目标设备网络 | 目标设备 MAC |
|---|---|---|---|
| 设备在本网络，可直接访问 | 设备 IP | 0 | 留空 |
| 设备在路由器后的 MS/TP 网络 2001 | 路由器 IP | 2001 | 05 |
| 设备在路由器后的另一 B/IP 网络 | 路由器 IP | 该网络的网络号 | C0A80164BAC0 |
TIP
不确定该填什么时，先用 设备扫描 扫描一次。扫描结果中每台设备都带有 address、port、dnet、dadr 四个字段，与上面四项配置一一对应；也可以直接调用它的应用接口生成节点，无需手工填写。
设置组和点位
完成插件的添加和配置后，要建立设备与 Neuron 之间的通信，首先为南向驱动程序添加组和点位。
完成设备配置后，在南向设备页，点击设备卡片/设备列进入组列表页。点击创建来创建组，设定组名称以及采集间隔。完成组的创建后，点击组名称进入点位列表页，添加需要采集的设备点位，包括点位地址，点位属性，数据类型等。
公共配置项部分可参考连接南向设备，本页将介绍支持的数据类型和地址格式部分。
数据类型
- FLOAT
- DOUBLE
- BIT
- BOOL
- INT8
- INT32
- UINT8
- UINT16
- UINT32
- STRING
地址格式
AREA ADDRESS(.PROPERTY_ID)
AREA 为区域缩写，ADDRESS 为对象实例号，PROPERTY_ID 为可选的属性名。不指定属性时读写当前值（Present_Value），DEV 区域除外。
支持区域
| 区域 | 对象类型 | 地址范围 | 属性 | 数据类型 | 备注 |
|---|---|---|---|---|---|
| AI | analog-input | 0 - 0x3fffff | 读 | FLOAT | 模拟输入 |
| AO | analog-output | 0 - 0x3fffff | 读/写 | FLOAT | 模拟输出 |
| AV | analog-value | 0 - 0x3fffff | 读/写 | FLOAT | 模拟量 |
| BI | binary-input | 0 - 0x3fffff | 读 | BIT | 二进制输入 |
| BO | binary-output | 0 - 0x3fffff | 读/写 | BIT | 二进制输出 |
| BV | binary-value | 0 - 0x3fffff | 读/写 | BIT | 二进制值 |
| MSI | multi-state-input | 0 - 0x3fffff | 读 | UINT8 | 多状态输入 |
| MSO | multi-state-output | 0 - 0x3fffff | 读/写 | UINT8 | 多状态输出 |
| MSV | multi-state-value | 0 - 0x3fffff | 读/写 | UINT8 | 多状态值 |
| ACC | accumulator | 0 - 0x3fffff | 读/写 | UINT32（兼容 UINT8） | 累加器 |
| LAV | large-analog-value | 0 - 0x3fffff | 读/写 | DOUBLE | 大模拟量 |
| IV | integer-value | 0 - 0x3fffff | 读/写 | INT32 | 整数量 |
| PIV | positive-integer-value | 0 - 0x3fffff | 读/写 | UINT32 | 正整数量 |
| CSV | characterstring-value | 0 - 0x3fffff | 读/写 | STRING | 字符串量 |
| LO | lighting-output | 0 - 0x3fffff | 读/写 | FLOAT | 照明输出 |
| BLO | binary-lighting-output | 0 - 0x3fffff | 读/写 | BIT | 二进制照明输出 |
| DV | date-value | 0 - 0x3fffff | 读/写 | STRING | 日期量 |
| TV | time-value | 0 - 0x3fffff | 读/写 | STRING | 时间量 |
| DEV | device | 0 - 0x3fffff | 读 | 见下方属性表 | 设备 |
TIP
数据类型由对象类型决定，不能任选。例如 AI 点位只能是 FLOAT，MSV 点位只能是 UINT8，类型填错会返回类型不支持的错误。ACC 区域按标准应为 UINT32，UINT8 仅为兼容早期配置而保留。
输入类对象（AI、BI、MSI）反映被测量的物理量，不可写，添加时带上写属性会被拒绝。
目前支持标准属性和自定义属性
标准属性
| 属性 | 地址 | 类型 |
|---|---|---|
| 对象名称 | Object_Name | string |
| 对象类型 | Object_Type | uint8 |
| 描述 | Description | string |
| 设备类型 | Device_Type | string |
| 状态标志 | Status_Flags | string |
| 事件状态 | Event_State | uint8 |
| 脱离服务 | Out_Of_Service | bool |
| 更新间隔 | Update_Interval | uint8 |
| 最小值 | Min_Pres_Value | float |
| 最大值 | Max_Pres_Value | float |
| 分辨率 | Resolution | float |
| COV增量 | COV_Increment | float |
| 时间延迟 | Time_Delay | uint8 |
| 通告类 | Notification_Class | uint8 |
| 通告类型 | Notify_Type | uint8 |
| 单位 | Units | uint8 |
| 高阈值 | High_Limit | float |
| 低阈值 | Low_Limit | float |
| 阈值宽度 | Deadband | float |
| 可靠性 | Reliability | uint8 |
| 极性 | Polarity | uint8 |
| 系统状态 | System_Status | uint8 |
| 厂商名 | Vendor_Name | string |
| 厂商ID | Vendor_Identifier | uint8 |
| 型号名称 | Model_Name | string |
| 固件版本 | Firmware_Revision | string |
| 应用软件版本 | Application_Software_Version | string |
| 位置 | Location | string |
| 协议版本 | Protocol_Version | uint16 |
| 协议一致类别 | Protocol_Conformance_Class | uint8 |
| 协议服务支持 | Protocol_Service_Supported | string |
| 协议对象类型支持 | Protocol_Object_Types_Supported | string |
| 序列号 | Serial_Number | string |
| 最大APDU长度支持 | Max_APDU_Length_Accepted | uint16 |
| 分段支持 | Segmentation_Supported | uint8 |
| 本地时间 | LOCAL_TIME | string |
| 本地日期 | LOCAL_DATE | string |
| 时差 | UTC_Offset | int8 |
| 夏令时状态 | Daylight_Savings_Status | bool |
| APDU分段超时 | APUD_Segment_Timeout | uint8 |
| APDU超时 | APUD_Timeout | uint16 |
| APDU重传次数 | Number_Of_APDU_Retries | uint8 |
| 最大主节点数 | Max_Master | uint8 |
| 最大信息帧数 | Max_Info_Frame | uint8 |
| 配置名 | Profile_Name | string |
| 频率 | Pulse_Rate | uint8 |
| 分频 | Scale | float |
| 预分频 | Prescale | float |
| 原值 | Value_Before_Change | uint8 |
| 修改时间 | Value_Change_Time | string |
不指定属性，默认为当前值（Present_Value）属性，DEV 区域除外。
自定义属性
PROPERTY_ID 由两部分组成，一个是 custom 标志，一个是属性的值（int），整体格式为 AREA ADDRESS.custom.id。
支持 Present Value 置零操作，目前支持 AO 和 BO 区域，地址形式为 (AO|BO)xxx.NULL，只支持写操作，根据区域的类型，写入类型的零值即可。
TIP
.NULL 点位只能写不能读，添加时若带上读属性或订阅属性会返回属性不支持的错误。
地址示例
| 地址 | 数据属性 | 说明 |
|---|---|---|
| AI0 | FLOAT | AI 区域，地址为 0 |
| AI1 | FLOAT | AI 区域，地址为 1 |
| AV30 | FLOAT | AV 区域，地址为 30 |
| BO10 | BIT | BO 区域，地址为 10 |
| BO10.NULL | BIT | BO 区域，地址为 10，写入NULL值 |
| BO20 | BIT | BO 区域，地址为 20 |
| BI0 | BIT | BI 区域，地址为 0 |
| BI1 | BIT | BI 区域，地址为 1 |
| BV3 | BIT | BV 区域，地址为 3 |
| MSI10 | UINT8 | MSI 区域，地址为 10 |
| MSI20 | UINT8 | MSI 区域，地址为 20 |
| MSI30 | UINT8 | MSI 区域，地址为 30 |
| ACC1 | UINT32 | ACC 区域，地址为 1 |
| LAV5 | DOUBLE | LAV 区域，地址为 5 |
| IV7 | INT32 | IV 区域，地址为 7 |
| PIV8 | UINT32 | PIV 区域，地址为 8 |
| CSV2 | STRING | CSV 区域，地址为 2 |
| AI0.Object_Name | STRING | AI 区域，地址为 0，属性为对象名 |
| AI0.custom.1234 | ALL | AI 区域，地址为 0，属性值为1234 |
| DEV400001.Vendor_Name | STRING | DEV 区域，地址为 400001，属性值为厂商名 |
设备扫描
BACnet/IP 驱动需要预先知道设备地址。当现场设备清单不明确时，可以先用扫描插件摸清网络：它广播 Who-Is 发现设备，再逐台读取设备的 Object_List，把每个对象的地址、名称、当前值等属性整理成点位清单。清单通过 HTTP 接口读取，也可以直接据此生成一个配置好的 BACnet/IP 采集节点。
扫描只负责"发现"，不负责"采集"。BACnet/IP 设备扫描在 系统设置 中开启，数据采集仍由 BACnet/IP 驱动完成。
典型用法是三步：
- 系统设置中开启扫描，按网络拓扑选好扫描方式
- 查看扫描到的设备和设备点位
- 选中一台设备和需要的点位，一键添加 BACnet/IP 节点与点位
开启扫描功能
在 系统设置 -> BACnet/IP 设备扫描，开启扫描。
扫描配置
| 字段 | 默认值 | 说明 |
|---|---|---|
| 本地绑定地址 | 0.0.0.0 | 绑定的本地网卡地址，0.0.0.0 表示绑定所有网卡。多网卡主机建议指定网卡 |
| 本地绑定端口号 | 47808 | 收发 BACnet 报文的本地端口，通常必须是 47808，原因见下 |
| 设备扫描周期 | 600 | 定时广播 Who-Is 发现设备的周期，单位秒，取值 30 - 86400 |
| 点位扫描周期 | 1200 | 定时枚举已发现设备点位的周期，单位秒，取值 60 - 86400 |
| 本地子网广播扫描 | 启用 | 以 Original-Broadcast-NPDU 发送 Who-Is |
| 全局广播扫描 | 禁用 | 以 DNET 0xFFFF 发送 Who-Is，BACnet 路由器会向所有直连网络转发 |
| 广播地址 | 255.255.255.255 | 两种广播模式的目标地址，建议改为子网定向广播地址，如 192.168.1.255 |
| 经 BBMD 扫描 | 禁用 | 向 BBMD 注册为外部设备，以 Distribute-Broadcast-To-Network 发送 Who-Is |
| BBMD IP 地址 | 空 | 仅在启用"经 BBMD 扫描"时需要填写 |
| BBMD 端口号 | 47808 | 仅在启用"经 BBMD 扫描"时需要填写 |
三种扫描方式怎么选
三种方式对应三种不同的网络位置，可以同时启用，发现结果会自动去重。
| 设备位置 | 需要启用的方式 | 说明 |
|---|---|---|
| 与 Neuron 在同一个 IP 子网 | 本地子网广播扫描 | 最常见的情况，广播报文直接送达 |
| 同一个 BACnet/IP 网络，但在别的 IP 子网 | 经 BBMD 扫描 | IP 广播不跨子网，需要子网里的 BBMD 代为转发 |
| 在 BACnet 路由器后面的 MS/TP 等其他 BACnet 网络 | 全局广播扫描 | 路由器收到 DNET 0xFFFF 的 Who-Is 后向它的所有网络转发 |
判断不了的话把三种都启用，扫一次看结果。跨 BACnet 网络发现到的设备，结果中 routed 为 true 并带有 dnet 和 dadr，可直接填入上文的目标设备网络和目标设备 MAC。
扫描到的属性
每个对象除地址和名称外，还会读取以下属性。它们大多是 BACnet 的可选属性，设备不支持时对应字段为空。
| 属性 | 适用对象类型 | 用途 |
|---|---|---|
| Object_Name | 全部 | 点位名称 |
| Present_Value | 全部 | 扫描时刻的值快照 |
| Status_Flags | 全部 | 报警、故障、被强制、脱离服务四个标志 |
| Description | 全部 | 描述，设备的可读标签常放在这里而非 Object_Name |
| Units | 模拟量类 | 工程单位，如 degrees-celsius |
| Number_Of_States | 多状态类 | 状态总数 |
| State_Text | 多状态类 | 每个状态的名称，最多记录 16 个 |
| Inactive_Text | 二进制类 | 值为 0 时的含义，如"停止" |
| Active_Text | 二进制类 | 值为 1 时的含义，如"运行" |