EmersonAirCalibTest/Docs/SCPI命令库说明.txt

================================================================================
                    SCPI 命令库使用说明
================================================================================

📚 软件内置完整的 SCPI 命令库，针对不同设备提供专用命令集：
   • APS-7100：AC 可编程电源，50+ 条命令
   • PSW-250：DC 可编程电源，30+ 条命令

================================================================================
                    APS-7100 命令库 (AC 可编程电源)
================================================================================

⚠️ 重要说明：
   APS7100 使用完整的、层级严格的 SCPI 命令树
   核心根节点：MEAS / SOUR / OUTP / STAT / DATA
   
   命令特点：
   1. 几乎都带二级/三级节点
   2. 不支持简写的无子节点查询（如 OUTP? 不行，必须 OUTP:STAT?）
   3. 测量命令必须走 SCALar 路径

--------------------------------------------------------------------------------

📂 IEEE 488.2 标准命令（13 条）
    *IDN?                  查询设备识别信息
    *RST                   重置设备到出厂状态
    *CLS                   清除状态寄存器
    *TST?                  设备自检
    *OPC?                  查询操作完成
    *WAI                   等待操作完成
    *TRG                   触发设备
    *SAV 0                 保存设置到位置 0
    *RCL 0                 恢复设置从位置 0
    *ESR?                  查询事件状态寄存器
    *ESE                   设置事件状态使能
    *STB?                  查询状态字节
    *SRE                   设置服务请求使能

📂 系统命令 - SYSTEM（6 条）
    SYST:ERR?              查询错误队列
    SYST:VERS?             查询 SCPI 版本
    SYST:REM               进入远程控制模式
    SYST:LOC               返回本地控制模式
    SYST:KLOC ON           锁定前面板按键 ⚠ 不是 RWLOCK
    SYST:KLOC OFF          解锁前面板按键 ⚠ 不是 RWLOCK

📂 输出控制 - OUTPUT（4 条）
    ⚠️ 必须使用 OUTP:STAT，不支持简写 OUTP ON/OFF
    
    OUTP:STAT ON           开启输出
    OUTP:STAT OFF          关闭输出
    OUTP:STAT?             查询输出状态
    OUTP:PROT:CLE          清除输出保护状态

📂 电压设置 - SOURCE:VOLTAGE（7 条）
    ⚠️ 量程使用 R155/R310/R600/AUTO，不支持 LOW/HIGH
    
    SOUR:VOLT 220          设置输出电压为 220V
    SOUR:VOLT?             查询电压设定值
    SOUR:VOLT:RANG R155    设置电压量程 0-155V
    SOUR:VOLT:RANG R310    设置电压量程 0-310V
    SOUR:VOLT:RANG R600    设置电压量程 0-600V
    SOUR:VOLT:RANG AUTO    设置自动量程
    SOUR:VOLT:RANG?        查询电压量程

📂 频率设置 - SOURCE:FREQUENCY（4 条）
    SOUR:FREQ 50           设置输出频率为 50Hz
    SOUR:FREQ 60           设置输出频率为 60Hz
    SOUR:FREQ 400          设置输出频率为 400Hz (航空标准)
    SOUR:FREQ?             查询频率设定值

📂 相位设置 - SOURCE:PHASE（2 条）
    SOUR:PHAS 0            设置相位为 0 度
    SOUR:PHAS?             查询相位设定值
    ⚠️ 用于多相或并机控制

📂 电流限制 - SOURCE:CURRENT（2 条）
    ⚠️ APS7100 只有电流限制，没有"电流设定"概念！
    ❌ SOUR:CURR 和 SOUR:CURR? 不可用
    
    SOUR:CURR:LIM:RMS 5    设置电流限值为 5A (RMS)
    SOUR:CURR:LIM:RMS?     查询电流限值 (RMS)

