Repository navigation
Releases
v0.7.0
Date: 2026-11-15
Previous release: v0.6.1
Summary
The release publishes manifest.json, and versions.yaml records every reference with the fields results.json and the manifest take from it. OT Fabric's own image is scanned before it is pushed. Images, the container contract and the fixtures are unchanged.
Added
manifest.jsonin the GitHub release, written byscripts/release-manifest.py: the release version and commit, the contract and fixture schema versions, the platforms, and per published reference its image by digest and its upstream (name, repository, version, revision, licence, roles). The release fails without a digest for every reference thatversions.yamlmarkspublished: true.images.txtstays.versions.yaml:native_snap7gainsname,version(f6ff90317ca5, the short revision: the SCADACS fork has no releases),rolesandpublished;python_snap7gainsrepository,license,rolesandpublished.scripts/check-versions.shalso checks that the Snap7 version is the short revision of the Dockerfile's, and that a reference ispublished: trueexactly whenPUBLISHED_ADAPTERSof the Makefile andimages:name it.
Changed
scripts/report-to-results.pytakes the name, repository, version, revision and licence of the references fromversions.yaml(scripts/references.py) instead of constants, and refuses an entry without them.results.jsonis unchanged except that python-snap7 now has itsupstream.- The Own stack (go-s7comm) workflow scans
snap7-interop-otfabricwith the release gate (Trivy, fixable CRITICAL and HIGH) before it pushes it. SECURITY.md says that this image is scanned like the release images and that it has a floating:latest, which a rebuild replaces. own/go-s7commrequires go-cotp v1.4.2 and go-tpkt v1.2.2 (fewer allocations per segment and packet; nothing changes on the wire or in the API). The image is published by hand, outside this release.- CONTRIBUTING.md, When CI runs: what the release workflow runs.
Documentation
docs/COMPATIBILITY.md, Write to a read-only area, and the README: a real CPU 1214C DC/DC/DC (S7-1200, firmware V4.2) answers a write to a write-protected DB with item code0x03and no header error. The capture was posted on python-snap7#976 and is kept in go-s7comm'stestdata/captures. Theotfabricimage's0x03is the code this CPU sends. An S7-300 or S7-1500 is still open (#19).
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/snap7-interop-native:v0.7.0 |
sha256:5d15923abaf53186a0732fc4e0c64b3b4a2a70432f643a9a3eda1c2cf9e5b9ef |
ghcr.io/otfabric/snap7-interop-python:v0.7.0 |
sha256:2c8c5bcb250d99a6bc11604b5270eb91c00ee58cc7396345f5d6861559c82673 |
Pinning in a consumer
docker pull ghcr.io/otfabric/snap7-interop-native@sha256:5d15923abaf53186a0732fc4e0c64b3b4a2a70432f643a9a3eda1c2cf9e5b9ef
docker pull ghcr.io/otfabric/snap7-interop-python@sha256:2c8c5bcb250d99a6bc11604b5270eb91c00ee58cc7396345f5d6861559c82673manifest.json (and images.txt) and versions.yaml record the images and the upstream pins they were built from. The native image contains Snap7 (LGPL-3.0-or-later), the Python image python-snap7 (MIT); see THIRD_PARTY_NOTICES.md.
v0.6.1
Date: 2026-11-06
Previous release: v0.6.0
Summary
The read-only write difference of the otfabric image (item code 0x03 where both references send 0x0A) is reclassified as an intentional semantic difference and documented against the Siemens codes. Images, the container contract and the fixtures are unchanged.
Changed
tests/known-bugs.tsvis nowtests/known-differences.tsv, the name the other*-interopharnesses use for classified differences of a pin. Its one entry gives the Siemens STEP 7 V20 Use of FETCH/WRITE page as evidence and says why the references send0x0A.scripts/interop.sh,scripts/validate-fixtures.pyand the otfabric self-test read the new name; the waiver inresults.jsonis unchanged.
Documentation
docs/COMPATIBILITY.md, section Write to a read-only area: the codes0x03,0x05and0x0Ain Siemens, Wireshark, PLC4X, python-snap7 and Snap7; why Snap7 sends0x0A; that0x0Aalso means "range limit exceeded"; and that header-level refusals (0x81/0x04,0x85,0x83/0x04on an S7-300) are a different case from per-item write protection.README.md,docs/CAPABILITIES.md,docs/CONTAINER_CONTRACT.md,docs/FIXTURES.mdandown/go-s7comm/README.mdlink to it. The README's open item is now the real-CPU capture (#19), not "only if Snap7 can emit0x03".
Open
- Real-CPU evidence and the clarification questions to python-snap7, Snap7 (SCADACS) and Apache PLC4X: #19.
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/snap7-interop-native:v0.6.1 |
sha256:b2ac7b3d0d8cb1dc1ac5d7e465a118eb484a2506ea67b10be6ff7579ac5d5a97 |
ghcr.io/otfabric/snap7-interop-python:v0.6.1 |
sha256:7b2d7691e6f4ea95af6699025ad31946c542f237af543ccae686f6fe79b5cd5e |
Pinning in a consumer
docker pull ghcr.io/otfabric/snap7-interop-native@sha256:b2ac7b3d0d8cb1dc1ac5d7e465a118eb484a2506ea67b10be6ff7579ac5d5a97
docker pull ghcr.io/otfabric/snap7-interop-python@sha256:7b2d7691e6f4ea95af6699025ad31946c542f237af543ccae686f6fe79b5cd5eimages.txt and versions.yaml record the images and the upstream pins they were built from. The native image contains Snap7 (LGPL-3.0-or-later), the Python image python-snap7 (MIT); see THIRD_PARTY_NOTICES.md.
v0.6.0
Date: 2026-11-06
Previous release: v0.5.0
Summary
The repository layout of every otfabric *-interop harness (engineering/docs/own-stack-rollout.md). Image names, the container contract and the fixtures are unchanged.
Changed
servers/is nowadapters/(adapters/native,adapters/python);docs/compatibility.mdisdocs/COMPATIBILITY.md.scripts/lib.sh,scripts/smoke.sh <adapter>andscripts/interop.sh <adapter-a> <adapter-b>replacescripts/interop-run.shand the Makefile's_smoke-run.image_oftakesADAPTER_IMAGE_<adapter>, andVERSION=vX.Y.Ztests the images of a release. The smoke test now also checks that a missing fixture is refused before readiness, thatserver_readyis logged, and that SIGTERM stops the server with exit code 0.- The results writer takes each server's adapter and image. The references' independence comes from
versions.yaml, and any other image's from what it reports (version). A failing step listed intests/known-bugs.tsvis aknown-differencewith a waiver; an entry that no longer reproduces fails the run. - The otfabric self-test uses these scripts;
own/go-s7comm/selftest.sh,verdict.pyandknown-differences.tsvare gone. Its one known difference (read-only write,0x03against0x0A) is intests/known-bugs.tsv.
Added
tests/cases.tsv(the fixturesscripts/interop.shruns) andtests/known-bugs.tsv, checked against the fixtures byscripts/validate-fixtures.py.scripts/check-versions.sh: the pins of the Dockerfiles andrequirements.txtagainstversions.yaml. Alsoscripts/retry.sh.- Makefile:
ADAPTERS,PUBLISHED_ADAPTERS,all,validate,documents,smoke,capabilities(interop-probe capabilities),print-adapters,print-published-adapters,buildx-setup,buildx,publish-arch,publish-manifest,digests,clean. The old target names still work. REQUIREMENTS.md(R1 isolation, withown/as the one exception),docs/FIXTURES.md(the fixture catalog, moved from README),docs/CAPABILITIES.md(the capability matrix, moved from COMPATIBILITY, with otfabric),licenses/(LGPL-3.0 and GPL-3.0 texts for Snap7),.dockerignore, and thepolicy.ymlworkflow.
Breaking changes
- None for consumers. A local script or CI job that calls
scripts/interop-run.shor paths underservers/must usescripts/interop.sh native pythonandadapters/.
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/snap7-interop-native:v0.6.0 |
sha256:0ec6fe3b03ba4f7765b64290b7e8014c9958170f4711a588f8745bf75c2782dc |
ghcr.io/otfabric/snap7-interop-python:v0.6.0 |
sha256:872d2130b66ef2ec3ff05597c2e92c94167f035d9ab8ad2d096f440def2e0daa |
Pinning in a consumer
docker pull ghcr.io/otfabric/snap7-interop-native@sha256:0ec6fe3b03ba4f7765b64290b7e8014c9958170f4711a588f8745bf75c2782dc
docker pull ghcr.io/otfabric/snap7-interop-python@sha256:872d2130b66ef2ec3ff05597c2e92c94167f035d9ab8ad2d096f440def2e0daaimages.txt and versions.yaml record the images and the upstream pins they were built from. The native image contains Snap7 (LGPL-3.0-or-later), the Python image python-snap7 (MIT); see THIRD_PARTY_NOTICES.md.
v0.5.0
Date: 2026-11-06
Previous release: v0.4.2
Summary
-
Our own stack behind the contract (ADR-0012 in otfabric/engineering):
own/go-s7comm/buildsghcr.io/otfabric/snap7-interop-otfabric, the go-s7commserverpackage behind the container contract, adapter nameotfabric. It is not an independent implementation and not part of this release: the manual workflow Own stack (go-s7comm) builds it from the latest go-s7comm release, runs the smoke test and every fixture against the reference images of the latest harness release (own/go-s7comm/selftest.sh), and publishes:<go-s7comm version>and:latestfrommain. Known difference: it answers a write to a read-only area with0x03where the references send0x0A(own/go-s7comm/known-differences.tsv). -
Contract 1.1: adds the otfabric image, its
versioncommand andindependentEngine: falsein what it reports. The references are unchanged. -
CI: checks that nothing outside
own/go-s7comm/depends on go-s7comm. -
Go 1.25:
golang.org/x/textmoves to v0.41.0 (govulncheck), which requires it;versions.yamland CI follow. -
CI and release run on native runners: each architecture builds on its own GitHub runner (
ubuntu-latestfor amd64,ubuntu-24.04-armfor arm64) in parallel, with no QEMU emulation. CI now also smoke-tests, scans and runs interop on arm64. The release pushes each image and architecture by digest, then joins them into one signed multi-arch manifest list under the release tags. Both architectures are scanned for fixable CRITICAL and HIGH findings before anything is tagged. -
Release notes come from RELEASE.md, as in every otfabric repository: the section of the tag, up to its
---line, is the body of the GitHub release, followed by the image digests and pin snippets.scripts/release-notes.shextracts it;make lint, CI and the release workflow fail when the notes of the version are missing. -
Harness fixes:
interop-probeapplies--timeoutper request, as documented, rather than once to the whole session. A step after a failed reconnect reports a transport failure instead of panicking.junit.xmlcounts aninvalidfixture as a failure.fixturectlrejects a JSON number of exactly 2^63 (int64) or 2^64 (uint64); use the string form.fixturectlreports an overlap for aboolpatch of a bit already set, or over a one-byteuint8patch or initializer, unless it hasreplace: true; only different bits of one byte may share it.
Breaking changes
- None.
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/snap7-interop-native:v0.5.0 |
sha256:90d0dedc39cfaf5a691933463d4d3b349055cbc0ac530757ed5707c705234412 |
ghcr.io/otfabric/snap7-interop-python:v0.5.0 |
sha256:714bbb100300ca6c9408534f63a69a9450bcf53698f2cd86bfc8cf74fb5b75ce |
Pinning in a consumer
docker pull ghcr.io/otfabric/snap7-interop-native@sha256:90d0dedc39cfaf5a691933463d4d3b349055cbc0ac530757ed5707c705234412
docker pull ghcr.io/otfabric/snap7-interop-python@sha256:714bbb100300ca6c9408534f63a69a9450bcf53698f2cd86bfc8cf74fb5b75ceimages.txt and versions.yaml record the images and the upstream pins they were built from. The native image contains Snap7 (LGPL-3.0-or-later), the Python image python-snap7 (MIT); see THIRD_PARTY_NOTICES.md.
v0.4.2
Date: 2026-11-01
Previous release: v0.4.1
Changed
- The
Releaseworkflow can be run by hand from the Actions tab with a patch, minor or major bump. The adapters, the container contract and the fixtures do not change.
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/snap7-interop-native:v0.4.2 |
sha256:6b97b3233346323508c5c3caf7be3a151fa75ac017592d14919b7112efa46b88 |
ghcr.io/otfabric/snap7-interop-python:v0.4.2 |
sha256:91c237bee45bb484ea47821fc93a4f0422cec2d8b4c4d2444eca710f3ad1d2d9 |
Pinning in a consumer
docker pull ghcr.io/otfabric/snap7-interop-native@sha256:6b97b3233346323508c5c3caf7be3a151fa75ac017592d14919b7112efa46b88
docker pull ghcr.io/otfabric/snap7-interop-python@sha256:91c237bee45bb484ea47821fc93a4f0422cec2d8b4c4d2444eca710f3ad1d2d9images.txt and versions.yaml record the images and the upstream pins they were built from. The native image contains Snap7 (LGPL-3.0-or-later), the Python image python-snap7 (MIT); see THIRD_PARTY_NOTICES.md.
v0.4.1
Date: 2026-10-31
Previous release: v0.4.0
Changed
- Policy 1.2: build output in
bin/andrelease/, and shared CI at v3.3.0.
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/snap7-interop-native:v0.4.1 |
sha256:fa83009716079c75932cd0706beb70bc2128f702e700b6cdc76a5041d92dbacb |
ghcr.io/otfabric/snap7-interop-python:v0.4.1 |
sha256:5d85efe286d05c91f1aabbe227c3997f3d1060c510c6b577b929434e782494ce |
Pinning in a consumer
docker pull ghcr.io/otfabric/snap7-interop-native@sha256:fa83009716079c75932cd0706beb70bc2128f702e700b6cdc76a5041d92dbacb
docker pull ghcr.io/otfabric/snap7-interop-python@sha256:5d85efe286d05c91f1aabbe227c3997f3d1060c510c6b577b929434e782494ceimages.txt and versions.yaml record the images and the upstream pins they were built from. The native image contains Snap7 (LGPL-3.0-or-later), the Python image python-snap7 (MIT); see THIRD_PARTY_NOTICES.md.
v0.4.0
Date: 2026-10-30
Previous release: v0.3.0
Summary
Interop results as the organisation's interop-result-v1.
Changes
Added
reports/results.json(interop-result-v1):make interopderives it from the fixture reports, one result per fixture with the IDfixture.<fixture-id>. Onlypasscounts as passing; a run with no pass fails. Existing reports keep their shape.
Images
| Image | Digest |
|---|---|
ghcr.io/otfabric/snap7-interop-native:v0.4.0 |
sha256:0ca4b825f557ead57025d2ebf7ff9402a1169caf0ab4c18dac7a48c9019c9f7e |
ghcr.io/otfabric/snap7-interop-python:v0.4.0 |
sha256:7727dfeaf53df558bf10d4acc13b3f7ed3402d437d293541f46d9815c65b8f76 |
Pinning in a consumer
docker pull ghcr.io/otfabric/snap7-interop-native@sha256:0ca4b825f557ead57025d2ebf7ff9402a1169caf0ab4c18dac7a48c9019c9f7e
docker pull ghcr.io/otfabric/snap7-interop-python@sha256:7727dfeaf53df558bf10d4acc13b3f7ed3402d437d293541f46d9815c65b8f76images.txt and versions.yaml record the images and the upstream pins they were built from. The native image contains Snap7 (LGPL-3.0-or-later), the Python image python-snap7 (MIT); see THIRD_PARTY_NOTICES.md.
v0.3.0
What's Changed
- fixtures: link go-s7comm's API.md on main by @boeboe in #4
- Rename the module, images and servers to snap7-interop, prepare v0.3.0 by @boeboe in #5
Full Changelog: v0.2.0...v0.3.0
v0.2.0
v0.1.0
Full Changelog: https://github.com/otfabric/snap7-interop/commits/v0.1.0