当前位置：首页 > 文章列表 > 文章 > 软件教程 > 接口文档汇总 - 2.设备状态管理

接口文档汇总 - 2.设备状态管理

2026-08-20 21:52:40 0浏览收藏

C# WPF 设备状态管理标准化接口设计文档

1. 引言

这里为WPF应用程序定义了一套标准化的设备状态管理接口。这套设计方案能以统一的方式，对相机、PLC、工控机、磁盘空间等多种设备的连接状态和健康状态进行监控与管理。借助标准化接口，开发人员能轻松集成不同设备，实现状态变化通知、统一查询以及扩展功能。

接口文档汇总 - 2.设备状态管理

2. 设备状态枚举

定义设备可能的状态，用于统一表示各监控项的状态。

/// 
/// 表示设备的运行状态。
/// 
public enum DeviceStatus
{
    /// 未知状态，通常表示尚未开始监控或无法确定。
    Unknown,

    /// 设备正在连接中（例如正在建立连接）。
    Connecting,

    /// 设备已成功连接且工作正常。
    Connected,

    /// 设备处于断开状态（正常断开）。
    Disconnected,

    /// 设备发生错误或异常，无法正常工作。
    Error,

    /// 设备处于警告状态（例如磁盘空间不足）。
    Warning
}

3. 核心监控接口 `IDeviceMonitor`

/// 
/// 定义设备监控器的通用接口。
/// 
public interface IDeviceMonitor : IDisposable
{
    /// 
    /// 获取设备的唯一标识符（如名称或ID）。
    /// 
    string DeviceId { get; }

    /// 
    /// 获取设备的显示名称。
    /// 
    string DeviceName { get; }

    /// 
    /// 获取当前设备状态。
    /// 
    DeviceStatus Status { get; }

    /// 
    /// 获取上次状态更新的时间。
    /// 
    DateTime LastUpdateTime { get; }

    /// 
    /// 获取附加的状态消息（例如错误信息或警告详情）。
    /// 
    string StatusMessage { get; }

    /// 
    /// 当设备状态发生变化时触发。
    /// 
    event EventHandler StatusChanged;

    /// 
    /// 启动监控（例如开始轮询或监听）。
    /// 
    void Start();

    /// 
    /// 停止监控。
    /// 
    void Stop();

    /// 
    /// 手动刷新状态（立即执行一次状态检查）。
    /// 
    void Refresh();
}

4. 状态变化事件参数

用于传递状态变化信息。

/// 
/// 提供设备状态变化的事件数据。
/// 
public class DeviceStatusChangedEventArgs : EventArgs
{
    /// 
    /// 初始化事件参数。
    /// 
    public DeviceStatusChangedEventArgs(string deviceId, DeviceStatus oldStatus, DeviceStatus newStatus, string message)
    {
        DeviceId = deviceId;
        OldStatus = oldStatus;
        NewStatus = newStatus;
        Message = message;
    }

    /// 设备标识符。
    public string DeviceId { get; }

    /// 变化前的状态。
    public DeviceStatus OldStatus { get; }

    /// 变化后的状态。
    public DeviceStatus NewStatus { get; }

    /// 附加消息。
    public string Message { get; }
}

5. 具体设备监控接口

根据设备类型扩展专用接口，可添加特定属性和方法。

5.1 相机监控接口 `ICameraMonitor`

/// 
/// 相机设备监控接口。
/// 
public interface ICameraMonitor : IDeviceMonitor
{
    /// 
    /// 获取相机分辨率（宽度）。
    /// 
    int Width { get; }

    /// 
    /// 获取相机分辨率（高度）。
    /// 
    int Height { get; }

    /// 
    /// 获取当前帧率（如果支持）。
    /// 
    double FrameRate { get; }

    /// 
    /// 尝试触发一次拍照并返回图像数据（演示功能，实际可扩展）。
    /// 
    Taskbyte[]> CaptureImageAsync();
}

