namespace Aging.Infrastructure.Contracts
|
{
|
/// <summary>
|
/// 设备驱动状态信息
|
/// </summary>
|
public sealed class DeviceDriverStatus
|
{
|
/// <summary>
|
/// 设备是否已连接
|
/// </summary>
|
public bool IsConnected { get; set; }
|
|
/// <summary>
|
/// 设备是否健康（无故障）
|
/// </summary>
|
public bool IsHealthy { get; set; }
|
|
/// <summary>
|
/// 最后一次错误信息
|
/// </summary>
|
public string LastError { get; set; } = "";
|
|
/// <summary>
|
/// 最后一次错误发生的时间
|
/// </summary>
|
public DateTime? LastErrorTime { get; set; }
|
|
/// <summary>
|
/// 通信延迟（毫秒）
|
/// </summary>
|
public double LatencyMs { get; set; }
|
|
/// <summary>
|
/// 重连次数
|
/// </summary>
|
public int ReconnectCount { get; set; }
|
}
|
|
/// <summary>
|
/// 设备连接状态变化事件参数
|
/// </summary>
|
public sealed class DeviceConnectionEventArgs : EventArgs
|
{
|
/// <summary>
|
/// 设备标识符
|
/// </summary>
|
public string DeviceId { get; set; } = "";
|
|
/// <summary>
|
/// 是否已连接
|
/// </summary>
|
public bool IsConnected { get; set; }
|
|
/// <summary>
|
/// 状态变化原因（可选）
|
/// </summary>
|
public string? Reason { get; set; }
|
}
|
|
/// <summary>
|
/// 设备驱动统一接口。
|
/// 所有硬件设备驱动必须实现此接口，提供连接、断开、命令发送和查询功能。
|
/// </summary>
|
public interface IDeviceDriver : IDisposable
|
{
|
/// <summary>
|
/// 设备唯一标识符
|
/// </summary>
|
string DeviceId { get; }
|
|
/// <summary>
|
/// 设备当前是否已连接
|
/// </summary>
|
bool IsConnected { get; }
|
|
/// <summary>
|
/// 异步连接设备
|
/// </summary>
|
/// <param name="ct">取消令牌</param>
|
Task ConnectAsync(CancellationToken ct);
|
|
/// <summary>
|
/// 异步断开设备连接
|
/// </summary>
|
Task DisconnectAsync();
|
|
/// <summary>
|
/// 发送命令到设备
|
/// </summary>
|
/// <param name="command">命令字符串</param>
|
/// <param name="ct">取消令牌</param>
|
/// <returns>设备响应字符串</returns>
|
Task<string> SendCommandAsync(string command, CancellationToken ct);
|
|
/// <summary>
|
/// 向设备发送查询并获取响应
|
/// </summary>
|
/// <param name="query">查询字符串</param>
|
/// <param name="ct">取消令牌</param>
|
/// <returns>设备查询响应字符串</returns>
|
Task<string> QueryAsync(string query, CancellationToken ct);
|
|
/// <summary>
|
/// 获取设备当前状态信息
|
/// </summary>
|
/// <returns>设备驱动状态</returns>
|
DeviceDriverStatus GetStatus();
|
|
/// <summary>
|
/// 设备连接状态变化事件
|
/// </summary>
|
event EventHandler<DeviceConnectionEventArgs>? ConnectionChanged;
|
}
|
}
|
