mirror of
https://github.com/OPCFoundation/UA-.NETStandard.git
synced 2026-10-18 22:55:08 +08:00
c48c8b93dd
**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
190 lines
6.5 KiB
C#
190 lines
6.5 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 System.IO;
|
|
using NUnit.Framework;
|
|
using Opc.Ua.Gpos;
|
|
|
|
namespace Opc.Ua.Positioning.Tests
|
|
{
|
|
[TestFixture]
|
|
[Category("Positioning")]
|
|
public sealed class ModelEncodingTests
|
|
{
|
|
[Test]
|
|
public void GeographicCoordinateRoundTripsBinaryAndJson()
|
|
{
|
|
var value = new S3DGeographicCoordinateDataType
|
|
{
|
|
EncodingMask =
|
|
(uint)S3DGeographicCoordinateDataTypeFields.Elevation,
|
|
Longitude = 8.55,
|
|
Latitude = 47.37,
|
|
Elevation = 408.2
|
|
};
|
|
|
|
AssertRoundTrips(value);
|
|
}
|
|
|
|
[Test]
|
|
public void GlobalPositionRoundTripsBinaryAndJson()
|
|
{
|
|
var value = new GlobalPositionDataType
|
|
{
|
|
EncodingMask =
|
|
(uint)S3DGeographicCoordinateDataTypeFields.Elevation |
|
|
(uint)GlobalPositionDataTypeFields.Accuracy |
|
|
(uint)GlobalPositionDataTypeFields.Floor,
|
|
Longitude = 8.55,
|
|
Latitude = 47.37,
|
|
Elevation = 408.2,
|
|
Accuracy = 0.04,
|
|
Floor = 2.0f
|
|
};
|
|
|
|
AssertRoundTrips(value);
|
|
}
|
|
|
|
[Test]
|
|
public void GlobalPositionBinaryEncodingUsesSingleOptionalFieldMask()
|
|
{
|
|
var value = new GlobalPositionDataType
|
|
{
|
|
EncodingMask =
|
|
(uint)GlobalPositionDataTypeFields.Elevation |
|
|
(uint)GlobalPositionDataTypeFields.Accuracy |
|
|
(uint)GlobalPositionDataTypeFields.Floor,
|
|
Longitude = 8.55,
|
|
Latitude = 47.37,
|
|
Elevation = 408.2,
|
|
Accuracy = 0.04,
|
|
Floor = 2.0f
|
|
};
|
|
ServiceMessageContext context = CreateContext();
|
|
|
|
using var stream = new MemoryStream();
|
|
using (var encoder = new BinaryEncoder(stream, context, true))
|
|
{
|
|
encoder.WriteEncodeable("Value", value);
|
|
}
|
|
|
|
Assert.That(stream.Length, Is.EqualTo(40));
|
|
}
|
|
|
|
[Test]
|
|
public void GlobalLocationRoundTripsBinaryAndJson()
|
|
{
|
|
var value = new GlobalLocationDataType
|
|
{
|
|
EncodingMask =
|
|
(uint)GlobalLocationDataTypeFields.Orientation,
|
|
Position = new GlobalPositionDataType
|
|
{
|
|
EncodingMask =
|
|
(uint)S3DGeographicCoordinateDataTypeFields.Elevation,
|
|
Longitude = 8.55,
|
|
Latitude = 47.37,
|
|
Elevation = 408.2
|
|
},
|
|
Orientation = new ThreeDOrientation
|
|
{
|
|
A = 1.0,
|
|
B = 2.0,
|
|
C = 3.0
|
|
}
|
|
};
|
|
|
|
AssertRoundTrips(value);
|
|
}
|
|
|
|
[Test]
|
|
public void GroundControlPointRoundTripsBinaryAndJson()
|
|
{
|
|
var value = new GroundControlPointDataType
|
|
{
|
|
GlobalPosition = new S3DGeographicCoordinateDataType
|
|
{
|
|
EncodingMask =
|
|
(uint)S3DGeographicCoordinateDataTypeFields.Elevation,
|
|
Longitude = 8.55,
|
|
Latitude = 47.37,
|
|
Elevation = 408.2
|
|
},
|
|
LocalPosition = new ThreeDCartesianCoordinates
|
|
{
|
|
X = 1.0,
|
|
Y = 2.0,
|
|
Z = 3.0
|
|
}
|
|
};
|
|
|
|
AssertRoundTrips(value);
|
|
}
|
|
|
|
private static void AssertRoundTrips<T>(T value)
|
|
where T : IEncodeable, new()
|
|
{
|
|
ServiceMessageContext context = CreateContext();
|
|
|
|
using var stream = new MemoryStream();
|
|
using (var encoder = new BinaryEncoder(stream, context, true))
|
|
{
|
|
encoder.WriteEncodeable("Value", value);
|
|
}
|
|
stream.Position = 0;
|
|
using (var decoder = new BinaryDecoder(stream, context, true))
|
|
{
|
|
T decoded = decoder.ReadEncodeable<T>("Value");
|
|
Assert.That(value.IsEqual(decoded), Is.True);
|
|
}
|
|
|
|
string json;
|
|
using (var encoder = new JsonEncoder(context))
|
|
{
|
|
encoder.EncodeMessage(value, value.TypeId);
|
|
json = encoder.CloseAndReturnText();
|
|
}
|
|
using (var decoder = new JsonDecoder(json, context))
|
|
{
|
|
T decoded = decoder.DecodeMessage<T>();
|
|
Assert.That(value.IsEqual(decoded), Is.True);
|
|
}
|
|
}
|
|
|
|
private static ServiceMessageContext CreateContext()
|
|
{
|
|
var context = ServiceMessageContext.Create(null);
|
|
context.NamespaceUris.GetIndexOrAppend(Rsl.Namespaces.RSL);
|
|
context.NamespaceUris.GetIndexOrAppend(Gpos.Namespaces.GPOS);
|
|
context.Factory.Builder.AddOpcUaGpos().Commit();
|
|
return context;
|
|
}
|
|
}
|
|
}
|