Skip to main content

Troubleshooting

Select the button labels to be displayed in the usage guide:

GP2040

Input Issues

Why are my buttons out of order?

There are many different reasons why this could be the case.

Incorrect Mapping in Steam

Verify that your controller settings in Steam are correctly set, both global settings and the per-game settings. See Steam Support for more information on how to resolve this issue.

Incorrect Input Mode

Verify that you are using the correct input mode as different modes may swap the mapping of inputs (e.g. Switch vs XInput, PS3/PS4, etc). See GP2040-CE Usage for more information on how to change input modes.

Incorrect Button Wiring

Verify that your buttons are correctly connected to the controller board according to the GPIO pin mapping provided by the vendor of your controller board.

Incorrect Firmware

Firmware is built to assume a specific GPIO pin out and there may be a mismatch between what the firmware expects and what you expect the controls to be. You can either update the GPIO pin mappings in the Web Configurator or install the correct firmware onto this device.

See Incorrect Firmware below for more information on how to resolve this issue.

Why does my button not register when I press it?

Check your wiring. The button should have two terminals where one side goes to the GPIO pin and the other to ground. Test whether wiring is working properly by touching the wires together and verifying that an input is received.

There might also be an issue with your button. Try using different buttons.

Why do I keep getting an input even though the button is not being pressed?

Check your wiring. There may be an unintended short where the signal wire is in contact with ground (GND) or a wire connected to GND.

There might also be an issue with your button. Try using different buttons.

Up/Down or Left/Right have been swapped. How do I fix this?

You've likely activated Invert Y-Axis or Invert X-Axis hotkey on your controller. Activate the hotkey again to disable the feature.

Configurable Hotkeys

If the hotkey combination is not present in or differs from the documentation, please refer to the Web Configurator on your device to verify which input combinations are assigned to each hotkey.

My SOCD cleaning changed. How do I get it back to X cleaning mode?

You've likely activated one of the following SOCD cleaning mode hotkeys on your controller. Activate the hotkey again to disable the feature.

Configurable Hotkeys

If the hotkey combination is not present in or differs from the documentation, please refer to the Web Configurator on your device to verify which input combinations are assigned to each hotkey.

Why is my DPad stuck outputting directions on the Left/Right Analog Joystick?

You've likely activated DPad Left Analog or DPad Right Analog hotkey on your controller. Activate the hotkey again to disable the feature.

Configurable Hotkeys

If the hotkey combination is not present in or differs from the documentation, please refer to the Web Configurator on your device to verify which input combinations are assigned to each hotkey.

Connection Issues

Why is the controller connected to the PC/Console not being recognized?

There are a number of reasons this could be happening. Check for the following issues.

Keyboard Mode

Check that the input mode of the device is not in keyboard mode. This will cause your computer to only recognize your controller as a keyboard and not as a gamepad.

Web Configurator

When booting into the Web Configurator, the controller initializes as a RNDIS device and will not be recognized by the PC/Console as a controller. Check that the controller is not booting into the Web Configurator and S2 is not being activated while booting.

Why does my controller not connect to the PC/console when using a USB Type C-C?

Depending on how your device hardware is designed, it may not be set up to use a reversible USB Type C. Try reversing the cable. If that does not work, try using a USB 2.0 Type C-C cable or a USB 2.0 Type C-A cable with an adapter.

Why does my controller stop responding on Playstation 4 or Playstation 5?

Regarding PS4 disconnection issues, verify that you have the PS4 Mode add-on is enabled with valid authentication files or the PS Passthrough add-on is enabled with a valid passthrough authentication device.

Regarding PS5 disconnection issues. PS Passthrough add-on is enabled with a valid passthrough authentication device.

For more information, refer to the PS4/PS5 Compatibility FAQ.

Configuration Issues

Why can't I access the Web Configurator?

If the Web Configurator page is timing out, verify that the controller is booting into Web Configurator Mode.

Test that you are holding S2 when booting, using a using the website like Gamepad Tester, or in another application such as the Steam Input Overlay. to verify that you are pressing the correct button.

Why does PS Passthrough not work on my device?

USB Host Port not configured correctly

Verify that your USB host port is correctly configured in the Web Configurator. The specific pins for Data+ and Data- may differ between devices and device manufacturers so check with the documentation provided by the vendor.

For more information, refer to the PS Passthrough add-on documentation.

Incompatible Controller/Dongle is being used

Only compatible devices will allow the use of a GP2040-CE controller with PS Passthrough to work on PS4 and not all devices will work with PS5.

For more information, refer to the PS4/PS5 Compatibility FAQ.

Why are my RGB LEDs the wrong color?

Verify that the LED Format is correctly set as different LEDs may have a different order to the Red, Green, and Blue data being sent.

For more information, refer to the RGB LED Button Order section of the Web Configurator menu.

Why are my RGB LEDs out of order?

The order of RGB LEDs can be set in the Web Configurator and the correct configuration is determined by the hardware, how the user wires up the LED chain or the device designer set the LED chain on the board.

For more information, refer to the RGB LED Button Order section of the Web Configurator menu.

When I updated my device, why did my controller stop working?

If you updated your device and suddenly your inputs aren't correct and your OLED Display or RGB LED stopped working, it's likely that the incorrect compiled firmware was flashed onto your device or your device is not supported and thus the precompiled builds on the Downloads page may not work for your device.

Incorrect Firmware for a Supported Device

If your device is supported and the incorrect firmware was flashed, follow the firmware installation instructions and reflash the correct firmware, verifying that the name of the firmware file matches your device.

Unsupported Devices

If your device is not supported, please speak with the vendor you purchased the device from for the proper firmware file to flash onto your device using the firmware installation instructions.

If your vendor is incapable of supporting their device, you will need to perform some investigative work to properly set up your device.

  1. Flash the compiled Pico GP2040 firmware from the downloads page using the firmware installation instructions.
  2. Repeat those steps without flash nuking your device, flashing this firmware file. This will force your device to boot into Web Configurator mode on boot.
  3. Go to Configuration>Pin Mapping
  4. For each gamepad input, use the “Press Button to Map” feature to map the input to a GPIO Pin connected to that button. Repeat for all inputs
  5. For any additional features (e.g. RGB LED, OLED display, USB Host Port, etc.), you will need to determine what GPIO pin is associated. This can be done by tracing physical copper paths on the PCB to the button/component.

No further assistance can be supplied as this last step is entirely determined by the manufacturer and how they designed the PCB, which is unsupported.