Initial commit: managed .NET 10 AVEVA Historian SDK + reverse-engineering toolkit

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>
2026-05-04 06:31:48 -04:00
commit c95824a65d
230 changed files with 38666 additions and 0 deletions
@@ -0,0 +1,50 @@
+param(
+    [string]$HostName = "localhost",
+    [int]$Port = 32568
+)
+
+$ErrorActionPreference = "Stop"
+$repoRoot = Split-Path -Parent $PSScriptRoot
+
+function Convert-SecureStringToPlainText {
+    param([Parameter(Mandatory = $true)][securestring]$SecureString)
+
+    $bstr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecureString)
+    try {
+        [Runtime.InteropServices.Marshal]::PtrToStringBSTR($bstr)
+    }
+    finally {
+        [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($bstr)
+    }
+}
+
+Push-Location $repoRoot
+try {
+    $suggestedUserName = "$env:COMPUTERNAME\$env:USERNAME"
+    $userName = Read-Host "Historian user [$suggestedUserName]"
+    if ([string]::IsNullOrWhiteSpace($userName)) {
+        $userName = $suggestedUserName
+    }
+
+    $securePassword = Read-Host "Historian password" -AsSecureString
+    $plainPassword = Convert-SecureStringToPlainText $securePassword
+
+    $env:HISTORIAN_USER = $userName
+    $env:HISTORIAN_PASSWORD = $plainPassword
+
+    Write-Host ""
+    Write-Host "Building latest harness..."
+    dotnet build .\Histsdk.slnx
+
+    Write-Host ""
+    Write-Host "Running managed Open2 probe against $HostName`:$Port..."
+    dotnet run --no-build --project tools\AVEVA.Historian.ReverseEngineering -- wcf-open2 $HostName $Port
+}
+finally {
+    Remove-Item Env:HISTORIAN_USER -ErrorAction SilentlyContinue
+    Remove-Item Env:HISTORIAN_PASSWORD -ErrorAction SilentlyContinue
+    if (Get-Variable -Name plainPassword -Scope Local -ErrorAction SilentlyContinue) {
+        $plainPassword = $null
+    }
+    Pop-Location
+}