【亲测免费】 BACnet4J 开源项目教程

2026-01-17 08:57:17作者：温玫谨Lighthearted

BACnet4J是一个纯Java编写的BACnet协议实现库，广泛适用于楼宇自动化控制领域。从最初设计用于监控级应用扩展至现今，它全面支持多种对象，使之同样胜任嵌入式系统需求。该库囊括IPv4、IPv6和MS/TP等多种网络协议，确保了在不同环境下的通讯灵活性。版本已更新至6.0系列，带来了增强的功能与修复，如对NULL值的支持、设备信息管理改进及更高效的分段传输。开发者可通过Maven轻松集成，无论是大型基础设施还是精密的楼宇管理系统，BACnet4J都是连接智能建筑设备的理想选择。通过其活跃的社区和技术支持，即使是复杂的应用场景也能得到良好支撑，推动智能化建筑技术的发展。

项目地址：https://gitcode.com/gh_mirrors/bac/BACnet4J

1、项目介绍

BACnet4J 是一个基于 Java 语言的 BACnet 规范实现。它最初是为了监控系统设计，现在已经扩展支持了许多对象类型，因此也适用于嵌入式环境。这个库支持了协议版本1修订19，包括IPv4、IPv6和MS/TP等。

2、项目快速启动

环境准备

Java 8 或更高版本
Apache Maven 2+

克隆项目

git clone https://github.com/infiniteautomation/BACnet4J.git
cd BACnet4J

构建项目

mvn clean install

示例代码

以下是一个简单的示例代码，展示了如何使用 BACnet4J 库来读取 BACnet 设备的属性。

import com.serotonin.bacnet4j.LocalDevice;
import com.serotonin.bacnet4j.RemoteDevice;
import com.serotonin.bacnet4j.npdu.ip.IpNetwork;
import com.serotonin.bacnet4j.npdu.ip.IpNetworkBuilder;
import com.serotonin.bacnet4j.service.acknowledgement.ReadPropertyAck;
import com.serotonin.bacnet4j.service.confirmed.ReadPropertyRequest;
import com.serotonin.bacnet4j.type.constructed.Address;
import com.serotonin.bacnet4j.type.enumerated.ObjectType;
import com.serotonin.bacnet4j.type.enumerated.PropertyIdentifier;
import com.serotonin.bacnet4j.type.primitive.ObjectIdentifier;
import com.serotonin.bacnet4j.type.primitive.UnsignedInteger;
import com.serotonin.bacnet4j.util.DiscoveryUtils;
import com.serotonin.bacnet4j.util.RequestUtils;

public class BACnetExample {
    public static void main(String[] args) throws Exception {
        IpNetwork network = new IpNetworkBuilder()
                .withBroadcast(true)
                .withPort(47808)
                .build();
        LocalDevice localDevice = new LocalDevice(123, network);
        localDevice.initialize();
        localDevice.startRemoteDeviceDiscovery();

        DiscoveryUtils.discoverRemoteDevices(localDevice).forEach(remoteDevice -> {
            System.out.println("Discovered device: " + remoteDevice.getInstanceNumber());
            try {
                ReadPropertyRequest request = new ReadPropertyRequest(
                        new ObjectIdentifier(ObjectType.device, remoteDevice.getInstanceNumber()),
                        PropertyIdentifier.objectName);
                ReadPropertyAck ack = (ReadPropertyAck) localDevice.send(remoteDevice, request).get();
                System.out.println("Device Name: " + ack.getValue().toString());
            } catch (Exception e) {
                e.printStackTrace();
            }
        });
    }
}