5.2 PLC监控接口 `IPlcMonitor`

/// 
/// PLC设备监控接口。
/// 
public interface IPlcMonitor : IDeviceMonitor
{
    /// 
    /// 获取PLC型号。
    /// 
    string Model { get; }

    /// 
    /// 获取当前CPU负载（如果支持）。
    /// 
    double CpuLoad { get; }

    /// 
    /// 读取指定地址的值（泛型示例）。
    /// 
    TaskT> ReadAsyncT>(string address);

    /// 
    /// 写入指定地址的值。
    /// 
    Task WriteAsyncT>(string address, T value);
}

5.3 工控机监控接口 `IIpcMonitor`

/// 
/// 工控机（IPC）监控接口，通常监控系统资源。
/// 
public interface IIpcMonitor : IDeviceMonitor
{
    /// 
    /// 获取CPU使用率（百分比）。
    /// 
    double CpuUsage { get; }

    /// 
    /// 获取内存使用率（百分比）。
    /// 
    double MemoryUsage { get; }

    /// 
    /// 获取总内存大小（字节）。
    /// 
    long TotalMemory { get; }

    /// 
    /// 获取可用内存大小（字节）。
    /// 
    long A vailableMemory { get; }

    /// 
    /// 获取系统运行时间。
    /// 
    TimeSpan UpTime { get; }
}

5.4 磁盘空间监控接口 `IDiskMonitor`

/// 
/// 磁盘空间监控接口。
/// 
public interface IDiskMonitor : IDeviceMonitor
{
    /// 
    /// 获取驱动器名称（如 "C:"）。
    /// 
    string DriveName { get; }

    /// 
    /// 获取总容量（字节）。
    /// 
    long TotalSize { get; }

    /// 
    /// 获取可用空间（字节）。
    /// 
    long A vailableFreeSpace { get; }

    /// 
    /// 获取已用空间百分比。
    /// 
    double UsedPercentage { get; }

    /// 
    /// 获取或设置磁盘空间警告阈值（百分比）。
    /// 
    double WarningThreshold { get; set; }
}

6. 设备状态管理器接口 `IDeviceStatusManager`

负责管理所有设备监控器，提供统一的状态聚合和事件转发。

/// 
/// 设备状态管理器，用于集中管理多个设备监控器。
/// 
public interface IDeviceStatusManager : IDisposable
{
    /// 
    /// 获取所有已注册的设备监控器。
    /// 
    IReadOnlyList Devices { get; }

    /// 
    /// 根据设备ID获取监控器。
    /// 
    IDeviceMonitor GetDevice(string deviceId);

    /// 
    /// 根据类型获取特定类型的监控器集合。
    /// 
    IEnumerableT> GetDevicesT>() where T : IDeviceMonitor;

    /// 
    /// 注册一个设备监控器。
    /// 
    void RegisterMonitor(IDeviceMonitor monitor);

    /// 
    /// 注销设备监控器。
    /// 
    void UnregisterMonitor(string deviceId);

    /// 
    /// 启动所有已注册的监控器。
    /// 
    void StartAll();

    /// 
    /// 停止所有已注册的监控器。
    /// 
    void StopAll();

    /// 
    /// 刷新所有监控器状态。
    /// 
    void RefreshAll();

    /// 
    /// 当任意设备状态发生变化时触发（聚合事件）。
    /// 
    event EventHandler DeviceStatusChanged;
}

7. 默认实现示例（非接口部分，仅演示用法）

以下展示如何在WPF应用程序中使用上述接口。假设已有实现类（如 CameraMonitor、PlcMonitor 等）实现了对应接口。

7.1 在App.xaml.cs中初始化管理器

public partial class App : Application
{
    public static IDeviceStatusManager DeviceManager { get; private set; }

