using System.Threading;
|
using System.Threading.Tasks;
|
|
namespace Aging.Infrastructure.Contracts
|
{
|
/// <summary>
|
/// 设备管理接口。
|
/// 提供设备驱动的注册、连接管理和状态查询功能。
|
/// </summary>
|
public interface IDeviceManager
|
{
|
/// <summary>
|
/// 根据设备ID获取设备驱动实例
|
/// </summary>
|
/// <param name="deviceId">设备标识符</param>
|
/// <returns>设备驱动实例，不存在时返回 null</returns>
|
IDeviceDriver? GetDriver(string deviceId);
|
|
/// <summary>
|
/// 获取设备当前状态
|
/// </summary>
|
/// <param name="deviceId">设备标识符</param>
|
/// <returns>设备驱动状态</returns>
|
DeviceDriverStatus GetStatus(string deviceId);
|
|
/// <summary>
|
/// 注册设备驱动
|
/// </summary>
|
/// <param name="deviceId">设备标识符</param>
|
/// <param name="driver">设备驱动实例</param>
|
void RegisterDriver(string deviceId, IDeviceDriver driver);
|
|
/// <summary>
|
/// 注销设备驱动
|
/// </summary>
|
/// <param name="deviceId">设备标识符</param>
|
void UnregisterDriver(string deviceId);
|
|
/// <summary>
|
/// 异步连接设备
|
/// </summary>
|
/// <param name="deviceId">设备标识符</param>
|
/// <param name="ct">取消令牌</param>
|
Task ConnectAsync(string deviceId, CancellationToken ct);
|
|
/// <summary>
|
/// 异步断开设备连接
|
/// </summary>
|
/// <param name="deviceId">设备标识符</param>
|
Task DisconnectAsync(string deviceId);
|
|
/// <summary>
|
/// 获取所有已注册设备的ID列表
|
/// </summary>
|
/// <returns>设备ID只读列表</returns>
|
IReadOnlyList<string> GetRegisteredDevices();
|
|
/// <summary>
|
/// 检查设备是否已注册
|
/// </summary>
|
/// <param name="deviceId">设备标识符</param>
|
/// <returns>设备是否已注册</returns>
|
bool IsDeviceRegistered(string deviceId);
|
}
|
}
|
