dohertj2
c95824a65d
Full read-only SDK (src/AVEVA.Historian.Client) implementing the CLAUDE.md required
surface against AVEVA Historian's binary WCF protocol — no native AVEVA runtime
dependency. All operations live-verified against a local Historian:
- ProbeAsync, ReadRawAsync, ReadAggregateAsync, ReadAtTimeAsync, ReadEventsAsync
- BrowseTagNamesAsync, GetTagMetadataAsync (17 native data-type codes mapped)
- GetConnectionStatusAsync, GetStoreForwardStatusAsync, GetSystemParameterAsync
- 108/108 unit + integration tests pass
Includes the reverse-engineering toolkit (tools/AVEVA.Historian.ReverseEngineering)
used to decode the protocol: WCF probes, IL inspection via dnlib, and IL-rewrite
instrumentation (instrument-wcf-{write,read}message etc.) plus the .NET Framework
trace harness (tools/AVEVA.Historian.NativeTraceHarness) for parity testing.
Sanitized handoff evidence under docs/reverse-engineering/. Native AVEVA binaries
(current/, aveva-install-x64/, aveva-install-x86/) are gitignored — fetch separately
from the AVEVA installer.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
46 lines
1.1 KiB
C#
46 lines
1.1 KiB
C#
using AVEVA.Historian.Client.Wcf;
|
|
|
|
namespace AVEVA.Historian.Client.Tests;
|
|
|
|
public sealed class WcfStatusProtocolTests
|
|
{
|
|
[Fact]
|
|
public void SystemTimeParserReadsWindowsSystemTimeLayout()
|
|
{
|
|
byte[] buffer =
|
|
[
|
|
0xEA, 0x07,
|
|
0x04, 0x00,
|
|
0x04, 0x00,
|
|
0x1E, 0x00,
|
|
0x0D, 0x00,
|
|
0x2A, 0x00,
|
|
0x07, 0x00,
|
|
0x7B, 0x00
|
|
];
|
|
|
|
DateTime? parsed = HistorianStatusProtocol.TryReadSystemTime(buffer);
|
|
|
|
Assert.Equal(new DateTime(2026, 4, 30, 13, 42, 7, 123), parsed);
|
|
}
|
|
|
|
[Fact]
|
|
public void SystemTimeParserRejectsShortAndInvalidBuffers()
|
|
{
|
|
Assert.Null(HistorianStatusProtocol.TryReadSystemTime([0xEA, 0x07]));
|
|
|
|
byte[] invalidMonth =
|
|
[
|
|
0xEA, 0x07,
|
|
0x00, 0x00,
|
|
0x04, 0x00,
|
|
0x1E, 0x00,
|
|
0x0D, 0x00,
|
|
0x2A, 0x00,
|
|
0x07, 0x00,
|
|
0x7B, 0x00
|
|
];
|
|
Assert.Null(HistorianStatusProtocol.TryReadSystemTime(invalidMonth));
|
|
}
|
|
}
|