Add basic_operation

2026-09-15 06:58:26 -05:00 · 2025-09-25 22:06:12 +08:00
parent 75ba644784
commit af90bb92f4
2 changed files with 138 additions and 12 deletions
--- a/docs/hardware/zh/logic_analyzer/slogic16u3/User_Guide.md
+++ b/docs/hardware/zh/logic_analyzer/slogic16u3/User_Guide.md
@@ -6,8 +6,8 @@

 ## 修订历史

-| 日期       | 版本    | 作者       | 描述             |
-|------------|---------|------------|------------------|
+| 日期       | 版本    | 作者         | 描述             |
+|------------|---------|-------------|------------------|
 | 2024-09-23 | v0.1    | Sipeed 团队 | 初始草稿         |

 ---
@@ -40,21 +40,30 @@ Slogic16U3 是一款用于数字信号调试与分析的高性能逻辑分析仪
 ## 规格

 - **通道数:** 16
- **最大采样率:** 800 MHz
+- **最大采样率:** 典型 800 MHz @ 4CH
 - **存储深度:** 无限
- **接口:** USB 3.0 (5 Gbps)
+- **接口:** USB 3.2 Gen1 (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
- **指示灯:** 多色（见常见问题）
- **附件:** 标准杜邦线，高速屏蔽线
+参见[基础使用](basic_operation.md)
+
+## 硬件配置
+
+- USB接口：**USB-C 3.2 Gen1** 
+- 信号输入：2x12P排母，16-ch Data + 2-ch VCC + 2-ch reserved
+- **指示灯:** 多色（见[基础使用](basic_operation.md#指示灯颜色与功能)）
+- **附件:** 
+    - 标准 ***2x6P*** **公对母杜邦线** x2，或 ***2x4P*** **同轴线模组** x2
+    - 逻辑分析仪测试夹 x16
+    - 0.5m **A+C to C** USB3 数据线 x1
+    - 不锈钢取卡针 x1
+    - 说明卡片 x1
+    - 拉链收纳包 x1

 ---

@@ -62,10 +71,10 @@ Slogic16U3 是一款用于数字信号调试与分析的高性能逻辑分析仪

 ### 支持的操作系统与测试平台

-| 操作系统 / 平台    | 支持     | 示例平台                 |
+| 操作系统 / 平台     | 支持      | 示例平台                 |
 |--------------------|----------|--------------------------|
 | Windows (x86_64)   | 是       | Ultra 5 125H             |
-| Linux (x86_64)     | 是       | 第8代 Core i5+           |
+| Linux (x86_64)     | 是       | Core i5+ 8225U           |
 | Linux (aarch64)    | 是       | RPI5                     |
 | macOS (aarch64)    | 是       | Apple Silicon M4         |

--- a/docs/hardware/zh/logic_analyzer/slogic16u3/basic_operation.md
+++ b/docs/hardware/zh/logic_analyzer/slogic16u3/basic_operation.md
@@ -0,0 +1,117 @@
+---
+title:  基础操作
+keywords: LogicAnalyzer, SLogic
+update:
+  - date: 2025-09-25
+    version: v0.1
+    author: Serika
+    content:
+      - Release docs
+---
+
+SLogic16 U3共有2个功能（SLogic Mode/DFU Mode）。
+这篇文档用来指导如何上手使用。
+
+## 硬件概览
+
+### 硬件示意图
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <title>CSS Indentation</title>
+  <style>
+    .indent {
+      margin-left: 0ch; /* wideof 0 characters */
+    }
+  </style>
+</head>
+<body>
+  <details class="indent">
+    <summary><font color="#4F84FF">点击此处查看SLoigc16 U3的硬件示意图览
+</font></summary>
+    <img src="./assets/Hardware_OverView.png">
+  </details>
+</body>
+<br>
+</html>
+
+**同轴线子板**/**杜邦线组** 的插入方向见上图，连接线上的三角标记 **▴** 对准外壳上的三角标记 **▼** 即可。
+
+其中MODE小孔中有一个隐藏式按键，可以用取卡针捅入后按下。
+
+ACT是**状态指示灯**，具体状态见下方[相应章节](#指示灯颜色与功能)描述。
+
+### 快速开始
+
+
+首先，使用**PC USB** → **USB-A/C to USB-C** → 连接 **SLogic**
+
+> 目前SLogic16仅有 **USB3** 模式支持，而DFU模式使用 **USB2** 模式。
+
+将目标设备的待测信号点连接至SLogic任意空闲CH端口，并确保待测设备的GND与SLogic的GND相连接。
+
+> 注意SLogic的GND线需要离待测点的位置越近越好，哪怕更近1cm也可能会增加采样
+质量
+
+## MODE按键功能
+
+> Windows环境打开设备管理器或使用 *USB treeview*，Linux环境使用 *lsusb* 命令，可以找到 "*SLogic16 U3/SLogic DFU*" 设备
+
+装置上电后默认功能是 **逻辑分析仪**，正常情况下[ACT指示灯](#指示灯颜色与功能)显示青色。
+同时出现一个新的 **USB3** 装置：**SLogic16 U3**（逻辑分析仪）
+
+<!-- ![slogic16_u3](./assets/slogic_u3.png) -->
+
+**按下MODE按键**切换功能，切换成功后可以看到**指示灯变化：** 红灯慢闪。
+同时出现一个新的 **USB2** 装置：**SLogic DFU** （升级模式）
+
+<!-- ![slogic16_u2](./assets/slogic_u2.png) -->
+
+再次按下MODE则切换回 **SLogic16 U3**，重复按下MODE再进入**SLogic DFU**，如此往复循环。
+
+## 指示灯颜色与功能
+
+指示灯是一颗3色RGB，每一种颜色代表一种状态，不同状态组合指示当前设备状态
+
+| **颜色**   | <span style="color:blue">蓝灯</span>    | <span style="color:green">绿灯</span> | <span style="color:red">红灯</span> |
+| ---------- | -------------------------------------- | ------------------------------------- | ----------------------------------  | 
+| **功能**   | 电源                                    | USB LINK 指示                         | 运行状态指示                         | 
+
+- 下边表是不同颜色对应的正常运行时候的装置状态
+
+  | 状态         | 颜色                                 | 备注                                                                      |
+  | ----------- | ------------------------------------ | ------------------------------------------------------------------------- | 
+  | **正常连接** | <span style="color:cyan">青色</span> | <span style="color:blue">蓝</span> + <span style="color:green">绿</span> |
+  | **数据传输** | <span style="color:cyan">青色</span> + <span style="color:red">红色快闪</span> | <span style="color:blue">蓝</span> + <span style="color:green">绿</span> + <span style="color:red">红快闪</span> |
+  | **DFU模式**  | <span style="color:cyan">青色</span> + <span style="color:red">红色慢闪</span> | <span style="color:blue">蓝</span> + <span style="color:green">绿</span> + <span style="color:red">红慢闪</span> |
+
+- ⚠下边的指示灯颜色对应的装置的异常状态
+  | 状态            | 颜色                               | 备注                                        |
+  | -------------- | ---------------------------------- | ------------------------------------------- | 
+  | **USB连接失败** | <span style="color:blue">蓝</span> | <span style="color:blue">只亮蓝灯</span>     |
+
+> ⚠注意：任何时候<span style="color:green">绿灯</span>如果熄灭都意味着USB连接出现问题，请尝试重新连接以解决问题。此时<span style="color:red">红灯</span>的状态没有意义。
+
+- 装置的异常状态的检查清单
+    - 使用的USB线缆不支持**USB3**（常见于手机充电线）
+    - PC的USB接口不支持**USB3**
+    - 连接到了Desktop PC 机箱的前面板的USB
+    - 连接到了不兼容的**USB hub**（请尽量保证SLogic直连PC USB）
+    - 连接到了供电能力不足的**USB端口**
+    - 连接线太长（请尽量使用1m以内的连接线）
+
+
+## 更新固件
+
+> Windows环境打开设备管理器或使用 *USB treeview*，Linux环境使用 *lsusb* 命令，可以找到 "*SLogic DFU*" 设备
+
+首先[进入DFU MODE](#mode按键功能)：上电后按下 **MODE按键**，等待<span style="color:red">红灯慢闪</span> 。
+
+确认"*SLogic DFU*" 设备出现后，使用DFU工具进行更新。
+
+DFU工具的说明详见[更新固件]()章节。
+
+## FAQ
+
+TBD