Joseph Doherty
389f5a0378
Communication Layer (WP-1–5): - 8 message patterns with correlation IDs, per-pattern timeouts - Central/Site communication actors, transport heartbeat config - Connection failure handling (no central buffering, debug streams killed) Data Connection Layer (WP-6–14, WP-34): - Connection actor with Become/Stash lifecycle (Connecting/Connected/Reconnecting) - OPC UA + LmxProxy adapters behind IDataConnection - Auto-reconnect, bad quality propagation, transparent re-subscribe - Write-back, tag path resolution with retry, health reporting - Protocol extensibility via DataConnectionFactory Site Runtime (WP-15–25, WP-32–33): - ScriptActor/ScriptExecutionActor (triggers, concurrent execution, blocking I/O dispatcher) - AlarmActor/AlarmExecutionActor (ValueMatch/RangeViolation/RateOfChange, in-memory state) - SharedScriptLibrary (inline execution), ScriptRuntimeContext (API) - ScriptCompilationService (Roslyn, forbidden API enforcement, execution timeout) - Recursion limit (default 10), call direction enforcement - SiteStreamManager (per-subscriber bounded buffers, fire-and-forget) - Debug view backend (snapshot + stream), concurrency serialization - Local artifact storage (4 SQLite tables) Health Monitoring (WP-26–28): - SiteHealthCollector (thread-safe counters, connection state) - HealthReportSender (30s interval, monotonic sequence numbers) - CentralHealthAggregator (offline detection 60s, online recovery) Site Event Logging (WP-29–31): - SiteEventLogger (SQLite, 6 event categories, ISO 8601 UTC) - EventLogPurgeService (30-day retention, 1GB cap) - EventLogQueryService (filters, keyword search, keyset pagination) 541 tests pass, zero warnings.
95 lines
3.1 KiB
C#
95 lines
3.1 KiB
C#
namespace ScadaLink.DataConnectionLayer.Adapters;
|
|
|
|
/// <summary>
|
|
/// WP-7: Abstraction over OPC UA client library for testability.
|
|
/// The real implementation would wrap an OPC UA SDK (e.g., OPC Foundation .NET Standard Library).
|
|
/// </summary>
|
|
public interface IOpcUaClient : IAsyncDisposable
|
|
{
|
|
Task ConnectAsync(string endpointUrl, CancellationToken cancellationToken = default);
|
|
Task DisconnectAsync(CancellationToken cancellationToken = default);
|
|
bool IsConnected { get; }
|
|
|
|
/// <summary>
|
|
/// Creates a monitored item subscription for a node. Returns a subscription handle.
|
|
/// </summary>
|
|
Task<string> CreateSubscriptionAsync(
|
|
string nodeId,
|
|
Action<string, object?, DateTime, uint> onValueChanged,
|
|
CancellationToken cancellationToken = default);
|
|
|
|
Task RemoveSubscriptionAsync(string subscriptionHandle, CancellationToken cancellationToken = default);
|
|
|
|
Task<(object? Value, DateTime SourceTimestamp, uint StatusCode)> ReadValueAsync(
|
|
string nodeId, CancellationToken cancellationToken = default);
|
|
|
|
Task<uint> WriteValueAsync(string nodeId, object? value, CancellationToken cancellationToken = default);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Factory for creating IOpcUaClient instances.
|
|
/// </summary>
|
|
public interface IOpcUaClientFactory
|
|
{
|
|
IOpcUaClient Create();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Default factory that creates stub OPC UA clients.
|
|
/// In production, this would create real OPC UA SDK client instances.
|
|
/// </summary>
|
|
public class DefaultOpcUaClientFactory : IOpcUaClientFactory
|
|
{
|
|
public IOpcUaClient Create() => new StubOpcUaClient();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Stub OPC UA client for development/testing. A real implementation would
|
|
/// wrap the OPC Foundation .NET Standard Library.
|
|
/// </summary>
|
|
internal class StubOpcUaClient : IOpcUaClient
|
|
{
|
|
public bool IsConnected { get; private set; }
|
|
|
|
public Task ConnectAsync(string endpointUrl, CancellationToken cancellationToken = default)
|
|
{
|
|
IsConnected = true;
|
|
return Task.CompletedTask;
|
|
}
|
|
|
|
public Task DisconnectAsync(CancellationToken cancellationToken = default)
|
|
{
|
|
IsConnected = false;
|
|
return Task.CompletedTask;
|
|
}
|
|
|
|
public Task<string> CreateSubscriptionAsync(
|
|
string nodeId, Action<string, object?, DateTime, uint> onValueChanged,
|
|
CancellationToken cancellationToken = default)
|
|
{
|
|
return Task.FromResult(Guid.NewGuid().ToString());
|
|
}
|
|
|
|
public Task RemoveSubscriptionAsync(string subscriptionHandle, CancellationToken cancellationToken = default)
|
|
{
|
|
return Task.CompletedTask;
|
|
}
|
|
|
|
public Task<(object? Value, DateTime SourceTimestamp, uint StatusCode)> ReadValueAsync(
|
|
string nodeId, CancellationToken cancellationToken = default)
|
|
{
|
|
return Task.FromResult<(object?, DateTime, uint)>((null, DateTime.UtcNow, 0));
|
|
}
|
|
|
|
public Task<uint> WriteValueAsync(string nodeId, object? value, CancellationToken cancellationToken = default)
|
|
{
|
|
return Task.FromResult<uint>(0); // Good status
|
|
}
|
|
|
|
public ValueTask DisposeAsync()
|
|
{
|
|
IsConnected = false;
|
|
return ValueTask.CompletedTask;
|
|
}
|
|
}
|