添加项目文件。

2026-06-05 10:57:09 +08:00
parent f29671b374
commit d960cb5912
166 changed files with 15996 additions and 0 deletions
--- a/DeviceCommand/Devices/SPAW7000.cs
+++ b/DeviceCommand/Devices/SPAW7000.cs
@@ -0,0 +1,217 @@
+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
+    }
+}