mirror of
https://github.com/OPCFoundation/UA-.NETStandard.git
synced 2026-10-24 19:13:02 +08:00
**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
135 lines
5.4 KiB
C#
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();
|
|
}
|