mirror of
https://github.com/sipeed/sipeed_wiki.git
synced 2026-09-11 00:22:49 -05:00
Add images and update User Guide for Slogic16U3
- Added multiple JPEG images to the documentation for the Slogic16U3 logic analyzer. - Updated the User Guide in Chinese, including a comprehensive revision history, detailed specifications, hardware connections, software installation instructions, usage guidelines, and common troubleshooting questions. - Enhanced visual content with screenshots to aid user understanding and experience.
This commit is contained in:
taorye
@@ -1,3 +1,278 @@
|
||||
# Slogic16U3 User Guide
|
||||
|
||||
👷♂️ We're building this guide for you — thanks for your patience!
|
||||
👷♂️ This guide is under active development — thank you for your patience!
|
||||
|
||||
---
|
||||
|
||||
## Revision History
|
||||
|
||||
| Date | Version | Author | Description |
|
||||
|------------|---------|-------------|-----------------------|
|
||||
| 2024-09-23 | v0.1 | Sipeed Team | Initial draft |
|
||||
|
||||
---
|
||||
|
||||
## Table of Contents
|
||||
|
||||
1. [Overview](#overview)
|
||||
2. [Specifications](#specifications)
|
||||
3. [Hardware Connection](#hardware-connection)
|
||||
4. [Software Installation](#software-installation)
|
||||
5. [Software Usage](#software-usage)
|
||||
6. [Build Software from Source](#build-software-from-source)
|
||||
7. [Firmware Update](#firmware-update)
|
||||
8. [FAQ](#faq)
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
Slogic16U3 is a high-performance logic analyzer for digital signal debugging and analysis.
|
||||
|
||||
<div style="display: flex; flex-wrap: wrap; gap: 10px; width: 100%;">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07963.JPG" style="width: 100%;">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07962.JPG" style="width: calc(50% - 5px);">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07961.JPG" style="width: calc(50% - 5px);">
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Specifications
|
||||
|
||||
- **Channels:** 16
|
||||
- **Max Sampling Rate:** 800 MHz
|
||||
- **Memory Depth:** Unlimited
|
||||
- **Interface:** USB 3.0 (5 Gbps)
|
||||
- **Power Supply:** USB powered (5V 900mA)
|
||||
- **Dimensions:** 150 × 100 × 30 mm
|
||||
|
||||
---
|
||||
|
||||
## Hardware Connection
|
||||
|
||||
- **USB-C to C** or **USB-A to C** cable:
|
||||
1. PC USB-A → USB-A/C to USB-C → SLogic
|
||||
2. PC USB-C → USB-C to USB-C → SLogic
|
||||
- **Indicators:** Multi-color (see FAQ)
|
||||
- **Accessories:** Standard Dupont wires, high-speed shielded wires
|
||||
|
||||
---
|
||||
|
||||
## Software
|
||||
|
||||
### Supported OS and Tested Platforms
|
||||
|
||||
| OS / Platform | Supported | Example Platform |
|
||||
|--------------------|-----------|---------------------------|
|
||||
| Windows (x86_64) | Yes | Ultra 5 125H |
|
||||
| Linux (x86_64) | Yes | 8th Gen Core i5+ |
|
||||
| Linux (aarch64) | Yes | RPI5 |
|
||||
| macOS (aarch64) | Yes | Apple Silicon M4 |
|
||||
|
||||
### Supported Protocols
|
||||
|
||||
A wide range of protocols are supported, including:
|
||||
AC '97, I²C, SPI, UART, CAN, JTAG, 1-Wire, PWM, USB, and many more.
|
||||
*For the latest list, refer to the software's decoder selection panel.*
|
||||
|
||||
### Installation
|
||||
|
||||
#### Windows
|
||||
|
||||
- Extract the portable archive and double-click `pulseview.exe` to launch.
|
||||
|
||||
|
||||
|
||||
- To enable debug mode, run in terminal:
|
||||
```cmd
|
||||
pulseview-debug.exe -l5
|
||||
```
|
||||
|
||||
|
||||
|
||||
#### Linux
|
||||
|
||||
```bash
|
||||
chmod +x Pulseview.appimage
|
||||
./Pulseview.appimage
|
||||
# ./Pulseview.appimage -l5 # enable debug mode
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
#### macOS
|
||||
|
||||
- Download and open `Pulseview.dmg` to install.
|
||||
|
||||
|
||||
|
||||
|
||||
**Related Links:**
|
||||
Taobao, AliExpress, MaixHub
|
||||
Email: support@sipeed.com
|
||||
|
||||
---
|
||||
|
||||
## Software Usage
|
||||
|
||||
- The interface and workflow are similar to DSView.
|
||||
- Configure channels, sample rate, sample points/time, and other parameters as needed.
|
||||
- Use the software to trigger, acquire, browse, measure, decode protocols, and manage files.
|
||||
|
||||
### Changing the Sample Depth
|
||||
|
||||
- The sample depth determines how many data points are captured per acquisition.
|
||||
- You can set the sample depth in the main control panel, typically as either a number of points.
|
||||
- Higher sample depth allows capturing longer or more detailed signal traces, but requires more memory and may take longer to transfer.
|
||||
- If you only need to capture short events, reduce the sample depth for faster operation.
|
||||
- Adjust the sample depth before starting acquisition to fit your analysis needs.
|
||||
- **Sample depth is unlimited if you have a large enough disk; data can be streamed directly to storage.**
|
||||
|
||||
|
||||
|
||||
### Changing the Sample Rate
|
||||
|
||||
- **Max sample rate:** 800 MHz (depends on active channels)
|
||||
- **16 channels:** up to 200 MHz
|
||||
- **8 channels:** up to 400 MHz
|
||||
- **4 channels:** up to 800 MHz
|
||||
- Set the sample rate in the main control panel.
|
||||
- If higher rates are unavailable, disable unused channels.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Selecting Active Channels
|
||||
|
||||
- Choose between **16**, **8**, or **4** channel configurations.
|
||||
- Enable/disable channels in the configuration area.
|
||||
- Fewer active channels allow higher sample rates.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Adjusting Voltage Threshold
|
||||
|
||||
- Set threshold from **0.1V to 6.0V** in **0.1V steps**.
|
||||
- Adjust in the channel/device configuration panel.
|
||||
- Match threshold to your logic level (e.g., 1.0V for 3.3V CMOS).
|
||||
- Apply changes before acquisition.
|
||||
|
||||
|
||||
|
||||
|
||||
Tip: For 3.3V CMOS/TTL, set threshold to ~1.0V (30% of 3.3V).
|
||||
|
||||
### Edge Trigger
|
||||
|
||||
- Configure edge trigger to start capture on a specific signal transition.
|
||||
- In the trigger panel, select channel and trigger type (rising, falling, or both).
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Build Software from Source
|
||||
|
||||
The software is open source.
|
||||
|
||||
- [Sipeed's libsigrok GitHub Repository](https://github.com/sipeed/libsigrok/tree/slogic-dev)
|
||||
|
||||
**Recommended:** Use [sigrok-util](https://github.com/sigrokproject/sigrok-util) build scripts for a simple, cross-platform experience.
|
||||
|
||||
**Steps:**
|
||||
1. Clone sigrok-util and follow its README for dependencies.
|
||||
2. Edit the build script to use Sipeed's libsigrok fork:
|
||||
```bash
|
||||
$GIT_CLONE https://github.com/sipeed/libsigrok -b slogic-dev
|
||||
```
|
||||
3. (Optional) Add options to speed up build and reduce size:
|
||||
```
|
||||
--disable-all-drivers --enable-sipeed-slogic-analyzer --disable-bindings --enable-cxx
|
||||
```
|
||||
4. Run the build script for your target (e.g., `./sigrok-cross-linux`, `./sigrok-cross-mingw`, `./sigrok-cross-macosx`).
|
||||
|
||||
For advanced/manual builds, refer to upstream sigrok and PulseView documentation.
|
||||
|
||||
---
|
||||
|
||||
## Firmware Update
|
||||
|
||||
Firmware updates are provided via a Python/PyQt GUI tool.
|
||||
|
||||
- [Firmware update tool repository](https://github.com/sipeed/slogic16u3-tools)
|
||||
|
||||
**Update steps:**
|
||||
1. Clone/download the repository:
|
||||
```bash
|
||||
git clone https://github.com/sipeed/slogic16u3-tools.git
|
||||
```
|
||||
2. Install dependencies and set up the environment:
|
||||
```bash
|
||||
source .venv/bin/activate
|
||||
```
|
||||
3. Navigate to the `pt` directory:
|
||||
```bash
|
||||
cd pt
|
||||
```
|
||||
4. Run the GUI tool:
|
||||
```bash
|
||||
python src/gui.py
|
||||
```
|
||||
5. Press the **mode** button on the device. The GUI should display "SLogic16U3 OTA".
|
||||
6. Select the firmware file in the GUI.
|
||||
7. Click **OTA** to start the update.
|
||||
8. Wait for completion and follow on-screen instructions.
|
||||
|
||||
> **Note:** A binary version of the update tool will be released soon.
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## FAQ
|
||||
|
||||
### Why can't I find the SLogic16U3 device in Linux?
|
||||
|
||||
Normal users can't access USB devices by default.
|
||||
Run Pulseview with `sudo`:
|
||||
|
||||
```bash
|
||||
sudo ./Pulseview.appimage
|
||||
```
|
||||
|
||||
Or set up udev rules (see below).
|
||||
|
||||
### How do I set up udev rules for Linux?
|
||||
|
||||
Create a new udev rules file:
|
||||
|
||||
```bash
|
||||
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="plug_dev", TAG+="uaccess"
|
||||
ENV{ID_MM_DEVICE_IGNORE}="1"
|
||||
LABEL="sipeed_rules_end"
|
||||
EOF
|
||||
```
|
||||
|
||||
Reload udev rules and trigger:
|
||||
|
||||
```bash
|
||||
sudo udevadm control --reload
|
||||
sudo udevadm trigger
|
||||
```
|
||||
|
||||
Unplug and reconnect the device.
|
||||
You can now run Pulseview as a normal user.
|
||||
|
||||
### Why can't I use higher sample rates? Only 200M shows.
|
||||
|
||||
The maximum sample rate depends on the number of active channels and USB bandwidth.
|
||||
Slogic16U3's USB 3.0 provides up to ~400MB/s.
|
||||
To use higher rates (400M/800M), disable unused channels.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 710 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 730 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 940 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 94 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 50 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 119 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 1.3 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 926 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 680 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 1.4 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 200 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 154 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 154 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 162 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 173 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 174 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 180 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 190 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 186 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 315 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 220 KiB |
@@ -1,3 +1,278 @@
|
||||
# Slogic16U3 用户指南
|
||||
|
||||
👷♂️ 我们正在为您打造这份指南，感谢您的耐心与支持！
|
||||
👷♂️ 本指南正在积极撰写中 — 感谢您的耐心！
|
||||
|
||||
---
|
||||
|
||||
## 修订历史
|
||||
|
||||
| 日期 | 版本 | 作者 | 描述 |
|
||||
|------------|---------|------------|------------------|
|
||||
| 2024-09-23 | v0.1 | Sipeed 团队 | 初始草稿 |
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
1. [概述](#概述)
|
||||
2. [规格](#规格)
|
||||
3. [硬件连接](#硬件连接)
|
||||
4. [软件安装](#软件安装)
|
||||
5. [软件使用](#软件使用)
|
||||
6. [从源码构建软件](#从源码构建软件)
|
||||
7. [固件更新](#固件更新)
|
||||
8. [常见问题](#常见问题)
|
||||
|
||||
---
|
||||
|
||||
## 概述
|
||||
|
||||
Slogic16U3 是一款用于数字信号调试与分析的高性能逻辑分析仪。
|
||||
|
||||
<div style="display: flex; flex-wrap: wrap; gap: 10px; width: 100%;">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07963.JPG" style="width: 100%;">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07962.JPG" style="width: calc(50% - 5px);">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07961.JPG" style="width: calc(50% - 5px);">
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## 规格
|
||||
|
||||
- **通道数:** 16
|
||||
- **最大采样率:** 800 MHz
|
||||
- **存储深度:** 无限
|
||||
- **接口:** USB 3.0 (5 Gbps)
|
||||
- **供电:** USB 供电 (5V 900mA)
|
||||
- **尺寸:** 150 × 100 × 30 mm
|
||||
|
||||
---
|
||||
|
||||
## 硬件连接
|
||||
|
||||
- **USB-C to C** 或 **USB-A to C** 数据线：
|
||||
1. PC USB-A → USB-A/C 转 USB-C → 连接 SLogic
|
||||
2. PC USB-C → USB-C to USB-C → 连接 SLogic
|
||||
- **指示灯:** 多色（见常见问题）
|
||||
- **附件:** 标准杜邦线，高速屏蔽线
|
||||
|
||||
---
|
||||
|
||||
## 软件
|
||||
|
||||
### 支持的操作系统与测试平台
|
||||
|
||||
| 操作系统 / 平台 | 支持 | 示例平台 |
|
||||
|--------------------|----------|--------------------------|
|
||||
| Windows (x86_64) | 是 | Ultra 5 125H |
|
||||
| Linux (x86_64) | 是 | 第8代 Core i5+ |
|
||||
| Linux (aarch64) | 是 | RPI5 |
|
||||
| macOS (aarch64) | 是 | Apple Silicon M4 |
|
||||
|
||||
### 支持的协议
|
||||
|
||||
支持多种协议，包括：
|
||||
AC '97、I²C、SPI、UART、CAN、JTAG、1-Wire、PWM、USB 等等。
|
||||
*最新支持协议请参考软件内的解码器选择面板。*
|
||||
|
||||
### 安装
|
||||
|
||||
#### Windows
|
||||
|
||||
- 解压便携版并双击 `pulseview.exe` 启动。
|
||||
|
||||
|
||||
|
||||
- 若需启用调试模式，在终端运行：
|
||||
```cmd
|
||||
pulseview-debug.exe -l5
|
||||
```
|
||||
|
||||
|
||||
|
||||
#### Linux
|
||||
|
||||
```bash
|
||||
chmod +x Pulseview.appimage
|
||||
./Pulseview.appimage
|
||||
# ./Pulseview.appimage -l5 # 启用调试模式
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
#### macOS
|
||||
|
||||
- 下载并打开 `Pulseview.dmg` 安装。
|
||||
|
||||
|
||||
|
||||
|
||||
**相关链接：**
|
||||
淘宝、AliExpress、MaixHub
|
||||
邮箱: support@sipeed.com
|
||||
|
||||
---
|
||||
|
||||
## 软件使用
|
||||
|
||||
- 界面和工作流程与 DSView 类似。
|
||||
- 配置通道、采样率、采样点/时间和其他参数后进行采集。
|
||||
- 使用软件触发、采集、浏览、测量、协议解码与文件管理。
|
||||
|
||||
### 更改采样深度
|
||||
|
||||
- 采样深度决定每次采集的数据点数量。
|
||||
- 可在主控面板中设置采样深度，通常以数据点数表示。
|
||||
- 更高的采样深度能够捕获更长或更详细的信号，但需要更多内存并可能增加传输时间。
|
||||
- 如果只需捕获短事件，可减小采样深度以加快操作。
|
||||
- 在开始采集前调整采样深度以满足分析需求。
|
||||
- **如果磁盘空间充足，采样深度可以视为无限；数据可以直接流式写入存储。**
|
||||
|
||||
|
||||
|
||||
### 更改采样率
|
||||
|
||||
- **最大采样率：** 800 MHz（受激活通道数影响）
|
||||
- **16 通道：** 最高 200 MHz
|
||||
- **8 通道：** 最高 400 MHz
|
||||
- **4 通道：** 最高 800 MHz
|
||||
- 在主控面板中设置采样率。
|
||||
- 若无法使用更高速率，请禁用未使用的通道。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 选择激活通道
|
||||
|
||||
- 可在 **16**, **8**, 或 **4** 通道配置间切换。
|
||||
- 在配置区域启用/禁用通道。
|
||||
- 减少激活通道数可提高最大采样率。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 调整电压阈值
|
||||
|
||||
- 阈值可在 **0.1V 到 6.0V** 之间以 **0.1V 步进** 设置。
|
||||
- 在通道/设备配置面板中调整。
|
||||
- 按照逻辑电平选择阈值（例如 3.3V CMOS 约设为 1.0V）。
|
||||
- 在采集前应用更改。
|
||||
|
||||
|
||||
|
||||
|
||||
提示：对于 3.3V CMOS/TTL，阈值可设为约 1.0V（大约 3.3V 的 30%）。
|
||||
|
||||
### 边沿触发
|
||||
|
||||
- 配置边沿触发以在特定信号跳变时开始采集。
|
||||
- 在触发面板中选择通道和触发类型（上升沿、下降沿或双边沿）。
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 从源码构建软件
|
||||
|
||||
软件为开源。
|
||||
|
||||
- [Sipeed 的 libsigrok GitHub 仓库](https://github.com/sipeed/libsigrok/tree/slogic-dev)
|
||||
|
||||
**推荐：** 使用 [sigrok-util](https://github.com/sigrokproject/sigrok-util) 的构建脚本，获得跨平台的简单体验。
|
||||
|
||||
**步骤：**
|
||||
1. 克隆 sigrok-util 并按照其 README 安装依赖。
|
||||
2. 编辑构建脚本以使用 Sipeed 的 libsigrok fork：
|
||||
```bash
|
||||
$GIT_CLONE https://github.com/sipeed/libsigrok -b slogic-dev
|
||||
```
|
||||
3. （可选）添加选项以加速构建并减小体积：
|
||||
```
|
||||
--disable-all-drivers --enable-sipeed-slogic-analyzer --disable-bindings --enable-cxx
|
||||
```
|
||||
4. 运行适合目标平台的构建脚本（例如 `./sigrok-cross-linux`、`./sigrok-cross-mingw`、`./sigrok-cross-macosx`）。
|
||||
|
||||
更多高级或手动构建请参考 upstream sigrok 与 PulseView 文档。
|
||||
|
||||
---
|
||||
|
||||
## 固件更新
|
||||
|
||||
固件更新通过 Python / PyQt GUI 工具提供。
|
||||
|
||||
- [固件更新工具仓库](https://github.com/sipeed/slogic16u3-tools)
|
||||
|
||||
**更新步骤：**
|
||||
1. 克隆或下载仓库：
|
||||
```bash
|
||||
git clone https://github.com/sipeed/slogic16u3-tools.git
|
||||
```
|
||||
2. 安装依赖并设置环境：
|
||||
```bash
|
||||
source .venv/bin/activate
|
||||
```
|
||||
3. 进入 `pt` 目录：
|
||||
```bash
|
||||
cd pt
|
||||
```
|
||||
4. 运行 GUI 工具：
|
||||
```bash
|
||||
python src/gui.py
|
||||
```
|
||||
5. 按下设备上的 **mode** 按钮。GUI 应显示 "SLogic16U3 OTA"。
|
||||
6. 在 GUI 中选择固件文件。
|
||||
7. 点击 **OTA** 开始更新。
|
||||
8. 等待完成并按界面指引操作。
|
||||
|
||||
> **注意：** 将很快发布该更新工具的二进制版本。
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 在 Linux 中为什么找不到 SLogic16U3 设备？
|
||||
|
||||
普通用户默认无法访问 USB 设备。
|
||||
使用 sudo 运行 Pulseview：
|
||||
|
||||
```bash
|
||||
sudo ./Pulseview.appimage
|
||||
```
|
||||
|
||||
或者设置 udev 规则（见下文）。
|
||||
|
||||
### 如何为 Linux 设置 udev 规则？
|
||||
|
||||
创建新的 udev 规则文件：
|
||||
|
||||
```bash
|
||||
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="plug_dev", TAG+="uaccess"
|
||||
ENV{ID_MM_DEVICE_IGNORE}="1"
|
||||
LABEL="sipeed_rules_end"
|
||||
EOF
|
||||
```
|
||||
|
||||
重新加载 udev 规则并触发：
|
||||
|
||||
```bash
|
||||
sudo udevadm control --reload
|
||||
sudo udevadm trigger
|
||||
```
|
||||
|
||||
拔掉并重新连接设备。
|
||||
现在可以以普通用户身份运行 Pulseview。
|
||||
|
||||
### 为什么不能使用更高采样率？只显示 200M。
|
||||
|
||||
最大采样率取决于激活通道数量和 USB 带宽。
|
||||
Slogic16U3 的 USB 3.0 提供约 ~400MB/s 带宽。
|
||||
要使用更高速率（400M/800M），请禁用未使用的通道。
|
||||
|
||||
Reference in New Issue
Block a user