================================================================================
              可编程电源测试工具 v3.0 - 快速使用指南
================================================================================

✨ 新版本支持：APS-7100 (AC) 和 PSW250-4.5 (DC) 两种设备！

一、硬件连接（两种方式任选其一）

    【方式 A：串口连接】
    1. 使用 RS-232 串口线或 USB 转串口线连接电脑与 APS-7100
    2. 打开 APS-7100 电源
    3. 在 Windows 设备管理器中确认串口号（如 COM3）

    【方式 B：网口连接】⭐ 推荐
    1. 使用网线将 APS-7100 连接到局域网
    2. 在设备上配置 IP 地址（参考设备手册）
    3. 记下设备的 IP 地址（如 192.168.1.100）
    4. 测试连接：在 CMD 中执行 ping 192.168.1.100

二、软件启动
    方式1：双击 "启动.bat" 直接运行（需要安装 .NET 6.0 SDK）
    方式2：命令行执行 "dotnet run"
    方式3：编译后运行独立可执行文件（双击 "编译发布.bat"）

三、选择设备类型 ⭐ 新功能

    软件支持两种设备，请先选择：
    
    【设备类型下拉框】
    □ APS-7100 (AC可编程电源)     - 交流电源，支持频率/波形调节
    □ PSW250-4.5 (DC可编程电源)   - 直流电源，支持恒压/恒流模式
    
    💡 界面会根据选择的设备自动显示/隐藏相关功能

四、连接设备

    【串口连接步骤】
    1. 选择"串口连接"单选框
    2. 在软件界面选择正确的 COM 端口
    3. 选择波特率（通常为 9600）
    4. 点击"连接"按钮
    5. 连接成功后会显示设备识别信息

    【网口连接步骤】⭐ 推荐
    1. 选择"网口连接"单选框
    2. 输入设备的 IP 地址（例如：192.168.1.100）
    3. 输入端口号（默认 2268）
    4. 点击"连接"按钮
    5. 连接成功后会显示设备识别信息

    💡 网口连接优势：速度更快、更稳定、支持远程控制

五、基本操作

    【APS-7100 (AC电源)】
    ┌─────────────────────────────────────────────────────────────┐
    │ 1. 设置电压      │ 输入电压值(0-350V) → 点击"设置"        │
    │ 2. 设置频率      │ 输入频率值(45-500Hz) → 点击"设置"      │
    │ 3. 设置电流限值  │ 输入电流值 → 点击"设置"                │
    │ 4. 切换量程      │ 下拉选择"低档"或"高档"                  │
    │ 5. 选择波形      │ 下拉选择"正弦波"、"方波"或"三角波"    │
    │ 6. 开启输出      │ 点击"输出 OFF"按钮变为"输出 ON"        │
    │ 7. 查看测量      │ 右侧实时显示电压、电流、功率、频率、PF │
    └─────────────────────────────────────────────────────────────┘

    【PSW250-4.5 (DC电源)】
    ┌─────────────────────────────────────────────────────────────┐
    │ 1. 设置电压      │ 输入电压值(0-72V) → 点击"设置"         │
    │ 2. 设置电流      │ 输入电流值(0-4.5A) → 点击"设置"        │
    │ 3. 开启输出      │ 点击"输出 OFF"按钮变为"输出 ON"        │
    │ 4. 查看测量      │ 右侧实时显示电压、电流、功率           │
    │                  │ （注意：DC电源无频率和功率因数）        │
    └─────────────────────────────────────────────────────────────┘

    【切换设备】
    如需切换到另一种设备：
    1. 点击"断开"按钮（⚠️ 必须先断开！）
    2. 从"设备类型"下拉框选择另一种设备
    3. 界面会自动调整
    4. 重新配置连接参数并连接

六、安全注意事项
    ⚠ 开启输出前务必确认所有参数设置正确
    ⚠ 确保负载正确连接后再开启输出
    ⚠ 不要在输出状态下插拔负载
    ⚠ 注意高压安全，避免触电
    ⚠ 监控设备温度，确保散热良好

