Merge branch 'master' of https://git.kaiyili-lab.com/huangsucan/ACP
This commit is contained in:
“hsc”
240
DeviceCommand/Devices/DG1000Z.cs
Normal file
240
DeviceCommand/Devices/DG1000Z.cs
Normal file
@@ -0,0 +1,240 @@
|
||||
using Common.Attributes;
|
||||
using DeviceCommand.Base;
|
||||
using Model.Models;
|
||||
using System;
|
||||
using System.Globalization;
|
||||
using System.Threading;
|
||||
using System.Threading.Tasks;
|
||||
|
||||
namespace DeviceCommand.Devices
|
||||
{
|
||||
#region 枚举定义
|
||||
|
||||
/// <summary>
|
||||
/// 信号发生器输出波形类型
|
||||
/// </summary>
|
||||
public enum SignalWaveform
|
||||
{
|
||||
/// <summary> 正弦波 </summary>
|
||||
SINusoid,
|
||||
/// <summary> 方波 </summary>
|
||||
SQUare,
|
||||
/// <summary> 锯齿波 </summary>
|
||||
RAMP,
|
||||
/// <summary> 脉冲波 (重点用于CP信号模拟) </summary>
|
||||
PULSe,
|
||||
/// <summary> 噪声 </summary>
|
||||
NOISe,
|
||||
/// <summary> 任意波 (USER) </summary>
|
||||
USER
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 频率计输入信号的耦合方式
|
||||
/// </summary>
|
||||
public enum CounterCoupling
|
||||
{
|
||||
/// <summary> 交流耦合 </summary>
|
||||
AC,
|
||||
/// <summary> 直流耦合 </summary>
|
||||
DC
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
[ACPCommand]
|
||||
public class DG1000Z : Tcp
|
||||
{
|
||||
// 使用换行符 \n (ASCII 0x0A) 作为 SCPI 结束符
|
||||
private const string ScpiDelimiter = "\n";
|
||||
|
||||
public DG1000Z(TcpConfig config) : base(config)
|
||||
{
|
||||
}
|
||||
|
||||
#region 1. IEEE 488.2 公共命令
|
||||
|
||||
public virtual async Task 清除状态寄存器(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"*CLS{ScpiDelimiter}", ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询设备标识(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"*IDN?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
public virtual async Task 重置设备(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"*RST{ScpiDelimiter}", ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询系统SCPI版本(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":SYSTem:VERSion?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 2. 通道输出控制 (CH1 / CH2)
|
||||
|
||||
/// <summary>
|
||||
/// 打开或关闭指定通道的输出
|
||||
/// </summary>
|
||||
/// <param name="通道号">通道 1 或 2，默认 1</param>
|
||||
/// <param name="开启">true为开启，false为关闭</param>
|
||||
public virtual async Task 设置通道输出状态(int 通道号 = 1, bool 开启 = true, CancellationToken ct = default)
|
||||
{
|
||||
string 参数 = 开启 ? "ON" : "OFF";
|
||||
await SendAsync($":OUTPut{通道号}:STATe {参数}{ScpiDelimiter}", ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询通道输出状态(int 通道号 = 1, CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":OUTPut{通道号}:STATe?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 3. 波形、频率与幅度设置 (基础输出)
|
||||
|
||||
/// <summary>
|
||||
/// 设置指定通道的波形类型 (如正弦波、方波等)
|
||||
/// </summary>
|
||||
public virtual async Task 设置波形类型(int 通道号 = 1, SignalWaveform 波形 = SignalWaveform.SINusoid, CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($":SOURce{通道号}:FUNCtion:SHAPe {波形}{ScpiDelimiter}", ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置指定通道的输出频率 (单位: Hz)
|
||||
/// </summary>
|
||||
public virtual async Task 设置频率(int 通道号 = 1, double 频率Hz = 1000, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce{0}:FREQuency {1:F2}{2}", 通道号, 频率Hz, ScpiDelimiter);
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询频率(int 通道号 = 1, CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":SOURce{通道号}:FREQuency?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置指定通道的输出幅度 (单位: Vpp，峰峰值)
|
||||
/// </summary>
|
||||
public virtual async Task 设置幅度(int 通道号 = 1, double 幅度Vpp = 5, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce{0}:VOLTage:AMPLitude {1:F2}{2}", 通道号, 幅度Vpp, ScpiDelimiter);
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询幅度(int 通道号 = 1, CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":SOURce{通道号}:VOLTage:AMPLitude?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置指定通道的直流偏移电压 (单位: Vdc)
|
||||
/// </summary>
|
||||
public virtual async Task 设置偏移电压(int 通道号 = 1, double 偏移Vdc = 0, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce{0}:VOLTage:OFFSet {1:F2}{2}", 通道号, 偏移Vdc, ScpiDelimiter);
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询偏移电压(int 通道号 = 1, CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":SOURce{通道号}:VOLTage:OFFSet?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 4. 方波 / 脉冲波占空比设置 (重点用于CP信号模拟)
|
||||
|
||||
/// <summary>
|
||||
/// 设置方波信号的占空比 (0.01% ~ 99.99%)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 设置方波占空比(int 通道号 = 1, double 占空比 = 50.0, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce{0}:FUNCtion:SQUare:DCYCle {1:F2}{2}", 通道号, 占空比, ScpiDelimiter);
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置脉冲波信号的占空比 (0.01% ~ 99.99%)[cite: 1]
|
||||
/// 注意：使用此命令前必须先设置为 PULSe 波形类型
|
||||
/// </summary>
|
||||
public virtual async Task 设置脉冲波占空比(int 通道号 = 1, double 占空比 = 50.0, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce{0}:FUNCtion:PULSe:DCYCle {1:F2}{2}", 通道号, 占空比, ScpiDelimiter);
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 5. 频率计测量功能 (高频数据轮询核心)
|
||||
|
||||
/// <summary>
|
||||
/// 打开或关闭内置频率计功能
|
||||
/// </summary>
|
||||
public virtual async Task 设置频率计开关(bool 开启 = true, CancellationToken ct = default)
|
||||
{
|
||||
string 参数 = 开启 ? "ON" : "OFF";
|
||||
await SendAsync($":COUNter:STATe {参数}{ScpiDelimiter}", ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询频率计开关状态(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":COUNter:STATe?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置频率计输入信号的耦合方式
|
||||
/// </summary>
|
||||
public virtual async Task 设置频率计耦合方式(CounterCoupling 耦合 = CounterCoupling.AC, CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($":COUNter:COUPling {耦合}{ScpiDelimiter}", ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置频率计的触发电平 (单位: V)
|
||||
/// </summary>
|
||||
public virtual async Task 设置频率计触发电平(double 电平V = 0.1, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":COUNter:LEVel {0:F2}{1}", 电平V, ScpiDelimiter);
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
[Monitorable("信号发生器频率计测量值")]
|
||||
public virtual async Task<string> 查询频率计测量值(CancellationToken ct = default)
|
||||
{
|
||||
// 返回格式: 频率, 周期, 占空比, 正脉宽, 负脉宽
|
||||
return await WriteReadAsync($":COUNter:MEASure?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 6. 系统维护与远程控制扩展命令
|
||||
|
||||
public virtual async Task 切换远程控制模式(CancellationToken ct = default)
|
||||
{
|
||||
// 信号发生器通常通过 LAN/USB 和 VISA 通信即自动进入远程控制，
|
||||
// 但为了兼容模板，保留一个类似的方法。
|
||||
await Task.CompletedTask;
|
||||
}
|
||||
|
||||
public virtual async Task 切换本地控制模式(CancellationToken ct = default)
|
||||
{
|
||||
// 通常通过前面板按键退出远程。不过可提供 SCPI 关闭屏幕保护等。
|
||||
await Task.CompletedTask;
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询错误信息(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":SYSTem:ERRor?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
331
DeviceCommand/Devices/IT6000C.cs
Normal file
331
DeviceCommand/Devices/IT6000C.cs
Normal file
@@ -0,0 +1,331 @@
|
||||
using Common.Attributes;
|
||||
using DeviceCommand.Base;
|
||||
using Model.Models;
|
||||
using System;
|
||||
using System.Globalization;
|
||||
using System.Threading;
|
||||
using System.Threading.Tasks;
|
||||
|
||||
namespace DeviceCommand.Devices
|
||||
{
|
||||
#region 枚举定义
|
||||
|
||||
/// <summary>
|
||||
/// IT6000C 优先工作模式 (CV优先 / CC优先)
|
||||
/// </summary>
|
||||
public enum IT6000CPriorityMode
|
||||
{
|
||||
/// <summary> 恒压优先模式 (CV优先) </summary>
|
||||
VOLTage,
|
||||
/// <summary> 恒流优先模式 (CC优先) </summary>
|
||||
CURRent
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// IT6000C 瞬变功能模式
|
||||
/// </summary>
|
||||
public enum IT6000CFunctionMode
|
||||
{
|
||||
/// <summary> 固定模式 (普通输出) </summary>
|
||||
FIXed,
|
||||
/// <summary> List 列表模式 </summary>
|
||||
LIST,
|
||||
/// <summary> 电池测试模式 </summary>
|
||||
BATTer,
|
||||
/// <summary> 光伏/太阳能板曲线模拟模式 </summary>
|
||||
SOLar,
|
||||
/// <summary> 汽车波形模拟模式 </summary>
|
||||
CARProfile
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
[ACPCommand]
|
||||
public class IT6000C : Tcp
|
||||
{
|
||||
// SCPI 指令结束符
|
||||
private const string ScpiDelimiter = "\n";
|
||||
|
||||
public IT6000C(TcpConfig config) : base(config)
|
||||
{
|
||||
}
|
||||
|
||||
#region 1. IEEE 488.2 公共命令
|
||||
|
||||
public virtual async Task 清除状态寄存器(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"*CLS{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询设备标识(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"*IDN?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 重置设备(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"*RST{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询状态字节(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"*STB?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询SCPI版本号(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":SYSTem:VERSion?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 2. 系统远程与状态控制
|
||||
|
||||
public virtual async Task 切换远程控制模式(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"SYSTem:REMote{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 切换本地控制模式(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"SYSTem:LOCal{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 锁定远程键盘(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"SYSTem:RWLock{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询错误信息(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"SYSTem:ERRor?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 清除错误队列(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"SYSTem:CLEar{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 3. 功能模式与优先级设置
|
||||
|
||||
/// <summary>
|
||||
/// 设置电源优先工作模式 (CV 电压优先 或 CC 电流优先)
|
||||
/// </summary>
|
||||
public virtual async Task 设置优先模式(IT6000CPriorityMode 模式, CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"FUNCTION {模式}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询优先模式(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"FUNCTION?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置瞬变/功能模式 (固定, LIST, 电池测试, PV曲线, 汽车波形)
|
||||
/// </summary>
|
||||
public virtual async Task 设置功能模式(IT6000CFunctionMode 模式, CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"FUNCTION:MODE {模式}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询功能模式(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"FUNCTION:MODE?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 4. 输出开关与保护清除
|
||||
|
||||
public virtual async Task 设置输出开关(bool 开启, CancellationToken ct = default)
|
||||
{
|
||||
string 参数 = 开启 ? "ON" : "OFF";
|
||||
await SendAsync($"OUTPut {参数}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询输出开关状态(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"OUTPut:STATe?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 清除保护告警(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"OUTPut:PROTection:CLEar{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 5. 输出电压 / 电流设定
|
||||
|
||||
/// <summary>
|
||||
/// 设置输出电压 (仅在 CV 模式下生效)
|
||||
/// </summary>
|
||||
public virtual async Task 设置电压(double 电压, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, "VOLTage {0:F2}{1}", 电压, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询电压设定值(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"VOLTage?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置输出电流 (仅在 CC 模式下生效)
|
||||
/// </summary>
|
||||
public virtual async Task 设置电流(double 电流, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, "CURRent {0:F3}{1}", 电流, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询电流设定值(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"CURRent?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置 CV 优先模式下的电流限制上限值 (I+, 限流保护)
|
||||
/// </summary>
|
||||
public virtual async Task 设置电流限制上限(double 电流, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, "CURRent:LIMit:POSitive {0:F3}{1}", 电流, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询电流限制上限(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"CURRent:LIMit:POSitive?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置电压上升/下降斜率 (单位: V/s, 数值越大变化越快)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 设置电压斜率(double 斜率Vs, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, "VOLTage:SLEW {0:F4}{1}", 斜率Vs, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 6. 保护功能配置 (OVP, OCP, OPP)
|
||||
|
||||
/// <summary>
|
||||
/// 开启或关闭过压保护 (OVP)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 设置过压保护开关(bool 开启, CancellationToken ct = default)
|
||||
{
|
||||
string 参数 = 开启 ? "ON" : "OFF";
|
||||
await SendAsync($"VOLTage:PROTection:STATe {参数}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 设置过压保护阈值(double 电压, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, "VOLTage:PROTection {0:F2}{1}", 电压, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 开启或关闭过流保护 (OCP)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 设置过流保护开关(bool 开启, CancellationToken ct = default)
|
||||
{
|
||||
string 参数 = 开启 ? "ON" : "OFF";
|
||||
await SendAsync($"CURRent:PROTection:STATe {参数}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 设置过流保护阈值(double 电流, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, "CURRent:PROTection {0:F3}{1}", 电流, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 开启或关闭过功率保护 (OPP)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 设置过功率保护开关(bool 开启, CancellationToken ct = default)
|
||||
{
|
||||
string 参数 = 开启 ? "ON" : "OFF";
|
||||
await SendAsync($"POWER:PROTection:STATe {参数}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 设置过功率保护阈值(double 功率, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, "POWER:PROTection {0:F2}{1}", 功率, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 7. 测量回读 (MEASure 与 FETCh)
|
||||
|
||||
[Monitorable("直流源载实际电压")]
|
||||
public virtual async Task<string> 查询实际电压(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"MEASure:VOLTage?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
[Monitorable("直流源载实际电流")]
|
||||
public virtual async Task<string> 查询实际电流(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"MEASure:CURRent?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
[Monitorable("直流源载实际功率")]
|
||||
public virtual async Task<string> 查询实际功率(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"MEASure:POWER?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询瞬时电压最大值(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"FETCh:VOLTage:MAXimum?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询瞬时电流最小值(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"FETCh:CURRent:MINimum?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 8. 负载电阻/CR模式设置 (仅限 CC 优先模式)
|
||||
|
||||
/// <summary>
|
||||
/// 开启或关闭恒阻 (CR) 负载模式[cite: 1]
|
||||
/// </summary>
|
||||
/// <remarks>执行该指令前，必须确保设备处于 CC 优先模式，否则会报错</remarks>
|
||||
public virtual async Task 设置CR模式开关(bool 开启, CancellationToken ct = default)
|
||||
{
|
||||
string 参数 = 开启 ? "ON" : "OFF";
|
||||
await SendAsync($"SINK:RESistance:STATe {参数}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询CR模式开关(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"SINK:RESistance:STATe?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置恒阻 (CR) 模式下的电阻值 (单位: Ω)[cite: 1]
|
||||
/// </summary>
|
||||
/// <remarks>必须在先开启 CR 模式才能使用，设置为 0 相当于关闭 CR 模式</remarks>
|
||||
public virtual async Task 设置CR电阻值(double 电阻, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, "SINK:RESistance {0:F2}{1}", 电阻, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询CR电阻值(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"SINK:RESistance?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
295
DeviceCommand/Devices/IT6720 .cs
Normal file
295
DeviceCommand/Devices/IT6720 .cs
Normal file
@@ -0,0 +1,295 @@
|
||||
using Common.Attributes;
|
||||
using DeviceCommand.Base;
|
||||
using Model.Models;
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Globalization;
|
||||
using System.Threading;
|
||||
using System.Threading.Tasks;
|
||||
|
||||
namespace DeviceCommand.Devices
|
||||
{
|
||||
[ACPCommand]
|
||||
public class IT6720 : Serial_Port // 直接继承您提供的 Serial_Port 基类
|
||||
{
|
||||
// 帧格式：同步头 AA + 地址 + 命令字 + 数据[4-25] + 校验和，共 26 字节
|
||||
private const byte FrameSyncByte = 0xAA;
|
||||
private const int FrameLength = 26;
|
||||
private readonly byte _deviceAddress; // 电源地址
|
||||
|
||||
public IT6720(SerialPortConfig config, byte address = 0x00) : base(config)
|
||||
{
|
||||
_deviceAddress = address;
|
||||
}
|
||||
|
||||
#region 核心协议封装（不变）
|
||||
|
||||
/// <summary>
|
||||
/// 构建 26 字节的发送帧，并计算校验和
|
||||
/// </summary>
|
||||
private byte[] BuildFrame(byte command, byte[] dataBytes)
|
||||
{
|
||||
List<byte> frame = new List<byte> { FrameSyncByte, _deviceAddress, command };
|
||||
|
||||
if (dataBytes != null && dataBytes.Length > 0)
|
||||
{
|
||||
frame.AddRange(dataBytes);
|
||||
}
|
||||
|
||||
// 数据区必须占满 23 字节 (索引 3 到 24)
|
||||
while (frame.Count < 25)
|
||||
{
|
||||
frame.Add(0x00);
|
||||
}
|
||||
|
||||
// 计算校验和：前 25 字节之和取低 8 位
|
||||
byte checkSum = 0;
|
||||
for (int i = 0; i < 25; i++)
|
||||
{
|
||||
checkSum += frame[i];
|
||||
}
|
||||
frame.Add(checkSum);
|
||||
|
||||
return frame.ToArray();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 检查返回的 26 字节响应帧是否正确
|
||||
/// </summary>
|
||||
private bool ValidateResponseFrame(byte[] response)
|
||||
{
|
||||
if (response == null || response.Length != FrameLength) return false;
|
||||
if (response[0] != FrameSyncByte) return false;
|
||||
if (response[1] != _deviceAddress) return false;
|
||||
|
||||
byte checkSum = 0;
|
||||
for (int i = 0; i < 25; i++)
|
||||
{
|
||||
checkSum += response[i];
|
||||
}
|
||||
return response[25] == checkSum;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 将实际电压/电流值转换成协议要求的整型 (乘以 1000 变成整形)
|
||||
/// </summary>
|
||||
private int ConvertToProtocolValue(double value)
|
||||
{
|
||||
return (int)Math.Round(value * 1000);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 将协议返回的 4 字节小端序转换为实际数值 (除以 1000.0)
|
||||
/// </summary>
|
||||
private double Convert4BytesToValue(byte b0, byte b1, byte b2, byte b3)
|
||||
{
|
||||
uint raw = (uint)(b0 | (b1 << 8) | (b2 << 16) | (b3 << 24));
|
||||
return raw / 1000.0;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 将协议返回的 2 字节小端序转换为实际数值 (除以 1000.0)
|
||||
/// </summary>
|
||||
private double Convert2BytesToValue(byte b0, byte b1)
|
||||
{
|
||||
ushort raw = (ushort)(b0 | (b1 << 8));
|
||||
return raw / 1000.0;
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 1. 核心二进制收发方法（使用基类新方法）
|
||||
|
||||
/// <summary>
|
||||
/// 发送命令帧并读取仪器返回的 26 字节数据帧
|
||||
/// </summary>
|
||||
private async Task<byte[]> SendAndReadFrameAsync(byte command, byte[] dataBytes, CancellationToken ct = default)
|
||||
{
|
||||
byte[] sendFrame = BuildFrame(command, dataBytes);
|
||||
|
||||
// 使用基类提供的 WriteBytesAsync 发送二进制数据
|
||||
await WriteBytesAsync(sendFrame, ct).ConfigureAwait(false);
|
||||
|
||||
// 使用基类提供的 ReadBytesAsync 读取定长 26 字节二进制数据
|
||||
// 注意：这里的 ReadTimeout 由基类统一控制
|
||||
return await ReadBytesAsync(FrameLength, ct).ConfigureAwait(false);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 2. 操作模式与输出控制
|
||||
|
||||
/// <summary>
|
||||
/// 切换电源控制模式：PC 远程控制 / 面板控制
|
||||
/// </summary>
|
||||
public virtual async Task 切换远程控制模式(bool 远程控制 = true, CancellationToken ct = default)
|
||||
{
|
||||
byte[] data = new byte[] { (byte)(远程控制 ? 0x01 : 0x00) };
|
||||
byte[] response = await SendAndReadFrameAsync(0x20, data, ct);
|
||||
|
||||
if (!ValidateResponseFrame(response))
|
||||
throw new Exception("IT6720 切换控制模式时通讯校验失败。");
|
||||
}
|
||||
|
||||
public virtual async Task 切换本地控制模式(CancellationToken ct = default)
|
||||
{
|
||||
await 切换远程控制模式(false, ct);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 开启或关闭电源输出
|
||||
/// </summary>
|
||||
public virtual async Task 设置输出开关(bool 开启 = true, CancellationToken ct = default)
|
||||
{
|
||||
byte[] data = new byte[] { (byte)(开启 ? 0x01 : 0x00) };
|
||||
byte[] response = await SendAndReadFrameAsync(0x21, data, ct);
|
||||
|
||||
if (!ValidateResponseFrame(response))
|
||||
throw new Exception("IT6720 设置输出时通讯校验失败。");
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询输出开关状态(CancellationToken ct = default)
|
||||
{
|
||||
var (_, _, status) = await 查询实时测量值(ct);
|
||||
return (status & 0x01) != 0 ? "ON" : "OFF";
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 3. 电压 / 电流设定
|
||||
|
||||
/// <summary>
|
||||
/// 设置电源的电压上限
|
||||
/// </summary>
|
||||
public virtual async Task 设置电压上限(double 电压, CancellationToken ct = default)
|
||||
{
|
||||
int raw = ConvertToProtocolValue(电压);
|
||||
byte[] data = new byte[]
|
||||
{
|
||||
(byte)(raw & 0xFF), (byte)((raw >> 8) & 0xFF),
|
||||
(byte)((raw >> 16) & 0xFF), (byte)((raw >> 24) & 0xFF)
|
||||
};
|
||||
byte[] response = await SendAndReadFrameAsync(0x22, data, ct);
|
||||
if (!ValidateResponseFrame(response))
|
||||
throw new Exception("IT6720 设置电压上限时通讯校验失败。");
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置电源的输出电压
|
||||
/// </summary>
|
||||
public virtual async Task 设置输出电压(double 电压, CancellationToken ct = default)
|
||||
{
|
||||
int raw = ConvertToProtocolValue(电压);
|
||||
byte[] data = new byte[]
|
||||
{
|
||||
(byte)(raw & 0xFF), (byte)((raw >> 8) & 0xFF),
|
||||
(byte)((raw >> 16) & 0xFF), (byte)((raw >> 24) & 0xFF)
|
||||
};
|
||||
byte[] response = await SendAndReadFrameAsync(0x23, data, ct);
|
||||
if (!ValidateResponseFrame(response))
|
||||
throw new Exception("IT6720 设置输出电压时通讯校验失败。");
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置电源的输出电流限流值
|
||||
/// </summary>
|
||||
public virtual async Task 设置输出电流(double 电流, CancellationToken ct = default)
|
||||
{
|
||||
int raw = ConvertToProtocolValue(电流);
|
||||
byte[] data = new byte[]
|
||||
{
|
||||
(byte)(raw & 0xFF), (byte)((raw >> 8) & 0xFF)
|
||||
};
|
||||
byte[] response = await SendAndReadFrameAsync(0x24, data, ct);
|
||||
if (!ValidateResponseFrame(response))
|
||||
throw new Exception("IT6720 设置输出电流时通讯校验失败。");
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 4. 读取实时数据与状态（对应 0x26H）
|
||||
|
||||
/// <summary>
|
||||
/// 读取电源的实时电流、电压、设定值及电源状态
|
||||
/// 返回元组：实际电流(A), 实际电压(V), 状态字节(int)
|
||||
/// </summary>
|
||||
[Monitorable("IT6720 实时测量数据")]
|
||||
public virtual async Task<(double ActualCurrent, double ActualVoltage, int StatusByte)> 查询实时测量值(CancellationToken ct = default)
|
||||
{
|
||||
byte[] response = await SendAndReadFrameAsync(0x26, new byte[0], ct);
|
||||
|
||||
if (!ValidateResponseFrame(response))
|
||||
throw new Exception("IT6720 读取数据时通讯校验失败。");
|
||||
|
||||
double actualCurrent = Convert2BytesToValue(response[4], response[5]);
|
||||
double actualVoltage = Convert4BytesToValue(response[6], response[7], response[8], response[9]);
|
||||
int statusByte = response[10];
|
||||
|
||||
return (actualCurrent, actualVoltage, statusByte);
|
||||
}
|
||||
|
||||
[Monitorable("IT6720 实际电压")]
|
||||
public virtual async Task<string> 查询实际电压(CancellationToken ct = default)
|
||||
{
|
||||
var (_, voltage, _) = await 查询实时测量值(ct);
|
||||
return voltage.ToString("F2", CultureInfo.InvariantCulture);
|
||||
}
|
||||
|
||||
[Monitorable("IT6720 实际电流")]
|
||||
public virtual async Task<string> 查询实际电流(CancellationToken ct = default)
|
||||
{
|
||||
var (current, _, _) = await 查询实时测量值(ct);
|
||||
return current.ToString("F3", CultureInfo.InvariantCulture);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 读取状态字，判断是否处于恒压 (CV) 模式或恒流 (CC) 模式
|
||||
/// 状态字节位详解：位 2,3 = 1(CV), 2(CC)
|
||||
/// </summary>
|
||||
public virtual async Task<string> 查询输出模式(CancellationToken ct = default)
|
||||
{
|
||||
var (_, _, status) = await 查询实时测量值(ct);
|
||||
int mode = (status >> 2) & 0x03;
|
||||
return mode switch
|
||||
{
|
||||
1 => "CV",
|
||||
2 => "CC",
|
||||
_ => "UNKNOWN"
|
||||
};
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 5. 读取设备信息（命令字 31H）
|
||||
|
||||
/// <summary>
|
||||
/// 读取电源的序列号、型号及软件版本
|
||||
/// </summary>
|
||||
public virtual async Task<string> 查询设备信息(CancellationToken ct = default)
|
||||
{
|
||||
byte[] response = await SendAndReadFrameAsync(0x31, new byte[0], ct);
|
||||
if (!ValidateResponseFrame(response)) return "Invalid Response";
|
||||
|
||||
string model = System.Text.Encoding.ASCII.GetString(response, 4, 5).Trim('\0');
|
||||
string swVersion = $"{response[9]:X2}.{response[10]:X2}";
|
||||
string serialNum = System.Text.Encoding.ASCII.GetString(response, 11, 10).Trim('\0');
|
||||
|
||||
return $"Model:{model}, SW:{swVersion}, SN:{serialNum}";
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 6. 扩展系统命令（兼容接口）
|
||||
|
||||
/// <summary>
|
||||
/// 基类自带的超时和清空缓冲区已经处理了大部分错误。
|
||||
/// 如需在面板显示具体错误，需通过状态位自行判断或查看面板 ERROR 灯。
|
||||
/// </summary>
|
||||
public virtual async Task<string> 查询错误信息(CancellationToken ct = default)
|
||||
{
|
||||
return "IT6720 无标准 SCPI 错误信息查询，请检查前面板 ERROR 指示灯。";
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
263
DeviceCommand/Devices/IT7800E.cs
Normal file
263
DeviceCommand/Devices/IT7800E.cs
Normal file
@@ -0,0 +1,263 @@
|
||||
using Common.Attributes;
|
||||
using DeviceCommand.Base;
|
||||
using Model.Models;
|
||||
using System;
|
||||
using System.Globalization;
|
||||
using System.Threading;
|
||||
using System.Threading.Tasks;
|
||||
|
||||
namespace DeviceCommand.Devices
|
||||
{
|
||||
#region 枚举定义
|
||||
|
||||
/// <summary>
|
||||
/// 电源电气/耦合模式
|
||||
/// </summary>
|
||||
public enum PowerCouplingMode
|
||||
{
|
||||
/// <summary> 纯交流模式 </summary>
|
||||
AC,
|
||||
/// <summary> 纯直流模式 </summary>
|
||||
DC,
|
||||
/// <summary> 交直流混合模式 </summary>
|
||||
ACDC,
|
||||
/// <summary> 直交流混合模式 </summary>
|
||||
DCAC
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设备操作运行角色/模式
|
||||
/// </summary>
|
||||
public enum DeviceOperationMode
|
||||
{
|
||||
/// <summary> 电压源模式（常规源） </summary>
|
||||
VOLTage,
|
||||
/// <summary> 电子负载模式（放电拉载） </summary>
|
||||
LOAD,
|
||||
/// <summary> 电流源模式 </summary>
|
||||
CURRent
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
[ACPCommand]
|
||||
public class IT7800E : Tcp
|
||||
{
|
||||
// 八台产品共用一个，使用换行符 \n (ASCII 0x0A) 作为 SCPI 结束符[cite: 1]
|
||||
private const string ScpiDelimiter = "\n";
|
||||
|
||||
public IT7800E(TcpConfig config) : base(config)
|
||||
{
|
||||
}
|
||||
|
||||
#region 1. IEEE 488.2 公共命令
|
||||
|
||||
public virtual async Task 清除错误队列和状态字节(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"*CLS{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询设备标识(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"*IDN?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 重置设备(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"*RST{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 读取状态字节(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"*STB?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 2. 耦合模式与拉载开关控制
|
||||
|
||||
/// <summary>
|
||||
/// 设置电源输出源的电气模式/工作耦合模式 (AC, DC, ACDC, DCAC)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 设置电源模式(PowerCouplingMode 模式, CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($":SOURce:FUNCtion {模式}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 查询电源当前的工作电气模式[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task<string> 查询电源模式(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":SOURce:FUNCtion?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 设置DC输出(bool 开启, CancellationToken ct = default)
|
||||
{
|
||||
string 参数 = 开启 ? "ON" : "OFF"; //[cite: 1]
|
||||
await SendAsync($":OUTPut {参数}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询DC输出状态(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":OUTPut?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 3. 设定输出参数设置 (AC 电压/频率/DC 电压)
|
||||
|
||||
public virtual async Task 设置交流电压(double 电压, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce:VOLTage {0:F2}{1}", 电压, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task 设置直流电压(double 电压, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce:VOLTage:DC {0:F2}{1}", 电压, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task 设置频率(double 频率, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce:FREQuency {0:F2}{1}", 频率, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task 设置电流(double 电流, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce:CURRent {0:F3}{1}", 电流, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 4. 测量与数据回测（高频数据轮询核心）
|
||||
|
||||
[Monitorable("交流电源电压")]
|
||||
public virtual async Task<string> 查询实际电压(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":MEASure:VOLTage?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
[Monitorable("交流电源电流")]
|
||||
public virtual async Task<string> 查询实际电流(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":MEASure:CURRent?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
[Monitorable("交流电源功率")]
|
||||
public virtual async Task<string> 查询实际功率(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":MEASure:POWer?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询视在功率(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":MEASure:POWer:APParent?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询实际频率(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":MEASure:FREQuency?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询功率因数(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":MEASure:POWer:PFACtor?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 5. 保护参数设置与系统监控
|
||||
|
||||
public virtual async Task 设置过流保护_OCP(double 电流, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce:CURRent:PROTection:RMS {0:F3}{1}", 电流, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task 设置过压保护_OVP(double 电压, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce:VOLTage:PROTection:PEAK {0:F2}{1}", 电压, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
public virtual async Task<string> 查询错误信息(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($":SYSTem:ERRor?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 切换远程控制模式(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($":SYSTem:REMote{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 切换本地控制模式(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($":SYSTem:LOCal{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
public virtual async Task 清除保护告警(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($":OUTPut:PROTection:CLEar{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 6. 充放电与能量统计扩展命令
|
||||
|
||||
/// <summary>
|
||||
/// 清除最近的安时（Ah）与瓦时（Wh）统计数据[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 清除充放电电量统计(CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"SENSe:AHOur:RESet{ScpiDelimiter}", ct); //[cite: 1]
|
||||
await SendAsync($"SENSe:WHOur:RESet{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 读取当前充放电累计的安时值 (单位: Ah)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task<string> 查询累计安时_Ah(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"FETCh:AHOur?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 读取当前充放电累计的瓦时值 (单位: Wh)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task<string> 查询累计瓦时_Wh(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"FETCh:WHOur?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 读取充放电积分持续时间 (单位: 秒)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task<string> 查询积分时间(CancellationToken ct = default)
|
||||
{
|
||||
return await WriteReadAsync($"FETCh:ENERgy:TIME?{ScpiDelimiter}", ScpiDelimiter, ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 切换设备的操作模式 (VOLTage: 电源模式, LOAD: 负载模式/放电, CURRent: 电流源)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 设置操作模式(DeviceOperationMode 模式, CancellationToken ct = default)
|
||||
{
|
||||
await SendAsync($"SYSTem:OPERation:MODE {模式}{ScpiDelimiter}", ct); //[cite: 1]
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 设置放电截止电压/电压下限 (单位: V，用于防止电池过放)[cite: 1]
|
||||
/// </summary>
|
||||
public virtual async Task 设置电压下限(double 电压, CancellationToken ct = default)
|
||||
{
|
||||
string cmd = string.Format(CultureInfo.InvariantCulture, ":SOURce:VOLTage:LIMit:LOW {0:F2}{1}", 电压, ScpiDelimiter); //[cite: 1]
|
||||
await SendAsync(cmd, ct);
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user