459cbb444e
I1: the U11 Bits[n] -> Bits[n/32] rewrite was unconditional. The native runtime now keeps the original element path until the first reply settles the layout: 0xD3 confirms DWORD addressing (bit n%32); any other reply type (e.g. a 0xC1 per-element BOOL array) or a refusal of the DWORD index falls back to Bits[n] and re-reads, and a write settles the layout by a read first, so it can never decode or write element n/32 of an element-addressed array. I2: libplctag ErrorNoMatch/ErrorBadDevice no longer fold into NotFound (they now read as BadConnection: comms, Degraded, LastSuccessfulRead preserved). ErrorNotImplemented - and the native runtime's own pre-send refusals - raise AbCipLocalRefusalException: BadNotSupported, no health, LastSuccessfulRead NOT advanced, no backoff record, not reachable for the probe or Test Connect. M1: the bit RMW's parent read/write status words follow the health contract (refusal: per-tag Bad + Warning; comms: evict the parent + Degraded). M2: device Unsupported read refusals return Refused (advance LastSuccessfulRead); device write refusals call RecordWriteAnswered (not the pre-send native type gate). M3: a good write clears a Degraded a write comms fault recorded (a read-side Degraded is still left for the read path). M4: a superseded init throws AbCipInitializationSupersededException (not an OCE); ShutdownAsync stamps Unknown only if no newer init published meanwhile. M5: the sync-Dispose timing assert is 2 s against a 4 s probe read; the unencodable-array test asserts health. Refs #737 Claude-Session: https://claude.ai/code/session_01Ub9hGmYLQvn9XETzw7CMsT
43 lines
2.7 KiB
C#
43 lines
2.7 KiB
C#
using ZB.MOM.WW.OtOpcUa.Driver.Ab.Transport;
|
|
|
|
namespace ZB.MOM.WW.OtOpcUa.Driver.AbCip;
|
|
|
|
/// <summary>
|
|
/// The ONE classification of a transport status into "the controller answered" vs "the wire failed", shared by
|
|
/// the data path, the probe loop, the Test-Connect probe and the native runtime's initialisation.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// A device refusal is deterministic: the session works and the controller said no to this one tag (a renamed
|
|
/// tag, <c>Arr[999]</c>, a read-protected tag, a type the authored config does not match). It is per-tag Bad,
|
|
/// keeps the tag runtime (evicting re-creates it — and, for a sole lease holder, re-Forward-Opens — on every poll),
|
|
/// never writes <c>Degraded</c>, never opens the device-wide connect backoff, and warns once per tag. Everything
|
|
/// else (timeout, bad connection, a reply that failed to parse, partial, abort, …) is a comms fault.
|
|
/// <para>
|
|
/// The native transport currently folds CIP general statuses 0x1C, 0x20 and 0xFF/0x2104 into
|
|
/// <see cref="AbStatus.BadReply"/> (<c>AbStatusCodes.FromCip</c>, owned by <c>Driver.Ab.Transport</c>), which
|
|
/// this classification cannot tell from a garbled reply; until the transport maps them explicitly they stay
|
|
/// comms faults.
|
|
/// </para>
|
|
/// </remarks>
|
|
internal static class AbCipRefusals
|
|
{
|
|
/// <summary>True when <paramref name="status"/> proves the controller answered but refused this tag.</summary>
|
|
/// <param name="status">The transport status.</param>
|
|
/// <returns><see langword="true"/> for a deterministic device refusal.</returns>
|
|
public static bool IsDeviceRefusal(AbStatus status) => status is AbStatus.NotFound or AbStatus.OutOfBounds
|
|
or AbStatus.NotAllowed or AbStatus.TooLarge or AbStatus.TooSmall or AbStatus.TypeMismatch
|
|
or AbStatus.Unsupported;
|
|
|
|
/// <summary>True when <paramref name="status"/> (an <see cref="AbStatus"/> value) is a device refusal.</summary>
|
|
/// <param name="status">The runtime status word.</param>
|
|
/// <returns><see langword="true"/> for a deterministic device refusal.</returns>
|
|
public static bool IsDeviceRefusal(int status) => IsDeviceRefusal((AbStatus)status);
|
|
|
|
/// <summary>True when <paramref name="ex"/> is an <see cref="AbTransportException"/> carrying a device refusal.</summary>
|
|
/// <param name="ex">The exception.</param>
|
|
/// <returns><see langword="true"/> for a deterministic device refusal.</returns>
|
|
/// <remarks>An <see cref="AbCipLocalRefusalException"/> is never a device refusal: nothing reached the device.</remarks>
|
|
public static bool IsDeviceRefusal(Exception ex) =>
|
|
ex is AbTransportException ate and not AbCipLocalRefusalException && IsDeviceRefusal(ate.Status);
|
|
}
|