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.

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 questions to Troubleshooting FAQ #34

Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
39 changes: 34 additions & 5 deletions docs/faq/faq-troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -102,28 +102,57 @@ Regarding PS5 disconnection issues. [PS Passthrough](../add-ons/ps-passthrough.m

For more information, refer to the [PS4/PS5 Compatibility FAQ](../faq/faq-console-compatibility.mdx).

## Configuration Issues

### 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.

Test that you are holding <Hotkey buttons={["S2"]}/> when booting, using a using the website like [Gamepad Tester](https://gamepad-tester.com/), or in another application such as the Steam Input Overlay. to verify that you are pressing the correct button.
:::info How to get into Webconfig Mode

- Holding <Hotkey buttons={["S2"]} /> while plugging in
- Holding <Hotkey buttons={["S2", "B3", "B4"]} /> for 5 seconds.

:::

Test that you are holding correct buttons, using a using the website like [Gamepad Tester](https://gamepad-tester.com/), 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 PS Passthrough not work on my device?

#### USB Host Port not configured correctly
#### Did not press A1 after connecting the controller.

After connecting a controller that is correctly configured for PS Passthrough, you need to press <Hotkey buttons={["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.

If you have PS Passthrough enabled, you must turn off the `PS4 Mode` add-on as the two will not work together.

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.
Ensure that, under the `Settings` section, you have set the input mode as `PS4` and the `Controller Mode` as `Arcade Stick`. The PS Passthrough add-on will not work otherwise.

For more information, refer to the [PS Passthrough](../add-ons/ps-passthrough.mdx) add-on documentation.

#### USB Host Port not configured correctly

Verify that your USB host port is correctly configured in the Web Configurator under [Peripheral Mapping](/docs/web-configurator/menu-pages/03-peripheral-mapping.mdx#usb-host). 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](../faq/faq-console-compatibility.mdx).

### 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](../downloads/force_webconfig.uf2) using the [firmware installation](../installation.mdx) 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.
Expand Down
2 changes: 0 additions & 2 deletions docs/rgb-leds.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -84,8 +84,6 @@ When using a custom LED theme, these hotkeys will not affect the settings in any

### RGB LED Pressed Parameter

<ColorBlock color="teal" />

Changes the color the LED changes to when the button is pressed

Cycle through colors: Black<ColorBlock color="black" />, White<ColorBlock color="white" />, Red<ColorBlock color="red" />,
Expand Down
39 changes: 34 additions & 5 deletions versioned_docs/version-0.7.7/faq/faq-troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -102,28 +102,57 @@ Regarding PS5 disconnection issues. [PS Passthrough](../add-ons/ps-passthrough.m

For more information, refer to the [PS4/PS5 Compatibility FAQ](../faq/faq-console-compatibility.mdx).

## Configuration Issues

### 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.

Test that you are holding <Hotkey buttons={["S2"]}/> when booting, using a using the website like [Gamepad Tester](https://gamepad-tester.com/), or in another application such as the Steam Input Overlay. to verify that you are pressing the correct button.
:::info How to get into Webconfig Mode

- Holding <Hotkey buttons={["S2"]} /> while plugging in
- Holding <Hotkey buttons={["S2", "B3", "B4"]} /> for 5 seconds.

:::

Test that you are holding correct buttons, using a using the website like [Gamepad Tester](https://gamepad-tester.com/), 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 dur 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 PS Passthrough not work on my device?

#### USB Host Port not configured correctly
#### Did not press A1 after connecting the controller.

After connecting a controller that is correctly configured for PS Passthrough, you need to press <Hotkey buttons={["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.

If you have PS Passthrough enabled, you must turn off the `PS4 Mode` add-on as the two will not work together.

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.
Ensure that, under the `Settings` section, you have set the input mode as `PS4` and the `Controller Mode` as `Arcade Stick`. The PS Passthrough add-on will not work otherwise.

For more information, refer to the [PS Passthrough](../add-ons/ps-passthrough.mdx) add-on documentation.

#### USB Host Port not configured correctly

Verify that your USB host port is correctly configured in the Web Configurator under [Peripheral Mapping](/docs/web-configurator/menu-pages/03-peripheral-mapping.mdx#usb-host). 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](../faq/faq-console-compatibility.mdx).

### 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](../downloads/force_webconfig.uf2) using the [firmware installation](../installation.mdx) 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.
Expand Down
Loading