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, 游戏外设, 硬件改造, 硬件桥接, 自制游戏设备, 蓝牙接收器, 蓝牙适配器, 超频