# 双设备支持说明文档

## 📋 概述

**可编程电源测试工具 v3.0** 现已支持两种固纬可编程电源：
- **APS-7100** - AC 可编程电源（1kVA，交流）
- **PSW250-4.5** - DC 可编程电源（250W，直流）

## ✨ 新增功能

### 1. 设备类型选择

在连接设置区域的顶部，新增了"设备类型"下拉框：
```
设备类型: [APS-7100 (AC可编程电源) ▼]
          [PSW250-4.5 (DC可编程电源)  ]
```

### 2. 智能界面适配

软件会根据选择的设备类型自动显示/隐藏相关控件：

| 功能 | APS-7100 (AC) | PSW250-4.5 (DC) |
|------|---------------|-----------------|
| 电压设置 | ✅ 0-350V | ✅ 0-72V |
| 电流设置 | ✅ 限值保护 | ✅ 恒流输出 0-4.5A |
| **频率设置** | ✅ 45-500Hz | ❌ 不显示 |
| **波形选择** | ✅ 正弦/方波/三角 | ❌ 不显示 |
| **电压量程** | ✅ 低档/高档 | ❌ 不显示 |
| 功率测量 | ✅ | ✅ |
| **频率测量** | ✅ | ❌ 不显示 |
| **功率因数** | ✅ | ❌ 不显示 |

### 3. 专用命令库

每种设备都有独立的 SCPI 命令库：

**APS-7100 命令库**（40+ 条命令）
- 系统命令、输出控制、电压/频率/波形设置
- 测量命令（包含频率、功率因数）
- 保护功能、远程控制、高级功能

**PSW250-4.5 命令库**（30+ 条命令）
- 系统命令、输出控制、电压/电流设置
- 工作模式（恒压CV/恒流CC）
- 保护功能（过压/过流保护）
- 测量命令（电压、电流、功率）

## 🚀 使用方法

### 方式 1：默认使用 APS-7100

软件启动时默认选择 APS-7100（AC电源）。直接连接即可使用。

### 方式 2：切换到 PSW250-4.5

#### 步骤 1：选择设备类型
1. 在软件顶部"设备类型"下拉框中选择 `PSW250-4.5 (DC可编程电源)`
2. 界面会自动隐藏频率、波形等 AC 特有功能
3. 电压/电流范围会自动调整为 DC 电源的范围

#### 步骤 2：连接设备
1. 选择串口或网口连接方式
2. 配置连接参数（COM 端口或 IP 地址）
3. 点击"连接"按钮

#### 步骤 3：控制设备
- 设置电压（0-72V）
- 设置电流（0-4.5A）
- 开启输出
- 查看实时测量值

### 方式 3：在两种设备之间切换

⚠️ **重要**：必须先断开当前连接才能切换设备类型！

```
正确流程：
1. 点击"断开"按钮（如果已连接）
2. 从下拉框选择另一种设备
3. 配置新设备的连接参数
4. 点击"连接"

错误操作：
❌ 在连接状态下直接切换设备类型
   （软件会提示："请先断开当前连接，再切换设备类型"）
```

## 📊 设备对比

### APS-7100 (AC 可编程电源)

**基本参数：**
- 类型：单相交流电源
- 功率：1 kVA
- 电压：0-350 Vrms（分低档/高档）
- 频率：45-500 Hz（可调）
- 波形：正弦波、方波、三角波

**特点：**
- ✅ 可变频率输出
- ✅ 多种波形选择
- ✅ 功率因数测量
- ✅ 适合测试交流设备
- ✅ 瞬态测试功能

### PSW250-4.5 (DC 可编程电源)

**基本参数：**
- 类型：直流电源
- 功率：250 W
- 电压：0-72 V
- 电流：0-4.5 A
- 模式：恒压（CV）/ 恒流（CC）

**特点：**
- ✅ 恒压/恒流模式
- ✅ 过压/过流保护
- ✅ 高稳定性输出
- ✅ 适合测试直流设备
- ✅ 低纹波噪声

## 🔧 技术实现

### 架构设计

```
IPowerSupplyController (接口)
    ├── APS7100Controller (AC电源实现)
    └── PSW250Controller (DC电源实现)

设备类型枚举:
    - DeviceType.APS7100
    - DeviceType.PSW250

命令库:
    - ScpiCommandLibrary (APS-7100)
    - PSW250CommandLibrary (PSW250-4.5)
```

### 核心特性

1. **接口统一**：两种设备都实现相同的接口，保证基本功能一致
2. **功能降级**：DC 电源的 AC 特有功能会抛出 `NotSupportedException`
3. **界面自适应**：根据设备类型自动显示/隐藏相关控件
4. **命令库分离**：每种设备有独立的 SCPI 命令库

### 添加新设备

如需支持更多设备型号，只需：

1. 在 `DeviceType.cs` 中添加新枚举值
2. 创建新的控制器类实现 `IPowerSupplyController`
3. 创建对应的命令库
4. 在 `DeviceInfo` 中添加设备信息
5. 更新界面下拉框选项

