Skip to content

Atoll lab preview 0.0.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@thirtykdev thirtykdev released this 15 Oct 12:01
· 4 commits to main since this release
lab-0.0.1
6caed73

Atoll lab preview 0.0.1

A single file per platform. A lab preview, not a release. It exists so the install and first-run experience can be tried against a BACnet lab. Nothing here is on the website's download page on purpose.

Run it

  • macOS (Apple silicon: atoll-darwin-arm64; Intel: atoll-darwin-x64): chmod +x atoll-darwin-arm64 && ./atoll-darwin-arm64. The file is signed ad hoc, not notarized, so Gatekeeper will object once: right-click → Open, or xattr -d com.apple.quarantine atoll-darwin-arm64.
  • Linux (atoll-linux-x64, atoll-linux-arm64): chmod +x atoll-linux-x64 && ./atoll-linux-x64.
  • Windows (atoll-win-x64.exe): double-click. SmartScreen will warn because the file is not code-signed: More info → Run anyway.

It opens http://127.0.0.1:2865 in your browser and asks three things: the site's name, your name, and whether to read the network over BACnet/IP (broadcast address, optional direct targets such as a JACE). Then import a station backup (.bog, .dist) and the controller files for the same job (.caf, .gfx) by dropping them on the page.

No hardware nearby? ./atoll-darwin-arm64 serve --installed --lab-device --open starts two synthetic BACnet devices on your machine for discovery to find.

What it does and does not do

  • Reads only. There is no write encoder in the BACnet connector; the test suite asserts it.
  • Discovers every device and object it can see and polls present values. No add-points step.
  • Correlates the station, the controller files and the network by device instance and object identity; lists what a controller exposes that the station never pulled in.
  • Keeps everything in your user application folder: an append-only model log and artifacts encrypted at rest. Delete the folder to remove everything. Nothing leaves the machine.
  • Permissions: a seeded set of identities to switch between (administrator, technician, scoped night operator, viewer) to see what each may do. Real accounts and sign-in come with the first release; for now Atoll listens on 127.0.0.1 only.

Known limits

  • Linux and Windows binaries were built but not run here; macOS Apple silicon was tested end to end.
  • Discovery reads each device's object list one index at a time, so a device with hundreds of objects takes a while on first discovery.
  • Polling only; no change-of-value subscriptions yet. No histories or alarms from BACnet yet.
  • The .caf and .gfx readers are validated on synthetic fixtures only and report what they do not understand.
  • Run one Atoll per machine: two of them share UDP 47808 and steal each other's replies.

Checksums in SHA256SUMS.txt.

Assets 9
Loading