fix(driver-focas): equipment tags run the capability-matrix pre-flight authored tags get (R2-11, 05/UNDER-6)

2026-07-13 11:05:02 -04:00
parent e294416087
commit 24435efa8b
3 changed files with 77 additions and 2 deletions
@@ -0,0 +1,61 @@
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Driver.FOCAS;
+
+namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Tests;
+
+/// <summary>
+///     R2-11 (05/UNDER-6): an equipment-tag reference whose address violates the device series'
+///     capability matrix must fail to RESOLVE (surfacing <c>BadNodeIdUnknown</c>) — the same pre-flight
+///     authored tags get at <c>InitializeAsync</c> — instead of reaching the wire and failing later with a
+///     wire error. A capability-valid equipment tag still resolves + reads.
+/// </summary>
+[Trait("Category", "Unit")]
+public sealed class FocasEquipmentTagCapabilityGateTests
+{
+    private const string Host = "focas://10.0.0.5:8193";
+
+    private static FocasDriver NewDriver() => new(new FocasDriverOptions
+    {
+        // Series 16i: macro range 0..999 — MACRO:9500 is out of range.
+        Devices = [new FocasDeviceOptions(Host, Series: FocasCncSeries.Sixteen_i)],
+        Probe = new FocasProbeOptions { Enabled = false },
+    }, "drv-1", new FakeFocasClientFactory());
+
+    private static string EquipTag(string address) =>
+        $"{{\"address\":\"{address}\",\"dataType\":\"Int32\",\"deviceHostAddress\":\"{Host}\"}}";
+
+    [Fact]
+    public async Task Capability_violating_equipment_tag_does_not_resolve()
+    {
+        var drv = NewDriver();
+        await drv.InitializeAsync("{}", CancellationToken.None);
+
+        var results = await drv.ReadAsync([EquipTag("MACRO:9500")], CancellationToken.None);
+
+        results.Single().StatusCode.ShouldBe(FocasStatusMapper.BadNodeIdUnknown);
+    }
+
+    [Fact]
+    public async Task Capability_valid_equipment_tag_resolves_and_reads()
+    {
+        var drv = NewDriver();
+        await drv.InitializeAsync("{}", CancellationToken.None);
+
+        var results = await drv.ReadAsync([EquipTag("MACRO:100")], CancellationToken.None);
+
+        results.Single().StatusCode.ShouldNotBe(FocasStatusMapper.BadNodeIdUnknown);
+    }
+
+    [Fact]
+    public async Task Equipment_tag_for_unknown_device_does_not_resolve()
+    {
+        var drv = NewDriver();
+        await drv.InitializeAsync("{}", CancellationToken.None);
+
+        var badDevice = "{\"address\":\"MACRO:100\",\"dataType\":\"Int32\",\"deviceHostAddress\":\"focas://10.9.9.9:8193\"}";
+        var results = await drv.ReadAsync([badDevice], CancellationToken.None);
+
+        results.Single().StatusCode.ShouldBe(FocasStatusMapper.BadNodeIdUnknown);
+    }
+}