217 lines
9.1 KiB
C#
217 lines
9.1 KiB
C#
using Common.Attributes;
|
||
using DeviceCommand.Base;
|
||
using System;
|
||
using System.Globalization;
|
||
using System.Threading;
|
||
using System.Threading.Tasks;
|
||
|
||
namespace DeviceCommand.Device
|
||
{
|
||
[ADPCommand]
|
||
public class SPAW7000 : Tcp
|
||
{
|
||
// 根据通用 SCPI 与远宽指令规范，使用换行符 (ASCII 字符 LF，即 \n) 作为标准结束符
|
||
private const string ScpiDelimiter = "\n";
|
||
|
||
/// <summary>
|
||
/// 构造函数：初始化 SPAW7000 功率分析记录仪通信参数
|
||
/// </summary>
|
||
public SPAW7000(string ipAddress, int port, int sendTimeout, int receiveTimeout)
|
||
{
|
||
ConfigureDevice(ipAddress, port, sendTimeout, receiveTimeout);
|
||
}
|
||
|
||
#region 1. IEEE 488.2 公共命令
|
||
|
||
/// <summary>
|
||
/// 清除状态命令。清除标准事件状态寄存器和错误队列
|
||
/// </summary>
|
||
public virtual async Task 清除错误队列和状态字节(CancellationToken ct = default)
|
||
{
|
||
await SendAsync($"*CLS{ScpiDelimiter}", ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 读取功率分析仪识别字符串（制造商、产品型号、系统 SN、软件版本号）
|
||
/// </summary>
|
||
public virtual async Task<string> 查询设备标识(CancellationToken ct = default)
|
||
{
|
||
return await WriteReadAsync($"*IDN?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 复位命令。使功率分析仪恢复到出厂默认配置状态
|
||
/// </summary>
|
||
public virtual async Task 重置设备(CancellationToken ct = default)
|
||
{
|
||
await SendAsync($"*RST{ScpiDelimiter}", ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 读取标准状态字节寄存器
|
||
/// </summary>
|
||
public virtual async Task<string> 读取状态字节(CancellationToken ct = default)
|
||
{
|
||
return await WriteReadAsync($"*STB?{ScpiDelimiter}", ScpiDelimiter, ct);
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region 2. MEASure / NUMeric 核心数据测量与轮询 (高频轮询核心)
|
||
|
||
/// <summary>
|
||
/// 查询指定通道的实时 RMS 电压值 (单位: V)
|
||
/// </summary>
|
||
/// <param name="channel">通道号 (例如: 1, 2, 3...)</param>
|
||
public virtual async Task<string> 查询实际电压(int channel, CancellationToken ct = default)
|
||
{
|
||
string query = string.Format(CultureInfo.InvariantCulture, ":MEASure:NUMeric:VALue? U,{0}{1}", channel, ScpiDelimiter);
|
||
return await WriteReadAsync(query, ScpiDelimiter, ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 查询指定通道的实时 RMS 电流值 (单位: A)
|
||
/// </summary>
|
||
/// <param name="channel">通道号 (例如: 1, 2, 3...)</param>
|
||
public virtual async Task<string> 查询实际电流(int channel, CancellationToken ct = default)
|
||
{
|
||
string query = string.Format(CultureInfo.InvariantCulture, ":MEASure:NUMeric:VALue? I,{0}{1}", channel, ScpiDelimiter);
|
||
return await WriteReadAsync(query, ScpiDelimiter, ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 查询指定通道的实时有功功率值 (单位: W)
|
||
/// </summary>
|
||
/// <param name="channel">通道号 (例如: 1, 2, 3...)</param>
|
||
public virtual async Task<string> 查询实际功率(int channel, CancellationToken ct = default)
|
||
{
|
||
string query = string.Format(CultureInfo.InvariantCulture, ":MEASure:NUMeric:VALue? P,{0}{1}", channel, ScpiDelimiter);
|
||
return await WriteReadAsync(query, ScpiDelimiter, ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 查询指定通道的实时频率值 (单位: Hz)
|
||
/// </summary>
|
||
/// <param name="channel">通道号 (例如: 1, 2, 3...)</param>
|
||
public virtual async Task<string> 查询频率(int channel, CancellationToken ct = default)
|
||
{
|
||
string query = string.Format(CultureInfo.InvariantCulture, ":MEASure:NUMeric:VALue? FREQuency,{0}{1}", channel, ScpiDelimiter);
|
||
return await WriteReadAsync(query, ScpiDelimiter, ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 查询指定通道的功率因数 (Power Factor)
|
||
/// </summary>
|
||
/// <param name="channel">通道号 (例如: 1, 2, 3...)</param>
|
||
public virtual async Task<string> 查询功率因数(int channel, CancellationToken ct = default)
|
||
{
|
||
string query = string.Format(CultureInfo.InvariantCulture, ":MEASure:NUMeric:VALue? PF,{0}{1}", channel, ScpiDelimiter);
|
||
return await WriteReadAsync(query, ScpiDelimiter, ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 自定义组合参数批量读取接口
|
||
/// </summary>
|
||
/// <param name="parameter">参数助记符 (如 "U,I,P" 或 "S,Q,LAMBda")</param>
|
||
/// <param name="channel">通道号</param>
|
||
public virtual async Task<string> 查询自定义测量组合(string parameter, int channel, CancellationToken ct = default)
|
||
{
|
||
string query = string.Format(CultureInfo.InvariantCulture, ":MEASure:NUMeric:VALue? {0},{1}{2}", parameter, channel, ScpiDelimiter);
|
||
return await WriteReadAsync(query, ScpiDelimiter, ct);
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region 3. INPut 通道电气参数配置
|
||
|
||
/// <summary>
|
||
/// 设置指定通道的电压量程 (例如: 15, 30, 60, 150, 300, 600, 1000)
|
||
/// </summary>
|
||
public virtual async Task 设置电压量程(int channel, double range, CancellationToken ct = default)
|
||
{
|
||
string cmd = string.Format(CultureInfo.InvariantCulture, ":INPut:VOLTage:RANGe {0},{1:F1}{2}", channel, range, ScpiDelimiter);
|
||
await SendAsync(cmd, ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 设置指定通道的电流量程 (取决于接线单元或传感器输入类型)
|
||
/// </summary>
|
||
public virtual async Task 设置电流量程(int channel, double range, CancellationToken ct = default)
|
||
{
|
||
string cmd = string.Format(CultureInfo.InvariantCulture, ":INPut:CURRent:RANGe {0},{1:F3}{2}", channel, range, ScpiDelimiter);
|
||
await SendAsync(cmd, ct);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 设置通道的耦合模式 (AC, DC, ACDC)
|
||
/// </summary>
|
||
public virtual async Task 设置通道耦合模式(int channel, string mode, CancellationToken ct = default)
|
||
{
|
||
string modeUpper = mode.ToUpper();
|
||
if (modeUpper != "AC" && modeUpper != "DC" && modeUpper != "ACDC")
|
||
throw new ArgumentException("耦合模式只能为 AC, DC, 或 ACDC");
|
||
|
||
string cmd = string.Format(CultureInfo.InvariantCulture, ":INPut:COUPling {0},{1}{2}", channel, modeUpper, ScpiDelimiter);
|
||
await SendAsync(cmd, ct);
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region 4. SYSTem 系统设置与状态查询
|
||
|
||
/// <summary>
|
||
/// 14. 查询仪器型号名称
|
||
/// </summary>
|
||
public virtual async Task<string> 查询设备型号(CancellationToken ct = default)
|
||
{
|
||
return await WriteReadAsync($":SYSTem:MODel?{ScpiDelimiter}", ScpiDelimiter, ct); //
|
||
}
|
||
|
||
/// <summary>
|
||
/// 16. 查询仪器唯一序列号
|
||
/// </summary>
|
||
public virtual async Task<string> 查询设备序列号(CancellationToken ct = default)
|
||
{
|
||
return await WriteReadAsync($":SYSTem:SERial?{ScpiDelimiter}", ScpiDelimiter, ct); //
|
||
}
|
||
|
||
/// <summary>
|
||
/// 15. 设置数值数据显示的分辨率 (5位或6位)
|
||
/// </summary>
|
||
/// <param name="resolution">有效值只能为 5 或 6</param>
|
||
public virtual async Task 设置显示分辨率(int resolution, CancellationToken ct = default)
|
||
{
|
||
if (resolution != 5 && resolution != 6) throw new ArgumentException("分辨率只能设置为 5 或 6 位");
|
||
await SendAsync($":SYSTem:RESolution {resolution}{ScpiDelimiter}", ct); //
|
||
}
|
||
|
||
/// <summary>
|
||
/// 13. 设置或查询屏幕 LCD 的亮度级别 (1-10)
|
||
/// </summary>
|
||
public virtual async Task 设置显示亮度(int brightness, CancellationToken ct = default)
|
||
{
|
||
if (brightness < 1 || brightness > 10) throw new ArgumentOutOfRangeException(nameof(brightness), "亮度范围必须在 1~10 之间");
|
||
await SendAsync($":SYSTem:LCD:BRIGhtness {brightness}{ScpiDelimiter}", ct); //
|
||
}
|
||
|
||
/// <summary>
|
||
/// 18. 设置或查询触摸锁的开/关状态 (锁定时防止人工误触触控屏)
|
||
/// </summary>
|
||
public virtual async Task 设置屏幕触摸锁定(bool isLocked, CancellationToken ct = default)
|
||
{
|
||
string state = isLocked ? "ON" : "OFF";
|
||
await SendAsync($":SYSTem:TLOCK {state}{ScpiDelimiter}", ct); //
|
||
}
|
||
|
||
/// <summary>
|
||
/// 17. 设置或读取分析仪当前的系统内部时间
|
||
/// </summary>
|
||
/// <param name="timeStr">格式必须为 "HH:MM:SS"</param>
|
||
public virtual async Task 设置系统时间(string timeStr, CancellationToken ct = default)
|
||
{
|
||
await SendAsync($":SYSTem:TIME \"{timeStr}\"{ScpiDelimiter}", ct); //
|
||
}
|
||
|
||
#endregion
|
||
}
|
||
} |