From 6667b233b691141b3812e2534127335c87087a22 Mon Sep 17 00:00:00 2001 From: Joseph Doherty Date: Wed, 3 Jun 2026 16:31:26 -0400 Subject: [PATCH] =?UTF-8?q?docs(audit):=20Driver.S7.Cli.md=20=E2=80=94=20v?= =?UTF-8?q?erb/flag=20accuracy=20+=20ordinal=20fix?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CODE-REALITY: - Line 7: "Fourth of four" → "Fourth of six"; there are 6 driver CLIs (Modbus, AbCip, AbLegacy, S7, TwinCAT, FOCAS); confirmed by src/Drivers/Cli/ project count. - read section: removed the `DB10.STRING[0] -t String --string-length 80` example that documented an unusable code path. String (and Int64, UInt64, Float64, DateTime) live in S7DataType but are blocked in S7Driver.UnimplementedDataTypes; any attempt returns BadNotSupported (src/Drivers/ZB.MOM.WW.OtOpcUa.Driver.S7/S7Driver.cs:327-333 and :450). Added an explicit "not yet implemented" note with the source location so readers know why those types are omitted. STRUCTURAL: no rows in links-report.md for this doc. STALE-STATUS: no state words found. INLINE COMPLETENESS: no inventory-diff gaps for this doc. --- docs/Driver.S7.Cli.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/Driver.S7.Cli.md b/docs/Driver.S7.Cli.md index a7b3eded..3a6e478c 100644 --- a/docs/Driver.S7.Cli.md +++ b/docs/Driver.S7.Cli.md @@ -4,7 +4,7 @@ Ad-hoc probe / read / write / subscribe tool for Siemens S7-300 / S7-400 / S7-1200 / S7-1500 (and compatible soft-PLCs) over S7comm / ISO-on-TCP port 102. Uses the **same** `S7Driver` the OtOpcUa server does (S7.Net under the hood). -Fourth of four driver test-client CLIs. +Fourth of six driver test-client CLIs. ## Build + run @@ -58,6 +58,12 @@ otopcua-s7-cli probe -h 192.168.1.31 -c S7300 --slot 2 -a DB1.DBW0 ### `read` +Supported types: `Bool`, `Byte`, `Int16`, `UInt16`, `Int32`, `UInt32`, `Float32`. +`Int64`, `UInt64`, `Float64`, `String`, and `DateTime` are defined in `S7DataType` but +**not yet implemented** — the driver rejects them at initialisation and any read or write +returns `BadNotSupported` +(`src/Drivers/ZB.MOM.WW.OtOpcUa.Driver.S7/S7Driver.cs` — `UnimplementedDataTypes` set). + ```powershell # DB word otopcua-s7-cli read -h 192.168.1.30 -a DB1.DBW0 -t Int16 @@ -67,9 +73,6 @@ otopcua-s7-cli read -h 192.168.1.30 -a DB1.DBD4 -t Float32 # Merker bit otopcua-s7-cli read -h 192.168.1.30 -a M0.0 -t Bool - -# 80-char S7 string -otopcua-s7-cli read -h 192.168.1.30 -a DB10.STRING[0] -t String --string-length 80 ``` ### `write`