Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 25 additions & 24 deletions INTEROPERABILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,7 @@ recordings decode at the CIP level only; their services are not public.
<!-- interop-matrix:begin -->
<!-- Generated by internal/cmd/genmatrix from interop/results/matrix.json. DO NOT EDIT. -->

Run of 2026-11-06T23:13:49Z against otfabric/ethernetip-interop v0.8.1.
Run of 2026-11-15T22:52:12Z against otfabric/ethernetip-interop v0.8.2.

### go-ethernetip as originator (client, scanner) against the reference targets

Expand Down Expand Up @@ -274,7 +274,7 @@ Notes:
- **OpENer, Unconnected_Send routing** (go-ethernetip originator): OpENer answers 0x08: not implemented
- **cB-Sigma enip, Class 1 I/O, T->O multicast** (reference originator): the adapter declares no client feature multicast
- **cB-Sigma enip, Class 1 I/O, configuration data** (reference originator): the adapter declares no client feature configData
- **cB-Sigma enip, Class 1 I/O, exclusive owner, point-to-point** (reference originator): reference limitation: cB-Sigma's scanner sends no Forward_Close for an I/O connection (documented upstream as not yet done)
- **cB-Sigma enip, Class 1 I/O, exclusive owner, point-to-point** (reference originator): reference limitation: cB-Sigma enip v0.2.1 sends no Forward_Close for an I/O connection; fixed upstream after v0.2.1
- **cB-Sigma enip, Class 1 I/O, input only (heartbeat O->T)** (reference originator): the adapter declares no client feature inputOnly
- **cB-Sigma enip, Identity object (identity operation)** (reference originator): the adapter has no identity operation
- **cB-Sigma enip, Large_Forward_Open** (reference originator): the adapter declares no client feature largeForwardOpen
Expand Down Expand Up @@ -426,19 +426,19 @@ Notes:

Images:

