Files
UA-.NETStandard/samples/MinimalIsa95Server/Program.cs
Marc SchierandCopilot c48c8b93dd Positioning: OPC 10000-210 RSL and 10000-211 GPOS on one geolocation provider (#4125)
**Stack 3/5** — base #4124. Part of the #4096 split; see #4096 for the
overall picture.

> Review after #4123 and #4124.

## What this is

The OPC 10000-210 Relative Spatial Location and OPC 10000-211 Global
Positioning companion models, with their server and client libraries,
plus the ISA-95 migration onto the shared geolocation seam.

## Why it is one change

A deployment writes **one** provider implementation and both OPC
10000-211 and OPC 10030 are served from it. The specifications disagree
on representation, not on content:

- GPOS publishes the structured `GlobalLocationDataType` and validates
the EPSG code against the configured CRS.
- ISA-95 publishes the same sample as the `String` array that OPC 10030
§8.3.2.2 requires.

Splitting them would mean two provider interfaces for one physical
sensor, which is exactly what this avoids. The seam itself lives in
`Opc.Ua.Server` and landed in 1/5.

## Contents

- `Opc.Ua.Positioning`, `.Server` and `.Client`.
- `Opc.Ua.ISA95.Server` moves onto `IGeoLocationProvider`; the three
ISA-95-specific provider files are removed because the shared seam and
its in-memory implementation replace them.
- **Fixes a conformance gap**: the ISA-95 binder wrote a scalar where
the type declares `ValueRank` OneOrMoreDimensions. It now writes
`String[]`.
- **Fixes a liveness bug**: a provider that cannot push is polled at the
Variable's `MinimumSamplingInterval` rather than installed once, so a
non-pushing provider no longer serves its start-up sample with `Good`
status forever.
- `samples/MinimalIsa95Server`.

## Validation

`dotnet build UA.slnx` — 0 errors.

| Suite | Result |
| --- | --- |
| Opc.Ua.Positioning.Tests | 69 / 0 |
| Opc.Ua.ISA95.Tests | 136 / 0 |
| Opc.Ua.Di.Tests | 304 / 0 |

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 8cbb8cd0-f0cb-4ab0-bea2-6202fbf69485
2026-08-01 07:55:58 +02:00

135 lines
5.4 KiB
C#

/* ========================================================================
* Copyright (c) 2005-2026 The OPC Foundation, Inc. All rights reserved.
*
* OPC Foundation MIT License 1.00
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without
* restriction, including without limitation the rights to use,
* copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following
* conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*
* The complete license agreement can be found here:
* http://opcfoundation.org/License/MIT/1.00/
* ======================================================================*/
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using MinimalIsa95Server;
using Opc.Ua;
using Opc.Ua.ISA95;
using Opc.Ua.ISA95.Server.Builders;
using Opc.Ua.ISA95.Server.Providers;
HostApplicationBuilder builder = Host.CreateApplicationBuilder(args);
builder.Logging.ClearProviders();
builder.Logging.AddConsole();
int port = int.TryParse(builder.Configuration["port"], out int configuredPort)
? configuredPort
: 62545;
Isa95GeoSpatialLocationBinding? locationBinding = null;
const string PlantSourceId = "plant";
using var locationProvider = new InMemoryGeoLocationProvider();
locationProvider.Update(
PlantSourceId,
new GeoPosition(47.3769, 8.5417, EpsgCode: 4326));
builder.Services
.AddOpcUa()
.AddServer(options =>
{
options.ApplicationName = "MinimalIsa95Server";
options.ApplicationUri = "urn:localhost:OPCFoundation:MinimalIsa95Server";
options.ProductUri = "uri:opcfoundation.org:MinimalIsa95Server";
options.AutoAcceptUntrustedCertificates = true;
options.EndpointUrls.Add(
$"opc.tcp://localhost:{port}/MinimalIsa95Server");
})
.AddIsa95Server()
.ConfigureModel(async (model, ct) =>
{
PersonnelClassState operators =
await model.CreatePersonnelClassAsync(model.Root, "Operators", ct)
.ConfigureAwait(false);
PersonState operatorOne =
await model.CreatePersonAsync(model.Root, "Operator-1", ct)
.ConfigureAwait(false);
model.DefinedByPersonnelClass(operatorOne, operators);
EquipmentClassState reactorClass =
await model.CreateEquipmentClassAsync(model.Root, "ReactorClass", ct)
.ConfigureAwait(false);
EquipmentState reactor =
await model.CreateEquipmentAsync(model.Root, "Reactor-1", ct)
.ConfigureAwait(false);
model.DefinedByEquipmentClass(reactor, reactorClass);
PhysicalAssetClassState vesselClass =
await model.CreatePhysicalAssetClassAsync(model.Root, "VesselClass", ct)
.ConfigureAwait(false);
PhysicalAssetState vessel =
await model.CreatePhysicalAssetAsync(model.Root, "Vessel-1", ct)
.ConfigureAwait(false);
model.DefinedByPhysicalAssetClass(vessel, vesselClass);
MaterialClassState materialClass =
await model.CreateMaterialClassAsync(model.Root, "Feedstock", ct)
.ConfigureAwait(false);
MaterialDefinitionState materialDefinition =
await model.CreateMaterialDefinitionAsync(
model.Root,
"Feedstock-Grade-A",
ct).ConfigureAwait(false);
model.DefinedByMaterialClass(materialDefinition, materialClass);
MaterialLotState lot =
await model.CreateMaterialLotAsync(model.Root, "Lot-1001", ct)
.ConfigureAwait(false);
model.DefinedByMaterialDefinition(lot, materialDefinition);
MaterialSublotState sublot =
await model.CreateMaterialSublotAsync(lot, "Sublot-A", ct)
.ConfigureAwait(false);
model.MadeUpOfMaterialSublot(lot, sublot);
Isa95GeoSpatialLocationBinding location =
await model.CreateGeoSpatialLocationAsync(
model.Root,
"PlantLocation",
locationProvider,
PlantSourceId,
cancellationToken: ct).ConfigureAwait(false);
PhysicalAssetPropertyState locationProperty = await model.AddPropertyAsync(
vessel,
"LocationReference",
cancellationToken: ct).ConfigureAwait(false);
model.LocatedIn(locationProperty, location.State);
locationBinding = location;
});
builder.Services.AddHostedService<DemoJobSeeder>();
using IHost host = builder.Build();
try
{
await host.RunAsync().ConfigureAwait(false);
}
finally
{
locationBinding?.Dispose();
}