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>
51 lines
1.5 KiB
PowerShell
51 lines
1.5 KiB
PowerShell
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
|
|
}
|