Documentation/input/cs461x.txt-CSDN博客

Chinese translated version of Documentation/input/cs461x.txt

If you have any comment or update to the content, please contact the
original document maintainer directly. However, if you have a problem
communicating in English you can also ask the Chinese maintainer for
help. Contact the Chinese maintainer if this translation is outdated
or if there is a problem with the translation.

Chinese maintainer: 秦芹 18768122412@163.com
---------------------------------------------------------------------
Documentation/input/cs461x.txt的中文翻译

如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻
译存在问题，请联系中文版维护者。

中文版维护者：秦芹 18768122412@163.com
中文版翻译者：秦芹 18768122412@163.com

以下为正文

---------------------------------------------------------------------

Preface.
前言。
This is a new low-level driver to support analog joystick attached to
Crystal SoundFusion CS4610/CS4612/CS4615. This code is based upon
Vortex/Solo drivers as an example of decoration style, and ALSA
0.5.8a kernel drivers as an chipset documentation and samples.
这是一个新的低级别驱动器支持模拟操纵杆连接到水晶SoundFusion

CS4610/CS4612/CS4615。此代码是基于Vortex/Solo的驱动程序作为

一个装饰风格的例子，ALSA0.5.8a内核驱动程序则作为一个芯片组的文档和示例。
This version does not have cooked mode support; the basic code
is present here, but have not tested completely. The button analysis
is completed in this mode, but the axis movement is not.
这个版本没有成熟的模式支持，基本代码是存在的，但是还没有进行完全测试。

在这种模式下，按钮分析已经完成，但轴运动还没有完成。
Raw mode works fine with analog joystick front-end driver and cs461x
driver as a backend. I've tested this driver with CS4610, 4-axis and
4-button joystick; I mean the jstest utility. Also I've tried to
play in xracer game using joystick, and the result is better than
keyboard only mode.
Raw模式是在模拟器操纵杆前端驱动器和cs461x来作为后端驱动程序的情况下，

正常工作的。我已经在CS4610，4轴和4按钮操纵杆的环境下测试过这个驱动程序；

这意味着jstest的实用性。此外，我已经尝试在xracer游戏中使用操纵杆，其结果比仅用键盘模式好。
The sensitivity and calibrate quality have not been tested; the two
reasons are performed: the same hardware cannot work under Win95 (blue
screen in VJOYD); I have no documentation on my chip; and the existing
behavior in my case was not raised the requirement of joystick calibration.
So the driver have no code to perform hardware related calibration.
灵敏度和校准质量还没有经过测试；原因是：一是在Win95（VJOYD蓝屏）下，

相同的硬件不能运转；在我的芯片上，没有任何文档；在任何情况下，

存在的行为没有提出操纵杆校准需求。所以驱动程序还没有代码来执行与硬件相关联的校准。
The patch contains minor changes of Config.in and Makefile files. All
needed code have been moved to one separate file cs461x.c like ns558.c
This driver have the basic support for PCI devices only; there is no
ISA or PnP ISA cards supported. AFAIK the ns558 have support for Crystal
ISA and PnP ISA series.
该补丁中的Config.in和Makefile文件包含细微的改变。所以需要的代码已经移至

一个单独的文件cs461x.c中，像ns558.c文件一样，这个驱动程序仅有PCI设备的基本支持，

没有ISA或者PnP ISA网卡的支持。AFAIK ns558支持水晶ISA和PnP ISA系列。
The driver works with ALSA drivers simultaneously. For example, the xracer
uses joystick as input device and PCM device as sound output in one time.
There are no sound or input collisions detected. The source code have
comments about them; but I've found the joystick can be initialized
separately of ALSA modules. So, you can use only one joystick driver
without ALSA drivers. The ALSA drivers are not needed to compile or
run this driver.
该驱动器与ALSA驱动同时运转。例如，xracer在同一时间，使用操纵杆作为输入设备，

PCM设备作为声音输出装置。这里没有声音和输入的冲突检测。

虽然源码已经对此作出了评论，但我已经找到了可以初始化将ALSA模块分开的操纵杆。

所以，你可以再没有ALSA驱动的情况下，只可以使用一个操纵杆来驱动。

ALSA驱动器不需要编译或者运行此驱动程序。
There are no debug information print have been placed in source, and no
specific options required to work this driver. The found chipset parameters
are printed via printk(KERN_INFO "..."), see the /var/log/messages to
inspect cs461x: prefixed messages to determine possible card detection
errors.
这里并没有将调试信息打印的结果放在源码中，也没有具体的选择需要启动

这个驱动程序。通过printk(KERN_INFO "...")打印发现的芯片参数，

在/var/log/messages路径下检测cs461x：前缀信息用来确定可能的卡检测错误。
Regards,
致敬，
Viktor
切尔诺梅尔