Repository navigation
sparkplugb-interop v0.1.0
Date: 2026-10-27
Summary
First release: Sparkplug B 3.0.0 edge nodes and host applications of
independent implementations as multi-arch images with one container
contract, two fixtures, and pinned MQTT brokers to run them on.
Changes
Added
- Container contract 0.1 (docs/CONTAINER_CONTRACT.md):
edge,host,callover a control socket,print-capabilities,print-fixture,version; JSON Lines events, call result documents, fixed exit codes. - Fixtures
baseline(node with two devices, writable metrics, two updates) andscalars(all 14 scalar datatypes at their limits), with a JSON Schema and a validator for the cross-field rules. - Adapter images: Eclipse Tahu 1.0.21 (Java, edge and host), pysparkplug 0.6.1 (Python, edge and host), SparkplugNet 1.4.1 (C#, edge and host), srad 0.5.0 (Rust, edge and host), Eclipse Tahu sparkplug-client 3.2.4 (JavaScript, edge) and sparkplughost v0.4.0 (Go, host). See README.md.
- Broker pins: Eclipse Mosquitto, HiveMQ CE, EMQX and NanoMQ, by multi-arch digest in
versions.yamlandmanifest.json. - Self-tests:
scripts/smoke.sh(contract of one image) andscripts/interop.sh(every host against every edge, every fixture, any broker), with expectations computed from the fixture, andtests/known-bugs.tsvfor verified upstream defects. - Schemas for capability documents, call results and events;
make documentsvalidates every document the self-tests produce. - CI natively on amd64 and arm64, the cross-stack self-test on every broker, and a tag-driven release to GHCR.
- Upstream candidates workflow, weekly and on demand: the latest release of every adapter library and broker against its pin, with a self-test of each newer one and a decision table (
make upstream,make candidate-<name>).
Upstream notes
The self-test passes on all four brokers with 0 failures. Verified upstream defects are listed in tests/known-bugs.tsv and described in docs/COMPATIBILITY.md.
Not in this release
- Templates, DataSets, arrays and properties in fixtures.
- A choice of MQTT version (every adapter speaks MQTT 3.1.1 except srad, which speaks MQTT 5 only), TLS and broker authentication.
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/sparkplugb-interop-tahu:v0.1.0 |
sha256:913e97106f4ea9388b7688aca748bf96a6ae344fe5308207ebbbe200d8eaebcb |
ghcr.io/otfabric/sparkplugb-interop-pysparkplug:v0.1.0 |
sha256:7473b1ceb06e26a6a8541546fada998eb222ea9464d031ad56ab7a5badb36e44 |
ghcr.io/otfabric/sparkplugb-interop-sparkplugnet:v0.1.0 |
sha256:919fce5b243a370656ddcb082ef95d0a4f001b991c7521ba3a06e64aa8a74a39 |
ghcr.io/otfabric/sparkplugb-interop-srad:v0.1.0 |
sha256:dddf909f714c0b7d606871e7adb9bd4034d4cad6b0fbd3133dd00daf12662633 |
ghcr.io/otfabric/sparkplugb-interop-tahu-js:v0.1.0 |
sha256:d278a2eebb12c34a05a29a126fc17908e9b9058666ea9f26d1f475edd0401b3e |
ghcr.io/otfabric/sparkplugb-interop-sparkplughost:v0.1.0 |
sha256:69265cbb76a542248b265db2c34ad3b5fc5add5d68a4adc85d91bdabd8a8cd60 |
Brokers
docker.io/library/eclipse-mosquitto:2.1.2-alpine@sha256:860aeb5d63ce509508f6dcfb2bc8a1c1dd2bc60555b562b45ce90e52d8dabb0fdocker.io/hivemq/hivemq-ce:2026.5@sha256:bac6d4d1d815bffe4bc9a7fca8d06ea12b32d34f84ef2f1851ff4548560ee67bdocker.io/emqx/emqx:6.3.2@sha256:135116400e11b25224350b2e55c874f4e224d357b593fb554ca1b1f398c631acdocker.io/emqx/nanomq:0.25.7@sha256:ed5a9bb892f58e59aa4e47a9932fb7e056f5ae57ba201414c793b8c961587784
Pinning in a consumer
SPARKPLUGB_INTEROP_TAHU_IMAGE=ghcr.io/otfabric/sparkplugb-interop-tahu@sha256:913e97106f4ea9388b7688aca748bf96a6ae344fe5308207ebbbe200d8eaebcb
SPARKPLUGB_INTEROP_PYSPARKPLUG_IMAGE=ghcr.io/otfabric/sparkplugb-interop-pysparkplug@sha256:7473b1ceb06e26a6a8541546fada998eb222ea9464d031ad56ab7a5badb36e44
SPARKPLUGB_INTEROP_SPARKPLUGNET_IMAGE=ghcr.io/otfabric/sparkplugb-interop-sparkplugnet@sha256:919fce5b243a370656ddcb082ef95d0a4f001b991c7521ba3a06e64aa8a74a39
SPARKPLUGB_INTEROP_SRAD_IMAGE=ghcr.io/otfabric/sparkplugb-interop-srad@sha256:dddf909f714c0b7d606871e7adb9bd4034d4cad6b0fbd3133dd00daf12662633
SPARKPLUGB_INTEROP_TAHU_JS_IMAGE=ghcr.io/otfabric/sparkplugb-interop-tahu-js@sha256:d278a2eebb12c34a05a29a126fc17908e9b9058666ea9f26d1f475edd0401b3e
SPARKPLUGB_INTEROP_SPARKPLUGHOST_IMAGE=ghcr.io/otfabric/sparkplugb-interop-sparkplughost@sha256:69265cbb76a542248b265db2c34ad3b5fc5add5d68a4adc85d91bdabd8a8cd60manifest.json records the upstream versions these images were built from and the brokers they were tested on. The images contain EPL-2.0, Apache-2.0, MIT and BSD software; see THIRD_PARTY_NOTICES.md and /licenses in each image.