## 📝 使用示例

### 示例 1：测试 AC 设备

```
1. 选择设备类型：APS-7100 (AC可编程电源)
2. 连接设备（串口或网口）
3. 设置参数：
   - 电压：220V
   - 频率：50Hz
   - 波形：正弦波
4. 开启输出
5. 观察测量值：
   - 实测电压：220.5V
   - 实测频率：50.01Hz
   - 功率因数：0.95
```

### 示例 2：测试 DC 设备

```
1. 选择设备类型：PSW250-4.5 (DC可编程电源)
2. 连接设备（串口或网口）
3. 设置参数：
   - 电压：12V
   - 电流：2A
   - 模式：恒压（默认）
4. 开启输出
5. 观察测量值：
   - 实测电压：12.05V
   - 实测电流：1.98A
   - 实测功率：23.8W
```

### 示例 3：设备间切换

```
场景：从测试 AC 设备切换到测试 DC 设备

1. 断开当前连接：
   点击"断开"按钮

2. 切换设备类型：
   设备类型下拉框选择：PSW250-4.5 (DC可编程电源)

3. 界面自动更新：
   - 频率控件消失
   - 波形控件消失
   - 电压范围变为 0-72V
   - 电流范围变为 0-4.5A

4. 连接新设备：
   配置串口/网口参数并连接

5. 开始测试
```

## ⚠️ 注意事项

### 1. 切换设备前必须断开连接
```
✅ 正确：
   断开 → 切换设备类型 → 连接新设备

❌ 错误：
   保持连接状态 → 尝试切换设备类型
   （系统会阻止此操作）
```

### 2. 参数范围限制
- **APS-7100**: 电压 0-350V，频率 45-500Hz
- **PSW250-4.5**: 电压 0-72V，电流 0-4.5A
- 切换设备时参数会自动重置为默认值

### 3. 命令兼容性
- 基本命令（*IDN?, OUTP, SOUR:VOLT 等）两种设备通用
- AC 特有命令（SOUR:FREQ, SOUR:WAVE）在 DC 设备上不可用
- DC 特有命令（FUNC:MODE, VOLT:PROT）在 AC 设备上不可用

### 4. 测量值差异
- AC 电源测量值为 **RMS（有效值）**
- DC 电源测量值为 **平均值**
- 功率因数仅 AC 电源有意义

## 🔍 故障排查

### 问题 1：切换设备后无法连接

**可能原因：**
- IP 地址或 COM 端口配置错误
- 设备未开机
- 串口被占用

**解决方案：**
1. 确认设备已开机
2. 检查连接参数（IP/COM/波特率）
3. 尝试刷新串口列表
4. 查看操作日志中的详细错误信息

### 问题 2：切换后界面显示异常

**可能原因：**
- 界面未正确刷新

**解决方案：**
1. 断开连接
2. 重新选择设备类型
3. 如问题持续，重启软件

### 问题 3：某些命令执行失败

**可能原因：**
- 使用了设备不支持的命令
- 例如在 PSW250 上使用频率设置命令

**解决方案：**
1. 检查命令库中的命令是否适用于当前设备
2. 查看命令说明中的设备支持情况
3. 参考设备编程手册

## 📚 相关文档

- `README.md` - 总体说明文档
- `SCPI命令库说明.txt` - APS-7100 命令库
- `网口连接配置指南.txt` - 网络连接配置
- `使用指南.txt` - 快速使用指南

## 🎯 版本信息

**版本**: v3.0  
**发布日期**: 2025-10-20  
**主要更新**:
- ✨ 新增 PSW250-4.5 DC 电源支持
- ✨ 双设备切换功能
- ✨ 智能界面自适应
- ✨ 独立的设备命令库
- 🎨 优化界面布局
- 📝 完善文档说明

**向后兼容**: ✅  
原有 APS-7100 的所有功能保持不变，默认选择 APS-7100。

---

## 💡 常见问题 FAQ

**Q1: 如何知道当前连接的是哪种设备？**  
A1: 查看窗口标题栏和"设备类型"下拉框，连接成功后日志会显示设备识别信息。

**Q2: 可以同时连接两种设备吗？**  
A2: 不可以。软件同一时间只能连接一台设备。需要切换设备时，必须先断开当前连接。

**Q3: 命令库中的命令都能用吗？**  
A3: 命令库会根据设备类型自动加载。APS-7100 显示 AC 命令，PSW250-4.5 显示 DC 命令。

**Q4: 切换设备后之前的设置会保留吗？**  
A4: 不会。切换设备类型后，所有参数会重置为新设备的默认值。

**Q5: 如何添加更多设备型号？**  
A5: 参考本文档"技术实现 - 添加新设备"章节，或联系开发者。

---

**技术支持**: 查看项目文档或固纬官网  
**官网**: https://www.gwinstek.com/