七、常见问题

    Q1: 如何选择设备类型？
    A1: 根据你的设备选择：
        - APS-7100：交流电源，有频率调节功能
        - PSW250-4.5：直流电源，有恒压/恒流模式

    Q2: 可以在连接状态下切换设备吗？
    A2: 不可以！必须先点击"断开"，再切换设备类型

    Q3: 无法连接设备？
    A3: 串口：检查 ① 串口线连接 ② COM 端口号 ③ 波特率设置 ④ 设备电源
        网口：检查 ① IP 地址正确 ② ping 通设备 ③ 端口号正确 ④ 防火墙设置

    Q4: 测量值显示为 0？
    A4: 检查：① 输出是否开启 ② 负载是否连接 ③ 重新连接设备

    Q5: 某些功能按钮不见了？
    A5: 正常！不同设备显示不同功能：
        - AC电源：显示频率、波形、量程控件
        - DC电源：隐藏这些控件，只显示电压/电流

    Q6: 命令执行失败？
    A6: 检查：① SCPI 命令格式 ② 查询命令需以"?"结尾 ③ 参考编程手册
               ④ 确认命令适用于当前设备类型

    Q7: 如何选择串口还是网口？
    A7: 调试/短期测试用串口；长时间测试/远程控制/高速通讯用网口

八、SCPI 命令使用

    【方式 A：使用命令清单】⭐ 推荐新手
    1. 从"命令分类"下拉框选择类别
       - 系统命令、输出控制、电压设置等
       - AC电源：包含频率设置、波形设置等
       - DC电源：包含工作模式、保护功能等
    2. 在"命令清单"中选择需要的命令
    3. 查看"功能说明"了解命令作用
    4. 点击"使用此命令"按钮
    5. 点击"发送"执行命令
    
    💡 软件内置 70+ 常用命令（AC 40+, DC 30+），每个都有详细说明
    💡 命令库会根据设备类型自动加载
    
    【方式 B：直接输入命令】适合熟练用户
    在输入框直接输入 SCPI 命令并发送

    常用命令快速参考：
    
    【通用命令】
        *IDN?                  - 查询设备信息
        *RST                   - 重置设备
        SOUR:VOLT 220          - 设置电压 220V
        SOUR:VOLT?             - 查询电压设定值
    
    【APS7100 (AC) 专用】⚠ 注意命令格式
        OUTP:STAT ON           - 开启输出（不是 OUTP ON）
        OUTP:STAT OFF          - 关闭输出
        SOUR:FREQ 50           - 设置频率 50Hz
        SOUR:CURR:LIM:RMS 5    - 设置电流限值（不是 SOUR:CURR）
        MEAS:SCAL:VOLT?        - 测量电压（不是 MEAS:VOLT?）
        MEAS:SCAL:CURR?        - 测量电流
        MEAS:SCAL:POW:AC:REAL? - 测量有功功率
        MEAS:SCAL:POW:AC:PFAC? - 测量功率因数
    
    【PSW250 (DC) 专用】支持简写命令
        OUTP ON                - 开启输出
        OUTP OFF               - 关闭输出
        SOUR:CURR 2            - 设置电流
        MEAS:VOLT?             - 测量电压
        MEAS:CURR?             - 测量电流
        MEAS:POW?              - 测量功率

九、技术支持
    固纬官网：https://www.gwinstek.com/
    产品手册：从官网下载 APS-7000 系列用户手册及编程手册

================================================================================
版本：3.0  |  更新日期：2025-10-20
🎉 重大更新：
  • 支持双设备：APS-7100 (AC) 和 PSW250-4.5 (DC)
  • 智能界面自适应（根据设备类型显示/隐藏功能）
  • 独立的设备命令库（AC 40+ 命令，DC 30+ 命令）
  • SCPI 命令库系统
  • 网口（Ethernet）连接支持
  • 串口/网口动态切换

详细说明请查看《双设备支持说明.md》
================================================================================