Skip to content

Commit 54606e3

Browse files
authored
Update controller-autoconfiguration.md
minor
1 parent fc4d6b2 commit 54606e3

File tree

1 file changed

+2
-3
lines changed

1 file changed

+2
-3
lines changed

docs/guides/controller-autoconfiguration.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,18 @@ When you connect a new controller to RetroArch, the system attempts to automatic
77
The matching algorithm considers several key factors:
88

99
- **Controller driver (input_driver)**: The software interface used to communicate with the controller. To use a specific driver, RetroArch must be configured accordingly by navigating to **Settings -> Drivers -> Controller**.
10-
- **Device Index (input_device)**: The name of the controller as recognized by the system.
10+
- **Device Index (input_device)**: The name of the controller as recognized by the system. The **Device Index** can be identified by navigating to **Settings -> Input -> RetroPad Binds -> Port 1 Controls**.
1111
- **Vendor ID (input_vendor_id)**: A unique identifier assigned to the controller's manufacturer.
1212
- **Product ID (input_product_id)**: A specific identifier for the particular controller model.
1313

1414
RetroArch evaluates each of these factors against its database of controller profiles. It then calculates a matching score for each profile, with the highest-scoring profile being selected to configure the controller.
1515

16-
It's important to note an exception involving the linuxraw driver. This driver uses an interface that does not provide Vendor ID (VID) and Product ID (PID) information. Instead, it only supplies a device name, which can be accessed using the `JSIOCGNAME` ioctl command from the Linux kernel. As a result, matching for controllers using the linuxraw driver relies more heavily on the device name rather than the usual vid:pid identifiers.
16+
RetroArch automatically utilizes the linuxraw driver, which operates differently than other drivers by providing only a device name instead of Vendor ID (VID) and Product ID (PID) information. This means that controller matching with the linuxraw driver depends primarily on the device name (Device Index), accessed through the JSIOCGNAME ioctl command, rather than the typical vid:pid identifiers.
1717

1818
It's worth noting that the Vendor ID and Product ID pair is often abbreviated as "vid:pid" in technical discussions.
1919

2020
This matching system allows RetroArch to support a wide range of controllers while minimizing the need for manual configuration in most cases.
2121

22-
2322
## Why is it needed?
2423

2524
RetroArch works many platforms. Each of these platforms has one or more input systems. These input systems in turn differ widely in the way they enumerate the pad buttons. For this reason, your joypad buttons may be mapped differently depending on if you are using Windows, Mac, or Linux.

0 commit comments

Comments
 (0)