aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/input/cs461x.txt
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
committerLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
commit1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 (patch)
tree0bba044c4ce775e45a88a51686b5d9f90697ea9d /Documentation/input/cs461x.txt
Linux-2.6.12-rc2
Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
Diffstat (limited to 'Documentation/input/cs461x.txt')
-rw-r--r--Documentation/input/cs461x.txt45
1 files changed, 45 insertions, 0 deletions
diff --git a/Documentation/input/cs461x.txt b/Documentation/input/cs461x.txt
new file mode 100644
index 000000000000..6181747a14d8
--- /dev/null
+++ b/Documentation/input/cs461x.txt
@@ -0,0 +1,45 @@
1Preface.
2
3This is a new low-level driver to support analog joystick attached to
4Crystal SoundFusion CS4610/CS4612/CS4615. This code is based upon
5Vortex/Solo drivers as an example of decoration style, and ALSA
60.5.8a kernel drivers as an chipset documentation and samples.
7
8This version does not have cooked mode support; the basic code
9is present here, but have not tested completely. The button analysis
10is completed in this mode, but the axis movement is not.
11
12Raw mode works fine with analog joystick front-end driver and cs461x
13driver as a backend. I've tested this driver with CS4610, 4-axis and
144-button joystick; I mean the jstest utility. Also I've tried to
15play in xracer game using joystick, and the result is better than
16keyboard only mode.
17
18The sensitivity and calibrate quality have not been tested; the two
19reasons are performed: the same hardware cannot work under Win95 (blue
20screen in VJOYD); I have no documentation on my chip; and the existing
21behavior in my case was not raised the requirement of joystick calibration.
22So the driver have no code to perform hardware related calibration.
23
24The patch contains minor changes of Config.in and Makefile files. All
25needed code have been moved to one separate file cs461x.c like ns558.c
26This driver have the basic support for PCI devices only; there is no
27ISA or PnP ISA cards supported. AFAIK the ns558 have support for Crystal
28ISA and PnP ISA series.
29
30The driver works witn ALSA drivers simultaneously. For exmple, the xracer
31uses joystick as input device and PCM device as sound output in one time.
32There are no sound or input collisions detected. The source code have
33comments about them; but I've found the joystick can be initialized
34separately of ALSA modules. So, you canm use only one joystick driver
35without ALSA drivers. The ALSA drivers are not needed to compile or
36run this driver.
37
38There are no debug information print have been placed in source, and no
39specific options required to work this driver. The found chipset parameters
40are printed via printk(KERN_INFO "..."), see the /var/log/messages to
41inspect cs461x: prefixed messages to determine possible card detection
42errors.
43
44Regards,
45Viktor