    protected override void OnStartup(StartupEventArgs e)
    {
        base.OnStartup(e);
        DeviceManager = new DeviceStatusManager(); // 假设有一个默认实现

        // 创建并注册具体监控器
        var cameraMonitor = new CameraMonitor("Camera1", "Basler acA1300");
        var plcMonitor = new PlcMonitor("PLC1", "Siemens S7-1200", "192.168.1.100");
        var ipcMonitor = new IpcMonitor("IPC1", "Main IPC");
        var diskMonitor = new DiskMonitor("DiskC", "C:\");

        DeviceManager.RegisterMonitor(cameraMonitor);
        DeviceManager.RegisterMonitor(plcMonitor);
        DeviceManager.RegisterMonitor(ipcMonitor);
        DeviceManager.RegisterMonitor(diskMonitor);

        // 启动所有监控
        DeviceManager.StartAll();

        // 订阅全局状态变化事件（可用于UI更新）
        DeviceManager.DeviceStatusChanged += (s, args) =>
        {
            // 可在UI线程上更新状态显示
            Debug.WriteLine($"设备 {args.DeviceId} 状态从 {args.OldStatus} 变为 {args.NewStatus}: {args.Message}");
        };
    }

    protected override void OnExit(ExitEventArgs e)
    {
        DeviceManager?.Dispose();
        base.OnExit(e);
    }
}

7.2 在ViewModel中绑定设备状态

public class MainViewModel : INotifyPropertyChanged
{
    private readonly IDeviceStatusManager _deviceManager;

    public MainViewModel()
    {
        _deviceManager = App.DeviceManager;
        // 可订阅单个设备变化或通过全局事件更新
        _deviceManager.DeviceStatusChanged += OnDeviceStatusChanged;
        LoadDevices();
    }

    private void OnDeviceStatusChanged(object sender, DeviceStatusChangedEventArgs e)
    {
        // 更新UI绑定属性
        var device = Devices.FirstOrDefault(d => d.DeviceId == e.DeviceId);
        if (device != null)
        {
            // 假设Devices集合中的项包装了IDeviceMonitor并实现了INotifyPropertyChanged
            // 这里触发属性变化通知
        }
    }

    public ObservableCollection Devices { get; } = new();

    private void LoadDevices()
    {
        foreach (var device in _deviceManager.Devices)
        {
            Devices.Add(new DeviceViewModel(device));
        }
    }

    // 其他代码...
}

public class DeviceViewModel : INotifyPropertyChanged
{
    private readonly IDeviceMonitor _monitor;

    public DeviceViewModel(IDeviceMonitor monitor)
    {
        _monitor = monitor;
        _monitor.StatusChanged += (s, e) =>
        {
            OnPropertyChanged(nameof(Status));
            OnPropertyChanged(nameof(StatusMessage));
        };
    }

    public string DeviceName => _monitor.DeviceName;
    public DeviceStatus Status => _monitor.Status;
    public string StatusMessage => _monitor.StatusMessage;
    public DateTime LastUpdate => _monitor.LastUpdateTime;

    // 实现INotifyPropertyChanged...
}

7.3 XAML绑定示例

ListBox ItemsSource="{Binding Devices}">
    ListBox.ItemTemplate>
        DataTemplate>
            StackPanel Orientation="Horizontal" Margin="5">
                TextBlock Text="{Binding DeviceName}" Width="120"/>
                TextBlock Text="{Binding Status}" Width="80" Foreground="{Binding Status, Converter={StaticResource StatusToColorConverter}}"/>
                TextBlock Text="{Binding StatusMessage}" Margin="5,0"/>
            StackPanel>
        DataTemplate>
    ListBox.ItemTemplate>
ListBox>

8. 总结

本文档定义了一套标准化的设备状态管理接口，能满足相机、PLC、工控机和磁盘空间的监控需求。此设计借助通用接口IDeviceMonitor以及具体类型接口，达成了与设备无关的状态查询和事件通知功能，还通过IDeviceStatusManager来统一管理多个设备。在WPF应用程序中，将这些接口与MVVM模式相结合轻而易举，从而实现响应式的设备状态UI。

其他