Troubleshooting
Select the button labels to be displayed in the usage guide:
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.
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.
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.
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 Input Mode with uploaded key files or USB Host with a valid passthrough authentication device.
Regarding PS5 disconnection issues. verify that you have the PS5 Input Mode with USB Host using a valid passthrough authentication device.
For more information, refer to the PS4/PS5 Compatibility FAQ.
Why can't I access the Web Configurator?
Controller is not booting into Web Configurator Mode
If the Web Configurator page is timing out, verify that the controller is booting into Web Configurator Mode.
- Holding
S2while plugging in - Holding
S2 + B3 + B4for 5 seconds.
Test that you are holding correct buttons, 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.
Another device on your network has the IPV4 address of 192.168.7.1
If another device (e.g. router, managed switch/hub, IoT device, etc.) is on the network and has the same IP address, the web configurator will not be able to access the Web Configurator due to IP conflicts.
Disconnect your computer from your local network (e.g. unplug the ethernet cable) and then attempt to access the Web Configurator again.
Configuration Issues
Why does PS4 or PS5 Input Mode not work on my device?
Did not press A1 after connecting the controller.
After connecting a controller that is correctly configured for PS4 or PS5 Input Mode, you need to press A1 in order to have the PS4 or PS5 register the controller. Once you have done so, the console should now properly receive inputs from the controller.
The controller mode is incorrectly configured.
Ensure that, under the Settings section, you have uploaded key files for PS4 or selected Host USB for PS4 and PS5.
For more information, refer to the PS4 Input Mode or PS5 Input Mode documentation.
USB Host Port not configured correctly
Verify that your USB host port is correctly configured in the Web Configurator under Peripheral Mapping. The specific pins for Data+ and Data- may differ between devices and device manufacturers so check with the documentation provided by the vendor.
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.
I cannot get to WebConfig using the shortcuts. How do I get to the Web Configurator?
Without flash nuking your device, flash this firmware file using the firmware installation instructions. This will force your device to reboot into Web Configurator mode.
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.
- Flash the compiled Pico GP2040 firmware from the downloads page using the firmware installation instructions.
- 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.
- Go to Configuration>Pin Mapping
- 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
- 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.