feat(ablegacy,focas): PLC-5 octal I/O, MicroLogix function files, indirect-address parse, 16i PMC F/G (#244 #245 #247 #265)

Claude-Session: https://claude.ai/code/session_01Ef2ozxS7QPanGT8uoATbTe
2026-10-08 14:28:22 -04:00
parent d898262c4a
commit 0dc09329b7
10 changed files with 552 additions and 58 deletions
@@ -0,0 +1,51 @@
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+
+namespace ZB.MOM.WW.OtOpcUa.Driver.AbLegacy;
+
+/// <summary>
+///     MicroLogix 1100/1400 function-file sub-element catalogue (#245): the driver-surface type of
+///     <c>RTC:0.HR</c>, <c>HSC:0.ACC</c>, ... Covers the commonly-addressed members per file — not exhaustive
+///     (Rockwell defines 30+ on RTC alone). <b>Unverified on the wire:</b> the layouts are transcribed from the
+///     MicroLogix instruction-set reference; neither transport has been captured against these files and the
+///     native transport has no encoding for them at all.
+/// </summary>
+public static class AbLegacyFunctionFile
+{
+    /// <summary>
+    ///     Driver-surface type for <paramref name="fileLetter"/>.<paramref name="subElement"/>; an unrecognised
+    ///     sub-element falls back to <see cref="DriverDataType.Int32"/> so the driver never refuses a member the
+    ///     catalogue happens to omit.
+    /// </summary>
+    /// <param name="fileLetter">The function-file letter (RTC, HSC, ...).</param>
+    /// <param name="subElement">The sub-element mnemonic, or null.</param>
+    /// <returns>The mapped driver data type.</returns>
+    public static DriverDataType SubElementType(string fileLetter, string? subElement)
+    {
+        if (subElement is null) return DriverDataType.Int32;
+        return (fileLetter.ToUpperInvariant(), subElement.ToUpperInvariant()) switch
+        {
+            // Real-time clock: time fields are 16-bit words; DS (disabled) / BL (battery low) are flags.
+            ("RTC", "DS") or ("RTC", "BL") or ("RTC", "EN") => DriverDataType.Boolean,
+
+            // High-speed counter: accumulator/preset/overflow/underflow are numeric, the rest status bits.
+            ("HSC", "EN") or ("HSC", "UF") or ("HSC", "IF") or ("HSC", "IN") or ("HSC", "IH") or
+            ("HSC", "IL") or ("HSC", "DN") or ("HSC", "CD") or ("HSC", "CU") => DriverDataType.Boolean,
+
+            // Daylight saving + memory-module info.
+            ("DLS", "EN") => DriverDataType.Boolean,
+            ("MMI", "MP") or ("MMI", "MCP") => DriverDataType.Boolean,
+
+            // Pulse-train / PWM outputs.
+            ("PTO", "EN") or ("PTO", "DN") or ("PTO", "EH") or ("PTO", "ED") or ("PTO", "RP") or ("PTO", "OUT") => DriverDataType.Boolean,
+            ("PWM", "EN") or ("PWM", "DN") or ("PWM", "EH") or ("PWM", "ED") or ("PWM", "RP") or ("PWM", "OUT") => DriverDataType.Boolean,
+
+            // Selectable timed interrupt + event input interrupt.
+            ("STI", "EN") or ("STI", "TIE") or ("STI", "DN") or ("STI", "PS") or ("STI", "ED") => DriverDataType.Boolean,
+            ("EII", "EN") or ("EII", "TIE") or ("EII", "PE") or ("EII", "ES") or ("EII", "ED") => DriverDataType.Boolean,
+
+            // Everything else (HR/MIN/SEC/MON/DAY/YR/DOW, ACC/PRE/OVF/UNF, STR/STD, FT/LBN, OF/IDA/ODA/PE/PD,
+            // SPM/ER/PFN, ID/TYP, OS/FRN/BSN/CC, ...) is a numeric word.
+            _ => DriverDataType.Int32,
+        };
+    }
+}