Skip to content

Releases

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 22:57
cb4e82f

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.json in the GitHub release, written by scripts/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 that versions.yaml marks published: true. images.txt stays.
  • versions.yaml: native_snap7 gains name, version (f6ff90317ca5, the short revision: the SCADACS fork has no releases), roles and published; python_snap7 gains repository, license, roles and published. scripts/check-versions.sh also checks that the Snap7 version is the short revision of the Dockerfile's, and that a reference is published: true exactly when PUBLISHED_ADAPTERS of the Makefile and images: name it.

Changed

  • scripts/report-to-results.py takes the name, repository, version, revision and licence of the references from versions.yaml (scripts/references.py) instead of constants, and refuses an entry without them. results.json is unchanged except that python-snap7 now has its upstream.
  • The Own stack (go-s7comm) workflow scans snap7-interop-otfabric with 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-s7comm requires 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 code 0x03 and no header error. The capture was posted on python-snap7#976 and is kept in go-s7comm's testdata/captures. The otfabric image's 0x03 is 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:2c8c5bcb250d99a6bc11604b5270eb91c00ee58cc7396345f5d6861559c82673

manifest.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

Choose a tag to compare

@github-actions github-actions released this 06 Nov 22:39
83c6b3f

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.tsv is now tests/known-differences.tsv, the name the other *-interop harnesses 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 send 0x0A. scripts/interop.sh, scripts/validate-fixtures.py and the otfabric self-test read the new name; the waiver in results.json is unchanged.

Documentation

  • docs/COMPATIBILITY.md, section Write to a read-only area: the codes 0x03, 0x05 and 0x0A in Siemens, Wireshark, PLC4X, python-snap7 and Snap7; why Snap7 sends 0x0A; that 0x0A also means "range limit exceeded"; and that header-level refusals (0x81/0x04, 0x85, 0x83/0x04 on an S7-300) are a different case from per-item write protection.
  • README.md, docs/CAPABILITIES.md, docs/CONTAINER_CONTRACT.md, docs/FIXTURES.md and own/go-s7comm/README.md link to it. The README's open item is now the real-CPU capture (#19), not "only if Snap7 can emit 0x03".

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:7b2d7691e6f4ea95af6699025ad31946c542f237af543ccae686f6fe79b5cd5e

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.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 18:00
8207cc1

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 now adapters/ (adapters/native, adapters/python); docs/compatibility.md is docs/COMPATIBILITY.md.
  • scripts/lib.sh, scripts/smoke.sh <adapter> and scripts/interop.sh <adapter-a> <adapter-b> replace scripts/interop-run.sh and the Makefile's _smoke-run. image_of takes ADAPTER_IMAGE_<adapter>, and VERSION=vX.Y.Z tests the images of a release. The smoke test now also checks that a missing fixture is refused before readiness, that server_ready is 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 in tests/known-bugs.tsv is a known-difference with a waiver; an entry that no longer reproduces fails the run.
  • The otfabric self-test uses these scripts; own/go-s7comm/selftest.sh, verdict.py and known-differences.tsv are gone. Its one known difference (read-only write, 0x03 against 0x0A) is in tests/known-bugs.tsv.

Added

  • tests/cases.tsv (the fixtures scripts/interop.sh runs) and tests/known-bugs.tsv, checked against the fixtures by scripts/validate-fixtures.py.
  • scripts/check-versions.sh: the pins of the Dockerfiles and requirements.txt against versions.yaml. Also scripts/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, with own/ 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 the policy.yml workflow.

Breaking changes

  • None for consumers. A local script or CI job that calls scripts/interop-run.sh or paths under servers/ must use scripts/interop.sh native python and adapters/.

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:872d2130b66ef2ec3ff05597c2e92c94167f035d9ab8ad2d096f440def2e0daa

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.5.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 17:17
667f113

Date: 2026-11-06
Previous release: v0.4.2

Summary

  • Our own stack behind the contract (ADR-0012 in otfabric/engineering): own/go-s7comm/ builds ghcr.io/otfabric/snap7-interop-otfabric, the go-s7comm server package behind the container contract, adapter name otfabric. 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 :latest from main. Known difference: it answers a write to a read-only area with 0x03 where the references send 0x0A (own/go-s7comm/known-differences.tsv).

  • Contract 1.1: adds the otfabric image, its version command and independentEngine: false in 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/text moves to v0.41.0 (govulncheck), which requires it; versions.yaml and CI follow.

  • CI and release run on native runners: each architecture builds on its own GitHub runner (ubuntu-latest for amd64, ubuntu-24.04-arm for 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.sh extracts it; make lint, CI and the release workflow fail when the notes of the version are missing.

  • Harness fixes: interop-probe applies --timeout per request, as documented, rather than once to the whole session. A step after a failed reconnect reports a transport failure instead of panicking. junit.xml counts an invalid fixture as a failure. fixturectl rejects a JSON number of exactly 2^63 (int64) or 2^64 (uint64); use the string form. fixturectl reports an overlap for a bool patch of a bit already set, or over a one-byte uint8 patch or initializer, unless it has replace: 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:714bbb100300ca6c9408534f63a69a9450bcf53698f2cd86bfc8cf74fb5b75ce

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.4.2

Choose a tag to compare

@github-actions github-actions released this 01 Nov 01:10

Date: 2026-11-01
Previous release: v0.4.1

Changed

  • The Release workflow 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:91c237bee45bb484ea47821fc93a4f0422cec2d8b4c4d2444eca710f3ad1d2d9

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.4.1

Choose a tag to compare

@github-actions github-actions released this 31 Oct 11:48

Date: 2026-10-31
Previous release: v0.4.0

Changed

  • Policy 1.2: build output in bin/ and release/, 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:5d85efe286d05c91f1aabbe227c3997f3d1060c510c6b577b929434e782494ce

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.4.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 18:25
4f0c22c

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 interop derives it from the fixture reports, one result per fixture with the ID fixture.<fixture-id>. Only pass counts 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:7727dfeaf53df558bf10d4acc13b3f7ed3402d437d293541f46d9815c65b8f76

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.3.0

Choose a tag to compare

@github-actions github-actions released this 19 Oct 13:08
aa276ef

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

Choose a tag to compare

@github-actions github-actions released this 19 Oct 11:27
5a034a6

What's Changed

  • Release v0.2.0: docs fixes, image scan CVEs and python-snap7 3.2.1 by @boeboe in #1
  • build: drop pip from the Python runtime image by @boeboe in #3

New Contributors

  • @boeboe made their first contribution in #1

Full Changelog: v0.1.0...v0.2.0

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 17 Jul 12:51