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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Machinery.Client" Version="2.0.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="OPCFoundation.NetStandard.Opc.Ua.Machinery.Client" Version="2.0.2" />
                    
Directory.Packages.props
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Machinery.Client" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add OPCFoundation.NetStandard.Opc.Ua.Machinery.Client --version 2.0.2
                    
#r "nuget: OPCFoundation.NetStandard.Opc.Ua.Machinery.Client, 2.0.2"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package OPCFoundation.NetStandard.Opc.Ua.Machinery.Client@2.0.2
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Machinery.Client&version=2.0.2
                    
Install as a Cake Addin
#tool nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Machinery.Client&version=2.0.2
                    
Install as a Cake Tool

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.

Version Downloads Last Updated
2.0.2 164 11/11/2026
2.0.1 232 10/12/2026
2.0.0 132 10/7/2026