mirror of
https://github.com/OPCFoundation/UA-.NETStandard.git
synced 2026-10-29 15:11:53 +08:00
# Description Add a generic, company-neutral recycling simulation sample and reusable plastics/rubber companion-model packages. One durable causal coordinator and ten separately launched OPC UA process views provide deterministic material balances, finite buffers, genealogy, utilities, quality holds/disposition, authenticated controls and crash recovery. Process views consume committed state instead of running independent simulations. Real companion-model equipment instances use DI/Machinery/AMB discovery, Machine Vision, Pumps/Scales, granulate drying, extrusion, filtration and pelletizing. Vendor/process extensions remain sample-local. Connectors and WoT conversion are out of scope. **External source-contract parity and complete deployment qualification are not claimed complete.** The sample and managed tests target **.NET 8, 9 and 10**. The consolidated [recycling guide](samples/Recycling/README.md) explains the actual composition, simulation, observation paths and exposed data; the application-directory README points to that guide. Typed client member extensions are emitted at build time through the default-false `ModelSourceGeneratorClientAccessorsOnly` opt-in. Extrusion uses it for all twelve parts instead of checked-in generated C# and a Python generator. The shared client runtime retains typed values, quality, timestamps and streaming behavior. ### Package layout Six packages contain fourteen models in two model-producing assemblies: | Specifications | Model | Typed client | Server runtime | | --- | --- | --- | --- | | OPC 40083 and OPC 40082-6 | `Opc.Ua.PlasticsRubber` | `Opc.Ua.PlasticsRubber.Client` | `Opc.Ua.PlasticsRubber.Server` | | OPC 40084 parts 1–12 | `Opc.Ua.Extrusion` | `Opc.Ua.Extrusion.Client` | `Opc.Ua.Extrusion.Server` | NuGet IDs use the `OPCFoundation.NetStandard.` prefix. All six packages are registered in `.azurepipelines/expected-packages.txt` and the generated preview-pack solution. Granulate-drying code lives in `GranulateDrying` folders in the PlasticsRubber projects; extrusion uses per-part folders. There are no standalone granulate-drying or per-part extrusion packages. Published model identities and CLR namespaces remain distinct and unchanged. The common 1.03 interface is independently authored on the explicitly MIT-licensed 1.02 implementation basis; the official 1.03 XML is not redistributed. The other imported models retain their individual MIT notices. All 42 pinned model, identifier and basis files retain their manifest-backed bytes, including their staged Git blobs. No formal companion certification is claimed; the disputed Filter profile is not advertised. ## Related Issues No tracking issue is currently linked. ## Checklist _Put an `x` in the boxes that apply. You can complete these step by step after opening the PR._ - [ ] I have signed the [CLA](https://opcfoundation.org/license/cla/ContributorLicenseAgreementv1.0.pdf) and read the [CONTRIBUTING](https://github.com/OPCFoundation/UA-.NETStandard/blob/master/CONTRIBUTING.md) doc. - [ ] I have added tests that prove my fix is effective or that my feature works and increased code coverage. - [x] I have added all necessary documentation. - [x] I have verified that my changes do not introduce (new) build or analyzer warnings. - [ ] I ran **all** tests locally using the **UA.slnx** solution against at least .net **framework** and .net **10**, and all passed. - [ ] I fixed **all** failing and flaky tests in the CI pipelines and **all** CodeQL warnings. - [x] I have addressed **all** PR feedback received. Current-head CI and coverage remain pending; the full local `UA.slnx` test matrix is not claimed complete.
89 lines
3.9 KiB
C#
89 lines
3.9 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
|
|
* 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;
|
|
|
|
namespace Opc.Ua.Recycling
|
|
{
|
|
/// <summary>
|
|
/// Explicit sample-only equipment coefficients. These do not advance production and are not physical calibration.
|
|
/// All live selection and residence progress comes from the committed coordinator image.
|
|
/// </summary>
|
|
public sealed record RecyclingNativeProcessOptions
|
|
{
|
|
/// <summary>
|
|
/// Synthetic conditioned-bin and desiccant-bed temperature, degrees Celsius.
|
|
/// </summary>
|
|
public double DryingTemperatureC { get; init; } = 80;
|
|
|
|
/// <summary>
|
|
/// Synthetic powered dry-air supply, cubic metres per hour. Bed publication converts this to litres/second.
|
|
/// </summary>
|
|
public double DryingAirFlowM3Hr { get; init; } = 60;
|
|
|
|
/// <summary>
|
|
/// Synthetic conditioned-air dewpoint, degrees Celsius.
|
|
/// </summary>
|
|
public double DryDewPointC { get; init; } = -40;
|
|
|
|
/// <summary>
|
|
/// Synthetic unconditioned-air dewpoint, degrees Celsius.
|
|
/// </summary>
|
|
public double AmbientDewPointC { get; init; } = 10;
|
|
|
|
/// <summary>
|
|
/// Synthetic selected filter mesh specification, micrometres; not an inferred contamination measurement.
|
|
/// </summary>
|
|
public double FiltrationFinenessMicrometres { get; init; } = 100;
|
|
|
|
/// <summary>
|
|
/// Synthetic pelletizer shaft speed while material is actually executing, revolutions per minute.
|
|
/// This is independent of mass throughput and pellet size.
|
|
/// </summary>
|
|
public double PelletizerSpeedRpm { get; init; } = 300;
|
|
|
|
/// <summary>
|
|
/// Validates finite display coefficients and their declared ranges.
|
|
/// </summary>
|
|
public void Validate()
|
|
{
|
|
if (!double.IsFinite(DryingTemperatureC) || DryingTemperatureC is < 20 or > 200 ||
|
|
!double.IsFinite(DryingAirFlowM3Hr) || DryingAirFlowM3Hr is <= 0 or > 10000 ||
|
|
!double.IsFinite(DryDewPointC) || DryDewPointC is < -100 or > 20 ||
|
|
!double.IsFinite(AmbientDewPointC) || AmbientDewPointC < DryDewPointC || AmbientDewPointC > 50 ||
|
|
!double.IsFinite(FiltrationFinenessMicrometres) ||
|
|
FiltrationFinenessMicrometres is <= 0 or > 10000 ||
|
|
!double.IsFinite(PelletizerSpeedRpm) || PelletizerSpeedRpm is <= 0 or > 10000)
|
|
{
|
|
throw new ArgumentException("Invalid synthetic native-equipment coefficients.");
|
|
}
|
|
}
|
|
}
|
|
}
|