Files
Marc Schier 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

124 lines
5.0 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;
using NUnit.Framework;
namespace Opc.Ua.Positioning.Tests.Transforms
{
[TestFixture]
[Category("Positioning")]
public sealed class InternalMathTests
{
[Test]
public void MatrixEqualityChecksEveryElement()
{
var expected = new Matrix3x3(
1.0, 2.0, 3.0,
4.0, 5.0, 6.0,
7.0, 8.0, 9.0);
Matrix3x3[] different =
[
new(0.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0),
new(1.0, 0.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0),
new(1.0, 2.0, 0.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0),
new(1.0, 2.0, 3.0, 0.0, 5.0, 6.0, 7.0, 8.0, 9.0),
new(1.0, 2.0, 3.0, 4.0, 0.0, 6.0, 7.0, 8.0, 9.0),
new(1.0, 2.0, 3.0, 4.0, 5.0, 0.0, 7.0, 8.0, 9.0),
new(1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 0.0, 8.0, 9.0),
new(1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 0.0, 9.0),
new(1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 0.0)
];
Assert.Multiple(() =>
{
var same = new Matrix3x3(
1.0, 2.0, 3.0,
4.0, 5.0, 6.0,
7.0, 8.0, 9.0);
Assert.That(
expected,
Is.EqualTo(same));
Assert.That((object)expected, Is.EqualTo(same));
Assert.That((object)expected, Is.Not.EqualTo("not a matrix"));
Assert.That(
expected.GetHashCode(),
Is.EqualTo(same.GetHashCode()));
for (int i = 0; i < different.Length; i++)
{
Assert.That(expected, Is.Not.EqualTo(different[i]));
}
});
}
[Test]
public void VectorOperationsAndIndexValidationAreDeterministic()
{
var left = new Vector3(1.0, 2.0, 3.0);
var right = new Vector3(4.0, 5.0, 6.0);
Assert.Multiple(() =>
{
Assert.That(left.LengthSquared, Is.EqualTo(14.0));
Assert.That(left.Length, Is.EqualTo(Math.Sqrt(14.0)));
Assert.That(left.IsFinite, Is.True);
Assert.That(
left + right,
Is.EqualTo(new Vector3(5.0, 7.0, 9.0)));
Assert.That(
right - left,
Is.EqualTo(new Vector3(3.0, 3.0, 3.0)));
Assert.That(
left * 2.0,
Is.EqualTo(new Vector3(2.0, 4.0, 6.0)));
Assert.That(
2.0 * left,
Is.EqualTo(new Vector3(2.0, 4.0, 6.0)));
Assert.That(Vector3.Dot(left, right), Is.EqualTo(32.0));
Assert.That(
Vector3.Cross(left, right),
Is.EqualTo(new Vector3(-3.0, 6.0, -3.0)));
Assert.That(left[0], Is.EqualTo(1.0));
Assert.That(left[1], Is.EqualTo(2.0));
Assert.That(left[2], Is.EqualTo(3.0));
Assert.That(
() => _ = left[3],
Throws.TypeOf<ArgumentOutOfRangeException>());
Assert.That((object)left, Is.EqualTo(left));
Assert.That((object)left, Is.Not.EqualTo("not a vector"));
Assert.That(
new Vector3(double.NaN, 0.0, 0.0).IsFinite,
Is.False);
Assert.That(left.GetHashCode(), Is.EqualTo(
new Vector3(1.0, 2.0, 3.0).GetHashCode()));
});
}
}
}