search

libsdl-org / SDL

Simple Directmedia Layer
https://libsdl.org
zlib License
9.8k stars 1.82k forks source link

Add steering wheel API for SDL3 #6540

Open IOBYTE opened 1 year ago

IOBYTE commented 1 year ago

We need a hardware independent API for steering wheels just like we have for gamepads. The axes for steering, brake, clutch and accelerator and buttons for shifters and force feedback are not standardized for different hardware and different operating systems so a mapping system is needed just like we have for gamepads.

flibitijibibo commented 1 year ago

Might be something for #4464, but I wonder how much research Feral has leftover from their F1 games...

berarma commented 1 year ago

This is really needed. It's a big hole in the SDL API. I came here to open a ticket for this.

I can offer some help. I've implemented an improved Logitech driver, a ffb testing tool, a wheel settings manager tool, and somewhat tried to help other wheel driver projects for Thrustmaster (and 2) and Fanatec wheels. I think the owners of those projects would be willing to help too.

Besides detecting wheels like we currently detect game controllers, the axes and buttons mappings, we should have a function to change the rotation range of the wheel. More things could be added but this would be a good start.

slouken commented 1 year ago

@berarma, I'm open to this for SDL3.

FWIW, I haven't been able to get wheels working in any game on any platform for the last 5 years. I have sitting here the Logitech G923 for Xbox and the PXN V900, and Linux and Windows don't see any input from the G923, and the V900 looks like a standard Xbox or PS3 controller depending on what mode it's in, but games don't see it mapped as a wheel.

Maybe you can help me get wheels working in general before we add an API for them? :)

berarma commented 1 year ago

@berarma, I'm open to this for SDL3.

FWIW, I haven't been able to get wheels working in any game on any platform for the last 5 years. I have sitting here the Logitech G923 for Xbox and the PXN V900, and Linux and Windows don't see any input from the G923, and the V900 looks like a standard Xbox or PS3 controller depending on what mode it's in, but games don't see it mapped as a wheel.

Maybe you can help me get wheels working in general before we add an API for them? :)

I don't know about the PXN V900 and the G923 for XBox isn't supported yet as far as I know.

There was a pending kernel patch for the G923 Xbox (I'd have to check its status again): https://www.spinics.net/lists/linux-input/msg73531.html

The G923 for Xbox uses the HIDPP protocol for FFB, same as the G920. In its initial state after plugging it in, the G920 isn't usable and the G923 might be the same. It has to switch modes internally using usb_modeswitch. This changes its USB product id and puts it in PC mode. Most (if not all) distributions already ship udev rules to do it. But not for the G923. And it would still need a patched HIDPP driver.

Logitech maintains a document with the technical information for their wheels: https://opensource.logitech.com/wiki/Technical_Information/

It should be possible to get the G923 for Xbox working like a G920 with the linked patch above and the information in that document.

The Logitech G923 for PS is similar to the Logitech G29 and it's currently supported by my driver new-lg4ff thanks to the patch provided by a user.

I have a summary of Linux wheel support at: https://github.com/berarma/oversteer/blob/master/README.md

The Logitech G29 is perhaps the most tested and better working wheel, followed by the G25 and G27. The G920 should work well too although there were reports of messages about a full command queue in the driver and laggy FFB in the past.

If the PXN V900 had a PS3 mode that worked like the Logitech wheels then it might be compatible. The USB id should be added to the Logitech driver to recognize the wheel though.

IOBYTE commented 1 year ago

Speed Dreams https://sourceforge.net/projects/speed-dreams/ is a car racing game that uses SDL2 for user input and works fine for me with a Logitech G29 on both Windows and linux. The game currently requires you to manually configure every aspect of the wheel before it can be used. I attempted to add auto configuration to Speed Dreams based on device ID using a mapping scheme like SDL currently has for game controllers. I got that working great on Windows. You could install the game and immediately start playing it without having to configure the wheel. I then tried to play the game on linux with the same configuration settings and it didn't work. Linux uses different axes than Windows for the same control so I would have to add an OS specific mapping for each device just like SDL does for game controllers. That's where I gave up because I would have to duplicate what SDL already has for game controllers for wheels and that's something that should be done in SDL and not the application.

IOBYTE commented 1 year ago

The new API should probably also handle aircraft controls.

IOBYTE commented 1 year ago

Another issue with high end steering wheels is that they consist of multiple USB devices. There will be a USB joystick device for the steering wheel base which is just the steering axis and the force feedback (haptic). There will be another USB joystick device just for the steering wheel which will have buttons, hats, analog clutches and LEDs. There will be another USB joystick device just for the pedals which could also have haptic. There could be another USB joystick device for a shifter which could be an H pattern or sequential. There could be another USB joystick device for the handbrake. There could be another USB joystick device for the dashboard or button box. I believe the type of the joystick device should be more than just SDL_JOYSTICK_TYPE_WHEEL and a joystick could have multiple device types. A wheel like a Logitech G29 would have multiple types because it supports many functions (wheel base, wheel, pedals, shifter) in a single device.

This same problem also exists for aircraft controls.