ngscopeclient × Sipeed SLogic 上手指南

让 Sipeed SLogic 系列逻辑分析仪在 ngscopeclient 上跑起来——从下载到看见第一条波形

这是什么

Sipeed SLogic 是一系列高性价比 USB 逻辑分析仪硬件。本项目把它接到了 ngscopeclient——一个开源、跨平台、基于 GPU 加速的示波器/分析仪 GUI——上面，让你能用 ngscopeclient 强大的波形显示、协议解码、自动化测试能力来操作 SLogic 硬件。

ngscopeclient 现为单个可执行程序：下载即运行，连接、采集模式与参数都在 UI 中配置，无需单独的后台程序或命令行参数。

📷 系列产品展示

下载

多平台上位机从 GitHub Release 获取最新版，下载站为备份镜像：

• GitHub Release（推荐，最新）：https://github.com/sipeed/SLogic/releases/latest
• 下载站（备份镜像）：https://dl.sipeed.com/shareURL/SLogic/ngscopeclient

单个绿色可执行程序，零依赖、免安装，放到任意目录皆可。

第一次跑起来

Windows

步骤 1：解压 ngscopeclient-*-win64.zip 到任意目录（保持目录结构）。

步骤 2：插上 SLogic 硬件——无需安装任何驱动。SLogic 默认就是 WinUSB 设备，Windows 即插即用。

步骤 3：双击 ngscopeclient.exe 启动。

系统要求：Windows 10 1903 或更新（自带 UCRT 运行时）。不需要装 Visual C++ Redistributable。

Linux

步骤 1：给 AppImage 加可执行权限

chmod +x ngscopeclient-*-x86_64.AppImage

步骤 2：装 udev 规则，让普通用户能访问 SLogic（只需做一次）

sudo cp 60-sigrok-slogic.rules /etc/udev/rules.d/
sudo udevadm control --reload && sudo udevadm trigger

SUBSYSTEM!="usb|usb_device", GOTO="sipeed_rules_end"
ACTION!="add", GOTO="sipeed_rules_end"
ATTRS{idVendor}=="359f", MODE="0666", GROUP="uucp", TAG+="uaccess", ENV{ID_MM_DEVICE_IGNORE}="1"
LABEL="sipeed_rules_end"

步骤 3：运行

./ngscopeclient-*-x86_64.AppImage

macOS

下载 macOS 版，打开即运行；若首次被系统阻止，在「系统设置 → 隐私与安全性」放行即可。

在 ngscopeclient 中连接

进入 ngscopeclient 主界面后，通过菜单 File → Add → Oscilloscope 添加并选择 SLogic 设备。连接成功后，通道面板里会出现对应数量的通道（如 SLogic16U3 16 路、SLogic32U3 32 路）。

🚧 具体驱动/选项以当前版本 UI 为准。

用法

数字逻辑分析（默认模式）

每个通道是一路独立的数字电平（高/低），这是最常用的工作模式，也是打开程序后的默认模式。

基本流程：

1. 选通道：在通道面板勾选你要采的通道。
2. 设采样率：从下拉里选，例如 200 MS/s。
3. 设采样深度：每次采集存多少点。一般 1 MS（即 100 万点）够用。
4. 配触发：在 Trigger 面板选触发源通道、上升沿/下降沿/任意沿。
5. 运行：
   • Run——连续采集，刷新显示
   • Single——采一帧后停下来仔细看
   • Force——不等待触发的采一帧

📷 数字波形图：对比模拟波形图

触发于 D9 的下降沿

进一步：协议解码

把数字波形拖进 Protocol Analyzer 就能解 UART、I²C、SPI、CAN 等协议——这是 ngscopeclient 比传统 sigrok GUI 强的地方。

📷 SPI解码参考图：数字波形和协议解码结果。

把硬件当采样示波器用（模拟模式）

这是本项目独有的能力之一：把 SLogic 的并行数字采样当作 ADC 数据流，让一台 SLogic 同时兼任逻辑分析仪 + 8-bit 采样示波器。在 ngscopeclient 的 UI 中开启模拟模式即可。

效果：原本的 D0–D7 / D8–D15 会被合并成 2 路 8-bit 模拟通道（A0、A1），如还有 D16–D23 / D24–D31 则一共合并成 4 路 8-bit 模拟通道（A0、A1、A2、A3），可以直接在 ngscopeclient 里像看模拟示波器一样看波形——量程、坐标轴、自动测量、FFT 等模拟示波器特性都自动可用。

🚧 具体在 UI 中开启模拟模式的步骤以当前版本为准。

📷 模拟波形图：对比数字波形图

常见问题

Linux 下报 "Permission denied" 或 "LIBUSB_ERROR_ACCESS"

USB 权限没配好。回到上面 Linux 一节装 udev 规则，然后拔插一次设备。

ngscopeclient 连上了但通道列表是空的

没识别到设备。检查硬件是否插好、设备管理器（Windows）/ lsusb（Linux）能否看到 SLogic；Linux 上确认已装 udev 规则并拔插过设备。

想换其它厂商或型号的逻辑分析仪能用吗

当前分发版本只对 Sipeed SLogic 系列做了适配，其它型号暂未添加，后续会考虑。

反馈

遇到 Bug、想要新功能、或使用上有任何疑问，请发邮件到 support@sipeed.com。

发邮件时请附上：

• ngscopeclient 版本（菜单 Help → About）
• 硬件型号 + 固件版本
• 操作系统版本（Windows / Linux / macOS）

📷 项目家族合照： SLogic 硬件实物 + ngscopeclient 屏幕画面 + 终端日志，三件套同屏。