📂 测量命令 - MEASURE（6 条）
    ⚠️ 必须走 SCALar 路径！MEAS:VOLT? / MEAS:CURR? / MEAS:POW? 都不可用
    
    MEAS:SCAL:VOLT?        测量实际输出电压 (V RMS)
    MEAS:SCAL:CURR?        测量实际输出电流 (A RMS)
    MEAS:SCAL:FREQ?        测量实际输出频率 (Hz)
    MEAS:SCAL:POW:AC:REAL? 测量有功功率 P (W)
    MEAS:SCAL:POW:AC:APP?  测量视在功率 S (VA)
    MEAS:SCAL:POW:AC:PFAC? 测量功率因数 PF ⚠️ 不是 MEAS:PF?

📂 触发命令 - INITIATE（2 条）
    INIT:IMM               立即执行（启动 Sequence/Simulation）
    INIT:IMM:TRAN          立即执行瞬态

📂 状态命令 - STATUS（2 条）
    STAT:OPER?             查询操作状态寄存器
    STAT:QUES?             查询可疑状态寄存器

📂 序列命令 - DATA/TRACE（6 条）
    ⚠️ 用于电压跌落、频率扫变、IEC测试波形（不是 SINE/SQUARE 波形设置）
    
    DATA:SEQ:CLE           清除序列数据
    DATA:SEQ:STOR 0        存储序列到位置 0
    DATA:SEQ:REC 0         从位置 0 调用序列
    DATA:SIM:CLE           清除模拟数据
    DATA:SIM:STOR 0        存储模拟到位置 0
    DATA:SIM:REC 0         从位置 0 调用模拟

================================================================================
                    PSW-250 命令库 (DC 可编程电源)
================================================================================

📂 系统命令（5 条）
    *IDN?                  查询设备识别信息
    *RST                   重置设备到出厂状态
    *CLS                   清除状态寄存器
    SYST:ERR?              查询错误队列
    SYST:VERS?             查询 SCPI 版本

📂 输出控制（3 条）
    OUTP ON                开启输出
    OUTP OFF               关闭输出
    OUTP?                  查询输出状态

📂 输出控制优先级（5 条）
    ⚠️ CV/CC 是运行结果（取决于负载），不是可切换的模式
    
    OUTP:MODE CVHS         恒压优先（高速响应）
    OUTP:MODE CCHS         恒流优先（高速响应）
    OUTP:MODE CVLS         恒压优先（斜率/平滑变化）
    OUTP:MODE CCLS         恒流优先（斜率/平滑变化）
    OUTP:MODE?             查询控制优先级 (返回 0-3)

📂 电压设置（4 条）
    SOUR:VOLT 12           设置输出电压为 12V
    SOUR:VOLT?             查询电压设定值
    SOUR:VOLT:PROT 75      设置过压保护值
    SOUR:VOLT:PROT?        查询过压保护值
    ⚠️ 电压范围: 0-72V

📂 电流设置（4 条）
    SOUR:CURR 1            设置输出电流为 1A
    SOUR:CURR 2            设置输出电流为 2A
    SOUR:CURR 3            设置输出电流为 3A
    SOUR:CURR?             查询电流设定值
    ⚠️ 电流范围: 0-4.5A

📂 测量命令（3 条）
    MEAS:VOLT?             测量实际输出电压
    MEAS:CURR?             测量实际输出电流
    MEAS:POW?              测量实际输出功率

📂 保护功能（6 条）
    VOLT:PROT:STAT ON      启用过压保护
    VOLT:PROT:STAT OFF     禁用过压保护
    VOLT:PROT:STAT?        查询过压保护状态
    CURR:PROT:STAT ON      启用过流保护
    CURR:PROT:STAT OFF     禁用过流保护
    CURR:PROT:STAT?        查询过流保护状态

📂 远程控制（2 条）
    SYST:REM               进入远程控制模式
    SYST:LOC               返回本地控制模式

================================================================================
两者主要区别
================================================================================

