using Common.Attributes; using DeviceCommand.Base; using System; using System.Collections.Generic; using System.Diagnostics.Metrics; using System.IO; using System.Linq; using System.Text; using System.Threading.Channels; using System.Threading.Tasks; using System.Windows.Shapes; using static Common.Attributes.ATSCommandAttribute; using static System.Formats.Asn1.AsnWriter; namespace DeviceCommand.Device { /// /// 示波器(型号:RTM3004) /// [ATSCommand] [DeviceCategory("示波器")] public class RTM3004 : Tcp { /// /// 信号量锁 /// public SemaphoreSlim semaphoreSlimLock { get; set; } = new(1, 1); #region 枚举定义(严格遵循手册规范) /// /// 单个通道名称枚举 /// public enum ChannelName_Single_Enum { CH1 = 1, CH2 = 2, CH3 = 3, CH4 = 4 } /// /// 测试项(1到9) /// public enum Measurement_Enum { MEAS1 = 1, MEAS2 = 2, MEAS3 = 3, MEAS4 = 4, MEAS5 = 5, MEAS6 = 6, MEAS7 = 7, MEAS8 = 8 } public enum CouplingMode { DCLimit, ACLimit, GND, //手册有 GND 耦合 DC } /// /// 采集状态(手册 ACQuire:STATE 支持值) /// public enum AcquisitionState { RUN, STOPping,//采集完成后停止采集 COMPlete,//设置:不可用 BREak//设置:立即中断当前采集 } /// 带宽限制(手册 CH:BANdwidth 支持值) public enum BandwidthLimit { FULL,//使用全部带宽 B20//频率限制为20 MHz。高频信号被移除以降低 } /// /// 触发模式(手册 TRIGger:A:MODe 支持值) /// public enum TriggerMode { AUTO, // 自动 NORMal, // 正常 } /// /// 触发模式(手册 TRIGger:A:MODe 支持值) /// public enum Slope_Enum { POSitive, //上升沿,正电压变化 NEGative,//下降沿,负电压变化 EITHer //上升和下降的边缘 } /// /// 测试项信号水平的百分比(手册 TRIGger:A:MODe 支持值) /// public enum Relative_Mode { TEN, //10, 50 and 90% TWENty,// 20, 50 and 80% FIVE,// 5, 50 and 95 % USER//层级定义采用REFLevel参数 } #endregion #region 核心控制命令 //罗德与施瓦茨RTM3000示波器没有专门的"切换本地/远程"SCPI命令,自动切换 /// /// 指定电源应用程序的电流源 /// /// 设备 /// 通道名称 /// /// public async Task Set_CurrentSource(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"POWer:SOURce:CURRent {channelName}\n", ct); // 手册 POWer 命令规范 } finally { semaphoreSlimLock.Release(); } } /// /// 指定电源应用程序的电压源 /// /// 设备 /// 通道 /// /// public async Task Set_VoltageSource(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"POWer:SOURce:VOLTage {channelName}\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 用于设置上升/下降时间测量的上下参考电平 /// /// 设备 /// 参考电平的百分比 /// /// public async Task Stop_QuickMeasurement(Tcp client, Relative_Mode relativemode, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"REFLevel:RELative:MODE{relativemode}:AOFF\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 启动快速测量(AUTO/NORMal) /// /// 设备 /// 测试项 /// /// public async Task Start_QuickMeasurement(Tcp client, Measurement_Enum measurement, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"MEASurement{measurement}:AON\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 停止快速测量 /// /// 设备 /// 测试项 /// /// public async Task Stop_QuickMeasurement(Tcp client, Measurement_Enum measurement, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"MEASurement{measurement}:AOFF\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 启动自动测量(AUTO/NORMal) /// /// 设备 /// 测试项 /// /// public async Task Start_AutoMeasurement(Tcp client, Measurement_Enum measurement, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"MEASurement{measurement}:ON\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 停止自动测量 /// /// 设备 /// 测试项 /// /// public async Task Stop_AutoMeasurement(Tcp client, Measurement_Enum measurement, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"MEASurement{measurement}:OFF\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 指定测量的通道 /// /// 设备 /// 通道 /// 测试项 /// /// public async Task Set_Measurement_Source(Tcp client, ChannelName_Single_Enum channelName, Measurement_Enum measurement, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"MEASurement{measurement}:SOURce CH{channelName}\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 指定A触发的通道 (AUTO/NORMal) /// /// 设备 /// 通道 /// /// public async Task Set_ATrigger_SOURce(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"TRIGger:A:SOURce CH{channelName}\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 设置A触发的模式 (AUTO/NORMal) /// /// 设备 /// 触发模式 /// /// public async Task Set_ATrigger_Mode(Tcp client, TriggerMode mode, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { string modeStr = mode.ToString().ToUpper(); await SendAsync(client, $"TRIGger:A:MODE {modeStr}\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 设置A触发的触发斜率(沿)(AUTO/NORMal) /// /// 设备 /// 触发斜率(沿) /// /// public async Task Set_ATrigger_Slope(Tcp client, Slope_Enum slope, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { string modeStr = slope.ToString().ToUpper(); await SendAsync(client, $"TRIGger:A:EDGE:SLOPe {slope}\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 设置A触发的阈值电压(取决于垂直标度) /// /// 设备 /// 通道 /// 阈值电压/param> /// /// public async Task Set_ATrigger_Level(Tcp client, ChannelName_Single_Enum channelName, float level, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { string modeStr = level.ToString().ToUpper(); await SendAsync(client, $"TRIGger:A:LEVel {channelName} {level}\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 设置指定通道的输入耦合模式 /// /// 设备 /// 通道名称 /// 耦合模式 /// /// public async Task Set_ChannelCoupling(Tcp client, ChannelName_Single_Enum channelName, CouplingMode couplingMode, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { string modeStr = couplingMode.ToString().ToUpper(); await SendAsync(client, $"CHANnel {channelName}:COUPling{couplingMode}\n", ct); // 直接使用通道枚举值(如 CHANnel 1:COUPLING AC) } finally { semaphoreSlimLock.Release(); } } /// /// 设置指定通道的输入耦合为DCLimit /// /// 设备 /// 通道名称 /// /// public async Task Set_ChannelCoupling_DCLimit(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await Set_ChannelCoupling(client, channelName, CouplingMode.DCLimit, ct); } /// /// 设置指定通道的输入耦合为ACLimit /// /// 设备 /// 通道名称 /// /// public async Task Set_ChannelCoupling_ACLimit(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await Set_ChannelCoupling(client, channelName, CouplingMode.ACLimit, ct); } /// /// 设置指定通道的输入耦合为GND /// /// 设备 /// 通道名称 /// /// public async Task Set_ChannelCoupling_GND(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await Set_ChannelCoupling(client, channelName, CouplingMode.GND, ct); } /// /// 设置指定通道的输入耦合为DC /// /// 设备 /// 通道名称 /// /// public async Task Set_ChannelCoupling_DC(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await Set_ChannelCoupling(client, channelName, CouplingMode.DC, ct); } /// /// 设置指定通道的硬件带宽限制 /// /// 设备 /// 通道名称 /// 带宽限制 /// /// public async Task Set_ChannelBandwidth(Tcp client, ChannelName_Single_Enum channelName, BandwidthLimit bandwidth, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { string bwStr = $"{(int)bandwidth}E6"; await SendAsync(client, $"CHANnel{channelName}:BANDwidth{bwStr}\n", ct); // 如 CHANnel 1:BANDwidth FULL } finally { semaphoreSlimLock.Release(); } } /// /// 启用指定通道 /// /// 设备 /// 通道名称 /// /// public async Task Start_Channel(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"CHANnel:{channelName}:STATe ON\n", ct); // 手册标准通道启用命令 } finally { semaphoreSlimLock.Release(); } } /// /// 关闭指定通道 /// /// 设备 /// 通道名称 /// /// public async Task Stop_Channel(Tcp client, ChannelName_Single_Enum channelName, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"CHANnel:{channelName}:STATe OFF\n", ct); // 手册标准通道启用命令 } finally { semaphoreSlimLock.Release(); } } /// /// 设置指定通道的垂直标度 (Volts/Div) /// /// 设备 /// 通道名称 /// 标度值(单位:V/div) /// /// public async Task Set_ChannelScale(Tcp client, ChannelName_Single_Enum channelName, float scale, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"CHANnel{channelName}:SCALe{scale}\n", ct); // 如 CH1:SCALE 1.0(单位 V/div) } finally { semaphoreSlimLock.Release(); } } /// /// 设置所有通道及数学波形的水平比例尺(每格时间,秒/格) /// /// 设备 /// 时基标度(单位:s/div) /// /// public async Task Set_Timebase_Scale(Tcp client, double scale, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"TIMebase:SCALe {scale}\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 设置水平触发位置 (相对于屏幕中心的偏移,百分比) /// /// 设备 /// 位置百分比 /// /// public async Task Set_Timebase_Position(Tcp client, double position, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"TIMebase:POSition {position}\n", ct); // 位置单位为百分比 } finally { semaphoreSlimLock.Release(); } } /// /// 设置示波器的采集状态 (RUN/STOP) /// /// 设备 /// 采集状态 /// /// public async Task Set_Acquisition_State(Tcp client, AcquisitionState state, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { string stateStr = state.ToString().ToUpper(); await SendAsync(client, $"ACQuire:STATe {stateStr}\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// Trigger 启动采集(替代原电源ON,手册无OUTPUT命令) /// /// 设备 /// /// public async Task Start_Acquisition(Tcp client, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"ACQuire:STATe RUN\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 采集完停止采集 /// /// 设备 /// /// public async Task Stopping_Acquisition(Tcp client, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"ACQuire:STATe STOPping\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 设置采集不可用 /// /// 设备 /// /// public async Task Complete_Acquisition(Tcp client, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"ACQuire:STATe COMPlete\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 立即停止采集 /// /// 设备 /// /// public async Task Break_Acquisition(Tcp client, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { await SendAsync(client, $"ACQuire:STATe BREak\n", ct); } finally { semaphoreSlimLock.Release(); } } /// /// 保存波形数据(保存全通道到CSV文件) /// /// 设备_当前时间.CSV /// 指定通道(默认:D:/BDUWAVE) /// 保存路径(默认:D:/BDUWAVE) /// 保存波形文件名(默认:WAVE_当前时间.PNG) /// /// public async Task Save_Waveform(Tcp client, ChannelName_Single_Enum channelName, string filePath, string fileName, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { if (!Directory.Exists(filePath)) { filePath = $"D:/WAVE"; Directory.CreateDirectory(filePath); } if (string.IsNullOrEmpty(fileName)) { fileName = $"WAVE_{DateTime.Now.ToString()}"; } await SendAsync(client, $"EXPort:WAVeform:SOURce{channelName}\n", ct); // 设置待导出的波形源 await SendAsync(client, $"EXPort:WFMSave:DESTination{filePath}\n", ct); // 设置待导出的目录 await SendAsync(client, "FORMAT CSV\n", ct); // 设置文件格式 await SendAsync(client, $"EXPort:WAVeform:NAME\"{fileName}\"\n", ct); //设置文件名字 await SendAsync(client, $"EXPort:WAVeform:SAVE\n", ct);// 执行保存操作 } finally { semaphoreSlimLock.Release(); } } /// /// 保存屏幕截图(指定格式为PNG) /// /// 设备 /// 保存路径(默认:D:/BDUSCREEN) /// 保存波形文件名(默认:SCREEN_当前时间.PNG) /// /// public async Task Save_Screen_Image(Tcp client, string filePath, string fileName, CancellationToken ct = default) { await semaphoreSlimLock.WaitAsync(ct); try { if (!Directory.Exists(filePath)) { filePath = $"D:/WAVE"; Directory.CreateDirectory(filePath); } if (string.IsNullOrEmpty(fileName)) { fileName = $"WAVE_{DateTime.Now.ToString()}"; } await SendAsync(client, $"EXPort:SCRSave:DESTination{filePath}\n", ct); // 设置待导出的目录 await SendAsync(client, "FORMAT PNG\n", ct); // 设置文件格式 await SendAsync(client, $"MMEMory:NAME\"{fileName}\"\n", ct); //设置文件名字 await SendAsync(client, $"HCOPy:IMMediate\n", ct);// 执行保存操作 } finally { semaphoreSlimLock.Release(); } } /// /// 发送自定义SCPI命令 /// /// 设备 /// SCPI命令字符串 /// /// 命令执行结果 public async Task Send_CustomCommand(Tcp client, string command, CancellationToken ct = default) { if (string.IsNullOrEmpty(command)) throw new ArgumentNullException(nameof(command)); await semaphoreSlimLock.WaitAsync(ct); try { return await WriteRead(client, $"{command}\n", "\n", ct: ct); } finally { semaphoreSlimLock.Release(); } } #endregion } }