- OpENer: `{"adapter":"opener","adapterVersion":"v0.8.1","upstream":"OpENer","upstreamVersion":"2.3-591","upstreamRevision":"0e1ab7ee5c272950c0dc8daf7793008d7a518912","contract":"1.0"}`
- EIPScanner: `{"adapter":"eipscanner","adapterVersion":"v0.8.1","upstream":"EIPScanner","upstreamVersion":"1.3.0-33","upstreamRevision":"12c89a57ec2e7449efb1348be52af10be9ef9701","contract":"1.0"}`
- pycomm3: `{"adapter": "pycomm3", "adapterVersion": "v0.8.1", "contract": "1.0", "upstream": "pycomm3", "upstreamRevision": "36aeb19b5cb47495df9fd1caa38ce9d2f6d12ea3", "upstreamVersion": "1.2.16"}`
- cpppo: `{"adapter": "cpppo", "adapterVersion": "v0.8.1", "contract": "1.0", "upstream": "cpppo", "upstreamRevision": "f7c224bbb2389bd26d0088eeb1a93db3a5c4858f", "upstreamVersion": "5.2.5"}`
- libplctag: `{"adapter":"libplctag","adapterVersion":"v0.8.1","upstream":"libplctag","upstreamVersion":"2.7.2","upstreamRevision":"7712ed7f1ee05ba0ebfca641b3f5c43da52a66ed","contract":"1.0"}`
- gologix: `{"adapter":"gologix","adapterVersion":"v0.8.1","contract":"1.0","upstream":"gologix","upstreamRevision":"647a0b87b756d42e37ac0f65c5762dc89036152c","upstreamVersion":"0.44.0-beta"}`
- pylogix: `{"adapter": "pylogix", "adapterVersion": "v0.8.1", "contract": "1.0", "upstream": "pylogix", "upstreamRevision": "193b6c7b0c601619223ee53587abd821d3b344c1", "upstreamVersion": "1.1.6"}`
- etherip: `{"adapter":"etherip","adapterVersion":"v0.8.1","upstream":"etherip","upstreamVersion":"1.0-67","upstreamRevision":"ce0688ae51be5652ec200fbe389667b36a638323","contract":"1.0"}`
- eip-rs: `{"adapter":"eiprs","adapterVersion":"v0.8.1","contract":"1.0","upstream":"rseip","upstreamRevision":"16e2236afb65acc9c82ebdcfbdcbba72e93b3887","upstreamVersion":"0.3.1-2"}`
- node-ethernet-ip: `{"adapter":"nodeeip","adapterVersion":"v0.8.1","upstream":"node-ethernet-ip","upstreamVersion":"2.0.0","upstreamRevision":"4743b077abd3cc8826d511acde8f890372826e16","contract":"1.0"}`
- EEIP.NET: `{"adapter":"eeip","adapterVersion":"v0.8.1","upstream":"EEIP.NET","upstreamVersion":"1.6.0","upstreamRevision":"58b91a0c8e30227b1b97a637635d147a2a9655dc","contract":"1.0"}`
- loki-os go-ethernet-ip: `{"adapter":"lokieip","adapterVersion":"v0.8.1","contract":"1.0","upstream":"go-ethernet-ip","upstreamRevision":"535f79752f63a4122c37c7f0f9b95ece01a8f7b4","upstreamVersion":"0.0.0-20221229063210-535f797"}`
- cB-Sigma enip: `{"adapter":"cbsigma","adapterVersion":"v0.8.1","contract":"1.0","upstream":"cB-Sigma/enip","upstreamRevision":"a3cb007728bbaf830cf89b24c3a06bba8075ec3b","upstreamVersion":"0.2.0"}`
- OpENer: `{"adapter":"opener","adapterVersion":"v0.8.2","upstream":"OpENer","upstreamVersion":"2.3-592","upstreamRevision":"fb90c9918081c184b1876ce0c893168cf8b5653c","contract":"1.0"}`
- EIPScanner: `{"adapter":"eipscanner","adapterVersion":"v0.8.2","upstream":"EIPScanner","upstreamVersion":"1.3.0-33","upstreamRevision":"12c89a57ec2e7449efb1348be52af10be9ef9701","contract":"1.0"}`
- pycomm3: `{"adapter": "pycomm3", "adapterVersion": "v0.8.2", "contract": "1.0", "upstream": "pycomm3", "upstreamRevision": "36aeb19b5cb47495df9fd1caa38ce9d2f6d12ea3", "upstreamVersion": "1.2.16"}`
- cpppo: `{"adapter": "cpppo", "adapterVersion": "v0.8.2", "contract": "1.0", "upstream": "cpppo", "upstreamRevision": "f7c224bbb2389bd26d0088eeb1a93db3a5c4858f", "upstreamVersion": "5.2.5"}`
- libplctag: `{"adapter":"libplctag","adapterVersion":"v0.8.2","upstream":"libplctag","upstreamVersion":"2.7.2","upstreamRevision":"7712ed7f1ee05ba0ebfca641b3f5c43da52a66ed","contract":"1.0"}`
- gologix: `{"adapter":"gologix","adapterVersion":"v0.8.2","contract":"1.0","upstream":"gologix","upstreamRevision":"647a0b87b756d42e37ac0f65c5762dc89036152c","upstreamVersion":"0.44.0-beta"}`
- pylogix: `{"adapter": "pylogix", "adapterVersion": "v0.8.2", "contract": "1.0", "upstream": "pylogix", "upstreamRevision": "0b67bdec05e74d49ea319f889c2ee4726f6eef03", "upstreamVersion": "1.1.7"}`
- etherip: `{"adapter":"etherip","adapterVersion":"v0.8.2","upstream":"etherip","upstreamVersion":"1.0-67","upstreamRevision":"ce0688ae51be5652ec200fbe389667b36a638323","contract":"1.0"}`
- eip-rs: `{"adapter":"eiprs","adapterVersion":"v0.8.2","contract":"1.0","upstream":"rseip","upstreamRevision":"16e2236afb65acc9c82ebdcfbdcbba72e93b3887","upstreamVersion":"0.3.1-2"}`
- node-ethernet-ip: `{"adapter":"nodeeip","adapterVersion":"v0.8.2","upstream":"node-ethernet-ip","upstreamVersion":"2.0.0","upstreamRevision":"4743b077abd3cc8826d511acde8f890372826e16","contract":"1.0"}`
- EEIP.NET: `{"adapter":"eeip","adapterVersion":"v0.8.2","upstream":"EEIP.NET","upstreamVersion":"1.6.0","upstreamRevision":"58b91a0c8e30227b1b97a637635d147a2a9655dc","contract":"1.0"}`
- loki-os go-ethernet-ip: `{"adapter":"lokieip","adapterVersion":"v0.8.2","contract":"1.0","upstream":"go-ethernet-ip","upstreamRevision":"535f79752f63a4122c37c7f0f9b95ece01a8f7b4","upstreamVersion":"0.0.0-20221229063210-535f797"}`
- cB-Sigma enip: `{"adapter":"cbsigma","adapterVersion":"v0.8.2","contract":"1.0","upstream":"cB-Sigma/enip","upstreamRevision":"49d9fb246a82c8d3cd2d54e31a93b9b12ed642ef","upstreamVersion":"0.2.1"}`
<!-- interop-matrix:end -->

