Add SLogic16U3 documentation and assets
- Added multiple screenshots for the SLogic16U3 logic analyzer to enhance visual documentation. - Updated sidebar navigation for both English and Chinese documentation to include links to the new Introduction, Hardware Specification, Software User Guide, and FAQ sections for SLogic16U3. - Created new documentation files in Chinese for Introduction, Hardware Specification, Software User Guide, and FAQ, providing comprehensive guidance for users.
taorye
56
docs/hardware/en/logic_analyzer/slogic16u3/FAQ.md
Normal file
@@ -0,0 +1,56 @@
|
||||
# FAQ
|
||||
|
||||
## Why can't I find the SLogic16U3 device?
|
||||
|
||||
|
||||
|
||||
The most common reason is that PulseView was started before the SLogic16U3 was connected. If the software can't see a device at startup it may not probe for it again automatically.
|
||||
|
||||
Solutions:
|
||||
1. For automatic detection, connect the SLogic16U3 first, then launch PulseView. The software should auto-detect the device on startup.
|
||||
2. If you started the software before connecting the SLogic, manually open the "Connect to Device" (or "Device Settings") dialog after plugging the SLogic in:
|
||||
- Open "Connect to Device".
|
||||
- Choose the correct driver/back-end for the SLogic16U3.
|
||||
- Click "Scan" to discover attached devices.
|
||||
- Select the SLogic device from the list and click "OK".
|
||||
- The UI will return to the normal capture/home page and the device will be available.
|
||||
- 
|
||||
|
||||
Additionally, on Linux a normal user cannot access USB devices by default due to permission restrictions. 
|
||||
Choose one of the two methods below:
|
||||
|
||||
- Run PulseView with root privileges (quick test):
|
||||
```bash
|
||||
sudo ./Pulseview.appimage
|
||||
```
|
||||
- Set up a udev rule so normal users can access the device (recommended). See [How do I set up udev rules for Linux?](#How-do-I-set-up-udev-rules-for-Linux) below for the udev rule and installation steps.
|
||||
|
||||
## 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.
|
||||
@@ -0,0 +1,2 @@
|
||||
# Hardware Specification
|
||||
|
||||
91
docs/hardware/en/logic_analyzer/slogic16u3/Introduction.md
Normal file
@@ -0,0 +1,91 @@
|
||||
# Introduction
|
||||
|
||||
---
|
||||
|
||||
## Introduction
|
||||
SLogic16U3 is the next-generation USB3 logic analyzer. In a compact 40×40×10 mm enclosure it achieves high sampling: 800M@4CH, 400M@8CH, 200M@16CH over a 5Gbps USB3 interface. It supports software (soft) trigger and configurable voltage threshold for all channel. Starting at $69.
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Features & Specifications
|
||||
| Attribute | SLogic Combo8 | SLogic16U3 | SLogic32U3 |
|
||||
| - | - | - | - |
|
||||
| Model | SLogic Combo8 | SLogic16U3 | SLogic32U3 |
|
||||
| Price | $15 | $69 | $149 |
|
||||
| USB Type | USB2.0 | USB3.0 | USB3.2 Gen2 |
|
||||
| Max Sample Rate | 80M | 800M | 1500M |
|
||||
| Max Channels | 8 | 16 | 32 |
|
||||
| Max Bandwidth | 0.3Gbps | 3.2Gbps | 6.4Gbps |
|
||||
| Typical Comb. (stream, unlimited) | 80M@4CH, 40M@8CH | 800M@4CH, 400M@8CH, 200M@16CH | 1500M@4CH, 800M@8CH, 400M@16CH, 200M@32CH |
|
||||
| Sigrok Compatible | Y | Y | Y |
|
||||
| Adjustable Threshold | N | Y | Y |
|
||||
| Case | Plastic | Aluminum | Aluminum |
|
||||
| Extra Feature | DAP-Link, CK-Link, 4-UART | | Extend ADC -> Oscilloscope |
|
||||
| Size | 20x40x10mm | 40x40x10mm | 50x50x10mm |
|
||||
|
||||
---
|
||||
|
||||
## Product Images
|
||||
|
||||
- size: 40x40x10mm
|
||||
- view: top/front/back
|
||||
<div style="display: flex; flex-wrap: wrap; gap: 10px; width: 100%;">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07963.png" style="width: 100%;">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07962.png" style="width: calc(50% - 5px);">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07961.png" style="width: calc(50% - 5px);">
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## Software installation
|
||||
|
||||
### Supported OS
|
||||
|
||||
- Windows 11 (x86_64)
|
||||
- Linux (x86_64, aarch64)
|
||||
- macOS (Apple Silicon M4)
|
||||
|
||||
### Downloads
|
||||
- Binary (prebuilt) downloads: https://dl.sipeed.com/shareURL/SLogic
|
||||
- Source code (slogic-dev branch): https://github.com/sipeed/libsigrok/tree/slogic-dev
|
||||
|
||||
#### 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 run directly.
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## Related links
|
||||
- Buy (Taobao): http://addme
|
||||
- Buy (AliExpress): http://addme
|
||||
- MaixHub: [maixhub.com](https://maixhub.com/discussion/slogic)
|
||||
- Support email: support@sipeed.com
|
||||
- GitHub (libsigrok slogic-dev): https://github.com/sipeed/libsigrok/tree/slogic-dev
|
||||
- Sipeed GitHub: https://github.com/sipeed
|
||||
- GitHub (SLogic16U3 Tools): https://github.com/sipeed/slogic16u3-tools
|
||||
- Community (Discord): https://discord.com/channels/1359800784375644291/1359802057569206323
|
||||
@@ -0,0 +1,179 @@
|
||||
# SLogic16U3 — Software User Guide
|
||||
|
||||
This guide explains how to use the SLogic16U3 with a capture application. It covers connecting and detecting the device, the user interface across platforms, basic and advanced sampling setup, the capture workflow, browsing and measurement tools, protocol decoding, and file operations.
|
||||
|
||||
## Connect the SLogic
|
||||
Best practice: connect the SLogic16U3 to a USB 3.0 port on the host before launching the capture application so the software can auto-detect the device.
|
||||
|
||||
If the application is already running:
|
||||
- Plug the SLogic into a USB 3.0 host port (avoid unpowered hubs).
|
||||
- Open the application menu and select "Connect to Device" dialog.
|
||||
- Select the SLogic driver/back-end.
|
||||
- Click "Scan".
|
||||
- Choose the SLogic device from the discovered list and click "OK".
|
||||
|
||||
Troubleshooting checklist:
|
||||
- Try a different USB cable or a different host port.
|
||||
- Confirm device power/LED indicators are on.
|
||||
- Unplug and replug the device, then reopen the Connect dialog or relaunch the app.
|
||||
- On Linux, check permissions (use sudo for quick testing or install udev rules; see FAQ).
|
||||
- See: [Why can't I find the SLogic16U3 device?](./FAQ.html#why-cant-i-find-the-slogic16u3-device)
|
||||
|
||||
|
||||
|
||||
## User Interface
|
||||
|
||||
### Windows
|
||||
- Menus, dialogs, and file dialogs follow Windows conventions.
|
||||
|
||||
|
||||
|
||||
### Linux
|
||||
- Layout is similar to other platforms.
|
||||
- Note: regular Linux users may lack permissions to access USB devices. For quick tests run the app with sudo; for day-to-day use install udev rules (see FAQ).
|
||||
- Running an `AppImage -l5` from a terminal can show helpful logs when troubleshooting.
|
||||
|
||||
|
||||
|
||||
### macOS
|
||||
- Menus are on the system menu bar; dialogs integrate with macOS UI conventions.
|
||||
- If macOS blocks access, open System Preferences → Security & Privacy and grant permission for the app.
|
||||
- Prefer direct ports or a powered USB3 hub.
|
||||
|
||||
|
||||
|
||||
## Basic sampling modes and configuration
|
||||
Before capturing, configure these core settings:
|
||||
|
||||
- Channel enables: enable only the channels you need to reduce bandwidth and increase sample-rate headroom.
|
||||
- Voltage threshold: set according to the device under test (DUT) logic levels.
|
||||
- Sample rate: pick a preset; allowed rates depend on active channels and USB bandwidth.
|
||||
- Sample depth / capture length: choose number of samples.
|
||||
|
||||
### Configuration (mixed settings)
|
||||
Recommended quick workflow:
|
||||
1. Enable required channels (16/8/4 as needed).
|
||||
2. Set voltage thresholds where supported.
|
||||
3. Select a sample-rate preset compatible with enabled channels.
|
||||
4. Choose sample depth.
|
||||
5. Configure your trigger or just start acquisition.
|
||||
|
||||
Tips:
|
||||
- Enabling less channels increases achievable sample rates.
|
||||
- For long captures, validate disk space before saving/exporting.
|
||||
|
||||
|
||||
|
||||
### Voltage threshold
|
||||
- Choose thresholds matching the DUT:
|
||||
- ~1.6 V for many low-voltage systems (e.g., 3.3 V or 5 V logic).
|
||||
- Up to 6.0 V for higher-voltage signals—verify hardware limits first.
|
||||
- When unsure, measure the signal with a multimeter or oscilloscope before connecting.
|
||||
|
||||
|
||||
|
||||
|
||||
### Channel / sample-rate presets
|
||||
- Available sample rates shrink as more channels are enabled due to USB throughput limits.
|
||||
- Use the preset list to switch between standard modes (16ch / 8ch / 4ch).
|
||||
- If you need finer time resolution, reduce active channels and increase the sample rate.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Sample depth / capture length
|
||||
- Choose a sample depth (points) or capture time. The product of sample rate × depth determines memory and storage usage.
|
||||
|
||||
|
||||
|
||||
## Advanced: Trigger configuration
|
||||
Supported trigger types typically include:
|
||||
- Edge trigger (rising/falling) on a single channel.
|
||||
- Level trigger (signal above/below threshold for duration).
|
||||
- Combine triggers across multiple channels.
|
||||
|
||||
How to set a basic edge trigger:
|
||||
1. Open Trigger settings.
|
||||
2. Choose the channel and select Rising or Falling or anything else.
|
||||
3. Add additional channel conditions for compound triggers if needed.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Capture workflow
|
||||
|
||||
### Typical steps
|
||||
1. Connect the device and confirm detection.
|
||||
2. Configure channels, voltage thresholds, and sample rate.
|
||||
3. Set sample depth and trigger mode.
|
||||
4. Start capture and wait it to be finished.
|
||||
5. Inspect waveforms and use decoders or measurements.
|
||||
|
||||
Capture modes:
|
||||
- Continuous/stream: capture continuously until stopped; manage data size and memory.
|
||||
|
||||
If you encounter dropped samples:
|
||||
- Lower the sample rate or reduce enabled channels.
|
||||
- Use a dedicated USB 3.0 port and a high-quality USB cable.
|
||||
|
||||
|
||||
|
||||
|
||||
### With trigger
|
||||
- Configure trigger conditions before starting capture to ensure the event is captured in the buffer.
|
||||
|
||||
|
||||
|
||||
|
||||
## Browse and ruler measurements
|
||||
Navigation and controls:
|
||||
- Zoom in/out: mouse wheel or Up/Down buttons.
|
||||
- Pan forward/back: drag or hold Shift + scroll or hold Shift + Up/Down buttons.
|
||||
- Move vertically across channels: hold Ctrl + scroll or hold Ctrl + Up/Down buttons.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Rulers:
|
||||
- Add time rulers to measure intervals. Place two rulers to compute the delta time.
|
||||
- Use ruler measurements to calculate baud rate, pulse width, or event spacing.
|
||||
- Hold Shift + drag to create the ruler for measurements.
|
||||
|
||||
|
||||
## Protocol decoders
|
||||
To decode a bus:
|
||||
1. Open the Decoder pane.
|
||||
2. Select the protocol (I2C, SPI, UART, CAN, SDIO, etc.).
|
||||
3. Configure pins, byte order (LSB/MSB), clock polarity/phase and baudrate/clock speed.
|
||||
4. Enable the decoder; decoded frames are annotated on the waveform and are clickable for details.
|
||||
|
||||
|
||||
Tips:
|
||||
- Map probe pins correctly to logical signals (MOSI/MISO/SCLK/CS, TX/RX).
|
||||
- Increase sample rate for high-speed buses to ensure correct decoding.
|
||||
- Disable unused decoders to reduce CPU and UI load.
|
||||
|
||||
### UART examples (4M)
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### SDIO / SDCard examples
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## File operations (save / load)
|
||||
- Save session: stores captured samples, channel configuration, trigger settings, and decoder state. Use sessions to preserve work for later analysis.
|
||||
- Load session: restores the saved capture and UI state.
|
||||
|
||||
|
||||
|
||||
|
||||
<!-- End of Software User Guide -->
|
||||
|
After Width: | Height: | Size: 347 KiB |
BIN
docs/hardware/en/logic_analyzer/slogic16u3/assets/DCIM/DSC07962.png
Executable file
|
After Width: | Height: | Size: 80 KiB |
|
After Width: | Height: | Size: 475 KiB |
|
After Width: | Height: | Size: 385 KiB |
|
After Width: | Height: | Size: 60 KiB |
|
After Width: | Height: | Size: 50 KiB |
|
After Width: | Height: | Size: 49 KiB |
|
After Width: | Height: | Size: 48 KiB |
|
After Width: | Height: | Size: 87 KiB |
|
After Width: | Height: | Size: 48 KiB |
|
After Width: | Height: | Size: 52 KiB |
|
After Width: | Height: | Size: 469 KiB |
|
After Width: | Height: | Size: 78 KiB |
|
After Width: | Height: | Size: 73 KiB |
|
After Width: | Height: | Size: 111 KiB |
|
After Width: | Height: | Size: 537 KiB |
|
After Width: | Height: | Size: 535 KiB |
|
After Width: | Height: | Size: 85 KiB |
|
After Width: | Height: | Size: 71 KiB |
|
After Width: | Height: | Size: 77 KiB |
|
After Width: | Height: | Size: 134 KiB |
|
After Width: | Height: | Size: 167 KiB |
|
After Width: | Height: | Size: 347 KiB |
|
After Width: | Height: | Size: 49 KiB |
|
After Width: | Height: | Size: 137 KiB |
|
After Width: | Height: | Size: 80 KiB |
|
After Width: | Height: | Size: 137 KiB |
|
After Width: | Height: | Size: 130 KiB |
|
After Width: | Height: | Size: 122 KiB |
|
After Width: | Height: | Size: 131 KiB |
|
After Width: | Height: | Size: 123 KiB |
|
After Width: | Height: | Size: 114 KiB |
|
After Width: | Height: | Size: 190 KiB |
|
After Width: | Height: | Size: 131 KiB |
|
After Width: | Height: | Size: 134 KiB |
|
After Width: | Height: | Size: 134 KiB |
|
After Width: | Height: | Size: 132 KiB |
|
After Width: | Height: | Size: 164 KiB |
|
After Width: | Height: | Size: 143 KiB |
|
After Width: | Height: | Size: 293 KiB |
|
After Width: | Height: | Size: 139 KiB |
|
After Width: | Height: | Size: 132 KiB |
|
After Width: | Height: | Size: 189 KiB |
|
After Width: | Height: | Size: 185 KiB |
|
After Width: | Height: | Size: 191 KiB |
|
After Width: | Height: | Size: 165 KiB |
|
After Width: | Height: | Size: 531 KiB |
|
After Width: | Height: | Size: 245 KiB |
|
After Width: | Height: | Size: 615 KiB |
|
After Width: | Height: | Size: 688 KiB |
|
After Width: | Height: | Size: 238 KiB |
|
After Width: | Height: | Size: 299 KiB |
|
After Width: | Height: | Size: 689 KiB |
|
After Width: | Height: | Size: 660 KiB |
|
After Width: | Height: | Size: 637 KiB |
|
After Width: | Height: | Size: 628 KiB |
|
After Width: | Height: | Size: 1.1 MiB |
|
After Width: | Height: | Size: 274 KiB |
@@ -482,6 +482,15 @@ items:
|
||||
|
||||
- label: SLogic16U3
|
||||
items:
|
||||
- label: Indroduction
|
||||
file: logic_analyzer/slogic16u3/Introduction.md
|
||||
- label: Hardware Specification
|
||||
file: logic_analyzer/slogic16u3/Hardware_Specification.md
|
||||
- label: Software User Guide
|
||||
file: logic_analyzer/slogic16u3/Software_User_Guide.md
|
||||
- label: FAQ
|
||||
file: logic_analyzer/slogic16u3/FAQ.md
|
||||
|
||||
- label: User Guide
|
||||
file: logic_analyzer/slogic16u3/User_Guide.md
|
||||
- label: KVM
|
||||
|
||||
56
docs/hardware/zh/logic_analyzer/slogic16u3/FAQ.md
Normal file
@@ -0,0 +1,56 @@
|
||||
# 常见问题
|
||||
|
||||
## 为什么找不到 SLogic16U3 设备？
|
||||
|
||||
|
||||
|
||||
最常见的原因是 PulseView 在连接 SLogic16U3 之前就已启动。如果软件在启动时找不到设备，它可能不会自动再次探测设备。
|
||||
|
||||
解决办法：
|
||||
1. 要自动检测，请先连接 SLogic16U3，然后再启动 PulseView。软件在启动时应能自动检测到设备。
|
||||
2. 如果你是在启动软件后才插入设备，请在插入设备后手动打开“连接到设备”（或“设备设置”）对话框：
|
||||
- 打开 “Connect to Device”。
|
||||
- 选择适用于 SLogic16U3 的驱动/后端。
|
||||
- 点击 “Scan” 来发现已连接的设备。
|
||||
- 从列表中选择 SLogic 设备并点击 “OK”。
|
||||
- UI 会返回到捕获/主页面，设备将可用。
|
||||
- 
|
||||
|
||||
另外，在 Linux 上普通用户默认无法访问 USB 设备，因为权限受限。 
|
||||
可选两种方法之一：
|
||||
|
||||
- 使用 root 权限运行 PulseView（快速测试）:
|
||||
```bash
|
||||
sudo ./Pulseview.appimage
|
||||
```
|
||||
- 设置 udev 规则以便普通用户可以访问设备（推荐）。关于 udev 规则和安装步骤，请参见下文“如何为 Linux 设置 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），请禁用未使用的通道。
|
||||
@@ -0,0 +1,2 @@
|
||||
# Hardware Specification
|
||||
|
||||
92
docs/hardware/zh/logic_analyzer/slogic16u3/Introduction.md
Normal file
@@ -0,0 +1,92 @@
|
||||
# 简介
|
||||
|
||||
---
|
||||
|
||||
## 简介
|
||||
SLogic16U3 是下一代 USB3 逻辑分析仪。它在紧凑的 40×40×10 mm 外壳中通过 5Gbps USB3 接口实现高采样率：4 通道 800M、8 通道 400M、16 通道 200M。它支持软件（软）触发和可配置的电压阈值。起价 ￥399。
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 特点与规格
|
||||
| 属性 | SLogic Combo8 | SLogic16U3 | SLogic32U3 |
|
||||
| - | - | - | - |
|
||||
| 型号 | SLogic Combo8 | SLogic16U3 | SLogic32U3 |
|
||||
| 价格 | ￥69 | ￥399 | ￥999 |
|
||||
| USB 类型 | USB2.0 | USB3.0 | USB3.2 Gen2 |
|
||||
| 最大采样率 | 80M | 800M | 1500M |
|
||||
| 最大通道数 | 8 | 16 | 32 |
|
||||
| 最大带宽 | 0.3Gbps | 3.2Gbps | 6.4Gbps |
|
||||
| Typical Comb. (stream, unlimited) | 80M@4CH, 40M@8CH | 800M@4CH, 400M@8CH, 200M@16CH | 1500M@4CH, 800M@8CH, 400M@16CH, 200M@32CH |
|
||||
| 兼容 Sigrok | Y | Y | Y |
|
||||
| 可调阈值 | N | Y | Y |
|
||||
| 外壳材质 | 塑料 | 铝合金 | 铝合金 |
|
||||
| 额外特性 | DAP-Link, CK-Link, 4-UART | | Extend ADC -> Oscilloscope |
|
||||
| 尺寸 | 20x40x10mm | 40x40x10mm | 50x50x10mm |
|
||||
|
||||
---
|
||||
|
||||
## 产品图
|
||||
|
||||
- 尺寸：40x40x10mm
|
||||
- 视图：顶/前/后
|
||||
//TODO
|
||||
<div style="display: flex; flex-wrap: wrap; gap: 10px; width: 100%;">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07963.png" style="width: 100%;">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07962.png" style="width: calc(50% - 5px);">
|
||||
<img src="../../../en/logic_analyzer/slogic16u3/assets/DCIM/DSC07961.png" style="width: calc(50% - 5px);">
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## 软件安装
|
||||
|
||||
### 支持的操作系统
|
||||
|
||||
- Windows 11 (x86_64)
|
||||
- Linux (x86_64, aarch64)
|
||||
- macOS (Apple Silicon M4)
|
||||
//TODO
|
||||
|
||||
### 下载
|
||||
- 二进制（预构建）下载: https://dl.sipeed.com/shareURL/SLogic
|
||||
- 源代码（slogic-dev 分支）: https://github.com/sipeed/libsigrok/tree/slogic-dev
|
||||
|
||||
#### Windows
|
||||
|
||||
- 解压便携版压缩包并双击 `pulseview.exe` 启动。
|
||||
- 若需启用调试模式，在终端运行：
|
||||
```cmd
|
||||
pulseview-debug.exe -l5
|
||||
```
|
||||
|
||||
|
||||
|
||||
#### Linux
|
||||
|
||||
```bash
|
||||
chmod +x Pulseview.appimage
|
||||
./Pulseview.appimage
|
||||
# ./Pulseview.appimage -l5 # 启用调试模式
|
||||
```
|
||||
|
||||
|
||||
|
||||
#### macOS
|
||||
|
||||
- 下载并打开 `Pulseview.dmg` 即可直接运行。
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 相关链接
|
||||
- 购买（淘宝）：http://addme
|
||||
- 购买（AliExpress）：http://addme
|
||||
- MaixHub: [maixhub.com](https://maixhub.com/discussion/slogic)
|
||||
- 支持邮箱：support@sipeed.com
|
||||
- GitHub（libsigrok slogic-dev）：https://github.com/sipeed/libsigrok/tree/slogic-dev
|
||||
- Sipeed GitHub: https://github.com/sipeed
|
||||
- GitHub（SLogic16U3 Tools）：https://github.com/sipeed/slogic16u3-tools
|
||||
- 社区（Discord）：https://discord.com/channels/1359800784375644291/1359802057569206323
|
||||
@@ -0,0 +1,179 @@
|
||||
# SLogic16U3 — 软件使用指南
|
||||
|
||||
本指南说明如何在捕获应用中使用 SLogic16U3。覆盖设备连接与检测、跨平台的用户界面、基础与高级采样设置、捕获流程、浏览与测量工具、协议解码以及文件操作。
|
||||
|
||||
## 连接 SLogic
|
||||
最佳做法：在主机上将 SLogic16U3 连接到 USB 3.0 接口，然后再启动捕获应用，这样软件可以在启动时自动检测到设备。
|
||||
|
||||
如果应用已在运行：
|
||||
- 将 SLogic 插入 USB 3.0 主机端口（避免使用无电源的集线器）。
|
||||
- 打开应用菜单，选择 “Connect to Device” 端选择对话框。
|
||||
- 选择 SLogic 驱动/后端。
|
||||
- 点击 “Scan” 或 “Refresh”。
|
||||
- 从发现的设备列表中选择 SLogic 设备，点击 “OK”。
|
||||
|
||||
故障排查清单：
|
||||
- 尝试更换 USB 数据线或使用不同的主机端口。
|
||||
- 确认设备电源/LED 指示正常。
|
||||
- 拔插设备后重新打开连接对话框或重启应用。
|
||||
- 在 Linux 上检查权限（可用 sudo 进行快速测试或安装 udev 规则；参见 FAQ）。
|
||||
- 参见: [Why can't I find the SLogic16U3 device?](./FAQ.html#why-cant-i-find-the-slogic16u3-device)
|
||||
|
||||
|
||||
|
||||
## 用户界面
|
||||
|
||||
### Windows
|
||||
- 菜单、对话框和文件对话框遵循 Windows 约定。
|
||||
|
||||
|
||||
|
||||
### Linux
|
||||
- 布局与其他平台相似。
|
||||
- 注意：普通 Linux 用户可能没有访问 USB 设备的权限。快速测试可使用 sudo 运行应用；日常使用请安装 udev 规则（参见 FAQ）。
|
||||
- 在终端运行 `AppImage -l5` 可以在故障排查时显示有用日志。
|
||||
|
||||
|
||||
|
||||
### macOS
|
||||
- 菜单位于系统菜单栏；对话框与 macOS UI 约定集成。
|
||||
- 如果 macOS 阻止访问，请打开 系统偏好设置 → 安全性与隐私 并为应用授予权限。
|
||||
- 优先使用主板直连端口或有电源的 USB3 集线器。
|
||||
|
||||
|
||||
|
||||
## 基本采样模式与配置
|
||||
在采集之前，配置以下核心设置：
|
||||
|
||||
- 通道使能：仅启用所需通道以减少带宽占用并提高采样率余量。
|
||||
- 电压阈值：根据被测设备（DUT）的逻辑电平设置。
|
||||
- 采样率：选择预设；允许的采样率取决于启用通道数和 USB 带宽。
|
||||
- 采样深度 / 捕获长度：选择捕获样点数。
|
||||
|
||||
### 配置（混合设置）
|
||||
推荐的快速工作流程：
|
||||
1. 启用所需通道（按需 16/8/4）。
|
||||
2. 在支持时设置电压阈值。
|
||||
3. 选择与启用通道兼容的采样率预设。
|
||||
4. 选择采样深度。
|
||||
5. 配置触发或直接开始采集。
|
||||
|
||||
提示：
|
||||
- 减少启用通道可提高可达采样率。
|
||||
- 对于长时间捕获，保存/导出前请确认磁盘空间。
|
||||
|
||||
|
||||
|
||||
### 电压阈值
|
||||
- 选择与 DUT 匹配的阈值：
|
||||
- 例如 ~1.6 V 适用于很多低电压系统（如 3.3 V 或 5 V 逻辑）。
|
||||
- 最高可达 6.0 V 用于更高电压信号——先确认硬件限制。
|
||||
- 不确定时，先用万用表或示波器测量信号再连接。
|
||||
|
||||
|
||||
|
||||
|
||||
### 通道 / 采样率预设
|
||||
- 随着启用通道增多，可用采样率会减少（受 USB 吞吐量限制）。
|
||||
- 使用预设列表在标准模式间切换（16ch / 8ch / 4ch）。
|
||||
- 需要更高时间分辨率时，减少活动通道并提高采样率。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 采样深度 / 捕获长度
|
||||
- 选择采样深度（点数）或捕获时间。采样率 × 深度决定内存和存储使用。
|
||||
|
||||
|
||||
|
||||
## 高级：触发配置
|
||||
通常支持的触发类型包括：
|
||||
- 单通道的边沿触发（上升/下降）。
|
||||
- 电平触发（信号在阈值上/下保持一段时间）。
|
||||
- 跨多个通道的组合触发。
|
||||
|
||||
设置基本边沿触发的方法：
|
||||
1. 打开触发设置。
|
||||
2. 选择通道并选择 Rising（上升）或 Falling（下降）等。
|
||||
3. 如需复合触发，可添加额外通道条件。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 捕获流程
|
||||
|
||||
### 典型步骤
|
||||
1. 连接设备并确认检测到。
|
||||
2. 配置通道、电压阈值和采样率。
|
||||
3. 设置采样深度和触发模式。
|
||||
4. 启动捕获并等待完成。
|
||||
5. 检查波形并使用解码器或测量工具。
|
||||
|
||||
捕获模式：
|
||||
- 连续/流式：持续捕获直到停止；注意数据大小和内存管理。
|
||||
|
||||
如遇样点丢失：
|
||||
- 降低采样率或减少启用通道。
|
||||
- 使用专用 USB 3.0 端口并选用高质量 USB 数据线。
|
||||
|
||||
|
||||
|
||||
|
||||
### 使用触发时
|
||||
- 在开始捕获前配置触发条件以确保事件被捕获到缓冲区中。
|
||||
|
||||
|
||||
|
||||
|
||||
## 浏览与标尺测量
|
||||
导航与控制：
|
||||
- 缩放：鼠标滚轮或上下按钮。
|
||||
- 前后平移：拖动或按住 Shift + 滚动 或按住 Shift + 上下按钮。
|
||||
- 垂直平移：按住 Ctrl + 滚动 或按住 Ctrl + 上下按钮。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
标尺：
|
||||
- 添加时间标尺以测量间隔。放置两个标尺可计算时间差。
|
||||
- 使用标尺测量来计算波特率、脉宽或事件间隔。
|
||||
- 按住 Shift + 拖动以创建测量标尺。
|
||||
|
||||
|
||||
## 协议解码
|
||||
要解码总线：
|
||||
1. 打开 Decoder 窗格。
|
||||
2. 选择协议（I2C、SPI、UART、CAN、SDIO 等）。
|
||||
3. 配置引脚、字节序（LSB/MSB）、时钟极性/相位及波特率/时钟速率。
|
||||
4. 启用解码器；解码后的帧会标注在波形上并可点击查看详情。
|
||||
|
||||
|
||||
提示：
|
||||
- 正确映射探针引脚到逻辑信号（MOSI/MISO/SCLK/CS、TX/RX）。
|
||||
- 对于高速总线提高采样率以确保正确解码。
|
||||
- 禁用未使用的解码器以减少 CPU 与 UI 负载。
|
||||
|
||||
### UART 示例（4M）
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### SDIO / SDCard 示例
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 文件操作（保存 / 加载）
|
||||
- 保存会话：存储捕获的样本、通道配置、触发设置和解码器状态。使用会话可保存工作以便以后分析。
|
||||
- 加载会话：恢复已保存的捕获和 UI 状态。
|
||||
|
||||
|
||||
|
||||
|
||||
<!-- End of Software User Guide -->
|
||||
@@ -480,6 +480,15 @@ items:
|
||||
|
||||
- label: SLogic16U3
|
||||
items:
|
||||
- label: 简介
|
||||
file: logic_analyzer/slogic16u3/Introduction.md
|
||||
- label: 硬件
|
||||
file: logic_analyzer/slogic16u3/Hardware_Specification.md
|
||||
- label: 软件使用指南
|
||||
file: logic_analyzer/slogic16u3/Software_User_Guide.md
|
||||
- label: FAQ
|
||||
file: logic_analyzer/slogic16u3/FAQ.md
|
||||
|
||||
- label: 使用指南
|
||||
file: logic_analyzer/slogic16u3/User_Guide.md
|
||||
- label: KVM
|
||||
|
||||