SSPC-Tester/SSPCTester.Devices/Interfaces/IPowerSupply.cs

namespace SSPCTester.Devices.Interfaces;

/// <summary>
/// 程控电源（UDP5080-100）抽象接口。
/// </summary>
public interface IPowerSupply : IDeviceConnection
{
    /// <summary>设定输出电压（V）。</summary>
    Task SetVoltageAsync(double volts, CancellationToken ct = default);

    /// <summary>设定输出电流上限（A）。</summary>
    Task SetCurrentLimitAsync(double amps, CancellationToken ct = default);

    /// <summary>开启 / 关闭输出。</summary>
    Task OutputAsync(bool on, CancellationToken ct = default);

    /// <summary>从设备查询当前输出开关状态。</summary>
    Task<bool> GetOutputStateAsync(CancellationToken ct = default);

    /// <summary>读取当前实际电压、电流。</summary>
    Task<(double volts, double amps)> ReadAsync(CancellationToken ct = default);

    /// <summary>Query instrument identity for connection diagnostics.</summary>
    Task<string> QueryIdentityAsync(CancellationToken ct = default);

    /// <summary>Query instrument error queue/status text.</summary>
    Task<string> QueryErrorAsync(CancellationToken ct = default);
}