Files
histsdk/docs/reverse-engineering/cserverclient-handle-correlation-latest.json
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

24 lines
1.1 KiB
JSON

{
"GeneratedUtc": "2026-05-02T23:00:03Z",
"Scenario": "native integrated history read",
"Sanitized": true,
"InstrumentedMethods": {
"CServerClient.GetHandle": "0x060017F9",
"HistorianClient.OpenConnection": "0x060055D8",
"Query.StartDataQuery": "0x0600574B",
"CRetrievalConnectionWCF.StartQuery2": "0x06004A0D",
"CRetrievalConnectionWCF.GetNextQueryResultBuffer2": "0x06004A0E",
"HistorianClient.GetNextRow<DataQueryResultRow>": "0x0600588D"
},
"ObservedValues": {
"CServerClientGetHandleRecords": 0,
"HistorianClientOpenConnectionHandle": 2,
"StartDataQueryClientHandleCandidate": 2,
"WcfStartQuery2ClientHandle": "<transient-redacted>",
"WcfStartQuery2ServerQueryHandle": "<transient-redacted>",
"WcfStartQuery2Success": 1,
"WcfGetNextQueryResultBuffer2Success": 1
},
"Conclusion": "CServerClient.GetHandle is not called on this successful local history read path. The transient WCF retrieval client handle is therefore not obtained through this accessor; the next target should be direct field access or the virtual/calli path through CRetrieval.StartQuery2 and CSrvRetrievalConnection.StartQuery."
}