README.QNX
author Sam Lantinga <slouken@libsdl.org>
Mon, 02 Jun 2003 14:50:22 +0000
changeset 632 85e104fe14c2
parent 380 bce7171e7a85
child 663 8bedd6d61642
permissions -rw-r--r--
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.
slouken@380
     1
README by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua>
slouken@266
     2
slouken@309
     3
    OpenGL in window mode  works well  and  stable, in fullscreen
slouken@309
     4
mode too, but fullscreen mode has not been heavily tested.
slouken@309
     5
    If you have QNX RtP 6.1.0 w/ or w/o Patch A you must download
slouken@309
     6
new Photon3D runtime from http://developers.qnx.com. The versions
slouken@309
     7
of OS before 6.1.0 are not supported.
slouken@279
     8
slouken@279
     9
Problems:
slouken@320
    10
1. While  creating  OpenGL  context  software  renderer  mode  is
slouken@320
    11
   artificially selected (QSSL made acceleration only for  Voodoo
slouken@320
    12
   boards in fullscreen mode, sorry but I don't have  this board,
slouken@320
    13
   if you want acceleration - you may remove some line  in source
slouken@320
    14
   code).
slouken@309
    15
2. Photon has some errors in detecting  how  much bits  per pixel
slouken@309
    16
   videomode has.
slouken@309
    17
3. No  shared  libraries  yet.  We  need  manually  set  flag  to
slouken@291
    18
   'configure' --disable-shared.
slouken@380
    19
4. Due to Photon API limitation, flag SDL_HWSURFACE supported on-
slouken@380
    20
   ly in case of desktop bpp is equal requested bpp in window mo-
slouken@380
    21
   de.
slouken@266
    22
slouken@266
    23
Some building issues:
slouken@266
    24
slouken@266
    25
    Run configure script without x11 support, e.g.:
slouken@266
    26
slouken@279
    27
    a) for OpenGL support:
slouken@279
    28
    ./configure --prefix=/usr/local \
slouken@279
    29
                --disable-video-x11 \
slouken@279
    30
                --disable-shared
slouken@279
    31
slouken@291
    32
    b) without OpenGL support:
slouken@279
    33
    ./configure --prefix=/usr/local \
slouken@279
    34
                --disable-video-x11 \
slouken@279
    35
                --disable-shared    \
slouken@279
    36
                --disable-video-opengl
slouken@266
    37
slouken@320
    38
    In test directory  also run  ./configure  script  without x11
slouken@320
    39
support, e.g.:
slouken@266
    40
slouken@266
    41
    ./configure  --with-sdl-prefix=/usr/local      \
slouken@266
    42
                 --with-sdl-exec-prefix=/usr/local \
slouken@266
    43
                 --prefix=/usr/local --without-x
slouken@279
    44