home *** CD-ROM | disk | FTP | other *** search
/ PC Welt 2006 November (DVD) / PCWELT_11_2006.ISO / casper / filesystem.squashfs / usr / share / doc / alsa-base / driver / Joystick.txt < prev    next >
Encoding:
Text File  |  2004-09-13  |  3.3 KB  |  87 lines

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