Auto: s7-c5 — pre-flight PUT/GET enablement test

Closes #298
2026-04-26 01:31:48 -04:00
parent 4bc8aa2478
commit 64a11ef285
9 changed files with 625 additions and 3 deletions
@@ -214,9 +214,26 @@ public sealed class S7ProbeOptions
    /// <summary>
    ///     Address to probe for liveness. DB1.DBW0 is the convention if the PLC project
    ///     reserves a small fingerprint DB for health checks (per <c>docs/v2/s7.md</c>);
-    ///     if not, pick any valid Merker word like <c>MW0</c>.
+    ///     if not, pick any valid Merker word like <c>MW0</c>. Set to <c>null</c> to
+    ///     skip the pre-flight probe at <see cref="S7Driver.InitializeAsync"/> time
+    ///     for sites that haven't wired a fingerprint address.
    /// </summary>
-    public string ProbeAddress { get; init; } = "MW0";
+    public string? ProbeAddress { get; init; } = "MW0";
+
+    /// <summary>
+    ///     PR-S7-C5 — skip the pre-flight PUT/GET enablement probe that
+    ///     <see cref="S7Driver.InitializeAsync"/> issues immediately after
+    ///     <c>OpenAsync</c>. Default <c>false</c> = pre-flight runs and a hardened
+    ///     CPU with PUT/GET disabled fails Init with
+    ///     <see cref="S7PutGetDisabledException"/>. Set <c>true</c> to defer the
+    ///     check to first per-tag read — the driver will still surface
+    ///     <c>BadDeviceFailure</c> per tag, but Init succeeds and dependent code
+    ///     paths (subscriptions, Admin UI binding) come up. Useful for staged
+    ///     deployments where the operator hasn't enabled PUT/GET yet but wants
+    ///     the driver visible in the Admin UI. See <c>docs/v2/s7.md</c>
+    ///     "Pre-flight PUT/GET enablement" section.
+    /// </summary>
+    public bool SkipPreflight { get; init; } = false;
 }

 /// <summary>