awalol/DS5Dongle

GitHub: awalol/DS5Dongle

将树莓派 Pico 2 W 变成 DualSense 手柄的蓝牙无线网桥,实现无线连接并完整支持 HD 触觉反馈。

Stars: 1094 | Forks: 68

# Pico2W DualSense 5 网桥 [中文](./README.CN.md) ## 概述 本项目使 Raspberry Pi Pico2W 能够作为 DualSense 控制器的蓝牙网桥,提供无线连接并增强触觉反馈支持。 ## 功能特性 - 🎮 通过 Pico2W 实现完整的 DualSense 连接 - 🔊 支持 HD 触觉反馈(高级震动反馈) - 📡 无线蓝牙桥接 - ⚙️ 可通过麦克风音量调节触觉增益 - 🔕 可配置的 LED 和断开连接行为 ## 入门指南 ### 刷入固件 1. 按住 Pico2W 上的 BOOTSEL 按钮 2. 通过 USB 将 Pico2W 连接到计算机 3. 设备将挂载为 USB 存储设备 4. 将 .uf2 固件文件拖放到设备中 ### 配对控制器 1. 将 DualSense 控制器置于蓝牙配对模式 2. 等待 Pico2W 检测并连接 3. 连接成功后,该设备将出现在主机系统中 ## 配置说明 以下控制器设置已被重新定义用途: ### 麦克风音量 控制触觉增益倍数 范围:[1.0 – 2.0] ### 扬声器静音 禁用 LED 连接指示灯 在控制器重新连接后生效 ### 麦克风静音 禁用静默断开连接行为 ## 注意事项 Pico 设备只有在控制器连接后才会被系统识别 某些行为需要重新连接循环才能生效 ## 已知问题 - ⚠️ 音频可能会出现轻微卡顿 - ⚠️ 需要超频才能保证正常运行 ## 性能 / 超频 由于编码需求,Pico2W 必须进行超频: 当前设置: - 电压:1.2V - 频率:320 MHz 如果您的设备无法启动: - 稍微提高电压或降低 CPU 频率 ## 构建说明 要从源代码构建本项目: 1. 将 Pico SDK 中的 TinyUSB 更新到最新版本 2. 使用标准的 Pico SDK 工具链进行编译 ## 路线图 - 请查看 [DS5Dongle 计划](https://github.com/users/awalol/projects/5) ## 社区 - 加入 Discord 服务器:[Discord 服务器](https://discord.gg/hM4ntchGCa) - 如果您遇到 Bug,请提交 issue。 ## 参考文献 - [rafaelvaloto/Pico_W-Dualsense](https://github.com/rafaelvaloto/Pico_W-Dualsense) — 项目灵感来源 - [egormanga/SAxense](https://github.com/egormanga/SAxense) — 蓝牙触觉反馈 POC - [https://controllers.fandom.com/wiki/Sony_DualSense](https://controllers.fandom.com/wiki/Sony_DualSense) - DualSense 数据报告结构文档 - [Paliverse/DualSenseX](https://github.com/Paliverse/DualSenseX) — 扬声器报告数据包
标签:C/C++, DIY硬件, DualSense, HD震动, Pico 2 W, Pico SDK, PS5手柄, TinyUSB, UF2固件, UML, USB HID, USB设备, 事务性I/O, 体感反馈, 单片机开发, 嵌入式开发, 嵌入式系统, 开源硬件, 微控制器, 无线手柄, 树莓派Pico, 游戏外设, 硬件改造, 硬件桥接, 自制游戏设备, 蓝牙接收器, 蓝牙适配器, 超频