## Known deviations of the references
Expand Down Expand Up @@ -494,15 +494,16 @@ each is handled:
- go-ethernet-ip (loki-os): no UDP, no timeouts of its own; does not check
the status of RegisterSession, Forward_Open or a write; writes a tag only
whole (scalar tags only); no fragmented services.
- cB-Sigma's enip (v0.2.0): the target's identity revision is fixed at 33.11
and its socket address is the listen address; it recognises the Message
Router and Connection Manager only in 8-bit segments, matches tag names
with case and refuses an empty Unconnected_Send route; a Class 1
Forward_Close is answered 0x0107, and the inactivity timer is reset only by
a new O->T CIP sequence count, so go-ethernetip's scanner, which repeats it
for unchanged data, is dropped after a few packets. Its scanner sends no
Forward_Close. Reported upstream as
[cB-Sigma/enip#1–#8](https://github.com/cB-Sigma/enip/issues).
- cB-Sigma's enip (v0.2.1): its scanner sends no Forward_Close for an I/O
connection, so the Class 1 case with its originator is recorded N/A;
fixed upstream after v0.2.1
([cB-Sigma/enip#9](https://github.com/cB-Sigma/enip/issues/9)). The
differences of its target in v0.2.0 (fixed identity revision, listen
address as socket address, 8-bit segments only for the Message Router and
Connection Manager, case-sensitive tag names, an empty Unconnected_Send
route refused, Class 1 Forward_Close answered 0x0107, an inactivity timer
reset only by a new O->T CIP sequence count) are fixed in v0.2.1
([cB-Sigma/enip#1–#8](https://github.com/cB-Sigma/enip/issues)).

All are recorded, with what the adapters do about them, in
[ethernetip-interop's CAPABILITIES.md](https://github.com/otfabric/ethernetip-interop/blob/main/docs/CAPABILITIES.md).
3 changes: 2 additions & 1 deletion PROGRESS.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ No work in progress: every branch is merged.

| Release | Date | Where |
|---|---|---|
| ethernetip-interop v0.8.2 (cB-Sigma's enip v0.2.1, fixing cB-Sigma/enip#1–#8; OpENer 2.3-592, pylogix 1.1.7; new base images) | 2026-11-13 | https://github.com/otfabric/ethernetip-interop/releases/tag/v0.8.2 |
| ethernetipctl v0.5.2 (on go-ethernetip v0.5.2: configuration instance 0 named in the Class 1 path) | 2026-11-07 | https://github.com/otfabric/ethernetipctl/releases/tag/v0.5.2 |
| Own image `ethernetip-interop-otfabric:v0.5.2` (Own stack run, self-tests of ethernetip-interop v0.8.1 green) | 2026-11-07 | https://github.com/otfabric/ethernetip-interop/actions/runs/42337289885 |
| go-ethernetip v0.5.2 (interop pinned to ethernetip-interop v0.8.1: thirteen references, + cB-Sigma's enip) | 2026-11-06 | https://github.com/otfabric/go-ethernetip/releases/tag/v0.5.2 |
Expand Down Expand Up @@ -51,7 +52,7 @@ GitHub CI green on the merged commits: go-ethernetip on Linux, macOS and
Windows (amd64 and arm64; race detector everywhere but Windows arm64), Go
1.26-1.27, 90% coverage gate (98.6%), lint, fuzz, chaos (with the chaos
monkey) and stress; interop on amd64 and arm64 against the pinned
ethernetip-interop v0.8.1 images (thirteen references): 221 pass, 0 fail, 160 N/A,
ethernetip-interop v0.8.2 images (thirteen references): 221 pass, 0 fail, 160 N/A,
2 skipped (the logix-structures fixture has no Counter or Samples)
([matrix](INTEROPERABILITY.md#interop-matrix)). ethernetip-interop native
amd64/arm64 build, smoke and self-test (52 pass, 0 fail). ethernetipctl
Expand Down
20 changes: 11 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ see where more interop or more features would help.
| **Project** | | | | | | | | | | | | | | |
| Language | Go | C | C++ | Python | Python | C | Go | Python | Java | Rust | TypeScript | C# | Go | Go |
| Licence | MIT | adapted BSD | MIT | MIT | GPL-3.0 | MPL-2.0 or LGPL-2.0+ | MIT | Apache-2.0 | EPL-1.0 | MIT | MIT | MIT | WTFPL | Apache-2.0 |
| Version compared | this module | master 0e1ab7e | 1.3.0+33 | 1.2.16 | 5.2.5 | 2.7.2 | 0.44.0-beta | 1.1.6 | main ce0688a | main 16e2236 | 2.0.0 | master 58b91a0 | master 535f797 | 0.2.0 |
| Version compared | this module | master fb90c99 | 1.3.0+33 | 1.2.16 | 5.2.5 | 2.7.2 | 0.44.0-beta | 1.1.7 | main ce0688a | main 16e2236 | 2.0.0 | master 58b91a0 | master 535f797 | 0.2.1 |
| Originator (scanner, client) | ✅ | — | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Target (adapter, server) | ✅ | ✅ | — | — | Logix simulator | ab_server simulator | Logix tags, Class 1 I/O | — | — | — | — | — | — | Logix tags, structures, Class 1 I/O |
| Dependencies | none (standard library) | none | none | none | greenery | none | crc16 | none | none (JRE) | tokio and others | none (Node.js) | none (.NET) | none | lanbcast |
Expand Down Expand Up @@ -141,7 +141,7 @@ see where more interop or more features would help.
scanner) · T = as target (adapter, server) · — = not available · n/a = the
stack has no target role · not tested = neither documented nor exercised by
the interop suite. For the versions go-ethernetip is tested against, as of
October 2026.
November 2026.

¹ EEIP.NET's own ListIdentity broadcasts without SO_BROADCAST and fails on
Linux; the adapter sends one unicast datagram built and parsed by EEIP.NET.
Expand All @@ -159,10 +159,12 @@ instead of the structure handle (refused 0x2107).
`Bits[37]`.
⁸ go-ethernet-ip writes a tag only whole (all elements, by instance), so
scalar tags only; it does not check the reply of a write.
⁹ cB-Sigma's scanner sends no Forward_Close for an I/O connection; its
target answers a Class 1 Forward_Close 0x01 / 0x0107 and resets its
inactivity timer only on a new O->T CIP sequence count, so it drops
go-ethernetip's scanner after a few packets (cB-Sigma/enip#3, #8).
⁹ cB-Sigma's scanner (v0.2.1) sends no Forward_Close for an I/O
connection; fixed upstream after v0.2.1 (cB-Sigma/enip#9). Its target's
Class 1 Forward_Close reply and inactivity timer, which dropped
go-ethernetip's scanner in v0.2.0 (cB-Sigma/enip#3, #8), are fixed in
v0.2.1 according to ethernetip-interop v0.8.2's cross-stack self-test;
this repository's interop suite has no Class 1 case against its target.

The interop counts are the cases each stack passes against go-ethernetip,
in both directions where it has a target, of those it declares; every
Expand Down Expand Up @@ -348,19 +350,19 @@ NAT).

| Reference | Version | Licence | Roles tested |
|-----------|---------|---------|--------------|
| [OpENer](https://github.com/EIPStackGroup/OpENer) | master 0e1ab7e (v2.3+591) | adapted BSD | target (adapter) |
| [OpENer](https://github.com/EIPStackGroup/OpENer) | master fb90c99 (v2.3+592) | adapted BSD | target (adapter) |
| [EIPScanner](https://github.com/nimbuscontrols/EIPScanner) | 1.3.0+33 (12c89a5) | MIT | originator (scanner) |
| [pycomm3](https://github.com/ottowayi/pycomm3) | 1.2.16 | MIT | originator (generic CIP and Logix) |
| [cpppo](https://github.com/pjkundert/cpppo) | 5.2.5 | GPL-3.0 | target (Logix simulator) and originator |
| [libplctag](https://github.com/libplctag/libplctag) | 2.7.2 | MPL-2.0 or LGPL-2.0+ | originator (Logix and generic CIP) and target (ab_server simulator) |
| [gologix](https://github.com/danomagnum/gologix) | 0.44.0-beta | MIT | originator and target (Logix tags, Class 1 I/O) |
| [pylogix](https://github.com/dmroeder/pylogix) | 1.1.6 | Apache-2.0 | originator (Logix) |
| [pylogix](https://github.com/dmroeder/pylogix) | 1.1.7 | Apache-2.0 | originator (Logix) |
| [etherip](https://github.com/ornl-epics/etherip) | main ce0688a | EPL-1.0 | originator (Logix, generic) |
| [eip-rs (rseip)](https://github.com/Joylei/eip-rs) | main 16e2236 | MIT | originator (generic CIP and Logix) |
| [node-ethernet-ip](https://github.com/cmseaton42/node-ethernet-ip) | 2.0.0 | MIT | originator (Logix, generic) |
| [EEIP.NET](https://github.com/rossmann-engineering/EEIP.NET) | master 58b91a0 | MIT | originator (scanner: explicit, Class 1 I/O) |
| [go-ethernet-ip (loki-os)](https://github.com/loki-os/go-ethernet-ip) | master 535f797 | WTFPL | originator (generic CIP and Logix) |
| [enip (cB-Sigma)](https://github.com/cB-Sigma/enip) | 0.2.0 | Apache-2.0 | originator (generic CIP, Logix, Class 1 I/O) and target (Logix tags, structures, tag list, Class 1 I/O) |
| [enip (cB-Sigma)](https://github.com/cB-Sigma/enip) | 0.2.1 | Apache-2.0 | originator (generic CIP, Logix, Class 1 I/O) and target (Logix tags, structures, tag list, Class 1 I/O) |

`ETHERNETIP_INTEROP_ADAPTERS=cpppo` runs one reference only.

Expand Down
28 changes: 28 additions & 0 deletions RELEASE.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,33 @@
# go-ethernetip Releases

## v0.8.2

**Date:** 2026-11-16
**Previous release:** v0.8.1

## Summary

A patch release on v0.8.1 that moves the interop suite to
ethernetip-interop v0.8.2. No library change: no exported identifier is
added, removed or changed.

## Changes

### Tests

- The interop suite is tested against ethernetip-interop v0.8.2: cB-Sigma's
enip v0.2.1 (fixes cB-Sigma/enip#1–#8), EIPScanner's adapter with the
configuration instance segment always in the Class 1 path, OpENer master
v2.3-592 (`fb90c99`), pylogix 1.1.7 and new base images; all thirteen
images pinned by their new digests.
- Run: 221 pass, 0 fail, 160 N/A, 2 skipped, as with v0.8.1; every
reference passes the same cases.
- The cB-Sigma Class 1 I/O case (its originator against go-ethernetip's
target) stays N/A: enip v0.2.1 sends no Forward_Close for an I/O
connection; fixed upstream after v0.2.1 (cB-Sigma/enip#9).

---

## v0.8.1

**Date:** 2026-11-15
Expand Down
2 changes: 1 addition & 1 deletion docs/FEATURE-STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Status words, as in INTEROPERABILITY.md:
| Unit, end-to-end, chaos, stress and leak suites with the race detector | [TESTING.md](../TESTING.md) |
| Coverage of at least 90 % in total and per package | `make coverage-check coverage-pkg-check` |
| Fuzz targets on the decoders, the client and the server, in CI and in `fuzz.yml` | `make fuzz` (every `Fuzz` function) |
| Independent peers: ethernetip-interop v0.8.1, images pinned by digest | `interop/harness_test.go`, `interop.yml`, nightly |
| Independent peers: ethernetip-interop v0.8.2, images pinned by digest | `interop/harness_test.go`, `interop.yml`, nightly |
| Recorded traffic of a 1756-L63 ControlLogix (15.4), a 1756-ENBT/A (4.3), a Micro850 (12.11), a MicroLogix 1400 and unidentified targets: decode, encode, client and server replay | [testdata/captures](../testdata/captures/README.md), `*/capture_test.go` |

## Platforms
Expand Down
2 changes: 1 addition & 1 deletion interop/generic_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ var knownLimits = map[string]map[string]string{
"Logix Write Tag": "reference limitation: go-ethernet-ip writes a tag only whole (all its elements, with the dimension bits in the type), not elements of an array",
},
"cbsigma": {
"Class 1 I/O, exclusive owner, point-to-point": "reference limitation: cB-Sigma's scanner sends no Forward_Close for an I/O connection (documented upstream as not yet done)",
"Class 1 I/O, exclusive owner, point-to-point": "reference limitation: cB-Sigma enip v0.2.1 sends no Forward_Close for an I/O connection; fixed upstream after v0.2.1",
},
}

Expand Down
Loading
Loading