Skip to content

basis-adapters v0.1.0-rc.1

Choose a tag to compare

View all tags
@basauth basauth released this 11 Jun 17:55
· 12 commits to main since this release
v0.1.0
2b80d26
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

basis-adapters v0.1.0-rc.1

Initial release candidate for basis-adapters.

Overview

basis-adapters is the protocol normalization layer of the BASIS ecosystem.

The project demonstrates that diverse operational technology (OT) protocol and platform operations can normalize into a shared authorization request model while preserving protocol evidence for auditability.

The adapter layer is intentionally focused on normalization.

It is not:

  • a protocol gateway
  • a protocol client or server implementation
  • a device controller
  • an identity provider
  • a policy engine
  • a runtime enforcement boundary

The architectural invariant remains:

Adapters normalize.
Gateway enforces.
Kernel evaluates.

Included Adapters

This release includes normalization support for:

  • REST
  • BACnet
  • Modbus
  • OPC UA
  • MQTT
  • DNP3
  • IEC 61850
  • KNX
  • Niagara

These adapters collectively cover:

  • Web APIs
  • Building Automation
  • Industrial Control
  • Utility Infrastructure
  • Messaging Systems
  • Supervisory Building Automation Platforms

Architectural Result

All supported adapters normalize protocol-specific operations into the same canonical authorization request shape while preserving protocol evidence.

Examples include:

  • BACnet object/property operations
  • Modbus register operations
  • OPC UA methods, browsing, and subscriptions
  • MQTT publish and subscribe operations
  • DNP3 control and read operations
  • IEC 61850 control and reporting operations
  • KNX group-address operations
  • Niagara platform operations

No protocol required changes to the canonical authorization model.

Highlights

  • Nine protocol and platform adapters
  • Cross-protocol normalization contract testing
  • Schema validation coverage
  • Fail-closed adapter behavior
  • Protocol evidence preservation
  • Deterministic resource mapping
  • GitHub Actions quality gates
  • Public API documentation
  • Release-readiness review completed

Quality

This release candidate passes:

  • pytest
  • ruff check
  • ruff format --check
  • mypy (strict)

and includes:

  • 1,400+ automated tests
  • schema validation tests
  • cross-protocol parity tests
  • adapter contract tests

Project Status

This release is considered:

Normalization-complete

for the initial planned adapter roadmap.

This release is not:

Wire-protocol complete

No live protocol communication, packet parsing, protocol stacks, broker integrations, device integrations, or runtime gateways are included.

License

Apache License 2.0

Next Steps

Future work will focus on:

  • ecosystem integration
  • runtime integration research
  • release hardening
  • broader BASIS platform capabilities

rather than expansion of the initial adapter roadmap.

Assets 2
Loading