Files
histsdk/scripts/Run-AahClientManagedFridaCapture.ps1
T
dohertj2 c95824a65d 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

55 lines
1.6 KiB
PowerShell

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"