DS5Dongle 生态地图6 大社区 Fork 功能对比 完整支持渠道清单Pico 2 W 变身 DualSense 无线适配器终极指南【免费下载链接】DS5DongleTurn your Pico 2 W into a DualSense 5 dongle.项目地址: https://gitcode.com/gh_mirrors/ds/DS5DongleDS5Dongle 是一款把Raspberry Pi Pico 2 W变成DualSenseDS5手柄无线适配器的开源固件插上电脑无线手柄即刻变成有线设备还支持 HD 震动、耳机音频输出与麦克风输入。本文用一张「生态地图」讲清6 大社区 ForkOLED 屏版 / 音频震动版 / DS4 版的功能差异并附上完整支持渠道清单帮你 3 分钟选对固件 一、DS5Dongle 是什么Pico 2 W 变身 DS5 无线适配器的核心能力主仓库只实现DS5Dongle 的核心功能——让无线 DualSense 手柄在电脑上以「有线」形态出现其余扩展功能都由社区 Fork 承担。核心能力说明 无线桥接DualSense / DualSense Edge 蓝牙配对后作为 USB 有线手柄出现 HD 震动完整透传 DualSense 高级触觉反馈Pico W 版本除外 耳机音频手柄扬声器 3.5 mm 耳机口输出麦克风作为 USB 音频输入 BOOTSEL 一键管理短按断开/配对、双击重启、三击进 BOOTSEL、长按清除所有配对全程免拔线⚡ 免超频运行音频热路径从 RAM 执行见 cmake/relocate_to_ram.cmake标准150 MHz即可跑满全部音频功能无需超频 低电量提醒手柄电量 ≤10% 时板载 LED 以 1 Hz 闪烁src/battery_led.cpp支持的硬件平台见 CMakeLists.txtPico 2 W默认目标功能最全Pico W-DPICO_W_BUILDON编译仅支持震动、无扬声器Waveshare RP2350B-Plus-WRP2350B 16 MB Flash USB-C可用 boards/build_waveshare_rp2350b_plus_w.sh 一键编译所有参数都可通过官方 Web 配置页在线调整震动增益、轮询率 250/500 Hz、麦克风/扬声器来源、PS 键唤醒、Xbox Game Bar 快捷键等完整字段定义在 src/config.h。二、生态地图6 大社区 Fork 功能对比主仓库 README 的 Community Fork 章节 列出了 6 个主要 Fork。它们与主仓库是「核心 扩展」的关系1️⃣ loteran/DS5Dongle —— 音频自动震动版从游戏音频实时生成震动Pico 监听游戏声音流把低频与撞击声转换成 DualSense 震动无需游戏本身支持触觉反馈也能「震起来」。适合想让老游戏也有沉浸震动的玩家。2️⃣ SundayMoments/DS5_Bridge —— 深度定制版更多自定义功能音频、震动、扳机力度、灯效、按键重映射、快捷键等参数级调整。适合喜欢把手柄调教到「刚刚好」的折腾党。3️⃣ MarcelineVPQ/DS5Dongle-OLED-Edition —— OLED 屏版最热门增加可选的Pico-OLED-1.3128×64屏幕扩展板提供11 个界面状态页、4 槽位多手柄配对、灯条颜色选择器含收藏与特效预设、扳机测试、陀螺仪倾斜、触摸板、诊断、CPU/时钟、蓝牙信号强度、音频 VU 表、常驻设置菜单并支持 DS5 按键组合软重启。适合想要「看得见」的连接状态与多手柄管理场景。4️⃣ artzox/DS5Dongle —— 震动增强版在 Awalol 与 Loteran 工作基础上扩展模拟震动原生震动抗锯齿、音频泄漏、扳机震动、扳机阻力、陀螺仪辅助瞄准、配置文件自动加载。适合追求最强震动质感与扳机体验的硬核用户。5️⃣ snipem/DS4Dongle —— DualShock 4 版为DS4 手柄服务的 Pico 2 W 固件受 DS5Dongle 启发同样带耳机与麦克风支持及配置能力。适合手里只有 DS4 的玩家——同样的无线适配体验换个手柄也能玩。6️⃣ zurce/DS5Dongle-OLED —— OLED 屏版另一个DS5 OLED 显示屏方向的 Fork与上面的 OLED-Edition 互为备选功能细节以该 Fork 自身文档为准。 一张表看懂 6 大 Fork 怎么选Fork定位核心新增能力硬件要求主仓库上游核心桥接默认之选HD 震动、耳机音频/麦克风、BOOTSEL 管理、USB 唤醒、PS 快捷键Pico 2 Wloteran/DS5Dongle音频自动震动声音→震动实时生成老游戏也可震Pico 2 WSundayMoments/DS5_Bridge深度定制音频/震动/扳机/灯效/按键重映射/快捷键Pico 2 WMarcelineVPQ/DS5Dongle-OLED-EditionOLED 可视化1.3 寸屏 11 界面、4 槽多手柄配对、VU 表Pico 2 W Pico-OLED-1.3artzox/DS5Dongle震动增强震动抗锯齿、扳机震动/阻力、陀螺仪瞄准、自动档案Pico 2 Wsnipem/DS4DongleDS4 专用DualShock 4 无线桥接 耳机/麦克风Pico 2 W DS4zurce/DS5Dongle-OLEDOLED 备选DS5 OLED 显示Pico 2 W OLED 模块三、按需求选 Fork3 步决策法需求是「能用」还是「好用」只想要稳定无线连接 HD 震动 音频 → 直接用主仓库固件它已是完整可用水准。缺什么补什么想要「震动更爽 / 声音变震动」 → 在loteran与artzox之间选前者主打音频驱动震动后者主打震动质量增强想要「看得见 多手柄」 →MarcelineVPQ 的 OLED-Edition或 zurce 的 OLED 版想要「参数狂调」 →SundayMoments/DS5_Bridge手柄是DS4→ 只能选snipem/DS4Dongle。注意上游关系社区 Fork 多以主仓库为上游如 OLED-Edition 明确基于上游 fork主仓库更新后 Fork 会有合并滞后选择时可留意各 Fork 的同步进度。 需要自己编译时先克隆主仓库git clone https://gitcode.com/gh_mirrors/ds/DS5DongleWindows 用户也可直接运行tools/build-windows.ps1一条命令完成全部依赖安装与构建见 README.md 的 Build Instructions 章节。四、完整支持渠道清单配置页、社区与调试工具渠道用途获取方式 官方 Web 配置页正式版在线修改所有固件参数、重连 USB、重启进 BOOTSEL访问ds5.awalol.eu.org Web 配置页开发版体验开发分支新参数访问ds5-dev.awalol.eu.org Discord 社区服务器官方即时交流、求助与反馈入口见 README.md 的 Community 章节 IssuesBug 报告与功能讨论在仓库 Issues 页面提交官方建议遇到问题优先开 Issue Releases预编译.uf2固件、other board.zip、config_tool.py仓库 Releases 页下载无需任何工具️ 本地配置脚本USB HID 免刷机读写配置get/set/fieldstools/config_tool.py依赖pip install hidapi BOOTSEL 重启脚本辅助触发重启进 BOOTSELtools/reboot_bootsel.py 抓包调试脚本Wireshark 解析 DualSense SetState 报文tools/wireshark_dualsense_setstate.lua两条使用小贴士来自 README.md 的 Notes 章节手柄麦克风在 Windows 上显示为 Headset Microphone选为录音设备后记得把输入音量调大Windows 默认常为 0听起来像麦克风坏了。部分行为需要重新连接手柄后才会生效。五、主要模块路径速查读懂 DS5Dongle 的源码骨架模块职责src/main.cpp固件入口与任务调度src/bt.cpp / src/bt.h蓝牙协议栈配对、数据通道、BOOTSEL 按键动作分发src/usb.cpp / src/usb_descriptors.cppUSB 复合设备假 DualSense 描述符src/fake_ds5.hsrc/audio.cppOpus 编解码、重采样、扬声器/麦克风/3.5 mm 通路src/config.cpp / src/config.h配置读取/持久化Flash CRC32 校验src/cmd.cppHID Feature Report 命令协议供config_tool.py使用src/wake.cppUSB 远程唤醒PS 键注入 F15 唤醒 S3 睡眠src/ps_shortcut.cppPS 键映射 WinG / WinTabXbox Game Bar / 任务视图src/button_functions.cppBOOTSEL 单击/双击/三击/长按手势识别src/dse.cppDualSense Edge 控制器支持src/status_gpio.cpp状态 GPIO连接指示/按键脉冲输出cmake/relocate_to_ram.cmake音频热路径搬入 RAM实现免超频⚠️ 已知问题音频可能存在轻微卡顿README.md。这是当前全生态主仓库 各 Fork共同面对的瓶颈社区正在持续优化。总结DS5Dongle 主仓库负责「把 DS5 变无线」这件事并做到足够好6 大社区 Fork 则分别向OLED 可视化、音频震动、震动增强、深度定制、DS4 兼容五个方向生长。按「核心功能看主仓库、扩展功能看 Fork」的原则选再用上面的支持渠道清单兜底你的 Pico 2 W 就能稳定变身 DualSense 无线适配器了。【免费下载链接】DS5DongleTurn your Pico 2 W into a DualSense 5 dongle.项目地址: https://gitcode.com/gh_mirrors/ds/DS5Dongle创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考