2026-10-02

编辑本页

title: SLogic32U3 用户指南
keywords: SLogic32U3, User Guide, PulseView, sigrok-cli, ngscopeclient, trigger, decoder, 信号完整性
update:

date: 2026-09-30
version: v0.1
author: Sipeed
content:
- 初始化用户指南骨架（章节 + 已知硬件事实 + 占位/TODO）

SLogic32U3 用户指南

本指南是 SLogic32U3 的功能全参考，涵盖硬件、三套上位机、触发、协议解码与信号完整性。想快速上手请先看快速上手。

硬件详解

接口总览

[!NOTE]
📷 配图待补（TODO）：正面 / 背面接口标注图 —— 需标出 4 组 Mini-HDMI、USB-C、MODE 小孔、ACT 指示灯。
文件：assets/MISC/front.jpg、assets/MISC/rear.jpg｜要求：正视角、≥1000px 宽、接口周围留出标注空间。

4 × Mini-HDMI 通道组：32 通道分为 4 组，每组 8 通道（CH0–7 / CH8–15 / CH16–23 / CH24–31），经同轴屏蔽探头线引出。每个 Mini-HDMI（HDMI Type-C 1.4）口含 8 路数据 + GND + VCC(+5V) + CK；4 组的 GND / VCC / CK 为同源共用（并非各组独立）。
USB-C：USB3.2 Gen2，需使用具备 USB3 能力的线缆与主机端口。
MODE 按键：切换 APP（逻辑分析仪）/ DFU（固件升级）模式，详见 MODE 按键与 DFU 模式。
ACT 指示灯：见指示灯小节。
CK：100MHz LVCMOS33 固定时钟输出（不可调、仅输出）。

通道与探头线

[!NOTE]
📷 配图待补（TODO）：Mini-HDMI 同轴探头线 + 测试夹接线细节 —— 需体现每组 8 路的八色配色。
文件：assets/MISC/probe.jpg｜要求：特写、色彩还原准确。

32 通道分 4 组，每组 8 通道合并到 1 个 Mini-HDMI 接口输入。
通道配色：每组 8 通道按 红 / 橙 / 黄 / 绿 / 棕 / 蓝 / 白 / 灰 八色循环标识。
探头线：前端为同轴电缆子板（每板 8 通道 / 1 个 Mini-HDMI）。每路信号走同轴——芯线=信号（数字输入阻抗约 100kΩ），屏蔽层=信号地。
VCC：Mini-HDMI 提供 +5V 输出（4 组同源）。

可选 ADC 示波器模组

SLogic32U3 可选配 4 通道 ADC 模组，把对应管脚采样作为 8-bit 模拟信号上传，让同一台设备兼作采样示波器。

通道数：4
分辨率：8-bit
采样率：100 MSa/s
模拟带宽：20 MHz
安全输入电压：±15V
输入阻抗：由探头决定
启用方式：在 ngscopeclient（单二进制）的 UI 中配置；32U3 会把 D0–7 / D8–15 / D16–23 / D24–31 合并为 4 路 8-bit 模拟通道 A0–A3。详见 ngscopeclient。(具体 UI 步骤待补)

[!NOTE]
📷 配图待补（TODO）：可选 ADC 模组实物照 + 示波器模式波形截图。
文件：assets/DCIM/adc-module.jpg（实物照，交同事产出）、assets/Screenshots/scope-mode.png（软件截图，实机截取）。

指示灯

灯语与 SLogic16U3 一致。指示灯为 3 色 RGB：蓝=电源，绿=USB LINK，红=运行状态。

[!NOTE]
📷 配图待补（TODO）：ACT 指示灯位置与状态 —— 可配正常连接 / 采集中 / DFU 几张。
文件：assets/MISC/act-led.jpg｜要求：暗环境拍摄以突出灯色。

状态	颜色	备注
正常连接	青色（蓝+绿）	已上电且 USB 已连接
数据传输	青+红快闪	采集中
DFU 模式	青+红慢闪	固件升级模式
USB 连接失败	只亮蓝	常见于非 USB3 线材/口
Flash 加载异常	只亮红	线材压降过大 / 硬件问题

MODE 按键与 DFU 模式

MODE 按键为隐藏式小孔按键（同 16U3，需用卡针/SIM 卡针捅入按下），用于在 APP（SLogic 逻辑分析仪）与 DFU（固件升级）模式之间切换。上电默认进入 APP 模式；按 MODE 切到 DFU 模式后即可刷写固件（见固件更新）。

切到 DFU 模式时指示灯为红灯慢闪（同 16U3）。

固件更新

固件更新工具：slogic16u3-tools releases（与 SLogic16U3 共用工具链）。SLogic32U3 固件尚未发布，正式发布后将于下载站提供。

