xref: /linux/Documentation/input/devices/cs461x.rst (revision bd628c1bed7902ec1f24ba0fe70758949146abbe)
1Crystal SoundFusion CS4610/CS4612/CS461 joystick
2================================================
3
4This is a new low-level driver to support analog joystick attached to
5Crystal SoundFusion CS4610/CS4612/CS4615. This code is based upon
6Vortex/Solo drivers as an example of decoration style, and ALSA
70.5.8a kernel drivers as an chipset documentation and samples.
8
9This version does not have cooked mode support; the basic code
10is present here, but have not tested completely. The button analysis
11is completed in this mode, but the axis movement is not.
12
13Raw mode works fine with analog joystick front-end driver and cs461x
14driver as a backend. I've tested this driver with CS4610, 4-axis and
154-button joystick; I mean the jstest utility. Also I've tried to
16play in xracer game using joystick, and the result is better than
17keyboard only mode.
18
19The sensitivity and calibrate quality have not been tested; the two
20reasons are performed: the same hardware cannot work under Win95 (blue
21screen in VJOYD); I have no documentation on my chip; and the existing
22behavior in my case was not raised the requirement of joystick calibration.
23So the driver have no code to perform hardware related calibration.
24
25This driver have the basic support for PCI devices only; there is no
26ISA or PnP ISA cards supported.
27
28The driver works with ALSA drivers simultaneously. For example, the xracer
29uses joystick as input device and PCM device as sound output in one time.
30There are no sound or input collisions detected. The source code have
31comments about them; but I've found the joystick can be initialized
32separately of ALSA modules. So, you can use only one joystick driver
33without ALSA drivers. The ALSA drivers are not needed to compile or
34run this driver.
35
36There are no debug information print have been placed in source, and no
37specific options required to work this driver. The found chipset parameters
38are printed via printk(KERN_INFO "..."), see the /var/log/messages to
39inspect cs461x: prefixed messages to determine possible card detection
40errors.
41
42Regards,
43Viktor
44