826312befe
Clears CommentChecker findings in src/ (3,280 -> 209, the remainder being false positives like PLC-5/IEEE-754/M0.0) by adding missing summaries/params/returns, normalising inheritdoc usage, and removing Gitea/review tracking IDs while keeping the rationale they annotated. Comment-only: comment-stripped sources are identical to the parent commit.
27 lines
1.5 KiB
C#
27 lines
1.5 KiB
C#
namespace ZB.MOM.WW.OtOpcUa.Driver.TwinCAT;
|
|
|
|
/// <summary>
|
|
/// One device's probe-sampled PLC facts, surfaced through the driver's
|
|
/// <see cref="Core.Abstractions.IDriverDiagnostics"/> bag to the <c>/hosts</c> page. Every field is
|
|
/// best-effort: a runtime that does not export a system symbol leaves that field at its last known value
|
|
/// (null if never seen).
|
|
/// </summary>
|
|
/// <param name="AdsState">The ADS device state name (<c>Run</c>, <c>Stop</c>, <c>Config</c>, …).</param>
|
|
/// <param name="AppName">The running PLC application's name (<c>_AppInfo.AppName</c>).</param>
|
|
/// <param name="OnlineChangeCnt">How many online changes the application has taken (<c>_AppInfo.OnlineChangeCnt</c>).</param>
|
|
/// <param name="CycleTimeMs">The first PLC task's configured cycle time in milliseconds.</param>
|
|
/// <param name="LastExecTimeMs">How long the task's last cycle took to execute, in milliseconds.</param>
|
|
/// <param name="UpdatedUtc">When the snapshot was taken.</param>
|
|
internal sealed record TwinCATDeviceDiagnostics(
|
|
string? AdsState,
|
|
string? AppName,
|
|
uint? OnlineChangeCnt,
|
|
double? CycleTimeMs,
|
|
double? LastExecTimeMs,
|
|
DateTime UpdatedUtc)
|
|
{
|
|
/// <summary>Gets cycle time minus last execution time: how much of the cycle was spare. Negative means the
|
|
/// task overran its cycle. (Not jitter — that needs the variation across cycles.)</summary>
|
|
public double? HeadroomMs => CycleTimeMs is { } c && LastExecTimeMs is { } x ? c - x : null;
|
|
}
|