BACnet.Serial 4.0.0-beta.1

.NET library for BACnet

A standalone BACnet protocol stack for .NET.

The stack was originally developed by Morten Kvistgaard — with significant contributions from F. Chaxel, Steve Karg, and the BACnet Stack (in C) — as part of YABE (Yet Another BACnet Explorer). This repository was forked from the YABE SourceForge SVN and is maintained here as an independent library on NuGet; it is a separate codebase from YABE (YABE keeps its own copy of the stack).

Packages

Package	Description
	Core stack — pure-managed BACnet/IP, MS/TP & PTP protocol, encode/decode. No native dependencies.
	pcap-based BACnet/Ethernet (ISO 8802-3) transport (SharpPcap / PacketDotNet).
	Physical serial-port transport (System.IO.Ports) for MS/TP and PTP.
	Optional bridge to route the stack's logs to Common.Logging.

Supported target frameworks

netstandard2.0 covers .NET 6/7 and other runtimes.

Install

dotnet add package BACnet
# optional native transports:
dotnet add package BACnet.Ethernet
dotnet add package BACnet.Serial

Getting started

A minimal Who-Is / read a property over BACnet/IP:

using System.IO.BACnet;

var client = new BacnetClient(new BacnetIpUdpProtocolTransport(0xBAC0));
client.OnIam += (sender, adr, deviceId, maxApdu, seg, vendorId)
    => Console.WriteLine($"Found device {deviceId} at {adr}");
client.Start();
client.WhoIs();

The Examples/ folder has runnable samples — basic read/write, a device/server, COV subscription, alarm/event handling, BBMD, a serial device, and more.

Logging

The stack uses Microsoft.Extensions.Logging. By default logging is a no-op; wire a factory once and everything logs through it:

using Microsoft.Extensions.Logging;

BacnetLogging.Factory = LoggerFactory.Create(b => b.AddConsole());

Console, Serilog, NLog, and log4net all work via their MEL providers. If you already use Common.Logging, add the BACnet.Logging.CommonLogging package and call b.AddCommonLogging().

Upgrading from 3.x to 4.0

4.0 has a few breaking changes — see MIGRATION.md for details:

• Logging moved from Common.Logging to Microsoft.Extensions.Logging (the Log property is now ILogger).
• Native transports split into optional packages: pcap → BACnet.Ethernet, serial → BACnet.Serial. The MS/TP and PTP protocols stay in the core; use SerialTransport.Mstp(...) / .Ptp(...) from BACnet.Serial.

GitHub Packages

Releases are also published to GitHub Packages. To restore from there, add the source https://nuget.pkg.github.com/ela-compil/index.json (a GitHub PAT with read:packages is required).

Contributing

See CONTRIBUTING.md. Licensed under the MIT License.