ricardoquesada/bluepad32：Bluetooth gamepad, mouse and k

ricardoquesada

1.2k

157 84

Other

项目介绍

ricardoquesada/bluepad32 是一个托管在 GitHub 上的开源项目，主要使用 C 编写，采用 Other 许可证，目前获得 1.2k 个 Star、157 次 Fork。

仓库全名: ricardoquesada/bluepad32
开源许可证: Other
Star 数: 1.2k
Fork 数: 157
未关闭 Issue: 84

README 摘要

Bluepad32 A Bluetooth controller "host" for the ESP32, ESP32-S3, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-H2, Raspberry Pi Pico W, Pico 2 W, and Posix (Linux, macOS). Add Bluetooth gamepad, mouse and keyboard support to your projects easily. In other words, it allows you to control a robot using a DualSense controller. Where to start Choose your target platform: Platform | Start here | Further info | Community projects |…

完整内容见 GitHub 原始 README 或本页。

常见问题

bluepad32 用什么语言开发？

主要使用 C 编写，采用 Other 许可证，目前有 1.2k 个 Star。

bluepad32 可以免费商用吗？

仓库标注的许可证为 Other，商用前请先阅读仓库 LICENSE 文件确认授权范围。

如何获取 bluepad32 的源码？

可以直接克隆仓库：git clone https://github.com/ricardoquesada/bluepad32.git，默认分支为 main；安装与运行步骤见仓库 README。

bluepad32 最近还在维护吗？

仓库最近一次更新为 1 周前，当前有 84 个未关闭 Issue；Star 数为 1.2k，可作为社区活跃度的参考。

简要分析

热度分

1507

价值分

746

活跃状态

活跃

arduino bluetooth esp-idf esp32 gamepad keyboard mouse pico-sdk pico-w

GitHub

语言占比

C++

CMake

Makefile

Python

Shell

Release

5.0.0-beta010月6日
Bluepad32 v4.2.02025年1月4日
Bluepad32 v4.1.02024年6月4日
Bluepad32 v4.0.42024年4月21日
Bluepad32 v4.0.32024年4月10日

贡献者

README

Bluepad32

drawing

A Bluetooth controller “host” for the ESP32, ESP32-S3, ESP32-C3, ESP32-C5, ESP32-C6, ESP32-H2, Raspberry Pi Pico W, Pico 2 W, and Posix (Linux, macOS).

Add Bluetooth gamepad, mouse and keyboard support to your projects easily.

In other words, it allows you to control a robot using a DualSense controller.

Where to start

Choose your target platform:

Platform	Start here	Further info	Community projects
Arduino IDE		Doc	Controller for Tello drone
Arduino using ESP-IDF toolchain	Template project	Doc	Lego Robot (video), gbaHD Shield (a GameBoy consolizer)
Pico W	Pico W example	Doc	Pico Switch, PicoNtrol
ESP-IDF	ESP32 example	Doc	OGX-Wireless-Lite
Posix (Linux, macOS)	Posix example, Posix ImGui	Doc
Unijoysticle	Unijoysticle2	Doc

Features

Supports most, if not all, modern Bluetooth gamepads, mice and keyboards (see below)
Supports ESP32 and Pico W families
Supported APIs: ESP-IDF, Pico-SDK and Arduino
Fast (very low latency)
Small footprint
Uses only one core (CPU0). The remaining one is free to use.
C11 based
Open Source (see below)
Easy to integrate into 3rd party projects

Supported controllers

Supported gamepads

Sony DualSense (PS5)
Sony DualShock 4 (PS4)
Sony DualShock 3 (PS3)
Nintendo Switch Pro controller
Nintendo Switch JoyCon
Nintendo Wii U controller
Nintendo Wii Remote + accessories
Xbox Wireless controller (models 1708, 1914, adaptive)
Android controllers
Steam controller
Stadia controller
PC/Window controller
8BitDo controllers
Atari joystick
iCade
Mouse
Keyboards
And more

NOTE: Original ESP32, Pico W and Pico 2 W support all listed controllers. ESP32-S3, ESP32-C3, ESP32-C5, ESP32-C6 and ESP32-H2 only support a subset.

See: Supported gamepads, supported mice and supported keyboards

Pre-compiled binaries

Download pre-compiled binaries for Unijoysticle:

https://github.com/ricardoquesada/bluepad32/releases

Creating your project

See the examples folder which includes examples for:

Bluepad32 for ESP32 (ESP32, ESP32-S3, ESP32-C3, ESP32-C5, ESP32-C6 and ESP32-H2)
Bluepad32 for Pico W (Pico W and Pico 2 W)
Bluepad32 for Posix (Linux, macOS)
Bluepad32 Posix ImGui Diagnostic Suite

Arduino examples are in:

Support

License

Bluepad32 is open source, licensed under Apache 2.

However, Bluepad32 depends on the great BTstack library. Which is free to use for open source projects. But commercial for closed-source projects.

If you are developing a commercial product for:

ESP32: You should contact BTstack people.
Pico W: You are already covered by Raspberry Pi License.

Notice: I’m not affiliated with BTstack people. They are super friendly and willing to help.

bluepad32