进入 DFU 模式（按 MODE，等红灯慢闪）。
确认出现 "SLogic DFU" 设备。
用 slogic16u3-tools 的刷写工具刷入固件（命令形如 spi_flash_xxx <固件路径>）。

探测与信号完整性

本节是高速逻辑分析仪的重点，建议充实为教学内容（参考 Saleae 的探针/接地教学）。

接地是关键：低频、少通道可共用一根地；随频率/通道数升高，地线自感会在地线上产生压降、劣化测量——高速时每根信号线就近配一根地线。
地线绝不可接到信号线上（可能损坏设备）。
阈值电压：按 DUT 逻辑电平设置（如 3.3V 逻辑设 ~1.6V）。不确定时先用万用表/示波器测量。
输入范围 0~10V，超范围前请确认硬件限制。
Mini-HDMI 屏蔽线相比杜邦线更适合高速信号。

🚧 TODO(配图)：接地对比示意（好/坏接地下的波形）。建议：assets/MISC/grounding-good-bad.png

安全与注意事项

VCC：Mini-HDMI 提供 +5V 输出（4 组同源），切勿与 GND 短接。
与市电供电电脑配合时，探头地会与电脑地相连，请仅连接等电位接地点，切勿接热地。

驱动与安装

Windows：免驱（WinUSB）

SLogic32U3 默认即为 WinUSB 设备，Windows 10/11 即插即用，无需 Zadig、无需手动安装驱动——这是相比部分 sigrok 生态竞品的体验优势。插上设备后直接运行 PulseView 或 ngscopeclient 即可。

PulseView 原生 Windows 版无软件层面的带宽/采样率上限，实际可达速率仅取决于物理机性能（不同于 SLogic16U3 早期 Windows 原生 exe 的降速限制）。

Linux udev 规则

普通用户默认无权限访问 USB，需安装一次 udev 规则（设备 VID 为 359f）：

sudo tee /etc/udev/rules.d/60-sipeed.rules <<'EOF'
SUBSYSTEM!="usb|usb_device", GOTO="sipeed_rules_end"
ACTION!="add", GOTO="sipeed_rules_end"
ATTRS{idVendor}=="359f", MODE="0666", GROUP="plugdev", TAG+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
LABEL="sipeed_rules_end"
EOF
sudo udevadm control --reload && sudo udevadm trigger

Arch 系统将 GROUP="plugdev" 改为 GROUP="uucp"。装完后拔插一次设备使规则生效。

macOS

支持 macOS。PulseView、ngscopeclient 与 sigrok-cli 均提供 macOS 版；若首次运行被系统阻止，在「系统设置 → 隐私与安全性」中放行即可。

软件使用 — PulseView (sigrok)

连接与设备检测

最佳做法：先把设备连到 USB3 口，再启动 PulseView，让软件启动时自动检测。若已在运行，用 "Connect to Device" → 选驱动 → Scan → 选中设备。

🚧 TODO(配图)：连接对话框截图。建议：assets/Screenshots/pv-connect.png

Stream 采集与采样率组合

SLogic32U3 采用 Stream（流式）模式：数据实时回传上位机，采集时长理论不限（受磁盘容量限制），并由板载 2Gbit（256MB）DDR 作弹性缓存平滑 USB 传输。稳定带宽达 6.4Gbps（800MB/s）。

各通道数下的最高采样率（受带宽或最高采样时钟约束）：

使能通道数	最高采样率	数据率
4ch	1400 MHz	5.6 Gbps
8ch	800 MHz	6.4 Gbps
16ch	400 MHz	6.4 Gbps
32ch	200 MHz	6.4 Gbps

8 / 16 / 32ch 均跑满 6.4Gbps（800MB/s）带宽上限；4ch 受最高采样时钟 1400MHz 约束（5.6Gbps）。使能通道越少 → 可用采样率越高，因此只启用本次采集需要的通道。

vs USB3.0 竞品：DreamSourceLab DSLogic U3Pro32（USB3.0）Stream 模式 16ch 约 125MHz、32ch 约 50MHz（据其公开 Datasheet）；SLogic32U3 对应为 16ch@400MHz、32ch@200MHz，Stream 采样率约 3~4×。

采样率、深度与通道的相互制约

使能通道越多，可用采样率越低（受 USB 吞吐限制）。
采样率怎么选（决策式）：经验上取信号最高频率的 ≥10 倍；采样率过低会错过边沿，过高则可能采到毛刺。
采样率 × 深度决定内存/磁盘占用，长采集前先确认磁盘空间。

🚧 TODO(配图)：采样率/通道预设面板；采样率过高/过低的波形对比。建议：assets/Screenshots/samplerate-presets.png、assets/Screenshots/samplerate-compare.png

