# SPD3303X DC Power Supply MCP Server

基于 Siglent SPD3303X Quick Start Guide 及公开 SCPI 文档编写的 MCP Server，通过 TCP/IP (SCPI 端口 **5025**) 远程控制 SPD3303X 系列可编程直流电源。

> ⚠️ 注意：SPD3303X 使用端口 **5025**（不是 5024！）

**适用型号**：SPD3303X、SPD3303X-E、SPD3000X 系列

## 通道规格

| 通道 | 电压范围 | 电流范围 | 说明 |
|------|---------|---------|------|
| CH1 | 0–32V | 0–3.2A | 可调，支持定时器 |
| CH2 | 0–32V | 0–3.2A | 可调，支持定时器 |
| CH3 | 2.5/3.3/5V | 3.2A 固定 | 可选电压档位 |

## 快速开始

```bash
pip install -r requirements.txt
```

## 可用工具（22 个）

### 连接
| 工具 | 说明 |
|------|------|
| `connect` | 连接电源（端口 5025） |
| `disconnect` | 断开 |
| `send_command` | 发送任意 SCPI 命令 |
| `get_id` | 设备 ID |

### 输出控制
| 工具 | 说明 |
|------|------|
| `set_output` | 单通道 ON/OFF |
| `set_all_outputs` | 全部通道同时 ON/OFF |
| `configure_channel` | 设置电压/电流 |
| `get_channel` | 读取设定值+实测电压/电流/功率 |
| `measure` | 读取实测电压/电流/功率 |

### 通道 / 跟踪模式
| 工具 | 说明 |
|------|------|
| `select_channel` | 选择当前通道 |
| `set_track_mode` | 0=独立 / 1=串联 / 2=并联 |
| `get_track_mode` | 读取跟踪模式 |

### 定时器
| 工具 | 说明 |
|------|------|
| `configure_timer` | 设置定时组（V/A/时长）+启动停止 |
| `get_timer` | 读取定时组参数 |

### 显示 / 面板
| 工具 | 说明 |
|------|------|
| `set_waveform_display` | 波形显示 ON/OFF |
| `lock_panel` | 锁定/解锁前面板 |

### 存储 / 网络 / 状态
| 工具 | 说明 |
|------|------|
| `save_state` / `recall_state` | 保存/调用设置（5 个槽位） |
| `configure_network` / `get_network` | 网络设置（IP/DHCP/网关） |
| `get_status` | 系统状态+错误 |
| `quick_snapshot` | 一键概览三通道 |

## 使用示例

```
> connect host=192.168.1.103
Connected to 192.168.1.103:5025

> configure_channel channel=CH1 voltage=5.0 current=1.0
CH1 configured:
  Voltage: 5.0 V
  Current Limit: 1.0 A

> set_output channel=CH1 state=true
CH1 output: ON

> measure channel=CH1
CH1: 5.001 V, 0.234 A, 1.170 W

> quick_snapshot
=== SPD3303X Quick Snapshot ===
Device: Siglent,SPD3303X,...
Track Mode: 0 (Independent)
  CH1: Set=5.000V/1.000A | Meas=5.001V, 0.234A, 1.170W
  CH2: Set=3.300V/0.500A | Meas=3.301V, 0.000A, 0.000W
  CH3: Set=3.300V | Meas=3.301V, 0.000A, 0.000W
```

## SCPI 命令来源

由于 SPD3303X 没有独立的编程手册，命令集参考以下来源：
- SPD3303X Quick Start Guide Chapter 3 (Remote Control)
- [Siglent SPD Programming Tips](https://siglentna.com/operating-tip/spd-local-front-panel-lock-out-scpi-commands/)
- [Python API reference](https://github.com/Swallowtail-Electronics/SPD3303X-Python-API)