Gamepad Map Example#
This example shows the gamepad_map component between a gamepad and whatever
comes next:
A BLE gamepad’s HID report map (a ShanWan BSP-D8 in its Android mode) is parsed with
hid_rp::ReportMapand decoded withhid_rp::GamepadDecoder, with the decoder’s emulator conveniences turned off.Each decoded report becomes an
espp::GamepadState, which anespp::GamepadMapremaps. The map here swaps A/B to the Nintendo layout, puts the left stick on the d-pad as well, makes the analog triggers press ZL/ZR too, and adds a left-stick dead zone.espp::GamepadProfilesstores a default map and a per-controller-type profile in a file on a littlefs partition, and reloads them.
It ends with a pass / fail summary.
How to use example#
Hardware Required#
Any ESP32 with a littlefs partition (see partitions.csv). The partition
label is configured through menuconfig
(CONFIG_ESPP_FILE_SYSTEM_PARTITION_LABEL).
Build and Flash#
Build the project and flash it to the board, then run the monitor tool to view serial output:
idf.py -p PORT flash monitor
(Replace PORT with the name of the serial port to use.)
(To exit the serial monitor, type Ctrl-].)
See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.
Expected Output#
I (…) gamepad map example: Starting gamepad map example!
I (…) gamepad map example: Decode a BLE gamepad report, then remap it
I (…) gamepad map example: controller: {buttons: [south], lx: -32767, ly: 128, rx: 128, ry: 128, lt: 0, rt: 32767}
I (…) gamepad map example: mapped: {buttons: [east, r2, left], lx: -32767, ly: 128, rx: 128, ry: 128, lt: 0, rt: 32767}
[PASS] south is mapped to east
[PASS] the left stick also presses d-pad left
[PASS] the stick is kept
[PASS] the right trigger also presses R2
I (…) gamepad map example: Per-controller profiles in a file
I (…) gamepad map example: BSP-D8 map: 4 rule(s); default map: 2 rule(s)
[PASS] the profile is used for its controller
[PASS] other controllers get the default map
[PASS] profiles survive a reload
[PASS] erase a profile
I (…) gamepad map example: 8 passed, 0 failed
I (…) gamepad map example: Gamepad map example complete!