Multi-Platform Gamepad Firmware for RP2040 customized by tamanegi_taro
You can connect your compatible controllers to Nintendo Switch, PS4, Egret II mini, Astrocity mini, Genesis mini and so on using this converter.
- 8BitDo Arcade Stick
- Cyber Stick USB
- Egret II mini Control panel
- Xinput
- Nintendo Switch
- PS3
- Keyboard
- PS4 *Require Authentication Device
- PS5 *Require Authentication Device
- Xbox One *Require Authentication Device
- Original Xbox *Require Authentication Device
- Sega Genesis
- Megadrive Mini
- NEOGEO mini
- PC Engine Mini
- CoreGrafx Mini
- Turbografx 16 Mini
- EGRET II mini
- ASTROCITY Mini
- ASTROCITY Mini V
- Playstation Classic
- RP2040-Zero * 1 https://ja.aliexpress.com/item/1005007393402333.html
- 1.3" OLED Display Module SH1106 128X64 * 1 (Optional) https://ja.aliexpress.com/item/1005005967766159.html
- USB A Type Standard Port Female PCB Mount Socket Connector Right Angle 4 Pin https://ja.aliexpress.com/item/1005004572352605.html
- 1206 SMD PTC Resettable fuse 500MA 0.5A * 1 (Optional) https://ja.aliexpress.com/item/1005004844581464.html
- 1206 Resistor 22ohm * 2 (Optional) https://ja.aliexpress.com/item/32996310793.html
- Some wires
- M3 Nylon screws nuts set (Optional)
- nuts * 4
- 6mm screws * 4
- 6mm/10mm male spacer * 4
- Order PCB of GP2040-CE USB Converter 2.0 (Optional)
You can order PCB from elecrow - PCB Fab - Regular PCB(Online order) https://www.elecrow.com/pcb-manufacturing.html?from=nav/
Download gerber/gerber.zip and upload it in elecrow PCB online order website. Choose your favorite color for your PCB board. Choosing Lead free is optional(Good for your health for extra $2).
Schematic is like this:
You can just get RP2040-Zero and USB A Type Standard Port Femaile PCB Mount Socket. Connect those two like this:
Now, move on to "How to setup firmware" section.
Connect everything like this. Connect USB socket, RP2040-Zero and OLED.
Connect 2 22ohm registors and resettable fuse
Use 4 screws and finish build.
-
Download build/GP2040-CE_0.7.11_WaveshareZero.uf2 from this repository.
-
From GP2040-CE Releases, download flash_nuke.uf2 https://github.com/OpenStickCommunity/GP2040-CE
-
Hold BOOT button on RP2040-Zero and connect converter to your PC
-
RPI-RP2 storage will be recognized(Bootsel mode). Copy flash_nuke.uf2 in RPI-RP2. This will initialize your RP2040-Zero.
-
RPI-RP2 storage will open again after initialization is completed. Copy GP2040-CE_0.7.10_WaveshareZero.uf2.
-
Once copy is completed, disconnect USB converter and done!
- Connect 8BitDo arcade stick 2.4G USB dongle or other USB controller to 8BitDo Arcade Stick USB Converter.
- Connect USB Converter to console.
- Now your controller and console will be connected and you can play games with your controller.
FAQ:
- If you are using 8BitDo Arcade Stick, set it's mode to Nintendo Switch(S) mode and 2.4G wireless mode.
- Wait 4 seconds until 8BitDo Arcade Stick gets recognized by console.
- For LS/DP/RS switch, make sure to set it as DP for mini console compatibility. You can also use LS/RS for Switch, PSx, and other consoles which utilizes LS/RS.
- For PS4/PS5 compatibility, you will need USB Hub(Experimental) and PS4/5 Authentication USB dongle.
- Connect your controller to your PC by this USB converter.
- Hold S1 + B3 + B4 of your controller for 5 seconds and USB converter will enter webconfig mode.
- Open http://192.168.7.1/
- In webconfiguration, you can change compatible console, pin mappings, display configuration and so on.
- In web configuration mode, open Settings - Input Mode Settings
- You can choose current input mode from list
- Make sure to save after changing configuration
- You can use button combination to push button that is not available in your controller.
- For example, press Home button + R2 will become R3 button when hotkey is active
- To configure hotkeys, open Settings - Hotkey settings in Webconfig
- You can choose key combination in this configuration window
- You can also set Fn to one of your button in pin settings and use Fn button for Hotkey.
In Web configuration - GPIO Pin mapping configuration, you can change pin mappings. Connect USB Converter to PC, set USB Converter mode to WebConfig mode, and open http://192.168.7.1/ in Browser. You should be able to find following pin mapping configuration window.
Pin mapping of controllers are shown as follows. Button name in parentheses is default configuration.
For Cyberstick, you can swap Left Stick and Right Lever. Also able to invert Y axis for both Left Lever and Right Stick in addon configuration.
In 8BitDo Arcade stick and Egret II mini Control panel, you can change game mode by pressing button combination. To change game mode, Hold A1 + S1 + S2 and push button below.
- B1 : Nintendo Switch
- B2 : XInput
- R2 : Keyboard
- L2 : No mode selected
- B3 : PS3
- B4 : PS4
- R1 : No mode selected
- L1 : No mode selected
This is just default configuration. You customize this configuration in WebConfig - Settings - Boot Input Modes
If you do not want to change mode by button combination, set "No Mode Selected" to all buttons.
- Hold S2 + B3 + B4 5 seconds for Firmware Upgrade mode - Bootsel (Or hold Boot button on RP2040-Zero and press reset button)
- Supports input by 8BitDo Arcade stick USB dongle(Switch mode)
- Neogeo mini's button alignment is ABCD instead of BOX alignment.
- Additional 3.5 seconds boot delay when connecting to Egret II mini to prevent stuck in white when connected to 2P side.
- After changing game mode, sometimes need to reboot USB converter and 8BitDo arcade stick to get it recognized.
How to manually enter webconfig mode without connecting USB controller instead of pressing S2 + B3 + B4 for 5 seconds
- From GP2040-CE Releases, download force_webconfig.uf2 https://github.com/OpenStickCommunity/GP2040-CE
- Hold BOOT button on RP2040-Zero and connect converter to your PC
- RPI-RP2 storage will be recognized(Bootsel mode). Copy force_webconfig.uf2 in RPI-RP2. This will force USB converter to be in webconfig mode.
- After copy is completed, open web browser in your PC and open http://192.168.7.1
- Open Webconfig in PC and open settings - Boot Input Modes
- Choose input mode for each button
- Open configuration - Pin mapping
GP2040-CE (Community Edition) is a gamepad firmware for the Raspberry Pi Pico and other boards based on the RP2040 microcontrollers that combines multi-platform compatibility, low latency and a rich feature set to provide endless customization possibilities without sacrificing performance.
GP2040-CE is compatible with PC, PS3, PS4, PS5, Nintendo Switch, Xbox One, Steam Deck, MiSTer and Android.
Downloads | Installation | Wiring | Usage | FAQ | GitHub
Full documentation can be found at https://gp2040-ce.info
- Select from 13 input modes including X-Input, Nintendo Switch, Playstation 4/5, Xbox One, D-Input, and Keyboard
- Input latency average of 0.76ms in Xinput and 0.91ms for Playstation 5.
- Multiple SOCD cleaning modes - Up Priority (a.k.a. Stickless), Neutral, and Second Input Priority.
- Left and Right stick emulation via D-pad inputs as well as dedicated toggle switches.
- Dual direction via D-pad + LS/RS.
- Reversed input via a button.
- Turbo and Turbo LED with selectable speed
- Per-button RGB LED support.
- PWM Player indicator LED support (XInput only).
- Multiple LED profiles support.
- Support for 128x64 monochrome I2C displays - SSD1306, SH1106, and SH1107 compatible.
- Custom startup splash screen and easy image upload via web configuration.
- Support for passive buzzer speaker (3v or 5v).
- Built-in, embedded web configuration - No download required!
Visit the GP2040-CE Usage page for more details.
Input latency is tested using the methodology outlined at WydD's inputlag.science website, using the default 1000 Hz (1 ms) polling rate in the firmware. You can read more about the setup we use to conduct latency testing HERE if you are interested in testing for yourself or would just like to know more about the devices used to do the testing.
| Version | Mode | Poll Rate | Min | Max | Avg | Stdev | % on time | %1f skip | %2f skip |
|---|---|---|---|---|---|---|---|---|---|
| v0.7.9 | Xinput | 1 ms | 0.45 ms | 1.28 ms | 0.76 ms | 0.24 ms | 98.48% | 1.52% | 0% |
| v0.7.9 | Switch | 1 ms | 0.41 ms | 1.23 ms | 0.72 ms | 0.24 ms | 98.53% | 1.47% | 0% |
| v0.7.9 | Dinput (PS3) | 1 ms | 0.44 ms | 1.27 ms | 0.75 ms | 0.24 ms | 98.49% | 1.51% | 0% |
| v0.7.9 | PS4 | 1 ms | 0.55 ms | 2.26 ms | 0.90 ms | 0.32 ms | 98.21% | 1.79% | 0% |
| v0.7.9 | PS5 | 1 ms | 0.55 ms | 2.33 ms | 0.91 ms | 0.33 ms | 98.18% | 1.82% | 0% |
Full results can be found in the GP2040-CE v0.7.9 Firmware Latency Test Results .xlsx Sheet.
Results from v0.7.8 can be found HERE. Previous results can be found in the latency_testing folder.
If you would like to discuss features, issues or anything else related to GP2040-CE please create an issue or join the OpenStick GP2040-CE Discord support channel.
Want to help improve GP2040-CE? There are a bunch of ways to contribute!
Have an idea for a cool new feature, or just want to discuss some technical details with the developers? Join the OpenStick GP2040-CE Discord server to participate in our active and ever-growing community!
Pull requests are welcome and encouraged for enhancements, bug fixes and documentation updates.
Please respect the coding style of the file(s) you are working in, and enforce the use of the .editorconfig file when present.
- FeralAI for building GP2040 and laying the foundation for this community project
- Ha Thach's excellent TinyUSB library examples
- fluffymadness's tinyusb-xinput sample
- Kevin Boone's blog post on using RP2040 flash memory as emulated EEPROM
- bitbank2 for the OneBitDisplay and BitBang_I2C libraries, which were ported for use with the Pico SDK
- arntsonl for the amazing cleanup and feature additions that brought us to v0.5.0
- alirin222 for the awesome turbo code (@alirin222 on Twitter)
- deeebug for improvements to the web-UI and fixing the PS3 home button issue
- TheTrain and Fortinbra for helping keep our community chugging along
- PassingLink for the technical details and code for PS4 implementation
- Youssef Habchi for allowing us to purchase a license to use Road Rage font for the project
- tamanegitaro and alirin222 for the basis of the mini/classic controller work
- Ryzee119 for the wonderful ogx360_t4 and xid_driver library for Original Xbox support
- Santroller and GIMX for technical examples of Xbox One authentication using pass-through