Bluepad32 for ESP32 with ESP-IDF¶
Supported boards¶
Bluepad32 supports all Bluetooth-enabled SoCs in the ESP32 family:
- ESP32
- ESP32-S3
- ESP32-C3, ESP32-C5, and ESP32-C6
- ESP32-H2
Installation¶
1. Install ESP-IDF¶
Install ESP-IDF v5.5 or newer. See the official ESP-IDF Getting Started guide:
2. Clone the Bluepad32 repository¶
git clone --recursive https://github.com/ricardoquesada/bluepad32.git
3. Apply the BTstack patches¶
cd ${BLUEPAD32_SRC}/external/btstack
git apply ../patches/*.patch
4. Customize the example¶
Open the ESP32 example directory:
# ${BLUEPAD32} is the path to your cloned Bluepad32 repository
cd ${BLUEPAD32}/examples/esp32
Edit main/my_platform.c to match your application requirements:
5. Compile the example¶
Set the target SoC (default is esp32):
# Options: esp32, esp32-s3, esp32-c3, esp32-c5, esp32-c6, esp32-h2
idf.py set-target esp32
Compile the project:
idf.py build
6. Flash the binary¶
idf.py flash
7. Open the serial monitor and console¶
Run idf.py monitor to view serial logs and use the interactive console:
idf.py monitor