From b1019fb5c2f2e2e4281cff25b78aa1cf1fdf6243 Mon Sep 17 00:00:00 2001 From: awalol Date: Sun, 17 May 2026 14:59:54 +0800 Subject: [PATCH] update README --- README.CN.md | 26 ++++++++++++++++++++++---- README.md | 39 ++++++++++++++++++++------------------- 2 files changed, 42 insertions(+), 23 deletions(-) diff --git a/README.CN.md b/README.CN.md index 3e83f53..6eb59a8 100644 --- a/README.CN.md +++ b/README.CN.md @@ -11,16 +11,34 @@ 3. 将 DS5 手柄进入蓝牙配对模式 4. Enjoy it -- 调整麦克风音量为改变震动增益倍数,范围 [1,2] -- 开启扬声器静音为关闭LED连接提示 (手柄重连后生效) -- 开启麦克风静音为禁用静默断连 +***你可能需要在控制器处于匹配模式时重新插拔 pico*** + - 手柄连接到pico以后,系统才会显示设备 +# Pico 配置调整 +你可以通过网页调整Pico的内部设置 + +- 用于正式固件: https://ds5.awalol.eu.org +- 用于测试固件: https://ds5-dev.awalol.eu.org + +### Pico W 版本 + +Pico W 由于性能问题,只能支持震动,不支持扬声器。 +你可以通过开启 `-DPICO_W_BUILD=ON` 编译项去开启 Pico W 固件编译,或者在 Github Action 下载预编译的固件 + +### USB 唤醒支持 +这是一项实验性的功能。如果你需要该功能,请前往 feat/usb-wake 分支进行编译,或者使用该分支对应的 Github Action 预编译固件。`ds5-bridge-wake.uf2` 为该功能的固件 + +极为建议在使用该功能前阅读 #60 和 #61 + +### 社区分支 +https://github.com/MarcelineVPQ/DS5Dongle-OLED-Edition +https://github.com/zurce/DS5Dongle-OLED + # 当前问题: - 声音可能有点小卡顿 - 由于编码需要,需要对pico进行超频,当前的参数是1.2V 320MHz。 - 若您的pico使用该超频参数无法启动,请自行增加电压或者降低频率 -- 在 Linux 扬声器不工作 # 未来计划 请查看[DS5Dongle plan](https://github.com/users/awalol/projects/5) diff --git a/README.md b/README.md index 3e29bbd..1686dd0 100644 --- a/README.md +++ b/README.md @@ -13,8 +13,6 @@ This project enables the Raspberry Pi Pico2W to function as a Bluetooth bridge f - 🎮 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 @@ -31,25 +29,14 @@ This project enables the Raspberry Pi Pico2W to function as a Bluetooth bridge f 2. Wait for the Pico2W to detect and connect 3. Once connected, the device will appear on the host system +***You may need to replug the Pico when the controller is in pairing mode.*** + ## Configuration -The following controller settings are repurposed: +You can modify the Pico settings via the web config. -### 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 +- For release: https://ds5.awalol.eu.org +- For development: https://ds5-dev.awalol.eu.org ## Notes @@ -63,6 +50,20 @@ When the connected DualSense reports its battery at or below 10% (and it is not To opt out at build time, configure with `-DENABLE_BATT_LED=OFF`. Default is ON. +### Pico W Version + +Pico W only has haptics support, no speaker. You can enable Pico W firmware compilation with `-DPICO_W_BUILD=ON`, or download precompiled firmware from GitHub Actions. + +### USB Wake Feature + +This feature is experimental. If you need this functionality, please check out the feat/usb-wake branch to compile it, or use the precompiled firmware from GitHub Actions under that branch. The `ds5-bridge-wake.uf2` is the firmware with this feature enabled. + +It is recommended to read #60 and #61 before using this feature. + +### Community Fork +https://github.com/MarcelineVPQ/DS5Dongle-OLED-Edition +https://github.com/zurce/DS5Dongle-OLED + ## Known Issues - ⚠️ Audio may experience slight stuttering @@ -85,7 +86,7 @@ If your device fails to boot: To build the project from source: -1. Update TinyUSB in the Pico SDK to the latest version +1. ***Update TinyUSB in the Pico SDK to the latest version*** 2. Compile using standard Pico SDK toolchain ## Roadmap