OPCFoundation.NetStandard.Opc.Ua.Machinery.Client
2.0.2
Prefix Reserved
dotnet add package OPCFoundation.NetStandard.Opc.Ua.Machinery.Client --version 2.0.2
NuGet\Install-Package OPCFoundation.NetStandard.Opc.Ua.Machinery.Client -Version 2.0.2
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Machinery.Client" Version="2.0.2" />
<PackageVersion Include="OPCFoundation.NetStandard.Opc.Ua.Machinery.Client" Version="2.0.2" />
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Machinery.Client" />
paket add OPCFoundation.NetStandard.Opc.Ua.Machinery.Client --version 2.0.2
#r "nuget: OPCFoundation.NetStandard.Opc.Ua.Machinery.Client, 2.0.2"
#:package OPCFoundation.NetStandard.Opc.Ua.Machinery.Client@2.0.2
#addin nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Machinery.Client&version=2.0.2
#tool nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Machinery.Client&version=2.0.2
OPCFoundation.NetStandard.Opc.Ua.Machinery.Client
Client-side helpers for the OPC 40001 OPC UA for Machinery specification series.
A Machinery server publishes its machines in one well-known place — the
Machines folder that OPC 40001-1 organizes from Objects, not from the
Device Integration DeviceSet. This package starts there and hands back typed
access to what a machine exposes.
MachineryClient machinery = session.Machinery(telemetry);
await foreach (MachineEntry machine in machinery.EnumerateMachinesAsync(ct))
{
MachineIdentification id = await machinery.ReadIdentificationAsync(machine.NodeId, ct);
Console.WriteLine($"{id.Manufacturer} {id.Model} — {id.SerialNumber}");
FiniteStateSnapshot? state = await machinery.GetItemStateAsync(machine.NodeId, ct);
Console.WriteLine($" state: {state?.CurrentState}");
}
| Concern | API |
|---|---|
| Discovery | EnumerateMachinesAsync, DiscoverMachinesAsync, FindComponentsAsync |
| Identification | ReadIdentificationAsync |
| State | GetItemStateAsync, ObserveItemStateAsync, GetOperationModeAsync, ObserveOperationModeAsync |
| Process values | ReadProcessValueAsync |
| Jobs | JobManagement(machine) → Isa95JobControlV2Client |
| Results | ResultManagement(machine), DownloadResultAsync |
State observation rides the generated state-machine proxies, so it works against any server that publishes the OPC 40001-1 state machines — including vendor subtypes.
For bounded inspection with explicit source, quality and timestamp evidence,
pass MachineryClientOptions:
MachineryClient strict = session.Machinery(telemetry, new MachineryClientOptions
{
MaximumBrowseReferences = 1024,
MaximumBrowsePages = 128,
MaximumReadArrayItems = 1024
});
MachineIdentification? id = await strict.ReadIdentificationAsync(selectedMachineId, ct);
MachineryStateSnapshot? state = await strict.ReadItemStateAsync(selectedMachineId, ct);
MachineryReadValue health = await strict.ReadDeviceHealthValueAsync(selectedMachineId, ct);
Strict detail records expose ArrayOf<MachineryReadValue> Values. Each field
retains its local source NodeId, qualified path and original DataValue. Good-null
is present; only genuine optional absence sets IsAbsent. Denied/Uncertain
reads, wrong types, incomplete responses and ambiguous/foreign translations
throw MachineryReadException, preserving status and offending evidence.
Browse budgets are enforced while following pages, including progressing pages
that reuse opaque continuation tokens. Continuation cleanup accepts standard
empty release responses and has an independently bounded five-second deadline.
Decoding and opaque vendor payload sizes
depend on session quotas.
Strict lifetime and equipment-life bounds are mandatory Number fields. Scalar and one-dimensional numeric warning thresholds remain in their original evidence when they are not Double arrays. Strict meters require ApplicationTag, keep StartTime and other properties as metadata, and validate measurements against their declared data type and rank, including ECM three-phase structures.
Use EnumeratePublishedResultsAsync for result identities and
ReadPublishedResultAsync for an explicitly selected variable. Job-list and
state snapshot APIs retain evidence without mutable client-wide last-read
state. Options also flow through AddMachineryClient(options) and
MachineryClientFactory. Generated proxies, event observation, job commands
and file transfers keep their own contracts. See the developer guide for
strict job-response-list semantics and array limits.
For bounded result exports, pass a writable, caller-owned stream and an explicit
byte limit. This overload downloads only the selected ResultId; it never
enumerates results or retrieves a result URI.
long bytesWritten = await machinery.DownloadResultAsync(
machineId, selectedResultId, destination, maxBytes: 1024 * 1024, cancellationToken: ct);
The limit is enforced during streaming, without trusting a declared file size.
Reads use at most 64 KiB per request and at most 1024 requests, including the
end-of-file probe. A zero limit accepts only an empty payload. The server handle
is closed with an independent five-second deadline, even when the download is
cancelled. If downloading and closing both fail, AggregateException preserves
the download failure first and the close failure second. The session and
destination stay open; discard any partial destination after failure.
On a ManagedSession, the result path and transfer share one captured session
generation. Bounded browse continuations use the same ownership rule; neither
operation forwards owned state to a replacement session after recovery.
DownloadResultAsync(machineId, resultId, ct) returns a buffered ByteString.
Use the streaming overload for exports that must remain bounded.
See the Machinery developer guide.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Framework | net48 is compatible. net481 was computed. |
-
.NETFramework 4.8
- BitFaster.Caching (>= 2.6.1)
- BouncyCastle.Cryptography (>= 2.7.0)
- Microsoft.Bcl.AsyncInterfaces (>= 10.0.13)
- Microsoft.Bcl.HashCode (>= 6.0.0)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Di.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.ISA95.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Energy (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Jobs (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.ProcessValues (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Result (>= 2.0.2)
- System.Buffers (>= 4.6.1)
- System.Collections.Immutable (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 10.0.13)
- System.Formats.Asn1 (>= 10.0.13)
- System.Memory (>= 4.6.3)
- System.Runtime.CompilerServices.Unsafe (>= 6.1.2)
- System.Text.Json (>= 10.0.13)
- System.Threading.Channels (>= 10.0.13)
- System.Threading.RateLimiting (>= 10.0.13)
- System.Threading.Tasks.Extensions (>= 4.6.3)
-
net10.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Di.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.ISA95.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Energy (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Jobs (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.ProcessValues (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Result (>= 2.0.2)
- System.Threading.RateLimiting (>= 10.0.13)
-
net8.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Di.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.ISA95.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Energy (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Jobs (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.ProcessValues (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Result (>= 2.0.2)
- System.Collections.Immutable (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 10.0.13)
- System.Formats.Asn1 (>= 10.0.13)
- System.Text.Json (>= 10.0.13)
- System.Threading.Channels (>= 10.0.13)
- System.Threading.RateLimiting (>= 10.0.13)
-
net9.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Di.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.ISA95.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Energy (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Jobs (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.ProcessValues (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Machinery.Result (>= 2.0.2)
- System.Diagnostics.DiagnosticSource (>= 10.0.13)
- System.Formats.Asn1 (>= 10.0.13)
- System.Text.Json (>= 10.0.13)
- System.Threading.Channels (>= 10.0.13)
- System.Threading.RateLimiting (>= 10.0.13)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on OPCFoundation.NetStandard.Opc.Ua.Machinery.Client:
| Package | Downloads |
|---|---|
|
OPCFoundation.NetStandard.Opc.Ua.MachineTool.Client
Typed, bounded client workflows for MachineTool and independently hosted wireless machine tool peripherals. |
|
|
OPCFoundation.NetStandard.Opc.Ua.GMS.Client
Bounded OPC 40210 GMS result queries, metadata, characteristics, corrections and result-file downloads using generated proxies and standard OPC UA file transfer. |
|
|
OPCFoundation.NetStandard.Opc.Ua.Mcp.Machinery
Bounded OPC UA Machinery MCP discovery, monitoring, result downloads and explicit zero adjustment. |
GitHub repositories
This package is not used by any popular GitHub repositories.