You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Merge pull request #984 from davidhedlund/patch-18
Update controller-autoconfiguration.md -- The `android`, `udev`, and `sdl2` drivers can use either the Device Index (`input_device`) or a combination of Vendor ID (`input_vendor_id`) and Product ID (`input_product_id`) -- Thanks zoltanvb!
Copy file name to clipboardExpand all lines: docs/guides/controller-autoconfiguration.md
+8-4Lines changed: 8 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -15,8 +15,8 @@ The matching algorithm considers several key factors:
15
15
16
16
Different controller drivers use these identifiers in various ways:
17
17
18
-
- The `android`and `sdl2` drivers utilize both the Vendor ID (input_vendor_id) and Product ID (input_product_id).
19
-
- The `linuxraw`and `udev` drivers rely on the Device Index (input_device).
18
+
- The `android`, `udev`, and `sdl2` drivers can use either the Device Index (`input_device`) or a combination of Vendor ID (`input_vendor_id`) and Product ID (`input_product_id`). If the Device Index is configured incorrectly, the system will fall back on checking the Vendor ID and Product ID, and vice versa. References: input_autoconfigure_get_config_file_affinity in (task_autodetect.c)[https://github.com/libretro/RetroArch/blob/master/tasks/task_autodetect.c], and `input_autoconfigure_connect` in [android_input.c](https://github.com/libretro/RetroArch/blob/master/input/drivers/android_input.c), [sdl_joypad.c](https://github.com/libretro/RetroArch/blob/master/input/drivers_joypad/sdl_joypad.c), [udev_joypad.c](https://github.com/libretro/RetroArch/blob/master/input/drivers_joypad/udev_joypad.c).
19
+
- The `linuxraw`driver rely on the Device Index (input_device).
20
20
21
21
### Difference in input variable generation between linuxraw and udev.
22
22
@@ -342,7 +342,7 @@ When developing controller configurations, it's essential to anticipate and miti
342
342
Here's how to set up a default-off configuration:
343
343
344
344
1. Append "(default-off)" to the configuration filename.
345
-
2. Comment out the `input_vendor_id` and `input_product_id` lines in the config file.
345
+
2. Comment out the `input_device`, `input_vendor_id` and `input_product_id` lines in the config file.
346
346
3. Do not add "(default-off)" to the values of the input_device_display_name and input_driver variables in the config file. The default-off status is already indicated by the filename, so these variables should remain unmodified for clarity.
347
347
348
348
This approach allows users to manually enable the configuration when needed, preventing automatic application that could interfere with common devices, and helps ensure a smoother experience for users while still providing the necessary configuration options for those who require them.
@@ -402,6 +402,8 @@ In the above list, five **Autoconfigs file names to generate** entries are ident
402
402
```
403
403
#input_device = "Nintendo Co., Ltd. Pro Controller"
404
404
input_device_display_name = "Nintendo Switch Pro Controller (non-HID) (USB)"
405
+
#input_vendor_id = "1406"
406
+
#input_product_id = "8201"
405
407
```
406
408
407
409
Note: `(default-off)` is added to the filename , and `input_device` variable is commented out to disable this auto-configuration, preventing file name duplication and conflicts with the HID version: Nintendo Co., Ltd. Pro Controller.cfg
@@ -410,9 +412,11 @@ Note: `(default-off)` is added to the filename , and `input_device` variable is
410
412
```
411
413
#input_device = "Pro Controller"
412
414
input_device_display_name = "Nintendo Switch Pro Controller (non-HID) (Bluetooth)"
415
+
#input_vendor_id = "1406"
416
+
#input_product_id = "8201"
413
417
```
414
418
415
-
Note: `(default-off)` is added to the filename , and `input_device` variable is commented out to disable this auto-configuration, preventing file name duplication and conflicts with the HID version: Pro Controller.cfg
419
+
Note: `(default-off)` is added to the filename , and the `input_device`, `input_vendor_id` and `input_product_id` variables are commented out to disable this auto-configuration, preventing file name duplication and conflicts with the HID version: Pro Controller.cfg
0 commit comments