요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Crystal SoundFusion CS4610/CS4612/CS461 joystick
================================================
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.
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.
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.
This driver have the basic support for PCI devices only; there is no
ISA or PnP ISA cards supported.
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.
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.
Regards,
Viktor
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
CS461x 아날로그 조이스틱과 모드 지원
1-17이 문서는 Crystal SoundFusion CS4610, CS4612, CS4615에 연결된 아날로그 조이스틱을 지원하는 새 저수준 드라이버를 설명합니다. 코드 구성 방식은 Vortex/Solo 드라이버를 참고했고, 칩셋 문서와 예제는 ALSA 0.5.8a 커널 드라이버를 기반으로 했습니다.
하드웨어 범위와 구현 참고 자료입니다.
이 버전은 cooked mode를 지원하지 않습니다. 기본 코드는 있지만 완전히 시험하지 않았고, 버튼 분석은 구현됐으나 축 이동 처리는 완성되지 않았습니다.
raw mode는 아날로그 조이스틱 front-end 드라이버와 `cs461x` backend 조합에서 정상 동작합니다. 작성자는 CS4610과 4축·4버튼 조이스틱을 `jstest`로 시험했고, `xracer` 게임에서도 키보드 전용 조작보다 나은 결과를 확인했습니다.
원문에서 명시한 구현·시험 수준을 구분합니다.
raw mode에서 front-end와 backend가 협력하는 구조입니다.
Crystal SoundFusion CS4610/CS4612/CS461 joystick
================================================
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.
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.보정 한계, PCI 범위와 ALSA 공존
18-34감도와 보정 품질은 시험하지 않았습니다. 같은 하드웨어가 Windows 95의 VJOYD에서 블루스크린을 냈고, 작성자에게 칩 문서가 없었으며, 실제 사용에서는 별도 조이스틱 보정이 필요하지 않았기 때문입니다. 따라서 드라이버에는 하드웨어 관련 보정 코드가 없습니다.
원문에 제시된 시험 제약을 그대로 정리합니다.
기본 지원 범위는 PCI 장치뿐이며 ISA 또는 PnP ISA 카드는 지원하지 않습니다.
드라이버는 ALSA와 동시에 사용할 수 있습니다. 예를 들어 `xracer`가 조이스틱을 입력으로 쓰면서 PCM 장치를 소리 출력으로 사용해도 충돌이 발견되지 않았습니다. 소스 주석은 관련 동작을 설명합니다.
조이스틱은 ALSA 모듈과 별개로 초기화할 수 있으므로 ALSA 없이 조이스틱 드라이버만 사용할 수 있습니다. 이 드라이버를 컴파일하거나 실행하는 데 ALSA 드라이버는 필요하지 않습니다.
지원 버스 및 오디오 드라이버와의 관계입니다.
입력과 사운드 경로가 독립적으로 동작하는 예입니다.
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.
This driver have the basic support for PCI devices only; there is no
ISA or PnP ISA cards supported.
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.진단 메시지와 옵션
35-43소스에는 별도의 디버그 출력이 없고 드라이버 동작에 필요한 전용 옵션도 없습니다. 감지한 칩셋 매개변수는 `printk(KERN_INFO "...")`로 기록됩니다.
카드 감지 오류 가능성을 조사하려면 `/var/log/messages`에서 `cs461x:` 접두사가 붙은 메시지를 확인합니다. 문서는 Viktor의 인사말로 끝납니다.
사용 가능한 로그와 별도 제공되지 않는 기능입니다.
드라이버가 별도 debug 옵션을 제공하지 않을 때의 확인 순서입니다.
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.
Regards,
Viktor
요약·해설
cs461x.rst:1-43CS461x 저수준 드라이버는 PCI SoundFusion 칩의 아날로그 조이스틱 raw mode를 제공합니다. cooked mode와 하드웨어 보정은 미완성이지만 ALSA와 충돌 없이 동시에 또는 독립적으로 사용할 수 있습니다.
지원 상태와 진단 지점을 요약합니다.