using Common.Attributes; using DeviceCommand.Base; using Model.Models; using System; using System.Globalization; using System.Text.RegularExpressions; using System.Threading; using System.Threading.Tasks; namespace DeviceCommand.Devices { /// /// ANEVH 操作模式枚举 /// public enum ANEVH操作模式_枚举 { /// 定值模式 FIXED, /// 序列测试模式 LIST } /// /// ANEVH 系列双向可编程直流电源(一拖三),基于 TCP 通信,使用 SCPI 指令集。 /// 作为高压源载一体机使用:同时具备直流电源输出(SOURce)与电子负载(SINK)能力。 /// [ACPCommand] public class ANEVH80 : Tcp { // SCPI 指令默认使用 \n 作为结束符 private const string ScpiDelimiter = "\n"; /// /// 构造函数,初始化 TCP 连接配置。 /// /// TCP 连接配置(IP、端口等) public ANEVH80(TcpConfig config) : base(config) { } /// /// 从设备返回的 SCPI 响应字符串中提取数值部分并转换为 double。 /// 支持科学计数法(如 2.48E-03),结果保留两位小数。 /// /// 设备返回的原始字符串 /// 提取到的数值(保留两位小数),解析失败时返回 0 private static double ExtractDouble(string raw) { if (string.IsNullOrWhiteSpace(raw)) return 0; // 从响应中提取第一个数值(含正负号、小数点、科学计数法),可自动忽略单位后缀与命令头 var match = Regex.Match(raw, @"[+-]?(?:\d+\.?\d*|\.\d+)(?:[Ee][+-]?\d+)?"); return match.Success && double.TryParse(match.Value, NumberStyles.Float, CultureInfo.InvariantCulture, out double val) ? Math.Round(val, 2) : 0; } #region 1. 系统与公共指令 /// /// 清除错误队列 (*CLS) /// /// 异步取消令牌 public virtual async Task 清除错误队列Async(CancellationToken ct = default) { await SendAsync($"*CLS{ScpiDelimiter}", ct); } /// /// 重设仪器为出厂默认状态 (*RST) /// /// 异步取消令牌 public virtual async Task 复位Async(CancellationToken ct = default) { await SendAsync($"*RST{ScpiDelimiter}", ct); } /// /// 查询仪器识别码 (*IDN?) /// /// 异步取消令牌 /// 设备标识字符串(厂商,型号,序列号,固件版本) public virtual async Task 查询设备信息Async(CancellationToken ct = default) { return await WriteReadAsync($"*IDN?{ScpiDelimiter}", ScpiDelimiter, ct); } /// /// 查询错误信息 (SYST:ERR?) /// /// 异步取消令牌 /// 错误信息字符串 public virtual async Task 查询错误信息Async(CancellationToken ct = default) { return await WriteReadAsync($"SYST:ERR?{ScpiDelimiter}", ScpiDelimiter, ct); } #endregion #region 2. 输出控制 (OUTPut 子系统) /// /// 设置输出开关状态 (OUTP ON / OFF) /// /// true: 开启输出, false: 关闭输出 /// 异步取消令牌 public virtual async Task 设置输出开关Async(bool isOn, CancellationToken ct = default) { string state = isOn ? "ON" : "OFF"; await SendAsync($"OUTP {state}{ScpiDelimiter}", ct); } /// /// 设置操作模式 (OUTP:MODE) /// /// 操作模式枚举 (FIXED: 定值 | LIST: 序列测试) /// 异步取消令牌 public virtual async Task 设置操作模式Async(ANEVH操作模式_枚举 mode, CancellationToken ct = default) { await SendAsync($"OUTP:MODE {mode}{ScpiDelimiter}", ct); } #endregion #region 3. 源模式参数设置 (SOURce 子系统) /// /// 设置源输出电压 (SOUR:VOLT) /// /// 电压值 (单位: V) /// 异步取消令牌 public virtual async Task 设置电压Async(double voltage, CancellationToken ct = default) { string valStr = voltage.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:VOLT {valStr}{ScpiDelimiter}", ct); } /// /// 查询源设定电压 (SOUR:VOLT?) /// /// 异步取消令牌 /// 设定电压值 (单位: V) public virtual async Task 查询设定电压Async(CancellationToken ct = default) { string resp = await WriteReadAsync($"SOUR:VOLT?{ScpiDelimiter}", ScpiDelimiter, ct); return ExtractDouble(resp); } /// /// 设置源正向限流 (SOUR:CURR) /// /// 电流值 (单位: A,正值) /// 异步取消令牌 public virtual async Task 设置电流Async(double current, CancellationToken ct = default) { string valStr = current.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:CURR {valStr}{ScpiDelimiter}", ct); } /// /// 查询源设定电流 (SOUR:CURR?) /// /// 异步取消令牌 /// 设定电流值 (单位: A) public virtual async Task 查询设定电流Async(CancellationToken ct = default) { string resp = await WriteReadAsync($"SOUR:CURR?{ScpiDelimiter}", ScpiDelimiter, ct); return ExtractDouble(resp); } /// /// 设置源正向限功率 (SOUR:POW) /// /// 功率值 (单位: W,正值) /// 异步取消令牌 public virtual async Task 设置功率Async(double power, CancellationToken ct = default) { string valStr = power.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:POW {valStr}{ScpiDelimiter}", ct); } /// /// 查询源设定功率 (SOUR:POW?) /// /// 异步取消令牌 /// 设定功率值 (单位: W) public virtual async Task 查询设定功率Async(CancellationToken ct = default) { string resp = await WriteReadAsync($"SOUR:POW?{ScpiDelimiter}", ScpiDelimiter, ct); return ExtractDouble(resp); } /// /// 设置电压上升斜率 (SOUR:VOLT:SLEW:POS) /// /// 电压上升速率 (单位: V/ms) /// 异步取消令牌 public virtual async Task 设置电压上升斜率Async(double slewRate, CancellationToken ct = default) { string valStr = slewRate.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:VOLT:SLEW:POS {valStr}{ScpiDelimiter}", ct); } /// /// 设置电压下降斜率 (SOUR:VOLT:SLEW:NEG) /// /// 电压下降速率 (单位: V/ms) /// 异步取消令牌 public virtual async Task 设置电压下降斜率Async(double slewRate, CancellationToken ct = default) { string valStr = slewRate.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:VOLT:SLEW:NEG {valStr}{ScpiDelimiter}", ct); } /// /// 设置电流上升斜率 (SOUR:CURR:SLEW:POS) /// /// 电流上升速率 (单位: A/ms) /// 异步取消令牌 public virtual async Task 设置电流上升斜率Async(double slewRate, CancellationToken ct = default) { string valStr = slewRate.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:CURR:SLEW:POS {valStr}{ScpiDelimiter}", ct); } /// /// 设置电流下降斜率 (SOUR:CURR:SLEW:NEG) /// /// 电流下降速率 (单位: A/ms) /// 异步取消令牌 public virtual async Task 设置电流下降斜率Async(double slewRate, CancellationToken ct = default) { string valStr = slewRate.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:CURR:SLEW:NEG {valStr}{ScpiDelimiter}", ct); } /// /// 设置过压保护值 (SOUR:VOLT:PROT) /// /// 过压保护阈值 (单位: V) /// 异步取消令牌 public virtual async Task 设置过压保护Async(double voltage, CancellationToken ct = default) { string valStr = voltage.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:VOLT:PROT {valStr}{ScpiDelimiter}", ct); } /// /// 设置过流保护值 (SOUR:CURR:PROT) /// /// 过流保护阈值 (单位: A) /// 异步取消令牌 public virtual async Task 设置过流保护Async(double current, CancellationToken ct = default) { string valStr = current.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:CURR:PROT {valStr}{ScpiDelimiter}", ct); } /// /// 设置过功率保护值 (SOUR:POW:PROT) /// /// 过功率保护阈值 (单位: W) /// 异步取消令牌 public virtual async Task 设置过功率保护Async(double power, CancellationToken ct = default) { string valStr = power.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SOUR:POW:PROT {valStr}{ScpiDelimiter}", ct); } #endregion #region 4. 负载模式参数设置 (SINK 子系统) /// /// 设置负载吸收电流 (SINK:CURR) /// /// 负载电流值 (单位: A) /// 异步取消令牌 public virtual async Task 设置负载电流Async(double current, CancellationToken ct = default) { string valStr = current.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SINK:CURR {valStr}{ScpiDelimiter}", ct); } /// /// 查询负载设定电流 (SINK:CURR?) /// /// 异步取消令牌 /// 负载电流设定值 (单位: A) public virtual async Task 查询负载电流Async(CancellationToken ct = default) { string resp = await WriteReadAsync($"SINK:CURR?{ScpiDelimiter}", ScpiDelimiter, ct); return ExtractDouble(resp); } /// /// 设置负载吸收功率 (SINK:POW) /// /// 负载功率值 (单位: W) /// 异步取消令牌 public virtual async Task 设置负载功率Async(double power, CancellationToken ct = default) { string valStr = power.ToString("0.###", CultureInfo.InvariantCulture); await SendAsync($"SINK:POWer {valStr}{ScpiDelimiter}", ct); } /// /// 查询负载设定功率 (SINK:POW?) /// /// 异步取消令牌 /// 负载功率设定值 (单位: W) public virtual async Task 查询负载功率Async(CancellationToken ct = default) { string resp = await WriteReadAsync($"SINK:POWer?{ScpiDelimiter}", ScpiDelimiter, ct); return ExtractDouble(resp); } #endregion #region 5. 测量查询 (MEASure 子系统) /// /// 查询测量电压 (MEAS:VOLT?) /// /// 异步取消令牌 /// 实际输出电压 (单位: V,保留两位小数) public virtual async Task 读取电压Async(CancellationToken ct = default) { string resp = await WriteReadAsync($"MEAS:VOLT?{ScpiDelimiter}", ScpiDelimiter, ct); return ExtractDouble(resp); } /// /// 查询测量电流 (MEAS:CURR?) /// /// 异步取消令牌 /// 实际输出电流 (单位: A,保留两位小数,正值为源模式,负值为负载模式) public virtual async Task 读取电流Async(CancellationToken ct = default) { string resp = await WriteReadAsync($"MEAS:CURR?{ScpiDelimiter}", ScpiDelimiter, ct); return ExtractDouble(resp); } /// /// 查询测量功率 (MEAS:POW?) /// /// 异步取消令牌 /// 实际输出功率 (单位: W,保留两位小数) public virtual async Task 读取功率Async(CancellationToken ct = default) { string resp = await WriteReadAsync($"MEAS:POW?{ScpiDelimiter}", ScpiDelimiter, ct); return ExtractDouble(resp); } #endregion } }