Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add information regarding mapping of analog triggers on Android #221

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add information regarding mapping of analog triggers on Android #221

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fd9bb39
Add files via upload
WIrral May 13, 2024
41e5924
Add files via upload
WIrral May 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ It would be great however if any improvements are fed back into this version.
- [x] Report optional battery level to host
- [x] Uses efficient NimBLE bluetooth library
- [x] Compatible with Windows
- [x] Compatible with Android (Android OS maps default buttons / axes / hats slightly differently than Windows)
- [x] Compatible with Android (Android OS maps default buttons / axes / hats slightly differently than Windows) (see notes)
- [x] Compatible with Linux (limited testing)
- [x] Compatible with MacOS X (limited testing)
- [ ] Compatible with iOS (No - not even for accessibility switch - This is not a “Made for iPhone” (MFI) compatible device)
Expand Down Expand Up @@ -139,10 +139,12 @@ Relies on [NimBLE-Arduino](https://github.com/h2zero/NimBLE-Arduino)
Use [this](http://www.planetpointy.co.uk/joystick-test-application/) Windows test app to test/see all of the buttons
Ensure you have Direct X 9 installed

Gamepads desgined for Android use a different button mapping. This effects analog triggers, where the standard left and right trigger axes are not detected.
Android calls the HID report for right trigger `"GAS"` and left trigger `"BRAKE"`. Enabling the `"Accelerator"` and `"Brake"` simulation controls allows them to be used instead of right and left trigger.

You might also be interested in:
- [ESP32-BLE-Mouse](https://github.com/T-vK/ESP32-BLE-Mouse)
- [ESP32-BLE-Keyboard](https://github.com/T-vK/ESP32-BLE-Keyboard)
- [Composite Gamepad/Mouse/Keyboard and Xinput capable fork of this library](https://github.com/Mystfit/ESP32-BLE-CompositeHID)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to remove this link? I think we should keep it.

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah - I added that link in


or the NimBLE versions at

Expand Down