Date: Sun, 1 Jun 2003 15:38:45 -0700 (PDT) From: Jeff Brown <jabrown@caida.org> Subject: [patch] SDL-1.2.5 + FreeBSD joystick axes, hat fixes Hello again! When I sent in some SDL fixes last December, I found out they'd already been fixed in the CVS version. This time, I checked the repository before bugging you. =) I'm using SDL-1.2.5 on a FreeBSD 4.6.2-RELEASE system, and in the course of getting my multi-analog-axis USB controller (with a hat switch!) working with d2x-sdl -- the SDL port of the Descent 2 engine -- I came across a few problems: 1) The second analog stick is reported as a slider in one direction, and "Rz" in the other. SDL was ignoring the Rz axis, so I added Rx/Ry/Rz to the set of things SDL considers to be axes. 2) After the above change, the set of JOYAXE_* axes for my gamepad was {0,1,3,7}; however, d2x-sdl expects the axes to be contiguously numbered from 0, which seems like a pretty reasonable expectation, rather than having to scan the entire space of axes that SDL may or may not have. So, I added a table lookup which maps the JOYAXE_* axis numbers to 0,1,... in the order they're detected by SDL_SYS_JoystickOpen(), when reporting them to the application. I also added a function "usage_to_joyaxe()" which maps the USB HUG_* usage values to JOYAXE_values, since the repeated case statements testing for HUG_* were getting out of hand. 3) The BSD joystick driver had no hat support, so I added it. It looks like our USB library can only support one hat switch per device, which makes life easy. The patch against SDL-1.2.5 which implements these changes is at: http://www.caida.org/~jabrown/patches/sdl-1.2.5-bsdhat.diff After applying, SDL's "testjoystick" reports all activity from my gamepad correctly, and d2x works too (though it needed some other fixes). Moving on... There is also a problem with slightly different USBHID library interfaces on different versions of FreeBSD. I wasn't going to mention this since the FreeBSD port for SDL-1.2.5 (and not SDL itself) was doing the FreeBSD version-specific patching, so I e-mailed the port maintainer with this change. However, I see that you've incorporated the FreeBSD version-checking stuff into the CVS version of SDL, so now it's relevant for you too. The problem is, the FreeBSD #if tests don't work right for FreeBSD 4.6.2-RELEASE. There may be other versions with this problem, but I've only tested 4.6.2-R. The following patch against your latest CVS version fixes this: --- SDL_sysjoystick.c-1.16 Tue Apr 15 09:02:08 2003 +++ SDL_sysjoystick.c Sun Jun 1 15:10:28 2003 @@ -420,6 +420,8 @@ # else len = hid_report_size(rd, repinfo[repind].kind, r->rid); # endif +# elif (__FreeBSD_version == 460002) + len = hid_report_size(rd, r->rid, repinfo[repind].kind); # else len = hid_report_size(rd, repinfo[repind].kind, &r->rid); #endif I hope this is all useful to you. I've been getting myself dizzy playing Descent 2 with it, all morning! -Jeff Brown P.S. My USB controller is a Thrustmaster Firestorm Dual Analog 2. That's probably irrelevant, but I threw it in for completeness.

Simple DirectMedia Layer CREDITS
Thanks to everyone who made this possible, including:

* Cliff Matthews, for giving me a reason to start this project. :)
 -- Executor rocks!  *grin*

* Scott Call, for making a home for SDL on the 'Net... Thanks! :)

* The Linux Fund, C Magazine, and Gareth Noyce for financial contributions

* Gaëtan de Menten for writing the PHP and SQL behind the SDL website

* Martin Donlon for his work on the SDL Documentation Project

* Ryan Gordon for helping everybody out and keeping the dream alive. :)

* Mattias Engdegård, for help with the Solaris port and lots of other help

* Max Watson, Matt Slot, and Kyle for help with the MacOS Classic port

* Stan Shebs, for the initial MacOS X port

* Max Horn and Darrell Walisser for unflagging work on the MacOS X port

* Patrick Trainor, Jim Boucher, and Mike Gorchak for the QNX Neutrino port

* Carsten Griwodz for the AIX port

* Gabriele Greco, for the Amiga port

* Patrice Mandin, for the Atari port

* Hannu Viitala for the EPOC port

* Peter Valchev for nagging me about the OpenBSD port until I got it right. :)

* Kent B Mein, for a place to do the IRIX port

* Ash, for a place to do the OSF/1 Alpha port

* David Sowsy, for help with the BeOS port

* Eugenia Loli, for endless work on porting SDL games to BeOS

* Jon Taylor for the GGI front-end

* Paulus Esterhazy, for the Visual C++ testing and libraries

* Brenda Tantzen, for Metrowerks CodeWarrior on MacOS

* Chris Nentwich, for the Hermes assembly blitters

* Michael Vance and Jim Kutter for the X11 OpenGL support

* Stephane Peter, for the AAlib front-end and multi-threaded timer idea.

* Jon Atkins for great SDL_net and SDL_mixer documentation

* Peter Wiklund, for the 1998 winning SDL logo,
  and Arto Hamara, Steven Wong, and Kent Mein for other logo entries.

* Everybody at Loki Software, Inc. for their great contributions!

 And a big hand to everyone else who gave me appreciation, advice,
 and suggestions, especially the good folks on the SDL mailing list.

THANKS! :)

  -- Sam Lantinga			<slouken@libsdl.org>