Windows kernel-mode Bluetooth Profile & Filter Drivers for PS3 peripherals.

/biː θriː/

TL;DR: these drivers allow popular PlayStation(R) 3 gaming peripherals (SIXAXIS/DualShock 3, PS Move Navigation & Motion Controllers) to connect to Windows via Bluetooth without losing any standard functionality. 😊

This set of Windows kernel-mode drivers enhances the standard (a.k.a. vanilla) Bluetooth stack (Microsoft/Broadcom/Toshiba/Intel/...) with an additional L2CAP server service (profile driver) and a USB lower filter driver gracefully working around the reserved PSMs issue causing the PS3 peripherals connections to get denied on the default Windows stack. The profile driver attempts to distinguish the incoming device types based on their reported remote names and exposes their HID Control and HID Interrupt channels via simple bus child devices (a.k.a PDOs). The profile/bus driver supports both "regular" operation modes (requiring a proper function driver like a HID-minidriver) and "raw" mode (powering the PDO up without a function driver and exposing it to user-land) for maximum flexibility and future-proofing. The PSM filter only attaches to Bluetooth class devices and unloads itself if the underlying enumerator isn't USB.

The solution consists of the following individual projects:

• BthPS3 - Multi-purpose kernel-mode driver. Function driver for service PDO exposed by BTHENUM (Microsoft), Bluetooth profile (L2CAP server service) and bus driver for PS3 wireless peripherals.
• BthPS3PSM - Lower filter driver for BTHUSB, patching L2CAP packets. Reroutes L2CAP traffic to profile driver.
• BthPS3CfgUI - User-land GUI utility to safely edit driver settings.
• BthPS3Installer - WiXSharp-based setup for driver installation and removal.

This solution contains BSD-3-Clause and MIT licensed components:

• Drivers (BthPS3.sys, BthPS3PSM.sys) - BSD-3-Clause
• Installer/Setup (WiXSharp project and assets) - BSD-3-Clause
• User-land utilities (BthPS3CfgUI.exe) - MIT

For details, please consult the individual LICENSE files.

This is a community project and not affiliated with Sony Interactive Entertainment Inc. in any way. "PlayStation", "PSP", "PS2", "PS one", "DUALSHOCK" and "SIXAXIS" are registered trademarks of Sony Interactive Entertainment Inc.

BthPS3 components can run on Windows 10 version 1507 or newer (x64, ARM64).

Pre-built binaries and instructions are provided by Nefarius Software Solutions e.U. and available via setup. Official support covers Windows 10/11 x64/ARM64 only, filing issues about any other version or architecture will be discarded.

Check out the companion solution DsHidMini for using the controller in games!

Knowledge on how to build and (test-)sign Windows drivers is required for creating usable builds. This is outside of the scope of the project documentation.

Everything you need to know is documented on the project page, read carefully before considering filing an issue.

      ----------------------                                  ---------------------- 
     |    Navigation PDO     <----------           --------->       Motion PDO      |
      ----------------------            |         |           ---------------------- 
                                        |         |
                                        |         |
                                        |         |
                                        |         |
                                        |         |
 ----------------------            ----- --------- ------           ---------------------- 
|      SIXAXIS PDO      <---------  Profile & Bus Driver  -------->      Wireless PDO     |
 ----------------------           |     (BthPS3.sys)     |          ---------------------- 
                                   ---------- ----------- 
                                             ^
                                             |
                                             v
                                   ---------- ----------- 
                                  | Bluetooth Enumerator |
                                  |    (bthenum.sys)     |
                                   ---------- ----------- 
                                             ^
                                             |
                                             v
                                   ---------- ----------- 
                                  |     bthport.sys      |
                                   ---------- ----------- 
                                             ^
                                             |
                                             v
                                   ---------- ----------- 
                                  |      bthusb.sys      |
                                   ---------- ----------- 
                                             ^
                                             |
                                             v
                                   ---------- ----------- 
                                  | BthPS3PSM.sys filter |
                                   ---------- ----------- 
                                             ^
                                             |
                                             v
                                   ---------- ----------- 
                                  |       USB Stack      |
                                   ---------- ----------- 
                                             ^
                                             |
                                             v
                                   ---------- ----------- 
                                  | USB Bluetooth dongle |
                                   ---------------------- 

This application benefits from these awesome projects ❤ (appearance in no special order):

• ViGEm Forums - Bluetooth Filter Driver for DS3-compatibility - research notes
• Arduino - felis/USB_Host_Shield_2.0 - PS3 Information
• Emulate HID Device with Windows Desktop
• microsoft/Windows-driver-samples - Bluetooth Echo L2CAP Profile Driver
• Microsoft Bluetooth DDI - Reserved PSMs
• Eleccelerator Wiki - DualShock 3
• Link Manager Protocol (LMP)
• Nefarius' Domito Library
• NUKE Build Automation
• Nefarius.Tools.WDKWhere
• Nefarius.Utilities.Bluetooth
• WixSharp (WixSharp) - managed interface for WiX