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

Update controller-autoconfiguration.md #910

Merged
merged 39 commits into from
Mar 16, 2024

Conversation

davidhedlund
Copy link
Contributor

@davidhedlund davidhedlund commented Jan 15, 2024

* Updated the GUI paths
* Mentioned: "If applicable, then also check the menu button binding in" (text copied from https://github.com/libretro/retroarch-joypad-autoconfig)
Added locations to the analog stick labels
the .cfg file will be in: [Controller profile directory]/[Controller driver]/[Device index].cfg
Replaced "Update Autoconfig Profiles" with "Update Controller Profiles"
[Input descriptors](#input-descriptors)
Updated the "Update Controller Profiles" screenshot
Replaced "Update Autoconfig Profiles" with "Update Controller Profiles"
Replaced the Snes9x (proprietary software) screenshot, with a BSNES (free software) screenshot
Added special instructions for Android

![Snes9x joypad configuration](../image/retroarch/input/snes9x-joyconfig-example.jpg)
![image](https://github.com/davidhedlund/docs/assets/6416073/d89aefdb-ea5e-40be-8443-d34d88766d25)
Copy link
Member

@RobLoach RobLoach Jan 19, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reference local images, rather than the direct URL.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry. How can I upload the new image then?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry. How can I upload the new image then?

You can put it into ../image/ folder. Make sure you put it into the correct sub-directory.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry. How can I upload the new image then?

You can put it into ../image/ folder. Make sure you put it into the correct sub-directory.

Check this please: master...davidhedlund:docs:master

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I removed the image from the document, I don't have time for this right now.

Restored the snes9x image, I don't have time to learn how to upload images right now.
@@ -38,32 +39,40 @@ Having automatically configured joypads makes it a lot easier to navigate the Re

## Installing or updating joypad profiles

![downloading joypad profiles](../image/retroarch/input/update-joypads.jpg)
![image](https://github.com/davidhedlund/docs/assets/6416073/e2c11f35-fef1-402b-a975-e092b05d4dcc)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It should be located here. docs/image/guides

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for reaching out. I'm just overloaded. It's ok if we skip the image, unless someone else wants to solve this. It's no biggie for me, the important thing is to merge since I made a lot of updates.

@fpscan fpscan requested a review from RobLoach January 20, 2024 11:20
## Before you begin

Make sure that you run the latest version of RetroArch...
Replaced wrong text "Input descriptors":

2. For Android, run the  [Input descriptors](#android) step first.

with

 2. For Android, run the [Android](#android) steps first.
Removed:

For example, RetroArch 1.16.0 incorrectly added these lines by default:
```
input_gun_trigger_mbtn = "1"
input_gun_offscreen_shot_mbtn = "2"
```
Replaced

- Create `/storage/emulated/0/RetroArch/autoconfig/android`

with

- Create `/storage/emulated/0/RetroArch/autoconfig/`
@davidhedlund
Copy link
Contributor Author

davidhedlund commented Feb 10, 2024

Thank you for the review, Rob.

Added:
- `Settings` -> `Input` -> `RetroPad Binds` -> `Port 1 Controls` -> `Save Controller Profile` will now save the Android autoconfig files in `/storage/emulated/0/RetroArch/autoconfig/android`
placed input_driver before input_device -- Reference: RetroArch 1.17.0 generates autoconfig this way
Took myself liberty to replace

input_device = "Microsoft X-Box One pad"
input_vendor_id = 1118
input_product_id = 721

with the current stable PlayStation controller that I have spent many, many working hours to generate autoconfig files for in various operating systems:

input_device = "Sony Interactive Entertainment DualSense Edge Wireless Controller"
input_vendor_id = "1356"
input_product_id = "3570"
7. Open the file in a text editor and check if some variables are missing. If your OS does not support the controller, then RetroArch will not be able to generate a complete autoconfig file.
8. Make sure that your mapping is perfect by testing every button in the menu, and in game(s) that make use of all of them.
You can try to re-map missing buttons before you give up and save the controller once again, but please do NOT add missing variables manually. We rely on automated data to debug the autoconfig files.
* Added a "#### Inspect the file" section
* Added: Evaluate Bluetooth
Add Hotkeys for games/cores that does not use all buttons
After you have loaded the game it's possible that you have to change the native controller to your controller in `Quick Menu` -> `Settings` -> `Input` -> `RetroPad Binds` -> `Port 1 Controls` -> `Device Index` -- for example if you want to use both thumbsticks you have to change `PS1` to `DualShock` in PlayStation cores.
Corrected the axis example
`Main Menu` -> `Load Core` -> `Start Remote RetroPad`
@fpscan
Copy link
Collaborator

fpscan commented Feb 24, 2024

Hi @davidhedlund is it done? @RobLoach do you think you can check one more time?

@davidhedlund
Copy link
Contributor Author

Hi @davidhedlund is it done? @RobLoach do you think you can check one more time?

Yes, I'm done.

@fpscan fpscan requested a review from RobLoach February 28, 2024 16:49
Improve the "### Inspect the file" section
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants