DS5Dongle 快速上手教程6 步刷好固件、配对 DualSense 手柄新手友好 常见问题【免费下载链接】DS5DongleTurn your Pico 2 W into a DualSense 5 dongle.项目地址: https://gitcode.com/gh_mirrors/ds/DS5DongleDS5Dongle 是一款开源固件能把树莓派 Pico 2 W 变成 DualSensePS5手柄的无线适配器手柄蓝牙连上 Pico电脑端则把它当成有线手柄使用还完整支持 HD 震动、手柄扬声器/3.5mm 耳机输出和麦克风输入。本教程带你用 6 步完成固件刷写与手柄配对并附新手常见问题解答。一、DS5Dongle 是什么它能做什么 一句话概括用一块几十块钱的 Pico 2 W让 DualSense 手柄在 Windows / Linux 上无线使用而且不掉 HD 震动效果。核心能力一览 DualSense / DualSense Edge 无线桥接电脑上呈现为有线手柄 完整支持 HD 高级震动反馈 手柄扬声器 3.5mm 耳机孔音频输出 手柄麦克风暴露为 USB 音频输入设备 复用 Pico 的 BOOTSEL 按键管理手柄配对、重启、进刷机模式、清除配对不用拔线⚡ 原生 150MHz 主频即可稳定运行无需超频 注意Pico 只有在手柄连接成功后才会被电脑识别这是正常现象别急着以为没刷成功。二、准备工作你需要什么物品说明Raspberry Pi Pico 2 W核心硬件也支持 WaveShare RP2350B-Plus-W 等兼容板DualSense / DualSense Edge 手柄确保手柄有电USB 数据线能传数据的线直连电脑固件文件项目 Releases 页的预编译ds5-bridge-version.uf2无需自己编译如果你想在其他兼容板如 RP2350B-Plus-W上编译可参考板级构建脚本 boards/build_waveshare_rp2350b_plus_w.sh 与板级头文件 boards/headers/waveshare_rp2350b_plus_w.h主编译入口在 CMakeLists.txt。三、刷写固件第 1~2 步⚡第 1 步获取固件到项目 Releases 页面下载最新预编译固件ds5-bridge-version.uf2。其他板型固件打包在other board.zip里config_tool.py配置文件也在其中。新手直接下现成的.uf2即可不用碰编译环境。第 2 步进入 BOOTSEL 并拖入固件按住Pico 2 W 上的 BOOTSEL 按钮不松手用 USB 线把 Pico 连到电脑系统会识别出一个 USB 大容量存储设备类似 U 盘把.uf2文件拖进去等待自动重启✅ 刷机完成之后刷固件还有更省事的办法固件运行中连点 3 下 BOOTSELPico 会自动重枚举为 U 盘直接拖新的.uf2即可不必再按住按钮插线。 小技巧网页配置页里也有Reboot to Bootloader按钮可远程让 Pico 进 BOOTSEL 刷机模式命令行工具 tools/reboot_bootsel.py 也能做到同样的事。四、配对 DualSense 手柄第 3~4 步第 3 步手柄进入蓝牙配对模式长按PS 键 Create/Share 键直到手柄灯条快速闪烁即进入配对模式。第 4 步等待 Pico 自动发现并连接Pico 开机后会进入配对扫描发现手柄即自动连接。若 30 秒内没连上可以短按一下 BOOTSEL 触发一次 30 秒的新手柄扫描扫描期间让手柄保持闪烁配对状态或者在手柄处于配对模式时重新插拔一次 Pico官方 README 也特别提示了这一点见 README.md / README.CN.md。五、验证与配置第 5~6 步第 5 步确认电脑识别手柄连接成功后设备管理器中会出现一个 DualSense 手柄设备直接开游戏或按普通手柄使用即可。第 6 步可选调整音量、震动等设置两种官方配置方式网页配置固件内置 Web 配置界面可调整音量、震动增益、开启 PS 键唤醒电脑 / Xbox Game Bar 快捷键等命令行工具tools/config_tool.py 通过 USB HID 直接读写配置无需重新刷机例如pip install hidapi python config_tool.py get # 读取当前配置 python config_tool.py set speaker_volume90 # 修改并保存想深入了解实现的可以看看配置定义 src/config.h、蓝牙桥接核心 src/bt.cpp 和 USB 端实现 src/usb.cpp。六、BOOTSEL 按键速查表超实用固件运行后Pico 上的 BOOTSEL 按钮就是手柄遥控器操作效果单击已连接→断开当前手柄保留配对未连接→开始 30 秒新配对扫描双击重启 Pico恢复偶发故障三击进入 BOOTSEL 刷机模式直接拖入新.uf2长按约 1.5 秒忘记所有已配对手柄LED 闪 6 次确认之后需重新配对七、常见问题FAQ❓Q1插上 Pico 后电脑没反应正常。Pico 必须等手柄连接成功后才会在系统中出现先完成配对再等它枚举。Q2手柄连不上 Pico确保手柄处于 PS Create/Share 闪烁的配对状态并在配对模式下重新插拔一次 Pico也可单击 BOOTSEL 手动触发 30 秒扫描。Q3麦克风没声音Windows 中手柄麦克风显示为 Headset Microphone选中它之后要把输入/拾音电平调大——Windows 默认经常是 0不是麦克风坏了。Q4Pico 上的 LED 一闪一闪是故障吗不是。手柄电量 ≤10% 且未在充电时LED 会从常亮变为 1Hz 慢闪提醒低电量逻辑见 src/battery_led.cpp充上电或电量回升后恢复常亮。Q5音频偶尔有点卡顿官方已知问题属正常现象。得益于音频热路径整体搬进 RAM 执行见 cmake/relocate_to_ram.cmake现在的固件在 150MHz 原频下即可完整跑通音频链路无需再像早期版本那样超频到 320MHz。Q6我的手柄之前配对过为什么突然不连了可能是被长按 BOOTSEL清除了配对或被其他设备抢占。重新进入 PS Create/Share 配对模式即可。八、写在最后整个上手过程不超过 10 分钟下载.uf2→ 拖入 BOOTSEL → 手柄 PSCreate 配对 → 开玩。之后想调参数用网页配置或config_tool.py随手一调即可。更多细节可查阅仓库内的 README.md 与 README.CN.md。【免费下载链接】DS5DongleTurn your Pico 2 W into a DualSense 5 dongle.项目地址: https://gitcode.com/gh_mirrors/ds/DS5Dongle创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考