解决 DSLogic 逻辑分析仪在 sigrok-cli 中报错 “Failed to open resource” 的问题

---

解决 DSLogic 逻辑分析仪在 sigrok-cli 中报错 “Failed to open resource” 的问题

背景

近期在使用 DreamSourceLab 出品的 DSLogic Plus 逻辑分析仪时，希望通过开源的 sigrok-cli 命令行工具进行数据采集与控制。然而在连接设备时遇到了固件缺失的错误，导致设备无法正常工作。经过一番排查，最终顺利解决。现将完整过程记录如下，希望对遇到类似问题的朋友有所帮助。

一、问题现象

在 Windows PowerShell 中执行以下扫描命令：

sigrok-cli --driver dreamsourcelab-dslogic --scan

出现如下报错（部分关键信息）：

sr: resource: Failed to open resource 'dreamsourcelab-dslogic-plus-fx2.fw' (use loglevel 5/spew for details).
sr: dreamsourcelab-dslogic: Firmware upload failed for device 1.12 (logical), name dreamsourcelab-dslogic-plus-fx2.fw.
The following devices were found:
dreamsourcelab-dslogic - DreamSourceLab DSLogic Plus with 16 channels: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

分析：

• 设备本身已被 USB 识别（最后一行显示了设备），但固件上传失败。
• 提示缺少文件 dreamsourcelab-dslogic-plus-fx2.fw，这是 DSLogic Plus 所需的 FX2 控制器固件。
• sigrok 在加载设备时需要将此固件动态上传到 DSLogic 硬件中，缺失则无法正常采集。

二、根本原因

sigrok 项目并不直接包含各厂商的专有固件，需要用户自行获取并放置到正确的搜索路径中。
对于 DSLogic Plus，需要两个核心固件文件：

• dreamsourcelab-dslogic-plus-fx2.fw – USB 控制器的固件
• dreamsourcelab-dslogic-plus-fpga.fw – FPGA 逻辑固件（部分采集操作需要）

本次报错仅提示缺少第一个 .fw 文件，因此首要解决此问题。

三、解决方案

1. 获取正确的固件文件

官方提供了固件提取脚本或手动下载方式。推荐从 sigrok 官方 Wiki 获取兼容的固件版本。

• 访问：DreamSourceLab DSLogic - sigrok Wiki
• 在页面中找到 “Firmware” 章节，根据你的设备型号（Basic / Plus / Pro）下载对应的固件文件。
  对于 DSLogic Plus，需要的文件为 DSLogic.fw（对应 FX2）和 DSLogicPlus.bin（对应 FPGA）。

若无法直接从 Wiki 下载，也可以从梦源科技官方提供的 DSView 软件安装目录中提取：
通常位于 C:\Program Files\DSView\res\ 下的 DSLogicPlus.fw 和 DSLogicPlus.bin。

2. 重命名固件文件

sigrok-cli 期望的命名规则与原始文件名不同，需要手动重命名：

原始文件（来自 DSView）	重命名后（sigrok 期望）
DSLogicPlus.fw	dreamsourcelab-dslogic-plus-fx2.fw
DSLogicPlus.bin	dreamsourcelab-dslogic-plus-fpga.fw

注意：如果使用的是 DSLogic Basic 型号，则文件名为 dreamsourcelab-dslogic-fx2.fw 和 dreamsourcelab-dslogic-fpga-5v.fw / -3v3.fw。根据实际设备选择对应名称。

3. 放置到 sigrok-cli 固件目录

sigrok-cli 会在多个预设路径中搜索固件。一个可靠的位置是 sigrok-cli 安装目录下的 share\sigrok-firmware。

以我本地环境为例：

• sigrok-cli 安装在 D:\Programs\sigrok\sigrok-cli
• 将重命名后的 .fw 文件复制到：
  D:\Programs\sigrok\sigrok-cli\share\sigrok-firmware\

最终文件路径：

D:\Programs\sigrok\sigrok-cli\share\sigrok-firmware\dreamsourcelab-dslogic-plus-fx2.fw
D:\Programs\sigrok\sigrok-cli\share\sigrok-firmware\dreamsourcelab-dslogic-plus-fpga.fw

其他可能的搜索路径（按优先级）：

• %LOCALAPPDATA%\sigrok-firmware
• C:\ProgramData\sigrok-firmware
• C:\Users\Public\Documents\sigrok-firmware

通常放在安装目录下即可，因为 sigrok-cli --scan 的日志中会列出所有搜索路径，你可以用 -l 5 参数查看详细日志确认。

4. 重新插拔设备并验证

完成文件放置后，拔掉 DSLogic 的 USB 线，等待几秒后重新插入。
这步很重要，因为设备需要重新枚举并触发固件上传。

再次运行扫描命令：

sigrok-cli --driver=dreamsourcelab-dslogic --scan

成功时输出如下（无报错信息）：

The following devices were found:
dreamsourcelab-dslogic:conn=1.17 - DreamSourceLab DSLogic Plus with 16 channels: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

此外，还可以尝试一次简单采集来确认功能正常：

sigrok-cli --driver=dreamsourcelab-dslogic --config samplerate=1M --samples=100 --output-format=csv

如果输出 CSV 数据（即使全是 0 或 1），说明固件已成功上传，设备可用。

四、补充说明与常见问题

Q1：为什么固件需要手动放置？不能自动下载吗？

出于许可证原因，sigrok 不直接分发厂商固件。用户需要自行从官方渠道（DSView 软件或 Wiki）获取并放置。

Q2：固件版本有要求吗？

建议使用与 DSLogic 硬件相匹配的固件版本。对于较新的 DSLogic Plus（PID 0x0034 等），可能需要较新版本的固件。如果上述方法仍然无法工作，可以尝试从 DSView 最新版中提取固件，并确保 sigrok-cli 也是最新版（可使用 nightly build）。

Q3：放置固件后仍然报错 “Failed to open resource”？

• 确认文件名拼写完全正确（区分大小写，Windows 下不区分但建议保持一致）。
• 确认文件扩展名为 .fw 而不是 .fw.txt 或 .bin。
• 使用 -l 5 参数运行扫描，查看详细日志中固件搜索路径是否包含了你的放置目录。
• 尝试将固件同时复制到其他搜索路径（如 %LOCALAPPDATA%\sigrok-firmware）。

【新】Q4：扫描正常，但执行采集时提示缺少 dreamsourcelab-dslogic-plus-fpga.fw？

现象：运行采集命令（如 --config samplerate=1M --samples=100）时报错：

sr: resource: Failed to open resource 'dreamsourcelab-dslogic-plus-fpga.fw' (use loglevel 5/spew for details).
Failed to open device.

原因：此时只放置了 FX2 固件（*fx2.fw），但采集操作需要 FPGA 固件（*fpga.fw）来配置逻辑分析仪的采样逻辑。

解决方法：按照步骤三中的说明，将 DSLogicPlus.bin（或对应型号的 .bin 文件）重命名为 dreamsourcelab-dslogic-plus-fpga.fw，并放置到相同的固件目录中。之后重新插拔设备即可。

简单概括：缺少哪个 .fw 文件，就按同样的方法从 DSView 中提取并重命名后放入固件目录。两个固件都放好后，设备即可完全正常工作。