docs(slogic): use the web OTA tool for firmware updates

SLogic16U3 and SLogic32U3 firmware is now updated in the browser at
https://slogic.sipeed.com/ota/ (WebUSB; Chrome/Edge). Replace the old
instructions that sent users to the slogic16u3-tools repository and its
binaries (git clone + PyQt GUI, spi_flash_xxx CLI) with the web tool's
flow, in zh and en:

- Hardware guides (16U3, 32U3) and the 16U3 user guide: browser and
  driver requirements (no driver on Windows, one-time udev rule on Linux,
  same command the page shows), direct data cable, firmware download
  links, and the five update steps -- 16U3 enters update mode with MODE
  and is re-plugged afterwards, 32U3 is switched and restarted by the
  page. The 32U3 "Firmware Update"/"更新固件" headings are kept: the OTA
  page links to those anchors.
- 16U3 introduction link list and the DFU-recovery FAQ entries point to
  the web tool.
- Remove the three screenshots of the old tool, now unreferenced.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
taorye
2026-10-16 19:22:29 +08:00
parent 4798da42dd
commit ab12e8d2f5
15 changed files with 116 additions and 115 deletions

View File

@@ -60,7 +60,7 @@ To use higher rates (400M/800M), disable unused channels.
## The device is locked in DFU mode and cannot switch back to SLogic mode.
This usually means the SLogic firmware is corrupted, often due to a failed OTA update.
**Solution:** Re-flash the correct firmware via OTA.
**Solution:** Re-flash the correct firmware with the [web update tool](https://slogic.sipeed.com/ota/).
## Cannot switch to DFU mode, error shows "unknown USB device".

View File

@@ -353,34 +353,28 @@ Pressing **MODE** again switches back to **SLogic16 U3**. Repeatedly pressing **
## Firmware Update
First, [enter DFU MODE](#MODE-Button): after powering on, press the **MODE button** and wait until the <span style="color:red">red light blinks slowly</span>.
SLogic16U3 firmware is updated online with the web tool **[SLogic Firmware Update](https://slogic.sipeed.com/ota/)** (https://slogic.sipeed.com/ota/) — nothing to download or install.
Confirm that the "*SLogic DFU*" device appears, then use the **DFU Tool** to perform the update.
- **Browser**: Chrome, Edge or another Chromium-based browser on a computer (updates use WebUSB, which Firefox and Safari do not support).
- **Driver**: no driver is needed on Windows. On Linux, run the following once to allow your user to access the analyzer, then re-plug it (the page shows it too):
```bash
sudo tee /etc/udev/rules.d/60-slogic.rules >/dev/null <<'END'
SUBSYSTEM=="usb", ATTRS{idVendor}=="359f", ATTRS{idProduct}=="0300|3031|3032|30f1|30f2", MODE="0666", TAG+="uaccess"
END
sudo udevadm control --reload-rules && sudo udevadm trigger
```
- **USB cable**: use a USB data cable plugged directly into the computer, not a charging-only cable or an unpowered hub.
- **Firmware downloads**: [SLogic16U3 firmware](https://dl.sipeed.com/shareURL/SLogic/SLogic16U3/4_Firmware) (`app.bin`); future updates are published here too.
> In Windows, open Device Manager or use *USB treeview*.
> In Linux/macOS, use *lsusb*.
> You should see "*SLogic DFU*" listed.
### Update steps
Detailed instructions for the DFU tool are provided below.
> In principle, OTA operations only update the SLogic firmware and do not affect the **DFU** function.
> Even if OTA fails, the device will remain locked in **DFU** mode until the SLogic firmware is successfully updated.
Firmware updates are provided via a CLI tool.
- [Firmware update tool repository](https://github.com/sipeed/slogic16u3-tools/tree/main/ota/src/dist)
- [Latest Firmware Download Link](https://dl.sipeed.com/shareURL/SLogic/SLogic16U3/4_Firmware)
### **Update steps:**
1. Download the update tool.
2. Press the **Mode** button on the device. A new device named "SLogic DFU" should appear in the kernel logs (Linux) or Device Manager (Windows).
3. Download the firmware file.
4. Open a command prompt and run `spi_flash_xxx <firmware_path>` to start the update.
5. Wait for the process to complete and check the update result.
![](../../../en/logic_analyzer/slogic16u3/assets/Screenshots/Screenshot_2025-12-25_16-28.png)
![](../../../en/logic_analyzer/slogic16u3/assets/Screenshots/Screenshot_2025-12-25_16-18.png)
1. Download the latest firmware file.
2. Open [https://slogic.sipeed.com/ota/](https://slogic.sipeed.com/ota/) in Chrome / Edge, connect the SLogic16U3 with a USB cable and click **Select device**.
3. Follow the page to enter update mode: press the **MODE** button on the device (see [MODE Button](#MODE-Button)); the LED shows <span style="color:cyan">cyan</span> with a <span style="color:red">slow red blink</span>. Then select "*SLogic DFU*" in the browser dialog.
4. Choose the downloaded firmware file and click **Update firmware**. Keep the device connected and the page open until the update finishes.
5. When the update finishes, unplug the device and plug it back in to start the new firmware.
> In principle the update only replaces the SLogic firmware and never touches the **DFU** (update-mode) function. Even if an update fails, the device stays in update mode — keep it connected and run the update again.
---

View File

@@ -97,5 +97,5 @@ chmod +x Pulseview.appimage
- 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
- Firmware update (web): https://slogic.sipeed.com/ota/
- Community (Discord): [discord.gg/V4sAZ9XWpN](https://discord.gg/V4sAZ9XWpN)

View File

@@ -202,35 +202,30 @@ For advanced/manual builds, refer to upstream sigrok and PulseView documentation
## Firmware Update
Firmware updates are provided via a Python/PyQt GUI tool.
SLogic16U3 firmware is updated online with the web tool **[SLogic Firmware Update](https://slogic.sipeed.com/ota/)** (https://slogic.sipeed.com/ota/) — nothing to download or install.
- [Firmware update tool repository](https://github.com/sipeed/slogic16u3-tools)
- **Browser**: Chrome, Edge or another Chromium-based browser on a computer (updates use WebUSB, which Firefox and Safari do not support).
- **Driver**: no driver is needed on Windows. On Linux, run the following once to allow your user to access the analyzer, then re-plug it (the page shows it too):
```bash
sudo tee /etc/udev/rules.d/60-slogic.rules >/dev/null <<'END'
SUBSYSTEM=="usb", ATTRS{idVendor}=="359f", ATTRS{idProduct}=="0300|3031|3032|30f1|30f2", MODE="0666", TAG+="uaccess"
END
sudo udevadm control --reload-rules && sudo udevadm trigger
```
- **USB cable**: use a USB data cable plugged directly into the computer, not a charging-only cable or an unpowered hub.
- **Firmware downloads**: [SLogic16U3 firmware](https://dl.sipeed.com/shareURL/SLogic/SLogic16U3/4_Firmware) (`app.bin`); future updates are published here too.
**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.
1. Download the latest firmware file.
2. Open [https://slogic.sipeed.com/ota/](https://slogic.sipeed.com/ota/) in Chrome / Edge, connect the SLogic16U3 with a USB cable and click **Select device**.
3. Follow the page to enter update mode: press the **MODE** button on the device (see [Hardware Guide · MODE Button](./Hardware_Specification.md#MODE-Button)); the LED shows <span style="color:cyan">cyan</span> with a <span style="color:red">slow red blink</span>. Then select "*SLogic DFU*" in the browser dialog.
4. Choose the downloaded firmware file and click **Update firmware**. Keep the device connected and the page open until the update finishes.
5. When the update finishes, unplug the device and plug it back in to start the new firmware.
![](../../../en/logic_analyzer/slogic16u3/assets/Screenshots/Screenshot_2025-09-25_15-34-06.png)
> In principle the update only replaces the SLogic firmware and never touches the **DFU** (update-mode) function. Even if an update fails, the device stays in update mode — keep it connected and run the update again.
See [Hardware Guide · Firmware Update](./Hardware_Specification.md#Firmware-Update) for more on browsers, drivers and firmware downloads.
---

Binary file not shown.

Before

Width:  |  Height:  |  Size: 315 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 193 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 64 KiB

View File

@@ -97,7 +97,7 @@ Empty output only means the current config produced no annotations, not that the
### The device is stuck in DFU mode and won't return to SLogic mode?
Usually the SLogic firmware is corrupted, often from an interrupted OTA. Re-flash the correct firmware by OTA to recover.
Usually the SLogic firmware is corrupted, often from an interrupted OTA. Re-flash the correct firmware with the [web update tool](https://slogic.sipeed.com/ota/) to recover.
### Can't enter DFU mode, it says "unknown usb device"?

View File

@@ -234,18 +234,28 @@ The indicator is a 3-color RGB: **blue = power, green = USB LINK, red = run stat
## Firmware Update
The SLogic32U3 supports Easy OTA; firmware can be updated online.
SLogic32U3 firmware is updated online with the web tool **[SLogic Firmware Update](https://slogic.sipeed.com/ota/)** (https://slogic.sipeed.com/ota/) — nothing to download or install.
- **Browser**: Chrome, Edge or another Chromium-based browser on a computer (updates use WebUSB, which Firefox and Safari do not support).
- **Driver**: no driver is needed on Windows. On Linux, run the following once to allow your user to access the analyzer, then re-plug it (the page shows it too):
```bash
sudo tee /etc/udev/rules.d/60-slogic.rules >/dev/null <<'END'
SUBSYSTEM=="usb", ATTRS{idVendor}=="359f", ATTRS{idProduct}=="0300|3031|3032|30f1|30f2", MODE="0666", TAG+="uaccess"
END
sudo udevadm control --reload-rules && sudo udevadm trigger
```
- **USB cable**: use a USB data cable plugged directly into the computer, not a charging-only cable or an unpowered hub.
- **Firmware downloads**: [SLogic32U3 firmware](https://dl.sipeed.com/shareURL/SLogic/SLogic32U3/4_Firmware) (`app.bin`); future updates are published here too.
### Update steps
1. Press MODE to enter DFU mode and wait for the slow blink.
2. Confirm an "SLogic DFU" device appears on the PC.
3. Run the flashing tool, pick the firmware file as prompted, and flash it.
4. Replug the device after flashing; it returns to APP mode.
1. Download the latest firmware file.
2. Open [https://slogic.sipeed.com/ota/](https://slogic.sipeed.com/ota/) in Chrome / Edge, connect the SLogic32U3 with a USB cable and click **Select device**.
3. The page restarts the SLogic32U3 in update mode automatically (LED cyan with a slow red blink); select the update-mode device (usually shown as "SLogic DFU") in the browser dialog. You can also enter update mode by pressing the recessed MODE button with a pin.
4. Choose the downloaded firmware file and click **Update firmware**. Keep the device connected and the page open until the update finishes.
5. When the update finishes the device restarts with the new firmware (LED steady cyan) and returns to APP mode.
> **Firmware downloads**: [SLogic32U3 firmware](https://dl.sipeed.com/shareURL/SLogic/SLogic32U3/4_Firmware); future updates are published here too.
>
> The flashing tool is shared with the SLogic16U3: [slogic16u3-tools](https://github.com/sipeed/slogic16u3-tools/releases/latest).
> In principle the update only replaces the SLogic firmware and never touches the **DFU** (update-mode) function. Even if an update fails, the device stays in update mode — keep it connected and run the update again.
---

View File

@@ -62,7 +62,7 @@ SLogic16U3 的 USB 3.0 提供大约 ~400MB/s 的带宽。
## 装置锁定在DFU模式,无法切换至SLogic模式
这通常意味着SLogic固件损坏,可能是由于OTA失败导致。
解决方法:重新OTA正确的固件。
解决方法:用 [网页升级工具](https://slogic.sipeed.com/ota/) 重新刷入正确的固件。
## 无法切换至DFU模式,提示"unknown usb device"
这意味着USB枚举失败,可能是由于USB线缆过长/质量不好导致。

View File

@@ -350,31 +350,28 @@ update:
## 更新固件
SLogic16U3 的固件通过网页工具在线升级:**[SLogic 固件升级](https://slogic.sipeed.com/ota/)**(https://slogic.sipeed.com/ota/),无需下载或安装任何程序。
首先,[进入DFU MODE](#MODE按键):上电后按下 **MODE按键**,等待<span style="color:red">红灯慢闪</span> 。
- **浏览器**:电脑上的 Chrome、Edge 等 Chromium 内核浏览器(升级基于 WebUSB,Firefox / Safari 不支持)。
- **驱动**:Windows 无需安装驱动;Linux 需先执行一次以下命令授予当前用户访问权限,然后重新插拔设备(网页上也会给出):
```bash
sudo tee /etc/udev/rules.d/60-slogic.rules >/dev/null <<'END'
SUBSYSTEM=="usb", ATTRS{idVendor}=="359f", ATTRS{idProduct}=="0300|3031|3032|30f1|30f2", MODE="0666", TAG+="uaccess"
END
sudo udevadm control --reload-rules && sudo udevadm trigger
```
- **USB 线**:使用支持数据传输的 USB 线直接连接电脑,不要用仅充电线或无供电的集线器。
- **固件下载**:[SLogic16U3 固件下载站](https://dl.sipeed.com/shareURL/SLogic/SLogic16U3/4_Firmware)(`app.bin`),后续更新也发布在此。
确认"*SLogic DFU*" 设备出现后,使用 **DFU工具** 进行更新。
### 更新步骤
> Windows环境打开设备管理器或使用 *USB treeview*,Linux/macOS环境使用 *lsusb* 命令,可以找到 "*SLogic DFU*" 装置
> 理论上,OTA操作只会更新SLogic固件,无法影响 **DFU** 功能。因此即使OTA失败也不要紧,装置会锁定在 **DFU** 模式,直到SLogic固件更新成功。
固件更新通过 命令行 工具提供。
- [固件更新工具仓库](https://github.com/sipeed/slogic16u3-tools/tree/main/ota/src/dist)
- [最新固件下载地址](https://dl.sipeed.com/shareURL/SLogic/SLogic16U3/4_Firmware)
### **更新步骤:**
1. 下载更新工具。
2. 按下设备上的 **mode** 按钮。内核日志(Linux)或设备管理器(Win)应显示名为 "SLogic DFU" 的新设备。
3. 下载固件文件。
4. 打开命令行输入 `spi_flash_xxx 固件路径` 开始更新。
5. 等待完成并查看更新结果。
![](../../../en/logic_analyzer/slogic16u3/assets/Screenshots/Screenshot_2025-12-25_16-28.png)
![](../../../en/logic_analyzer/slogic16u3/assets/Screenshots/Screenshot_2025-12-25_16-18.png)
1. 下载最新固件文件。
2. 用 Chrome / Edge 打开 [https://slogic.sipeed.com/ota/](https://slogic.sipeed.com/ota/),用 USB 线连接 SLogic16U3,点击 **选择设备**。
3. 按页面提示进入升级模式:按下设备上的 **MODE** 按键(见 [MODE按键](#MODE按键)),指示灯变为<span style="color:cyan">青色</span>常亮 + <span style="color:red">红色慢闪</span>,然后在浏览器弹窗中选择 "*SLogic DFU*"。
4. 选择下载的固件文件,点击 **开始升级**。升级完成前保持设备连接,不要关闭页面。
5. 升级完成后,按页面提示拔下设备再重新插入,即运行新固件。
> 理论上,升级只会更新 SLogic 固件,不会影响 **DFU**(升级模式)功能。因此即使升级失败也不要紧:设备会停留在升级模式,保持连接后重新升级即可。
## 安全 & 注意事項

View File

@@ -99,5 +99,5 @@ chmod +x Pulseview.appimage
- 支持邮箱: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
- 固件在线升级:https://slogic.sipeed.com/ota/
- 社区(Discord):[discord.gg/V4sAZ9XWpN](https://discord.gg/V4sAZ9XWpN)

View File

@@ -211,35 +211,30 @@ chmod +x Pulseview.appimage
## 固件更新
固件更新通过 Python / PyQt GUI 工具提供。
SLogic16U3 的固件通过网页工具在线升级:**[SLogic 固件升级](https://slogic.sipeed.com/ota/)**(https://slogic.sipeed.com/ota/),无需下载或安装任何程序。
- [固件更新工具仓库](https://github.com/sipeed/slogic16u3-tools)
- **浏览器**:电脑上的 Chrome、Edge 等 Chromium 内核浏览器(升级基于 WebUSB,Firefox / Safari 不支持)。
- **驱动**:Windows 无需安装驱动;Linux 需先执行一次以下命令授予当前用户访问权限,然后重新插拔设备(网页上也会给出):
```bash
sudo tee /etc/udev/rules.d/60-slogic.rules >/dev/null <<'END'
SUBSYSTEM=="usb", ATTRS{idVendor}=="359f", ATTRS{idProduct}=="0300|3031|3032|30f1|30f2", MODE="0666", TAG+="uaccess"
END
sudo udevadm control --reload-rules && sudo udevadm trigger
```
- **USB 线**:使用支持数据传输的 USB 线直接连接电脑,不要用仅充电线或无供电的集线器。
- **固件下载**:[SLogic16U3 固件下载站](https://dl.sipeed.com/shareURL/SLogic/SLogic16U3/4_Firmware)(`app.bin`),后续更新也发布在此。
**更新步骤:**
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. 等待完成并按界面指引操作。
> **注意:** 将很快发布该更新工具的二进制版本。
1. 下载最新固件文件。
2. 用 Chrome / Edge 打开 [https://slogic.sipeed.com/ota/](https://slogic.sipeed.com/ota/),用 USB 线连接 SLogic16U3,点击 **选择设备**。
3. 按页面提示进入升级模式:按下设备上的 **MODE** 按键(见 [硬件说明 · MODE按键](./Hardware_Specification.md#MODE按键)),指示灯变为<span style="color:cyan">青色</span>常亮 + <span style="color:red">红色慢闪</span>,然后在浏览器弹窗中选择 "*SLogic DFU*"。
4. 选择下载的固件文件,点击 **开始升级**。升级完成前保持设备连接,不要关闭页面。
5. 升级完成后,按页面提示拔下设备再重新插入,即运行新固件。
![](../../../en/logic_analyzer/slogic16u3/assets/Screenshots/Screenshot_2025-09-25_15-34-06.png)
> 理论上,升级只会更新 SLogic 固件,不会影响 **DFU**(升级模式)功能。因此即使升级失败也不要紧:设备会停留在升级模式,保持连接后重新升级即可。
浏览器、驱动与固件下载的详细说明见 [硬件说明 · 更新固件](./Hardware_Specification.md#更新固件)。
---

View File

@@ -97,7 +97,7 @@ sudo udevadm trigger
### 设备锁定在 DFU 模式,无法切回 SLogic 模式?
通常是 SLogic 固件损坏,多见于 OTA 中断。重新 OTA 刷入正确固件即可恢复。
通常是 SLogic 固件损坏,多见于 OTA 中断。用 [网页升级工具](https://slogic.sipeed.com/ota/) 重新刷入正确固件即可恢复。
### 无法进入 DFU 模式,提示 "unknown usb device"?

View File

@@ -235,18 +235,28 @@ SLogic32U3 可选配 4 通道 ADC 模组,把对应管脚采样**作为 8-bit
## 更新固件
SLogic32U3 支持 Easy OTA,固件可在线升级。
SLogic32U3 的固件通过网页工具在线升级:**[SLogic 固件升级](https://slogic.sipeed.com/ota/)**(https://slogic.sipeed.com/ota/),无需下载或安装任何程序。
- **浏览器**:电脑上的 Chrome、Edge 等 Chromium 内核浏览器(升级基于 WebUSB,Firefox / Safari 不支持)。
- **驱动**:Windows 无需安装驱动;Linux 需先执行一次以下命令授予当前用户访问权限,然后重新插拔设备(网页上也会给出):
```bash
sudo tee /etc/udev/rules.d/60-slogic.rules >/dev/null <<'END'
SUBSYSTEM=="usb", ATTRS{idVendor}=="359f", ATTRS{idProduct}=="0300|3031|3032|30f1|30f2", MODE="0666", TAG+="uaccess"
END
sudo udevadm control --reload-rules && sudo udevadm trigger
```
- **USB 线**:使用支持数据传输的 USB 线直接连接电脑,不要用仅充电线或无供电的集线器。
- **固件下载**:[SLogic32U3 固件下载站](https://dl.sipeed.com/shareURL/SLogic/SLogic32U3/4_Firmware)(`app.bin`),后续更新也发布在此。
### 更新步骤
1. 按 MODE 键进入 DFU 模式,等待指示灯慢闪。
2. 确认电脑上出现 "SLogic DFU" 设备。
3. 运行固件刷写工具,按提示选择固件文件并刷入。
4. 刷写完成后重新插拔设备,设备会回到 APP 模式。
1. 下载最新固件文件。
2. 用 Chrome / Edge 打开 [https://slogic.sipeed.com/ota/](https://slogic.sipeed.com/ota/),用 USB 线连接 SLogic32U3,点击 **选择设备**。
3. 页面会自动把 SLogic32U3 重启到升级模式(指示灯青色常亮 + 红色慢闪),按提示在浏览器弹窗中选择升级模式设备(通常显示为 "SLogic DFU")。也可先用卡针按背面的 MODE 小孔按键手动进入升级模式。
4. 选择下载的固件文件,点击 **开始升级**。升级完成前保持设备连接,不要关闭页面。
5. 升级完成后设备自动以新固件重启(指示灯青色常亮),回到 APP 模式。
> **固件下载**:[SLogic32U3 固件下载站](https://dl.sipeed.com/shareURL/SLogic/SLogic32U3/4_Firmware),后续更新也发布在此。
>
> 刷写工具与 SLogic16U3 共用同一套工具链:[slogic16u3-tools](https://github.com/sipeed/slogic16u3-tools/releases/latest)。
> 理论上,升级只会更新 SLogic 固件,不会影响 **DFU**(升级模式)功能。因此即使升级失败也不要紧:设备会停留在升级模式,保持连接后重新升级即可。
---