mirror of
https://github.com/OPCFoundation/UA-.NETStandard.git
synced 2026-10-18 14:43:08 +08:00
15d0ce7bd5
# Description Implement OPC UA Part 10 Programs across `Opc.Ua.Core`/`Core.Types`, `Opc.Ua.Server`, and `Opc.Ua.Client`, reusing the existing state-machine, source-generation, node-management, auditing, and streaming-subscription infrastructure. - Add asynchronous provider-backed execution, standard controls, internal/autonomous transitions, generation checks, and nested-state activation/resumption. - Add checked creation/adoption, vendor Create adapters, deletion, recycling and instance limits, auto-delete, DI, and direct-construction paths. - Maintain ProgramDiagnostic2 and retained final results; publish captured intermediate results and concrete transition/audit events with access controls. - Add generated SDK models/proxies, typed client discovery and reads, event streams, and subscribe-before-call readiness handling. - Add unit, connected client/server, generated Annex A-style model, and NativeAOT coverage. Document usage and migration in `docs/Programs.md` and related guides. ### Compatibility and design decisions The linked Part 10 document is v1.05.00; namespace-zero definitions remain aligned with 1.05.07. Documentation distinguishes normative requirements from conflicting specification text and SDK conventions. - Correct state numbers to Halted=11, Ready=12, Running=13, Suspended=14. Generated subtypes retain inherited namespace-zero state/transition identifiers. - Managed Reset is Halted-to-Ready only. Preserve the existing low-level Reset-from-Suspended behavior for compatibility. - Preserve UInt32 limit types; use `UInt32.MaxValue` as a documented SDK unlimited convention. RecycleCount overflow reports BadOutOfRange without stopping unlimited execution. - In-memory default with injectable providers. Durable recovery, distributed execution/failover, and a production Annex A download engine are excluded. ## 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. - [ ] I have addressed **all** PR feedback received. Tests and focused coverage evidence are above; the combined tests/coverage checkbox remains open because a whole-repository coverage increase has not been established. CLA status, CI/CodeQL results, tracking-issue approval, and PR feedback are not asserted.
91 lines
3.7 KiB
C#
91 lines
3.7 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.Threading;
|
|
using Opc.Ua.Server.StateMachines;
|
|
|
|
namespace Opc.Ua.TestModels.DomainDownload
|
|
{
|
|
public partial class DomainDownloadState
|
|
{
|
|
/// <inheritdoc/>
|
|
protected override void OnAfterCreate(ISystemContext context, NodeState node, CancellationToken ct = default)
|
|
{
|
|
base.OnAfterCreate(context, node, ct);
|
|
StateMachineBuilder.For(this, context).BindSubStateMachine(
|
|
global::Opc.Ua.Objects.ProgramStateMachineType_Running,
|
|
StateMachineBuilder.For(TransferStateMachine!, context),
|
|
Objects.TransferStateMachineType_Opening,
|
|
preserveOnReentry: true);
|
|
}
|
|
}
|
|
|
|
public partial class TransferStateMachineState
|
|
{
|
|
/// <inheritdoc/>
|
|
protected override ElementInfo[] StateTable => s_states;
|
|
|
|
/// <inheritdoc/>
|
|
protected override ElementInfo[] TransitionTable => s_transitions;
|
|
|
|
/// <inheritdoc/>
|
|
protected override uint[,] TransitionMappings => s_mappings;
|
|
|
|
private static readonly ElementInfo[] s_states =
|
|
[
|
|
new(Objects.TransferStateMachineType_Opening, "Opening", 1),
|
|
new(Objects.TransferStateMachineType_Sending, "Sending", 2),
|
|
new(Objects.TransferStateMachineType_Closing, "Closing", 3)
|
|
];
|
|
|
|
private static readonly ElementInfo[] s_transitions =
|
|
[
|
|
new(Objects.TransferStateMachineType_OpeningToSending, "OpeningToSending", 10),
|
|
new(Objects.TransferStateMachineType_SendingToSending, "SendingToSending", 11),
|
|
new(Objects.TransferStateMachineType_SendingToClosing, "SendingToClosing", 12)
|
|
];
|
|
|
|
private static readonly uint[,] s_mappings =
|
|
{
|
|
{
|
|
Objects.TransferStateMachineType_OpeningToSending, Objects.TransferStateMachineType_Opening,
|
|
Objects.TransferStateMachineType_Sending, 1
|
|
},
|
|
{
|
|
Objects.TransferStateMachineType_SendingToSending, Objects.TransferStateMachineType_Sending,
|
|
Objects.TransferStateMachineType_Sending, 1
|
|
},
|
|
{
|
|
Objects.TransferStateMachineType_SendingToClosing, Objects.TransferStateMachineType_Sending,
|
|
Objects.TransferStateMachineType_Closing, 1
|
|
}
|
|
};
|
|
}
|
|
}
|