From 572d017ec536fbd498a3a1df83e1148c3779341e Mon Sep 17 00:00:00 2001 From: awalol Date: Sat, 2 May 2026 18:07:06 +0800 Subject: [PATCH] switch README language --- README.CN.md | 35 ++++++++++++++++ README.EN.md | 94 ------------------------------------------- README.md | 110 +++++++++++++++++++++++++++++++++++++++------------ 3 files changed, 120 insertions(+), 119 deletions(-) create mode 100644 README.CN.md delete mode 100644 README.EN.md diff --git a/README.CN.md b/README.CN.md new file mode 100644 index 0000000..3e83f53 --- /dev/null +++ b/README.CN.md @@ -0,0 +1,35 @@ +# Pico2W DualSense 5 Bridge +[English](./README.md) +> 将 Pico2W 变成 DS5 手柄的无线适配器 + +# 功能特点 + - 支持HD震动 + +# 使用方法 +1. 按住 Pico 上的BOOTSEL进入刷机 +2. 将 .uf2 文件拖入进去 +3. 将 DS5 手柄进入蓝牙配对模式 +4. Enjoy it + +- 调整麦克风音量为改变震动增益倍数，范围 [1,2] +- 开启扬声器静音为关闭LED连接提示 (手柄重连后生效) +- 开启麦克风静音为禁用静默断连 +- 手柄连接到pico以后，系统才会显示设备 + +# 当前问题: +- 声音可能有点小卡顿 +- 由于编码需要，需要对pico进行超频，当前的参数是1.2V 320MHz。 +- 若您的pico使用该超频参数无法启动，请自行增加电压或者降低频率 +- 在 Linux 扬声器不工作 + +# 未来计划 +请查看[DS5Dongle plan](https://github.com/users/awalol/projects/5) + +# 编译 +需要将pico sdk里面的tinyusb版本升级到最新 + +# 致谢 + - [rafaelvaloto/Pico_W-Dualsense](https://github.com/rafaelvaloto/Pico_W-Dualsense) - 灵感来源 + - [egormanga/SAxense](https://github.com/egormanga/SAxense) - 震动报文 + - [https://controllers.fandom.com/wiki/Sony_DualSense](https://controllers.fandom.com/wiki/Sony_DualSense) - 数据报文结构 + - [Paliverse/DualSenseX](https://github.com/Paliverse/DualSenseX) - 扬声器数据包报文 diff --git a/README.EN.md b/README.EN.md deleted file mode 100644 index f590356..0000000 --- a/README.EN.md +++ /dev/null @@ -1,94 +0,0 @@ -# Pico2W DualSense 5 Bridge - -[中文](./README.md) - -> Turn a Raspberry Pi Pico2W into a wireless adapter for the DualSense (DS5) controller. - -## Overview - -This project enables the Raspberry Pi Pico2W to function as a Bluetooth bridge for the DualSense controller, allowing wireless connectivity with enhanced haptics support. - -## Features - -- 🎮 Full DualSense connectivity via Pico2W -- 🔊 Supports HD haptics (advanced vibration feedback) -- 📡 Wireless Bluetooth bridging -- ⚙️ Adjustable haptic gain via microphone volume -- 🔕 Configurable LED and disconnection behaviors - -## Getting Started - -### Flashing Firmware - -1. Hold the BOOTSEL button on the Pico2W -2. Connect the Pico2W to your computer via USB -3. The device will mount as a USB storage device -4. Drag and drop the .uf2 firmware file onto the device - -### Pairing the Controller - -1. Put the DualSense controller into Bluetooth pairing mode -2. Wait for the Pico2W to detect and connect -3. Once connected, the device will appear on the host system - -## Configuration - -The following controller settings are repurposed: - -### Microphone volume - -Controls haptic gain multiplier - -Range: [1.0 – 2.0] - -### Speaker mute - -Disables LED connection indicator - -Takes effect after controller reconnects - -### Microphone mute - -Disables silent disconnection behavior - -## Notes - -The Pico device will only be visible to the system after the controller is connected - -Some behaviors depend on reconnection cycles to take effect - -## Known Issues - -- ⚠️ Audio may experience slight stuttering -- ⚠️ Overclocking is required for proper performance - -## Performance / Overclocking - -Due to encoding requirements, the Pico2W must be overclocked: - -Current settings: - -- Voltage: 1.2V -- Frequency: 320 MHz - -If your device fails to boot: - -- Increase voltage slightly or Reduce CPU frequency - -## Build Instructions - -To build the project from source: - -1. Update TinyUSB in the Pico SDK to the latest version -2. Compile using standard Pico SDK toolchain - -## Roadmap - -- Improve audio stability - -## References - -- [rafaelvaloto/Pico_W-Dualsense](https://github.com/rafaelvaloto/Pico_W-Dualsense) — Project inspiration -- [egormanga/SAxense](https://github.com/egormanga/SAxense) — Bluetooth Haptics POC -- [https://controllers.fandom.com/wiki/Sony_DualSense](https://controllers.fandom.com/wiki/Sony_DualSense) - DualSense data report structure documentation -- [Paliverse/DualSenseX](https://github.com/Paliverse/DualSenseX) — Speaker report packet \ No newline at end of file diff --git a/README.md b/README.md index e7cd717..b6a03c1 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,93 @@ # Pico2W DualSense 5 Bridge -[English](./README.EN.md) -> 将 Pico2W 变成 DS5 手柄的无线适配器 -# 功能特点 - - 支持HD震动 +[中文](./README.CN.md) -# 使用方法 -1. 按住 Pico 上的BOOTSEL进入刷机 -2. 将 .uf2 文件拖入进去 -3. 将 DS5 手柄进入蓝牙配对模式 -4. Enjoy it +> Turn a Raspberry Pi Pico2W into a wireless adapter for the DualSense (DS5) controller. -- 调整麦克风音量为改变震动增益倍数，范围 [1,2] -- 开启扬声器静音为关闭LED连接提示 (手柄重连后生效) -- 开启麦克风静音为禁用静默断连 -- 手柄连接到pico以后，系统才会显示设备 +## Overview -# 当前问题: -- 声音可能有点小卡顿 -- 由于编码需要，需要对pico进行超频，当前的参数是1.2V 320MHz。 -- 若您的pico使用该超频参数无法启动，请自行增加电压或者降低频率 +This project enables the Raspberry Pi Pico2W to function as a Bluetooth bridge for the DualSense controller, allowing wireless connectivity with enhanced haptics support. -# 未来计划 +## Features -# 编译 -需要将pico sdk里面的tinyusb版本升级到最新 +- 🎮 Full DualSense connectivity via Pico2W +- 🔊 Supports HD haptics (advanced vibration feedback) +- 📡 Wireless Bluetooth bridging +- ⚙️ Adjustable haptic gain via microphone volume +- 🔕 Configurable LED and disconnection behaviors -# 致谢 - - [rafaelvaloto/Pico_W-Dualsense](https://github.com/rafaelvaloto/Pico_W-Dualsense) - 灵感来源 - - [egormanga/SAxense](https://github.com/egormanga/SAxense) - 震动报文 - - [https://controllers.fandom.com/wiki/Sony_DualSense](https://controllers.fandom.com/wiki/Sony_DualSense) - 数据报文结构 - - [Paliverse/DualSenseX](https://github.com/Paliverse/DualSenseX) - 扬声器数据包报文 +## Getting Started + +### Flashing Firmware + +1. Hold the BOOTSEL button on the Pico2W +2. Connect the Pico2W to your computer via USB +3. The device will mount as a USB storage device +4. Drag and drop the .uf2 firmware file onto the device + +### Pairing the Controller + +1. Put the DualSense controller into Bluetooth pairing mode +2. Wait for the Pico2W to detect and connect +3. Once connected, the device will appear on the host system + +## Configuration + +The following controller settings are repurposed: + +### Microphone volume + +Controls haptic gain multiplier + +Range: [1.0 – 2.0] + +### Speaker mute + +Disables LED connection indicator + +Takes effect after controller reconnects + +### Microphone mute + +Disables silent disconnection behavior + +## Notes + +The Pico device will only be visible to the system after the controller is connected + +Some behaviors depend on reconnection cycles to take effect + +## Known Issues + +- ⚠️ Audio may experience slight stuttering +- ⚠️ Overclocking is required for proper performance + +## Performance / Overclocking + +Due to encoding requirements, the Pico2W must be overclocked: + +Current settings: + +- Voltage: 1.2V +- Frequency: 320 MHz + +If your device fails to boot: + +- Increase voltage slightly or Reduce CPU frequency + +## Build Instructions + +To build the project from source: + +1. Update TinyUSB in the Pico SDK to the latest version +2. Compile using standard Pico SDK toolchain + +## Roadmap +- Please check out [DS5Dongle plan](https://github.com/users/awalol/projects/5) + +## References + +- [rafaelvaloto/Pico_W-Dualsense](https://github.com/rafaelvaloto/Pico_W-Dualsense) — Project inspiration +- [egormanga/SAxense](https://github.com/egormanga/SAxense) — Bluetooth Haptics POC +- [https://controllers.fandom.com/wiki/Sony_DualSense](https://controllers.fandom.com/wiki/Sony_DualSense) - DualSense data report structure documentation +- [Paliverse/DualSenseX](https://github.com/Paliverse/DualSenseX) — Speaker report packet \ No newline at end of file