OPCFoundation.NetStandard.Opc.Ua.AMB.Client
2.0.2
Prefix Reserved
dotnet add package OPCFoundation.NetStandard.Opc.Ua.AMB.Client --version 2.0.2
NuGet\Install-Package OPCFoundation.NetStandard.Opc.Ua.AMB.Client -Version 2.0.2
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.AMB.Client" Version="2.0.2" />
<PackageVersion Include="OPCFoundation.NetStandard.Opc.Ua.AMB.Client" Version="2.0.2" />
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.AMB.Client" />
paket add OPCFoundation.NetStandard.Opc.Ua.AMB.Client --version 2.0.2
#r "nuget: OPCFoundation.NetStandard.Opc.Ua.AMB.Client, 2.0.2"
#:package OPCFoundation.NetStandard.Opc.Ua.AMB.Client@2.0.2
#addin nuget:?package=OPCFoundation.NetStandard.Opc.Ua.AMB.Client&version=2.0.2
#tool nuget:?package=OPCFoundation.NetStandard.Opc.Ua.AMB.Client&version=2.0.2
Opc.Ua.AMB.Client
Client-side access to OPC 10000-110 — Asset Management Basics (AMB).
AmbClient amb = session.AssetManagement(telemetry);
foreach (NodeId asset in await amb.DiscoverAssetsAsync(ct))
{
AssetSnapshot snapshot = await amb.ReadAssetAsync(asset, ct);
Console.WriteLine($"{snapshot.Identification.ProductInstanceUri}: {snapshot.DeviceHealth}");
}
Discovery
FindAssetsAsync calls FindAlias on the alias categories Assets,
AssetsByProductInstanceUri and AssetsByAssetId; EnumerateAssetsAsync
browses the alias objects instead. DiscoverAssetsAsync returns every asset of
the server once. ReadNodeVersionAsync and ObserveAssetSetChangesAsync
follow changes of the categories.
Reading
| Call | OPC 10000-110 |
|---|---|
ReadIdentificationAsync, WriteAssetIdAsync |
§7, on the asset or in 2:Identification |
ReadDeviceHealthAsync, ReadHealthAlarmsAsync |
§9 |
ReadMaintenanceActivitiesAsync |
§12 |
ReadDocumentationLinksAsync, AddDocumentationLinkAsync, RemoveDocumentationLinkAsync |
§10.5 |
ReadEntriesAsync |
§10.6, §10.7 |
ReadContextAsync, ReadLocationsOfAssetAsync, BrowseLocationsAsync |
§11, §13 |
EnumerateSubAssetsAsync, ReadRelationsAsync |
§14 |
ReadAssetAsync |
all of the above for one asset |
Pass AmbClientOptions to the client constructor to opt into bounded traversal
and strict response validation. Read records then retain original source nodes,
quality and timestamps in their Values evidence. A present Good-null structure
is not an absent optional path; scalar type mismatches are still rejected.
Events
ObserveHealthAlarmsAsync and ObserveMaintenanceAsync subscribe to the
condition events and return AssetAlarmRecord and MaintenanceActivityRecord
values, including the potential root causes, the maintenance state and the
comment of an acknowledgement. A maintenance activity is told apart by its
condition class (MaintenanceConditionClassType or a subtype), and the two
filters select disjoint events. The fields of the AMB interfaces are selected
with BaseEventType as the type definition, since a server checks select
clauses against the type hierarchy of an event, which interfaces are not part
of. Tolerant read calls ask for a condition refresh when there is no
2:DeviceHealthAlarms folder; strict reads require the folder and do not start
an implicit refresh. Event observation still falls back to known maintenance
classes if subtype browsing fails or reaches a traversal limit, without caching
an incomplete class set. AcknowledgeAsync acknowledges a condition.
History
ReadHealthHistoryAsync reads raw DeviceHealth with original quality and
timestamps. ReadHealthEventsAsync and ReadPastMaintenanceAsync read
immutable condition events filtered by asset and maintenance class, including
subtypes. They use HistoryClient for paging, continuation release and
cancellation; pass HistoryClientOptions for read-duration and page limits.
Event records preserve original field values in HistoryFields, whose
select-clause identities are returned by GetHistoryEventFields().
GetHistoryCapabilitiesAsync reports history-read attributes. Unsupported
or denied history is an error, not an empty successful result.
Hosting
services.AddOpcUa().AddClient(...).AddAssetManagementClient();
registers an AmbClientFactory and a Func<CancellationToken, Task<AmbClient>>.
Use AddAssetManagementClient(new AmbClientOptions { MaximumBrowseReferences = 1024, MaximumBrowsePages = 128 }) to apply strict limits to both factories. An
AmbClientOptions singleton registered separately is also honored. Without
options, both retain tolerant behavior. Direct construction supports
new AmbClientFactory(openSession, telemetry, options) as well.
For the server side use Opc.Ua.AMB.Server; the model and the shared
contracts live in Opc.Ua.AMB.
| 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.AMB (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Di.Client (>= 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.AMB (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Di.Client (>= 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.AMB (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Di.Client (>= 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.AMB (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Client (>= 2.0.2)
- OPCFoundation.NetStandard.Opc.Ua.Di.Client (>= 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 (1)
Showing the top 1 NuGet packages that depend on OPCFoundation.NetStandard.Opc.Ua.AMB.Client:
| Package | Downloads |
|---|---|
|
OPCFoundation.NetStandard.Opc.Ua.Mcp.AMB
Embeddable MCP tools for OPC UA Asset Management Basics: asset discovery, identification, health, maintenance, documentation, and explicit asset controls. |
GitHub repositories
This package is not used by any popular GitHub repositories.