bacnet.sourceforge.netBACnet stack - open source BACnet protocol stack

BACnet Stack An open source BACnet protocol stack for embedded systems About this Project This BACnet protocol stack library provides a BACnet application layer, network layer and media access (MAC) layer communications services. It is an open source, royalty-free library for an embedded system, Windows, Linux, or other operating system. Example BACnet client and server applications are included. BACnet - A Data Communication Protocol for Building Automation and Control Networks - see bacnet.org . BACnet is a standard data communication protocol for Building Automation and Control Networks. BACnet is an open protocol, which means anyone can contribute to the standard, and anyone may use it. The only caveat is that the BACnet standard document itself is copyrighted by ASHRAE, and they sell the document to help defray costs of developing and maintaining the standard (just like IEEE or ANSI or ISO). For software developers, the BACnet protocol is a standard way to send and receive messages on the wire containing data that is understood by other BACnet compliant devices. The BACnet standard defines a standard way to communicate over a number of wires, known as Data Link/Physical Layers: Ethernet, EIA-485, EIA-232, ARCNET, and LonTalk. The BACnet standard also defines a standard way to communicate using UDP, IP and HTTP (Web Services). There are other open source projects for BACnet: Yabe - Graphical explorer program for BACnet devices. Small graphical explorer program written in C#, for browsing BACnet devices. Currently supports both BACnet/IP, BACnet MSTP, and BACnet PTP. Basic functions for ReadProperty, WriteProperty, ReadPropertyMultiple, WritePropertyMultiple, I-Am, Who-Is, SubscribeCOV, Notify, AtomicWriteFile, AtomicReadFile, and more. VTS - visual test shell for Win32, used for Visually testing a BACnet implementation. It also includes a detailed network sniffer for BACnet messages, and the ability to send any BACnet services. The source code is in the public domain. Wireshark - an open source, cross platform protocol analyzer with BACnet support. The detailed BACnet support began in version 0.10.11 released on May 4, 2005 when Wireshark was known as Ethereal. BACnet4Linux - an LGPL BACnet application that requires Linux as the OS. BACnet Firewall Router -an application that combines BACnet routing capability with traffic management functions to carefully control access to building automation and control networks. BACpypes - a BACnet stack written in Python. BACsharp - a BACnet/IP stack written in C#. BACnet4J - a BACnet/IP stack written in Java that serves as the BACnet layer for Mango . Mango is open source Machine-to-Machine software (aka Industrial Control, SCADA, HMI, or domotics). There are also commercial BACnet protocol source code libraries for BACnet that are designed for embedded use: Cimetrics TM - has a source library called BACstac/32 as part of their BACNet Protocol Stack SDK. Polarsoft - has a protocol stack source library for embedded use called FreeRange TM and PolarSoft® FreeRange VSB (Very Small BACnet stack). SCADA Engine - The BACnet Linux Server is a complete BACnet Device running on the linux platform. The entire source code is available for custom applications and has been written in ANSI C which has been succesfully ported to Unix, VxWorks etc. BACnet Stack - Chipkin automation systems BACnet stack is an application layer BACnet library for an embedded system and application development. Licensing Our BACnet protocol stack implementation is specifically designed for the embedded BACnet appliance, using a GPL with exception license (like eCos ), which means that any changes to the core code that are distributed are made available, but the BACnet library can be linked to proprietary code without it becoming licensed under the GPL. See the eCos license overview for easy to read details about this exception to the GPL. The license does not require users to release the source code of any applications that are developed with this BACnet stack - only portions of the BACnet stack that have been modified. Note that those files in this BACnet stack that are expected to be modified are licensed using the MIT License . The text of the GPL exception included in each source file is as follows: "As a special exception, if other files instantiate templates or use macros or inline functions from this file, or you compile this file and link it with other works to produce a work based on this file, this file does not by itself cause the resulting work to be covered by the GNU General Public License. However the source code for this file must still be made available in accordance with section (3) of the GNU General Public License." The source code The source code is written in C for portability, and includes unit tests (PC based unit tests) and example application code. Since the code is designed to be portable, it compiles with GCC as well as other compilers, such as Borland C++, Visual C++, MinGW, Code Warrior, IAR, or MicroChip C18. The source code is also designed to be high quality, readable, understandable, and easy to use. The BACnet protocol is an ASHRAE/ANSI/ISO standard, so this library adheres to that standard. BACnet has no royalties or licensing restrictions, and registration for a BACnet vendor ID is free. What the code does The BACnet stack comes with example applications that can be run under Linux, Win32, RTOS-32, and just about any embedded microcontroller. The BACnet stack includes unit tests can be run in a command shell on Linux using the unittest.sh script, or using individual .mak files. They were tested under Debian GNU/Linux and Ubuntu Linux . The BACnet stack was functionally tested using VTS (Visual Test Shell) , another project hosted on SourceForge, as well as various BACnet controllers, BACnet workstations, and through BACnet routers. Some versions of the BACnet stack were BTL tested. Demo BACnet Applications Using a master Makefile in the project root directory, a dozen demo applications can be created that run under Linux or Win32. Linux supports BACnet Ethernet, BACnet/IP, or ARCNET data link layer for communication, and BACnet/IP is supported under Win32. BACnet Ethernet can also be used under Win32 with the WinPcap library . Root priveleges are required to run the Ethernet or ARCNET interfaces on Linux, but are not needed to run BACnet/IP. MS/TP support under Windows or Linux using a USB to RS-485 device is a work in progress. To build all the demo applications under linux using the BACnet/IP datalink layer, use the familiar make command: $ make clean all You can also modify the Makefile variabiles from the command line to build with the BACnet MS/TP datalink layer, for example: $ make BACDL_DEFINE=-DBACDL_MSTP=1 clean all To build all the demo applications under Windows with the BACnet/IP datalink layer and utilizing the MinGW tools , use the build.bat file provided in the root directory. Note that you may have to copy the mingw-make.exe to make.exe to enable the compile. $ build.bat To build all the demo applications under Windows with the BACnet/IP datalink layer and utilizing the Borland tools , use the borland.bat file provided in the root directory. $ borland.bat To build all the demo applications under Windows using the BACnet/IP datalink layer utilizing the Code::Blocks tools, use the BACnetDemo.workspace file provided in the demo directory. The demo application accept command line arguments. To specify an array index of ALL, use "-1". To make a priority optional, use "0". The applications also use environment variables to set datalink layer preferences. Use help on the command line to see more options. $ demo/server/bacsrv 123 BACnet Server Demo - Device #123 $ demo/readprop/bacrp bacrp device-instance object-type object-instance property [index] $ demo/writeprop/bacwp bacwp device-instance object-type object-instance property priority index tag value [tag value...] $ demo/readfile/bacarf...