DS5Dongle 源码编译教程Windows 11 一行命令、macOS 一键脚本免 WSL完整环境搭建【免费下载链接】DS5DongleTurn your Pico 2 W into a DualSense 5 dongle.项目地址: https://gitcode.com/gh_mirrors/ds/DS5DongleDS5Dongle 能把树莓派 Pico 2 W 变成 DualSense 手柄的无线适配器支持 HD 震动、耳麦音频与麦克风。本文带你从零搭建编译环境Windows 11 只需一行 PowerShell 命令无需 WSLmacOS 一条脚本一键搞定并附手动 CMake 编译、特殊开发板构建与刷机验证全流程新手也能一次编译成功。一、项目简介为什么要自己编译源码大多数用户直接下载预编译固件即可使用但自己编译 DS5Dongle 源码可以按需定制开启调试串口、PS 键唤醒Wake-on-PS等可选功能针对自己的开发板构建如 Waveshare RP2350B-Plus-W验证最新提交拿到仓库最新代码体验尚未发布的功能。硬件准备清单物料说明Raspberry Pi Pico 2 W主控板Pico W 也支持但无扬声器DualSense 手柄DS5 无线手柄USB 数据线连接 Pico 与电脑二、Windows 11 一行命令编译免 WSLDS5Dongle 官方提供了专门的 Windows 构建脚本 tools/build-windows.ps1它会自动安装所有依赖并产出固件全程不需要安装 WSL。2.1 获取编译脚本两种方式任选方式 A克隆整个仓库推荐可看源码git clone https://gitcode.com/gh_mirrors/ds/DS5Dongle cd DS5Dongle方式 B只下载脚本如果只想编译甚至不需要克隆仓库——把 tools/build-windows.ps1 这一个文件下载到任意文件夹即可运行。2.2 一行命令启动编译在 PowerShell 中执行powershell -ExecutionPolicy Bypass -File .\build-windows.ps1脚本会自动完成以下工作安装前置工具优先通过winget安装 CMake、Ninja、Python、Git 和 ARM GNU 工具链若没有winget自动回退为便携版下载拉取依赖克隆项目 锁定版本的 Pico SDK 与 TinyUSB 到%USERPROFILE%\.ds5-build初始化子模块自动执行git submodule update --init --recursive编译固件用 CMake Ninja 构建产物ds5-bridge.uf2会放在脚本同目录和桌面方便直接拖进 Pico 刷机。脚本可安全重复运行——已安装的工具会自动跳过。2.3 可选参数编译调试版/唤醒版参数作用-Variant debug开启串口输出与详细日志-Variant wake开启 PS 键唤醒Wake-on-PS功能-Repo url指定要克隆的仓库地址编译 Fork 时用-Ref branch\|tag指定分支、标签或提交-Clean先清空该变体的构建目录再编译示例编译带唤醒功能的版本powershell -ExecutionPolicy Bypass -File .\build-windows.ps1 -Variant wake三、macOS 一键脚本编译macOS 用户使用仓库自带的 tools/build-macos.sh 一键脚本tools/build-macos.sh脚本会自动准备仓库本地的 Pico SDK 检出、提示安装缺失的 Homebrew 构建工具、初始化子模块、固定 TinyUSB 版本然后完成编译。常用选项# 从头干净重建 tools/build-macos.sh --clean # 编译标准版不带唤醒 HID tools/build-macos.sh --standard # 复用已有的 Pico SDK tools/build-macos.sh --sdk-dir /path/to/pico-sdk 若 Homebrew 的arm-none-eabi-gcc缺少标准 C 头文件脚本会提示改装完整的gcc-arm-embeddedcask 并自动指向该工具链按提示确认即可。四、手动 CMake 编译Linux 及通用流程想理解底层流程或编译其他平台可按 README.md 的标准步骤手动执行安装 Pico SDK 2.3.0并将其 TinyUSB 子模块切换到 tag0.21.0这一步很关键旧版 TinyUSB 无法使用完整 USB 音频路径初始化仓库子模块git submodule update --init --recursive配置并构建sdk替换为 Pico SDK 路径cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPERelease -DPICO_SDK_PATHsdk cmake --build build --target ds5-bridge构建选项都定义在 CMakeLists.txt 中按需添加-D参数即可。五、特殊开发板编译5.1 Pico W 版本Pico W 性能有限只支持震动、不支持扬声器。加参数开启-DPICO_W_BUILDON5.2 Waveshare RP2350B-Plus-W该板基于 RP2350B带 RM2 无线模块、16 MB QSPI 闪存和 USB-C 接口。可直接用专用脚本 boards/build_waveshare_rp2350b_plus_w.sh./boards/build_waveshare_rp2350b_plus_w.sh Release或手动加编译开关-DWAVESHARE_RP2350B_PLUS_W_BUILDON。六、刷入固件并验证编译成功后得到ds5-bridge.uf2刷写步骤非常简单按住 Pico 板上的BOOTSEL按钮用 USB 线连接电脑Pico 会挂载为一个 U 盘设备把ds5-bridge.uf2直接拖拽进该 U 盘等待自动烧录重启将 DualSense 手柄进入蓝牙配对模式长按PS Create/Share直到灯条闪烁等待 Pico 自动连接。连接成功后电脑系统中就会出现 DS5 手柄设备 。常见小问题速查编译报工具链缺失 → 重新运行脚本它会自动补齐缺失工具固件刷入后设备不出现 → 手柄未连接时 Pico 不会向系统显示先完成配对手柄配对失败 → 尝试在配对模式下重新插拔 Pico。总结平台推荐方式关键命令Windows 11一键脚本免 WSLpowershell -ExecutionPolicy Bypass -File .\build-windows.ps1macOS一键脚本tools/build-macos.shLinux / 其他手动 CMakecmake --build build --target ds5-bridge按本文步骤操作从克隆仓库到拿到ds5-bridge.uf2全程无需手动配置任何依赖——编译完成后拖入 U 盘你的 Pico 2 W 就变成了一枚 DualSense 无线适配器快去试试吧【免费下载链接】DS5DongleTurn your Pico 2 W into a DualSense 5 dongle.项目地址: https://gitcode.com/gh_mirrors/ds/DS5Dongle创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考