# Tektronix_TBS1102

**Repository Path**: gumpyang/tektronix_tbs1102

## Basic Information

- **Project Name**: Tektronix_TBS1102
- **Description**: 创建示波器 Tektronix TBS1102 的接入工作
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-16
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tektronix_TBS1102

#### 介绍

示波器 Tektronix TBS1102 的 PC 接入:通过 USB(USBTMC 协议)实时读取波形与
自动测量值,提供**命令行**和**图形界面**两种使用方式,数据可逐帧记录为 CSV。
已在 Windows 11 + NI-VISA + Python(uv)环境实测通过(固件 v26.02)。

#### 软件架构

```
tektronix_tbs1102/
├── skills/tbs1102/      ZCode 技能(随仓库分发,让 AI 助手按手册自动操作)
├── windows/             Windows 平台代码(uv 项目)
│   ├── core/            共享驱动包:SCPI 封装、波形换算、CSV 输出(GUI/CLI 共用)
│   ├── cli/             命令行:tbs1102-test(自检)/ tbs1102-live(实时监控)
│   └── gui/             图形界面:tbs1102-gui(tkinter 实时监控面板)
└── raspberry/           树莓派无人值守采集(uv 项目,自带驱动副本)
    ├── core/ cli/       tbs1102-agent(守护采集)/ check / status / snapshot
    ├── web/             tbs1102-web: 局域网只读监测面板(Flask,端口 8080)
    └── deploy/          systemd 服务 + udev 规则 + 一键部署脚本
```

- 数据能力:每帧 2500 点双通道波形 + 每通道 4 项测量(频率/峰峰值/周期/交流有效值),逐帧写入 CSV
- 驱动方案:Windows 用 NI-VISA(含 USBTMC 驱动),树莓派用 pyvisa-py 纯 Python 后端(无 NI-VISA)

#### 树莓派无人值守

示波器 USB 线直插树莓派,`tbs1102-agent` 以 systemd 服务 7×24 常驻:连续测量记录 +
波形抽样快照 + 报警留痕;断电自恢复、USB 断链自重连;实时数据写内存盘、定时批量归档,
保 TF 卡寿命。附带 `tbs1102-web` 局域网面板,浏览器打开 `http://<树莓派IP>:8080/`
即可看实时读数、波形、历史趋势与告警。部署与使用见 [raspberry/README.md](raspberry/README.md)。

#### 安装教程

1. 安装 uv(Python 环境管理):`winget install astral-sh.uv`
2. 安装 NI-VISA 驱动(解决设备管理器代码 28):`winget install ni.ni-visa`,装完重新插拔 USB 线
3. 克隆仓库并安装依赖:

```bash
git clone git@gitee.com:gumpyang/tektronix_tbs1102.git
cd tektronix_tbs1102/windows
uv sync
```

从零开始的完整步骤(含驱动排障)见 [windows/安装手册.md](windows/安装手册.md)。

#### 使用说明

```bash
uv run tbs1102-test    # 连接自检(*IDN? 与档位读取)
uv run tbs1102-live    # 命令行实时监控:波形 + 测量 + CSV 记录
uv run tbs1102-gui     # 图形界面监控面板
```

全部参数、输出文件格式与故障排查见 [windows/命令行使用手册.md](windows/命令行使用手册.md),
项目概览见 [windows/README.md](windows/README.md)。

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request