How nefarius/bthps3 works
BthPS3 is a Windows kernel-mode Bluetooth profile and host-radio filter driver suite for connecting PS3 peripherals. Its main runtime path extends the Windows Bluetooth stack with an L2CAP profile service, identifies incoming peripherals, and exposes HID control/interrupt channels through bus child devices. A separate lower filter patches and reroutes L2CAP traffic. The repository also provides a settings GUI and CLI, plus an installer. Relationships in the driver map rely mainly on the README’s architecture description; unsampled implementation details are not inferred.
Main entry points: Bluetooth.c Profile driver · BusLogic.c Bus driver · ProfileDriverSettingsViewModel.cs Settings GUI · InstallScript.cs Driver installer
Components 22
Profile and bus driver
- Profile driver
BthPS3/Bluetooth.c - L2CAP service
BthPS3/L2CAP.Connect.c - L2CAP disconnect
BthPS3/L2CAP.Disconnect.c - L2CAP transfer
BthPS3/L2CAP.Transfer.c - Device classification
BthPS3/Device.c - Bus driver
BthPS3/BusLogic.c - Child device I/O
BthPS3/BusLogic.IO.c - Child device state
BthPS3/BusLogic.State.c
Radio filter driver
- Bluetooth radio filter
BthPS3PSM/Filter.c - Filter device control
BthPS3PSM/Device.c - Sideband routing
BthPS3PSM/Sideband.c - Packet queue
BthPS3PSM/Queue.c
Configuration tools
- Filter control API
shared/FilterDriver.cs - Radio availability
shared/BluetoothHelper.cs - Settings GUI
BthPS3CfgUI/ProfileDriverSettingsViewModel.cs - Settings CLI
BthPS3Util/BthPS3Util.cpp
Installation
- Driver installer
BthPS3Installer/InstallScript.cs - Install actions
BthPS3Installer/CustomActions.cs - Radio transport detection
BthPS3Installer/RadioTransport.cs
Other components
- Windows Bluetooth stack
- PS3 peripherals
- HID channel children
Connections 22
- Windows Bluetooth stack → Profile driver: hosts service
- Profile driver → L2CAP service: provides service
- Profile driver → Device classification: classifies devices
- Profile driver → Bus driver: exposes channels
- L2CAP service → L2CAP disconnect: disconnects
- L2CAP service → L2CAP transfer: transfers data
- PS3 peripherals → Windows Bluetooth stack: connect over Bluetooth
- Bus driver → HID channel children: creates child devices
- Bus driver → Child device I/O: handles I/O
- Bus driver → Child device state: tracks state
- Bluetooth radio filter → Windows Bluetooth stack: extends host stack
- Bluetooth radio filter → Sideband routing: reroutes traffic
- Sideband routing → Packet queue: queues packets
- Filter control API → Filter device control: sends control IOCTLs
shared/FilterDriver.cs - Settings GUI → Filter control API: controls patching
BthPS3CfgUI/ProfileDriverSettingsViewModel.cs - Settings GUI → Radio availability: checks radio
BthPS3CfgUI/ProfileDriverSettingsViewModel.cs - Settings GUI → Profile driver: edits registry settings
BthPS3CfgUI/ProfileDriverSettingsViewModel.cs - Settings CLI → Filter control API: configures filter
- Driver installer → Install actions: configures actions
BthPS3Installer/InstallScript.cs - Install actions → Radio transport detection: detects transport
BthPS3Installer/CustomActions.cs - Driver installer → Profile driver: installs driver
BthPS3Installer/InstallScript.cs - Driver installer → Bluetooth radio filter: installs filter
BthPS3Installer/InstallScript.cs