annotate README.Qtopia @ 632:85e104fe14c2

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.
author Sam Lantinga <slouken@libsdl.org>
date Mon, 02 Jun 2003 14:50:22 +0000
parents 2c5d4c22a2ac
children
rev   line source
386
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
1
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
2 ==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
3 Using the Simple DirectMedia Layer with Qtopia/OPIE
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
4 ==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
5
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
6 ==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
7 I. Setting up the Qtopia development environment.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
8
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
9 This document will not explain how to setup the Qtopia development
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
10 environment. That is outside the scope of the document. You can read
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
11 more on this subject in this excellent howto:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
12
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
13 http://www.zauruszone.com/howtos/linux_compiler_setup_howto.html
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
14
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
15 ==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
16 II. Building the Simple DirectMedia Layer libraries using the arm
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
17 cross-compiler
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
18
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
19 This is somewhat tricky since the name of the compiler binaries
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
20 differ from the standard. Also you should disable features not
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
21 needed. The command below works for me. Note that it's all one
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
22 line. You can also set the NM, LD etc environment variables
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
23 separately.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
24
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
25 NM=arm-linux-nm LD=arm-linux-ld CC=arm-linux-gcc CXX=arm-linux-g++ RANLIB=arm-linux-ranlib AR=arm-linux-ar ./configure --enable-video-qtopia --disable-video-dummy --disable-video-fbcon --disable-video-dga --disable-arts --disable-esd --disable-alsa --disable-cdrom --disable-video-x11 --disable-nasm --prefix=/opt/Qtopia/sharp/ arm-unknown-linux-gnu
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
26
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
27 One thing to note is that the above configure will include joystick
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
28 support, even though you can't have joysticks on the Zaurus. The
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
29 reason for this is to avoid link / compile / runtime errors with
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
30 applications that have joystick support.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
31
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
32 ==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
33 III. Building the Simple DirectMedia Layer test programs:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
34
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
35 After installing, making sure the correct sdl-config is in your
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
36 path, run configure like this:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
37
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
38 NM=arm-linux-nm LD=arm-linux-ld CC=arm-linux-gcc CXX=arm-linux-g++ AR=arm-linux-ar ./configure arm-unknown-linux-gnu
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
39
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
40 ==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
41 IV. Application porting notes
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
42
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
43 One thing I have noticed is that applications sometimes don't exit
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
44 correctly. Their icon remains in the taskbar and they tend to
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
45 relaunch themselves automatically. I believe this problem doesn't
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
46 occur if you exit your application using the exit() method. However,
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
47 if you end main() with 'return 0;' or so, this seems to happen.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
48
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
49 Also note that when running in landscape mode - i.e requesting a
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
50 window that is HEIGHT pixels wide and WIDTH pixels high, where WIDTH
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
51 and HEIGHT normally is 240 and 320 - the image is blitted so that
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
52 the hardware buttons are on the left side of the display. This might
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
53 not always be desirable but such is the code today.
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
54
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
55
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
56 ==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
57 V. Enjoy! :)
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
58
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
59 If you have a project you'd like me to know about, or want to ask questions,
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
60 go ahead and join the SDL developer's mailing list by sending e-mail to:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
61
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
62 sdl-request@libsdl.org
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
63
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
64 and put "subscribe" into the subject of the message. Or alternatively you
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
65 can use the web interface:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
66
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
67 http://www.libsdl.org/mailman/listinfo/sdl
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
68
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
69 ==============================================================================
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
70 VI. What is supported:
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
71
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
72 Keyboard (Sharp Zaurus)
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
73 Hardware buttons
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
74 Stylus input (mouse)
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
75 Video. Allows fullscreen both in portrait mode (up to WIDTHxHEIGHT
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
76 size window) and in landscape mode (up to HEIGHTxWIDTH).
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
77
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
78 All other SDL functionality works like a normal Linux system (threads,
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
79 audio etc).
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
80
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
81 --
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
82 David Hedbor <david@hedbor.org>
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
83 http://david.hedbor.org/ http://eongames.com/
2c5d4c22a2ac Added a README for Qtopia
Sam Lantinga <slouken@libsdl.org>
parents:
diff changeset
84