BACnet4J 技术文档

安装指南

BACnet4J 是一个纯Java编写的BACnet协议实现库，支持IPv4、IPv6和MS/TP协议。为了在您的项目中使用BACnet4J，您需要遵循以下步骤进行安装配置：

Maven 用户

对于Maven项目，将以下仓库添加到您的 pom.xml 文件中：

<repositories>
    <repository>
        <id>ias-snapshots</id>
        <name>Infinite Automation Snapshot Repository</name>
        <url>https://maven.mangoautomation.net/repository/ias-snapshot/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
    <repository>
        <id>ias-releases</id>
        <name>Infinite Automation Release Repository</name>
        <url>https://maven.mangoautomation.net/repository/ias-release/</url>
        <releases>
            <enabled>true</enabled>
        </releases>
    </repository>
</repositories>

然后，根据您使用的BACnet4J版本，加入相应的依赖。如果是5.0及以上版本：

<dependency>
    <groupId>com.infiniteautomation</groupId>
    <artifactId>bacnet4j</artifactId>
    <version>具体的版本号如x.x.x</version>
</dependency>

对于5.0之前的版本，则需要：

<dependency>
    <groupId>com.serotonin</groupId>
    <artifactId>bacnet4j</artifactId>
    <version>对应的旧版号x.x.x</version>
</dependency>

非Maven 用户

非Maven用户需手动下载对应版本的jar文件，并将其添加到项目的类路径中。

项目的使用说明

1. 初始化本地设备: 创建并启动一个LocalDevice实例是使用BACnet4J的基础。

   LocalDevice localDevice = new LocalDevice(1234, new DefaultBBMD(BBMD_ADDRESS, 47808));
   localDevice.start();
   

2. 对象操作: 您可以创建、读取、更新或删除BACnet对象。

3. 网络通信: 利用BACnet4J发送请求，例如读取远程设备的属性。

   ObjectIdentifier oi = new ObjectIdentifier(ObjectType.binaryValue, 1);
   ReadPropertyMultipleRequest req = new ReadPropertyMultipleRequest(new ObjectIdentifier[]
       {oi}, new PropertyReference[]{new PropertyReference(PropertyIdentifier.presentValue)});
   Apdu apdu = req.encodeRequest(null);
   // 发送请求逻辑...
   

项目API使用文档

BACnet4J提供了丰富的API来操作BACnet对象和服务，重要接口和类包括但不限于：

• LocalDevice: 表示当前运行的BACnet设备，控制设备的行为和配置。
• Network: 管理网络连接和寻址。
• ReadPropertyRequest: 请求远程设备的单个属性值。
• WritePropertyRequest: 修改远程设备的单个属性值。
• Object: 抽象基类，具体对象类型如AnalogInput, BinaryValue,等继承自它。

查看Javadoc或源码注释以获取每个类和方法的详细信息。

版本更新与特性

• 版本6.0.1: 允许日程安排中的NULL值。
• 版本6.0.0: 更新了设备对象测试，移除自动检索扩展设备信息，需通过监听器实现。

更多版本详情，请参照官方发布的更新日志。

---

以上就是对BACnet4J的基本安装、使用以及部分API介绍。请注意，实际应用中应详细阅读官方文档以确保正确且高效地使用该库。若有商业用途，请考虑其GPL许可下的限制，并联系相关方获取可能的商业许可证。