Skip to main content

BACnet Scripting Framework for testing DDC Controls

Project description

BAC0 Build & Test Coverage Documentation Status

Join the chat at https://gitter.im/ChristianTremblay/BAC0

BAC0 is a asynchronous Python 3 (3.10 and over) scripting application that uses BACpypes3 to process BACnet™ messages on a IP network. This library brings out simple commands to browse a BACnet network, read properties from BACnet devices or write to them.

Python is a simple language to learn and a very powerful tool for data processing. Coupled to BACnet, it becomes a great tool to test devices an interact with controllers.

BAC0 takes its name from the default IP port used by BACnet/IP communication which is port 47808. In hexadecimal, it's written 0xBAC0.

Test driven development (TDD) for DDC controls

BAC0 is made for building automation system (BAS) programmers. Controllers used in this field are commonly called DDC Controllers (Direct Digital Control).

Typical controllers can be programmed in different ways, depending on the manufacturer selling them (block programming, basic "kinda" scripts, C code, etc...). BAC0, is a unified way, using Python language and BACnet/IP communication, to interact with those controllers once their sequence is built.

BAC0 allows users to simply test an application even if sensors are not connected to the controller. Using the out_of_service property, it's easy to write a value to the input so the controller will think an input is connected.

It's also possible to do "manual commands" on output (often called overrides). In fact, every variable is exposed and seen by BAC0 and it's possible to interact with them using a simple scripting language or a complete unit test suite (like Pytest).

Without a program like BAC0, you can rely on your DDC programming tool... but it is often slow and every test must be done manually. That means also that if you want to repeat the tests, the more complicated they are, the less chance you'll be able to do so.

Now you can write your test and run them as often as you want. We'll show you how it works.

Better start-up with data acquisition

As you will discover, when you define a controller in BAC0, you will get access to historical data of every variables in the controllers. Every points are trended every 10 seconds by default. Which means that you can do data analysis on everything while you're doing your startup. It allows to see performances and trouble really fast.

This make BAC0 not only a good tool to test your sequence while your in the office. But also a really good tool to assist your startup, test and balancing. Using Jupyter Notebook, you'll even be able to create nice looking report right from your code.

InfluxDB native support

Connect BAC0 histories directly to a InfluxDB v2.0 instance. It's then possible to use Grafana to explore your data.

Note: BACnet™ is a trademark of ASHRAE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bac0-2024.9.20.tar.gz (92.8 kB view details)

Uploaded Source

Built Distribution

BAC0-2024.9.20-py3-none-any.whl (113.7 kB view details)

Uploaded Python 3

File details

Details for the file bac0-2024.9.20.tar.gz.

File metadata

  • Download URL: bac0-2024.9.20.tar.gz
  • Upload date:
  • Size: 92.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for bac0-2024.9.20.tar.gz
Algorithm Hash digest
SHA256 21a27280f0d4903125320d0297bb83e0c24ac2b1da84dc94f8ff1bc5c157e210
MD5 ee25e87fb4c1f576d5ae7726ac8e0983
BLAKE2b-256 7693d741aacbf241e1a221737555b9276bebf06b73bc7a9e9049d6da37f1fa85

See more details on using hashes here.

File details

Details for the file BAC0-2024.9.20-py3-none-any.whl.

File metadata

  • Download URL: BAC0-2024.9.20-py3-none-any.whl
  • Upload date:
  • Size: 113.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for BAC0-2024.9.20-py3-none-any.whl
Algorithm Hash digest
SHA256 74e030db63249a8e84f50f62e69f5037234e025889b0695e634422f58117516b
MD5 4450c616316b03551c15da6f6c586c71
BLAKE2b-256 a31e737e8251e086f79fd89192fd26de2b725c4d53b56c04546f4eff33155e17

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page