# pico3000

**Repository Path**: osr-tech/pico3000

## Basic Information

- **Project Name**: pico3000
- **Description**: pico3000示波器python控制包
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2024-08-21
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pico3000

使用纯 Python 脚本控制 PicoSDK `ps3000a` 驱动支持的 PicoScope 3000 系列示波器，支持 Windows、Linux 和 macOS arm64 平台。

## CLI

安装包后会自动安装 `pico3000` 命令行工具：

```sh
pip install .
pico3000 --help
pico3000 list
pico3000 capture --channel A --a-range 2V --sample-rate-mhz 125 --samples 100000 --trigger-source A --trigger-threshold-mv 500 --output capture.png
```

上面的命令是标准命令行调用，不依赖 PowerShell；在 Windows PowerShell/cmd、Linux sh/bash、macOS zsh/bash 中都可以使用。当前包内置并加载 Windows、Linux、macOS arm64 的 PicoSDK 动态库；macOS Intel 暂未作为内置目标平台。

常用子命令：

- `pico3000 list`：枚举已连接设备。
- `pico3000 info`：查看支持的垂直范围和 timebase 采样率换算。
- `pico3000 plan`：根据预期电压、采样窗口和频率建议垂直范围、采样率和样本数。
- `pico3000 capture`：执行一次触发块采集，支持 A-D 模拟通道参数；双通道机型只使用 A/B，四通道机型可使用 C/D。默认输出 PNG 波形图，支持 `--dry-run` 先输出配置供确认；如需原始数据可加 `--data-output capture.npz`。

AI agent 可使用项目内的 `skills/pico3000-oscilloscope` skill 来规划和调用示波器，并通过输出的 PNG 图片判断采集效果。

## 版权与许可声明
本项目仅用于学习科研使用，如果您需要将本项目代码用于商业产品，请联系我们获取**商业许可证**。