1 ======================================= 1 =======================================
2 Analog Joystick Support on ALSA Drivers 2 Analog Joystick Support on ALSA Drivers
3 ======================================= 3 =======================================
4 4
5 Oct. 14, 2003 5 Oct. 14, 2003
6 6
7 Takashi Iwai <tiwai@suse.de> 7 Takashi Iwai <tiwai@suse.de>
8 8
9 General 9 General
10 ------- 10 -------
11 11
12 First of all, you need to enable GAMEPORT supp 12 First of all, you need to enable GAMEPORT support on Linux kernel for
13 using a joystick with the ALSA driver. For th 13 using a joystick with the ALSA driver. For the details of gameport
14 support, refer to Documentation/input/joydev/j 14 support, refer to Documentation/input/joydev/joystick.rst.
15 15
16 The joystick support of ALSA drivers is differ 16 The joystick support of ALSA drivers is different between ISA and PCI
17 cards. In the case of ISA (PnP) cards, it's u 17 cards. In the case of ISA (PnP) cards, it's usually handled by the
18 independent module (ns558). Meanwhile, the AL 18 independent module (ns558). Meanwhile, the ALSA PCI drivers have the
19 built-in gameport support. Hence, when the AL 19 built-in gameport support. Hence, when the ALSA PCI driver is built
20 in the kernel, CONFIG_GAMEPORT must be 'y', to 20 in the kernel, CONFIG_GAMEPORT must be 'y', too. Otherwise, the
21 gameport support on that card will be (silentl 21 gameport support on that card will be (silently) disabled.
22 22
23 Some adapter modules probe the physical connec 23 Some adapter modules probe the physical connection of the device at
24 the load time. It'd be safer to plug in the j 24 the load time. It'd be safer to plug in the joystick device before
25 loading the module. 25 loading the module.
26 26
27 27
28 PCI Cards 28 PCI Cards
29 --------- 29 ---------
30 30
31 For PCI cards, the joystick is enabled when th 31 For PCI cards, the joystick is enabled when the appropriate module
32 option is specified. Some drivers don't need 32 option is specified. Some drivers don't need options, and the
33 joystick support is always enabled. In the fo 33 joystick support is always enabled. In the former ALSA version, there
34 was a dynamic control API for the joystick act 34 was a dynamic control API for the joystick activation. It was
35 changed, however, to the static module options 35 changed, however, to the static module options because of the system
36 stability and the resource management. 36 stability and the resource management.
37 37
38 The following PCI drivers support the joystick 38 The following PCI drivers support the joystick natively.
39 39
40 ============== ============= ============== 40 ============== ============= ============================================
41 Driver Module Option Available Valu 41 Driver Module Option Available Values
42 ============== ============= ============== 42 ============== ============= ============================================
43 als4000 joystick_port 0 = disable (d 43 als4000 joystick_port 0 = disable (default), 1 = auto-detect,
44 manual: any ad 44 manual: any address (e.g. 0x200)
45 au88x0 N/A N/A 45 au88x0 N/A N/A
46 azf3328 joystick 0 = disable, 1 46 azf3328 joystick 0 = disable, 1 = enable, -1 = auto (default)
47 ens1370 joystick 0 = disable (d 47 ens1370 joystick 0 = disable (default), 1 = enable
48 ens1371 joystick_port 0 = disable (d 48 ens1371 joystick_port 0 = disable (default), 1 = auto-detect,
49 manual: 0x200, 49 manual: 0x200, 0x208, 0x210, 0x218
50 cmipci joystick_port 0 = disable (d 50 cmipci joystick_port 0 = disable (default), 1 = auto-detect,
51 manual: any ad 51 manual: any address (e.g. 0x200)
52 cs4281 N/A N/A 52 cs4281 N/A N/A
53 cs46xx N/A N/A 53 cs46xx N/A N/A
54 es1938 N/A N/A 54 es1938 N/A N/A
55 es1968 joystick 0 = disable (d 55 es1968 joystick 0 = disable (default), 1 = enable
56 sonicvibes N/A N/A 56 sonicvibes N/A N/A
57 trident N/A N/A 57 trident N/A N/A
58 via82xx [#f1]_ joystick 0 = disable (d 58 via82xx [#f1]_ joystick 0 = disable (default), 1 = enable
59 ymfpci joystick_port 0 = disable (d 59 ymfpci joystick_port 0 = disable (default), 1 = auto-detect,
60 manual: 0x201, 60 manual: 0x201, 0x202, 0x204, 0x205 [#f2]_
61 ============== ============= ============== 61 ============== ============= ============================================
62 62
63 .. [#f1] VIA686A/B only 63 .. [#f1] VIA686A/B only
64 .. [#f2] With YMF744/754 chips, the port addre 64 .. [#f2] With YMF744/754 chips, the port address can be chosen arbitrarily
65 65
66 The following drivers don't support gameport n 66 The following drivers don't support gameport natively, but there are
67 additional modules. Load the corresponding mo 67 additional modules. Load the corresponding module to add the gameport
68 support. 68 support.
69 69
70 ======= ================= 70 ======= =================
71 Driver Additional Module 71 Driver Additional Module
72 ======= ================= 72 ======= =================
73 emu10k1 emu10k1-gp 73 emu10k1 emu10k1-gp
74 fm801 fm801-gp 74 fm801 fm801-gp
75 ======= ================= 75 ======= =================
76 76
77 Note: the "pcigame" and "cs461x" modules are f 77 Note: the "pcigame" and "cs461x" modules are for the OSS drivers only.
78 These ALSA drivers (cs46xx, trident and au88x0 78 These ALSA drivers (cs46xx, trident and au88x0) have the
79 built-in gameport support. 79 built-in gameport support.
80 80
81 As mentioned above, ALSA PCI drivers have the 81 As mentioned above, ALSA PCI drivers have the built-in gameport
82 support, so you don't have to load ns558 modul 82 support, so you don't have to load ns558 module. Just load "joydev"
83 and the appropriate adapter module (e.g. "anal 83 and the appropriate adapter module (e.g. "analog").
84 84
85 85
86 ISA Cards 86 ISA Cards
87 --------- 87 ---------
88 88
89 ALSA ISA drivers don't have the built-in gamep 89 ALSA ISA drivers don't have the built-in gameport support.
90 Instead, you need to load "ns558" module in ad 90 Instead, you need to load "ns558" module in addition to "joydev" and
91 the adapter module (e.g. "analog"). 91 the adapter module (e.g. "analog").
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.