┌─────────────────┬────────────────────────────────────────────────────────────┐
│     特性        │                        说明                                │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 输出类型        │ APS-7100: AC 交流电源  |  PSW-250: DC 直流电源            │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 电压范围        │ APS-7100: 0-350V       |  PSW-250: 0-72V                  │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 命令格式        │ APS-7100: 完整 SCPI    |  PSW-250: 支持简写命令           │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 输出控制        │ APS-7100: OUTP:STAT    |  PSW-250: OUTP ON/OFF            │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 电流设置        │ APS-7100: SOUR:CURR:LIM:RMS|  PSW-250: SOUR:CURR          │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 测量命令        │ APS-7100: MEAS:SCAL:*  |  PSW-250: MEAS:*                 │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 频率设置        │ APS-7100: ✓ 支持       |  PSW-250: ✗ 不支持 (DC无频率)   │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 功率因数        │ APS-7100: ✓ PFAC       |  PSW-250: ✗ 不适用              │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 电压量程        │ APS-7100: R155/R310/R600/AUTO  |  PSW-250: 无量程设置    │
├─────────────────┼────────────────────────────────────────────────────────────┤
│ 面板锁定        │ APS-7100: SYST:KLOC    |  PSW-250: 不支持                 │
└─────────────────┴────────────────────────────────────────────────────────────┘

================================================================================
使用方法
================================================================================

【步骤 1】连接设备
    在主界面选择对应的设备进行连接。

【步骤 2】打开测试面板
    菜单 → 手动测试 → 选择对应设备的测试面板

【步骤 3】选择分类
    在"命令分类"下拉框中选择你需要的命令类别。

【步骤 4】选择命令
    在"命令清单"中选择一个命令。
    软件会根据连接的设备类型自动显示对应的命令库。

【步骤 5】查看说明
    "功能说明"区域会显示该命令的详细信息。

【步骤 6】使用命令
    点击"使用此命令"按钮，命令会自动填充到输入框。

【步骤 7】发送命令
    点击"发送"按钮执行命令。

================================================================================
命令类型说明
================================================================================

📖 查询命令（末尾带 ?）
    - 用于读取设备状态或测量值
    - 发送后会返回一个值
    - 例如：MEAS:SCAL:VOLT? 返回当前测量电压 (APS7100)
    - 例如：MEAS:VOLT? 返回当前测量电压 (PSW250)

⚙️ 设置命令（末尾不带 ?）
    - 用于配置设备参数
    - 发送后无返回值，执行后生效
    - 例如：SOUR:VOLT 220 将电压设置为 220V

================================================================================
常用操作示例
================================================================================

【APS-7100 示例：设置 AC 220V 50Hz 输出】
    1. SOUR:VOLT 220              设置电压
    2. SOUR:FREQ 50               设置频率
    3. OUTP:STAT ON               开启输出 ⚠ 注意使用 OUTP:STAT
    4. MEAS:SCAL:VOLT?            读取实际电压 ⚠ 注意使用 MEAS:SCAL
    5. MEAS:SCAL:POW:AC:PFAC?     读取功率因数 ⚠ 注意使用完整路径

【PSW-250 示例：设置 DC 24V 恒压输出】
    1. OUTP:MODE CVHS             设置恒压优先（高速）
    2. SOUR:VOLT 24               设置电压
    3. SOUR:CURR 2                设置电流限制
    4. OUTP ON                    开启输出
    5. MEAS:VOLT?                 读取实际电压
    6. MEAS:CURR?                 读取实际电流

================================================================================
扩展命令库
================================================================================

如需添加自定义命令，请编辑对应的命令库文件：

APS-7100: Libraries\ScpiCommandLibrary.cs
PSW-250:  Libraries\PSW250CommandLibrary.cs

格式：
    new ScpiCommandInfo
    {
        Category = "分类名称",
        Command = "YOUR:COMMAND",
        Description = "命令说明",
        IsQuery = false,
        Example = "使用示例"
    }

================================================================================
技术支持
================================================================================

固纬官网：https://www.gwinstek.com/
产品手册：从官网下载对应型号的用户手册及编程手册

================================================================================