触发

SLogic32U3 支持多通道、多边沿组合触发（在 PulseView / sigrok-cli 中配置）：可对多个通道分别设定上升沿 / 下降沿 / 任意边沿 / 电平条件并组合使用。

⚠️ ngscopeclient 集成当前仅支持单通道、单边沿触发——需要多通道 / 多边沿组合时请改用 PulseView 或 sigrok-cli。

预触发 (pre-trigger)：支持，可在 UI 中设置触发点之前保留的采样量。

🚧 TODO：为常见总线各配 1~2 个触发实例（如 UART 起始位、I²C 起始条件）。

🚧 TODO(配图)：触发设置面板。建议：assets/Screenshots/trigger.png

浏览与光标测量

缩放：滚轮；平移：拖动或 Shift+滚动；垂直平移：Ctrl+滚动。
用光标测量时间差，换算波特率 / 脉宽 / 事件间隔（Shift+拖动创建测量光标）。

🚧 TODO(配图)：光标测量示例。建议：assets/Screenshots/cursors.png

协议解码

打开 Decoder 面板，选择协议（I2C/SPI/UART/CAN/SDIO…）。
配置引脚映射、字节序、时钟极性/相位、波特率/时钟速率。
解码帧标注在波形上，可点击查看详情；支持 decoder 堆叠（stack）。

常见解码失败原因：阈值设置不当、采样率不足、引脚映射错误。

🚧 TODO：为常用协议各补一个 32U3 实测示例（接线 + 触发 + 解码结果截图）。
建议每协议一小节：UART / I2C / SPI / CAN / SDIO。

文件操作

保存会话：保存样本、通道配置、触发与 decoder 状态。
导出：CSV / VCD 等；导入已有 .sr 波形。

软件使用 — ngscopeclient

SLogic32U3 是 ngscopeclient 分发版的重点支持型号。完整安装与连接见 ngscopeclient 上手指南。

本节仅补 32U3 特有（完整安装/连接见共享页）：

单二进制、全 UI 配置：ngscopeclient 现为单个可执行程序，直接运行即可；连接、采集模式与参数都在 UI 中设置，无需单独的后台程序或命令行参数。
连接设备：在 ngscopeclient 界面中添加/选择 SLogic 设备，连上后通道面板出现 32 路通道。
Filter Graph：ngscopeclient 把协议解码/数学/测量统一为 Filter 节点，串成处理链。
ADC 模拟模式：在 UI 中启用后，把数字管脚合并为 4 路 8-bit 模拟通道 A0–A3，像采样示波器一样观测（量程/坐标轴/FFT 等自动可用）。需硬件支持外接 ADC 模块。

🚧 TODO：补充 ngscopeclient 单二进制版的实际连接步骤与在 UI 中启用模拟模式的具体操作。共享页 ngscopeclient 的现有内容仍是旧的 sigrok-bridge 架构，需同步更新。

🚧 TODO(配图)：ngscopeclient 里 32U3 的波形/解码。建议：assets/Screenshots/ngscope-32u3.png

命令行 — sigrok-cli

用于自动化、CI、无头采集。

Sipeed 按平台预分发 SLogic 版 sigrok-cli：sigrok-cli-SLogic-xxxx.{AppImage,exe,dmg}（GitHub Release，下载站为备份镜像）。libsigrok 驱动名为 sipeed-slogic-analyzer。

sigrok-cli --scan                                   # 扫描设备
sigrok-cli -d sipeed-slogic-analyzer --show         # 查看设备能力
sigrok-cli -d sipeed-slogic-analyzer \              # 采集：只启用 D0，10MHz 采 500k 样本
  --config samplerate=10m -C D0 \
  --samples 500k -o capture.sr
sigrok-cli -i capture.sr -P uart:rx=D0:baudrate=115200 -A uart   # 解码

采样时间(秒) = 样本数 ÷ 采样率。想让 AI Agent 代跑扫描/采集/解码，见 SLogic 接入 AI Agent。
🚧 TODO：补一个完整的端到端脚本示例（扫描→采集→解码→导出 CSV），并核对驱动名在发布版 sigrok-cli 中的确切拼写。

接入 AI Agent

配合 sigrok-cli-slogic-plugin，无需学 PulseView，把通道与协议目标告诉 Agent 即可自动扫描/采集/解码。完整教程见 SLogic 接入 AI Agent。

真实约束与已知问题

学习 sigrok 的 "Known Issues" 文化——如实标注限制，建立可信度。

🚧 TODO：随测试完善本节。候选条目：

采样率 × 通道数 × 深度的组合限制（哪些组合不可用）。
触发在 Stream 模式下的限制。
ADC 模组与数字采集是否可同时使用。

快速上手

ngscopeclient

wiki