Files
histsdk/docs/reverse-engineering/native-trace-harness-cyclic-latest.json
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

2 lines
7.1 KiB
JSON

{"Operation":"NativeTraceHarness.IntegratedRead","TagName":"OtOpcUaParityTest_001.Counter","LookbackMinutes":1440,"RetrievalMode":"Cyclic","ResolutionTicks":600000000,"StartUtc":"2026-04-30T11:35:59.6702667Z","EndUtc":"2026-05-01T11:35:59.6484309Z","OpenSuccess":true,"OpenErrorType":"NoError","OpenErrorCode":"Success","OpenErrorDescription":"No error type set","ConnectedToServer":true,"Pending":false,"ErrorOccurred":false,"StartQuerySuccess":true,"StartQueryErrorType":"NoError","StartQueryErrorCode":"Success","StartQueryErrorDescription":"No error type set","MoveTerminalDescription":"result = 30 (No more data)","RowCount":2,"Rows":[{"StartDateTime":"2026-04-23T12:55:59.6702667Z","EndDateTime":"2026-04-30T11:35:59.6702667Z","Quality":0,"OpcQuality":192,"QualityDetail":248,"Value":0,"PercentGood":100},{"StartDateTime":"2026-04-30T11:35:59.6702667Z","EndDateTime":"2026-05-01T11:35:59.6484309Z","Quality":0,"OpcQuality":192,"QualityDetail":4344,"Value":0,"PercentGood":100}],"Snapshots":{"ConnectionArgs":{"field:tcpPort":32568,"field:serverName":"localhost","field:readOnly":true,"field:bandwidthLimit":0,"field:compression":false,"field:packetTimeout":1000,"field:storeForwardPath":"","field:storeForwardFreeDiskSpace":125,"field:minStoreForwardDuration":30,"field:bufferMemory":8,"field:connectionType":"Process","field:details":"","field:consoleAccess":false,"field:metadataNamespace":null,"field:directConnection":false,"field:proxyServer":"","field:futureTimeThreshold":0,"field:futureTimeThresholdSpecified":false,"property:ProxyServer":"","property:BufferMemory":8,"property:MinStoreForwardDuration":30,"property:StoreForwardFreeDiskSpace":125,"property:StoreForwardPath":"","property:PacketTimeout":1000,"property:Compression":false,"property:BandwidthLimit":0,"property:ConsoleAccess":false,"property:ReadOnly":true,"property:Details":"","property:ServerName":"localhost","property:TcpPort":32568,"property:ConnectionType":"Process","property:FutureTimeThreshold":0,"property:DirectConnection":false,"property:MetaDataNamespace":null},"AccessAfterOpen":{"field:clientHandlerArray":[1,0],"field:ptrClientArray":"\u003cunreadable:NotSupportedException\u003e","field:connectionType":"Process","field:eventTagHandle":0},"QueryAfterCreate":{"field:maxStates":0,"field:filter":null,"field:valueSelector":"0","field:stateCalc":"Minimum","field:valueDeadband":0,"field:timeDeadband":0,"field:dataSourceId":null,"field:optionAvailable":true,"field:queryResult":null,"field:queryHandle":0,"field:retrievalMode":"Cyclic","field:dataVersion":"Original","field:resolution":0,"property:QueryResult":null},"QueryArgsBeforeStart":{"field:valueDeadband":0,"field:querytimeDeadband":0,"field:interpolationType":"None","field:timestampRule":"End","field:qualityRule":"Extended","field:valueSelector":"Auto","field:stateCalc":"Total","field:wwFilter":"NoFilter","field:wwOption":"","field:maxStates":100,"field:dataSourceId":null,"property:MaxStates":100,"property:Filter":"NoFilter","property:AggregationType":"Total","property:ValueSelector":"Auto","property:Option":"","property:QualityRule":"Extended","property:TimeStampRule":"End","property:InterpolationType":"None","property:TimeDeadband":0,"property:ValueDeadband":0,"property:SkipRows":0,"property:BatchSize":3,"property:DataVersion":"Latest","property:Resolution":600000000,"property:RetrievalMode":"Cyclic","property:EndDateTime":"2026-05-01T11:35:59.6484309Z","property:StartDateTime":"2026-04-30T11:35:59.6702667Z","property:TagNames":["OtOpcUaParityTest_001.Counter"]},"QueryAfterStart":{"field:maxStates":0,"field:filter":null,"field:valueSelector":"0","field:stateCalc":"Minimum","field:valueDeadband":0,"field:timeDeadband":0,"field:dataSourceId":"","field:optionAvailable":true,"field:queryResult":"\u003cArchestrA.HistoryQueryResult\u003e","field:queryHandle":1,"field:retrievalMode":"Cyclic","field:dataVersion":"Original","field:resolution":0,"property:QueryResult":"\u003cArchestrA.HistoryQueryResult\u003e"},"QueryArgsAfterStart":{"field:valueDeadband":0,"field:querytimeDeadband":0,"field:interpolationType":"None","field:timestampRule":"End","field:qualityRule":"Extended","field:valueSelector":"Auto","field:stateCalc":"Total","field:wwFilter":"NoFilter","field:wwOption":"","field:maxStates":100,"field:dataSourceId":"","property:MaxStates":100,"property:Filter":"NoFilter","property:AggregationType":"Total","property:ValueSelector":"Auto","property:Option":"","property:QualityRule":"Extended","property:TimeStampRule":"End","property:InterpolationType":"None","property:TimeDeadband":0,"property:ValueDeadband":0,"property:SkipRows":0,"property:BatchSize":3,"property:DataVersion":"Latest","property:Resolution":600000000,"property:RetrievalMode":"Cyclic","property:EndDateTime":"2026-05-01T11:35:59.6484309Z","property:StartDateTime":"2026-04-30T11:35:59.6702667Z","property:TagNames":["OtOpcUaParityTest_001.Counter"]},"QueryAfterFirstMove":{"field:maxStates":0,"field:filter":null,"field:valueSelector":"0","field:stateCalc":"Minimum","field:valueDeadband":0,"field:timeDeadband":0,"field:dataSourceId":"","field:optionAvailable":true,"field:queryResult":"\u003cArchestrA.HistoryQueryResult\u003e","field:queryHandle":1,"field:retrievalMode":"Cyclic","field:dataVersion":"Original","field:resolution":0,"property:QueryResult":"\u003cArchestrA.HistoryQueryResult\u003e"},"QueryResultAfterFirstMove":{"field:tagName":null,"field:tagKey":238,"field:startDateTime":"2026-04-30T11:35:59.6702667Z","field:endDateTime":"2026-05-01T11:35:59.6484309Z","field:analogValue":0,"field:stringValue":"0","field:quality":0,"field:qualityDetail":4344,"field:opcQuality":192,"field:resolution":600000000,"field:retrievalMode":null,"field:timeDeadband":0,"field:valueDeadband":0,"field:timestampRule":null,"field:interpolationType":null,"field:qualityRule":null,"field:stateCalc":null,"field:stateTime":0,"field:percentGood":100,"field:sourceTag":null,"field:sourceServer":null,"field:filter":null,"field:valueSelector":null,"field:maxStates":0,"field:dataVersion":null,"field:basicPropertiesInitialized":true,"field:valuePropertiesInitialized":false,"field:queryArgs":"\u003cArchestrA.HistoryQueryArgs\u003e","field:pUnmanagedQueryResult":"\u003cSystem.Reflection.Pointer\u003e","property:DataVersion":"Latest","property:MaxStates":0,"property:ValueSelector":"Auto","property:Filter":"NoFilter","property:SourceServer":"","property:SourceTag":"","property:PercentGood":100,"property:StateTime":0,"property:StateCalc":"Total","property:QualityRule":"Extended","property:InterpolationType":"StairStep","property:TimeStampRule":"End","property:ValueDeadband":0,"property:TimeDeadband":0,"property:RetrievalMode":"Cyclic","property:Resolution":600000000,"property:OpcQuality":192,"property:QualityDetail":4344,"property:Quality":0,"property:StringValue":"0","property:Value":0,"property:EndDateTime":"2026-05-01T11:35:59.6484309Z","property:StartDateTime":"2026-04-30T11:35:59.6702667Z","property:TagKey":238,"property:TagName":"OtOpcUaParityTest_001.Counter","property:UnmanagedQueryResult":"\u003cSystem.Reflection.Pointer\u003e"}},"TracePath":"C:\\Users\\dohertj2\\Desktop\\histsdk\\docs\\reverse-engineering\\native-wcf-message-log.svclog","TraceExists":false,"TraceBytes":0}