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>
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
param(
|
||||
[string]$TagName = "OtOpcUaParityTest_001.Counter",
|
||||
[int]$LookbackMinutes = 1440,
|
||||
[int]$MaxRows = 1,
|
||||
[string]$OutputPath = $null
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
|
||||
$repoRoot = Split-Path -Parent $PSScriptRoot
|
||||
$fridaScript = Join-Path $PSScriptRoot "frida\aahclientmanaged-open-query.js"
|
||||
$nativeReadScript = Join-Path $PSScriptRoot "Test-AahClientManagedReadIntegrated.ps1"
|
||||
|
||||
if (-not (Test-Path -LiteralPath $fridaScript)) {
|
||||
throw "Missing Frida script at $fridaScript"
|
||||
}
|
||||
|
||||
if (-not (Test-Path -LiteralPath $nativeReadScript)) {
|
||||
throw "Missing native read script at $nativeReadScript"
|
||||
}
|
||||
|
||||
if ([string]::IsNullOrWhiteSpace($OutputPath)) {
|
||||
$stamp = Get-Date -Format "yyyyMMdd-HHmmss"
|
||||
$OutputPath = Join-Path $repoRoot "docs\reverse-engineering\frida-aahclientmanaged-integrated-read-$stamp.ndjson"
|
||||
}
|
||||
|
||||
$outputDirectory = Split-Path -Parent $OutputPath
|
||||
New-Item -ItemType Directory -Force -Path $outputDirectory | Out-Null
|
||||
|
||||
$powershell = Join-Path $env:WINDIR "System32\WindowsPowerShell\v1.0\powershell.exe"
|
||||
if (-not (Test-Path -LiteralPath $powershell)) {
|
||||
$powershell = "powershell.exe"
|
||||
}
|
||||
|
||||
$fridaArgs = @(
|
||||
"-q",
|
||||
"-f", $powershell,
|
||||
"-l", $fridaScript,
|
||||
"--",
|
||||
"-NoProfile",
|
||||
"-ExecutionPolicy", "Bypass",
|
||||
"-File", $nativeReadScript,
|
||||
"-TagName", $TagName,
|
||||
"-LookbackMinutes", $LookbackMinutes.ToString(),
|
||||
"-MaxRows", $MaxRows.ToString(),
|
||||
"-ConnectionWaitSeconds", "15"
|
||||
)
|
||||
|
||||
Write-Host "Writing Frida capture to $OutputPath"
|
||||
Write-Host "Target tag: $TagName"
|
||||
|
||||
& frida @fridaArgs 2>&1 | Tee-Object -FilePath $OutputPath
|
||||
|
||||
Write-Host "Capture complete: $OutputPath"
|
||||
Reference in New Issue
Block a user