67 lines
2.9 KiB
C#
67 lines
2.9 KiB
C#
using CliFx.Attributes;
|
|
using CliFx.Infrastructure;
|
|
using ZB.MOM.WW.OtOpcUa.Driver.Cli.Common;
|
|
|
|
namespace ZB.MOM.WW.OtOpcUa.Driver.AbLegacy.Cli.Commands;
|
|
|
|
/// <summary>
|
|
/// Probes an AB Legacy (PCCC) endpoint: reads one N-file word + reports driver health.
|
|
/// Default probe address <c>N7:0</c> matches the integration-fixture seed so operators
|
|
/// can point the CLI at the ab_server Docker container + real hardware interchangeably.
|
|
/// </summary>
|
|
[Command("probe", Description = "Verify the AB Legacy endpoint is reachable and a sample PCCC read succeeds.")]
|
|
public sealed class ProbeCommand : AbLegacyCommandBase
|
|
{
|
|
[CommandOption("address", 'a', Description =
|
|
"PCCC address to probe (default N7:0). Use S:0 for the status file when you want " +
|
|
"the pre-populated register every SLC / MicroLogix / PLC-5 ships with.")]
|
|
public string Address { get; init; } = "N7:0";
|
|
|
|
[CommandOption("type", Description =
|
|
"PCCC data type of the probe address (default Int — matches N files).")]
|
|
public AbLegacyDataType DataType { get; init; } = AbLegacyDataType.Int;
|
|
|
|
public override async ValueTask ExecuteAsync(IConsole console)
|
|
{
|
|
ConfigureLogging();
|
|
var ct = console.RegisterCancellationHandler();
|
|
|
|
var probeTag = new AbLegacyTagDefinition(
|
|
Name: "__probe",
|
|
DeviceHostAddress: Gateway,
|
|
Address: Address,
|
|
DataType: DataType,
|
|
Writable: false);
|
|
var options = BuildOptions([probeTag]);
|
|
|
|
await using var driver = new AbLegacyDriver(options, DriverInstanceId);
|
|
try
|
|
{
|
|
await driver.InitializeAsync("{}", ct);
|
|
var snapshot = await driver.ReadAsync(["__probe"], ct);
|
|
var health = driver.GetHealth();
|
|
// PR ablegacy-12 / #255 — surface Demoted alongside the probe-driven
|
|
// HostState. After a one-shot probe the host hasn't been observed
|
|
// (no probe loop runs in CLI mode), so HostState is typically Unknown
|
|
// unless the read above tripped the demote threshold.
|
|
var hostStatus = driver.GetHostStatuses().FirstOrDefault();
|
|
|
|
await console.Output.WriteLineAsync($"Gateway: {Gateway}");
|
|
await console.Output.WriteLineAsync($"PLC type: {PlcType}");
|
|
await console.Output.WriteLineAsync($"Health: {health.State}");
|
|
if (hostStatus is not null)
|
|
{
|
|
await console.Output.WriteLineAsync($"Host state: {hostStatus.State}");
|
|
}
|
|
if (health.LastError is { } err)
|
|
await console.Output.WriteLineAsync($"Last error: {err}");
|
|
await console.Output.WriteLineAsync();
|
|
await console.Output.WriteLineAsync(SnapshotFormatter.Format(Address, snapshot[0]));
|
|
}
|
|
finally
|
|
{
|
|
await driver.ShutdownAsync(CancellationToken.None);
|
|
}
|
|
}
|
|
}
|