요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
=============================
2
Infinity Usb Unlimited Readme
3
=============================
5
Hi all,
8
This module provide a serial interface to use your
9
IUU unit in phoenix mode. Loading this module will
10
bring a ttyUSB[0-x] interface. This driver must be
11
used by your favorite application to pilot the IUU
13
This driver is still in beta stage, so bugs can
14
occur and your system may freeze. As far I now,
15
I never had any problem with it, but I'm not a real
16
guru, so don't blame me if your system is unstable
18
You can plug more than one IUU. Every unit will
19
have his own device file(/dev/ttyUSB0,/dev/ttyUSB1,...)
23
How to tune the reader speed?
24
=============================
26
A few parameters can be used at load time
27
To use parameters, just unload the module if it is
28
already loaded and use modprobe iuu_phoenix param=value.
29
In case of prebuilt module, use the command
30
insmod iuu_phoenix param=value.
32
Example::
34
modprobe iuu_phoenix clockmode=3
36
The parameters are:
38
clockmode:
39
1=3Mhz579,2=3Mhz680,3=6Mhz (int)
40
boost:
41
overclock boost percent 100 to 500 (int)
42
cdmode:
43
Card detect mode
44
0=none, 1=CD, 2=!CD, 3=DSR, 4=!DSR, 5=CTS, 6=!CTS, 7=RING, 8=!RING (int)
45
xmas:
46
xmas color enabled or not (bool)
47
debug:
48
Debug enabled or not (bool)
50
- clockmode will provide 3 different base settings commonly adopted by
51
different software:
53
1. 3Mhz579
54
2. 3Mhz680
55
3. 6Mhz
57
- boost provide a way to overclock the reader ( my favorite :-) )
58
For example to have best performance than a simple clockmode=3, try this::
60
modprobe boost=195
62
This will put the reader in a base of 3Mhz579 but boosted a 195 % !
63
the real clock will be now : 6979050 Hz ( 6Mhz979 ) and will increase
64
the speed to a score 10 to 20% better than the simple clockmode=3 !!!
67
- cdmode permit to setup the signal used to inform the userland ( ioctl answer )
68
if the card is present or not. Eight signals are possible.
70
- xmas is completely useless except for your eyes. This is one of my friend who was
71
so sad to have a nice device like the iuu without seeing all color range available.
72
So I have added this option to permit him to see a lot of color ( each activity change the color
73
and the frequency randomly )
75
- debug will produce a lot of debugging messages...
78
Last notes
79
==========
81
Don't worry about the serial settings, the serial emulation
82
is an abstraction, so use any speed or parity setting will
83
work. ( This will not change anything ).Later I will perhaps
84
use this settings to deduce de boost but is that feature
85
really necessary ?
86
The autodetect feature used is the serial CD. If that doesn't
87
work for your software, disable detection mechanism in it.
90
Have fun !
92
Alain Degreffe
94
eczema(at)ecze.com
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
개요와 주의 사항
1-24이 모듈은 IUU 장치를 Phoenix mode로 제어하기 위한 serial interface를 제공합니다. 모듈을 로드하면 `ttyUSB[0-x]` interface가 생기고 사용자 응용 프로그램이 이를 통해 IUU를 제어합니다.
드라이버는 beta 단계이므로 버그나 system freeze 가능성이 있습니다. 원저자는 직접 겪은 문제는 없지만 안정성을 보증하지 않는다고 경고합니다.
IUU를 여러 개 연결할 수 있으며 각 장치는 `/dev/ttyUSB0`, `/dev/ttyUSB1`처럼 별도 device file을 가집니다.
항목설명
moduleiuu_phoenix
modePhoenix
device nodes/dev/ttyUSB0, /dev/ttyUSB1, ...
statusbeta; freeze 가능성 주의
모듈을 통해 각 reader가 독립 TTY로 노출됩니다.
=============================
Infinity Usb Unlimited Readme
=============================
Hi all,
This module provide a serial interface to use your
IUU unit in phoenix mode. Loading this module will
bring a ttyUSB[0-x] interface. This driver must be
used by your favorite application to pilot the IUU
This driver is still in beta stage, so bugs can
occur and your system may freeze. As far I now,
I never had any problem with it, but I'm not a real
guru, so don't blame me if your system is unstable
You can plug more than one IUU. Every unit will
have his own device file(/dev/ttyUSB0,/dev/ttyUSB1,...)
How to tune the reader speed?
=============================Reader 속도 조정
25-81module parameter는 이미 로드된 모듈을 내린 뒤 `modprobe iuu_phoenix param=value`로 지정합니다. prebuilt module은 `insmod iuu_phoenix param=value`를 사용할 수 있습니다.
`clockmode`는 1=3.579MHz, 2=3.680MHz, 3=6MHz의 세 기본 clock을 선택합니다.
`boost`는 100~500% overclock 비율입니다. 원문의 `modprobe boost=195` 예제는 3.579MHz base를 195%로 올려 6,979,050Hz, 즉 약 6.979MHz를 만들며 단순 `clockmode=3`보다 10~20% 높은 성능을 목표로 합니다.
`cdmode`는 card 존재를 사용자 공간 ioctl 응답에 알릴 signal을 고릅니다. 0=none, 1=CD, 2=!CD, 3=DSR, 4=!DSR, 5=CTS, 6=!CTS, 7=RING, 8=!RING입니다.
`xmas`는 기능에는 필요 없고 activity가 바뀔 때 색과 빈도를 무작위로 바꾸는 장식 옵션입니다.
`debug`를 켜면 많은 debugging message가 출력됩니다.
항목설명
clockmode1=3.579MHz, 2=3.680MHz, 3=6MHz
boostoverclock 100..500%
cdmode0 none, 1 CD, 2 !CD, 3 DSR, 4 !DSR, 5 CTS, 6 !CTS, 7 RING, 8 !RING
xmasactivity별 random color/frequency
debugdebug message enable
reader clock, card detection, 표시와 진단을 설정합니다.
Base 3.579MHz→boost=195%→6,979,050Hz (6.979MHz)→clockmode=3 대비 약 10~20% 성능 향상 목표
base clock과 boost 비율로 실제 reader clock을 만듭니다.
A few parameters can be used at load time
To use parameters, just unload the module if it is
already loaded and use modprobe iuu_phoenix param=value.
In case of prebuilt module, use the command
insmod iuu_phoenix param=value.
Example::
modprobe iuu_phoenix clockmode=3
The parameters are:
clockmode:
1=3Mhz579,2=3Mhz680,3=6Mhz (int)
boost:
overclock boost percent 100 to 500 (int)
cdmode:
Card detect mode
0=none, 1=CD, 2=!CD, 3=DSR, 4=!DSR, 5=CTS, 6=!CTS, 7=RING, 8=!RING (int)
xmas:
xmas color enabled or not (bool)
debug:
Debug enabled or not (bool)
- clockmode will provide 3 different base settings commonly adopted by
different software:
1. 3Mhz579
2. 3Mhz680
3. 6Mhz
- boost provide a way to overclock the reader ( my favorite :-) )
For example to have best performance than a simple clockmode=3, try this::
modprobe boost=195
This will put the reader in a base of 3Mhz579 but boosted a 195 % !
the real clock will be now : 6979050 Hz ( 6Mhz979 ) and will increase
the speed to a score 10 to 20% better than the simple clockmode=3 !!!
- cdmode permit to setup the signal used to inform the userland ( ioctl answer )
if the card is present or not. Eight signals are possible.
- xmas is completely useless except for your eyes. This is one of my friend who was
so sad to have a nice device like the iuu without seeing all color range available.
So I have added this option to permit him to see a lot of color ( each activity change the color
and the frequency randomly )
- debug will produce a lot of debugging messages...
Last notes
==========
Don't worry about the serial settings, the serial emulation마지막 참고 사항
82-94serial emulation은 추상화이므로 serial speed나 parity를 어떤 값으로 설정해도 실제 동작은 바뀌지 않습니다.
원저자는 나중에 serial 설정에서 boost를 추론하는 기능을 고려했지만 필요성은 확정하지 않았습니다.
자동 감지는 serial CD signal을 사용합니다. 응용 프로그램과 맞지 않으면 그 프로그램의 detection mechanism을 비활성화해야 합니다.
항목설명
speed/parity현재 abstraction에서는 영향 없음
autodetectserial CD 사용
호환 문제응용 프로그램의 detection mechanism 비활성화
emulated serial 설정과 card detection의 의미입니다.
is an abstraction, so use any speed or parity setting will
work. ( This will not change anything ).Later I will perhaps
use this settings to deduce de boost but is that feature
really necessary ?
The autodetect feature used is the serial CD. If that doesn't
work for your software, disable detection mechanism in it.
Have fun !
Alain Degreffe
eczema(at)ecze.com
요약·해설
iuu_phoenix.rst:1-94IUU Phoenix reader의 TTY 노출, clock·boost·card detect module parameter와 주의 사항을 설명합니다.
원문 명령, symbol, source path, 수치와 ABI 이름을 그대로 유지하면서 각 절의 의미와 주의 사항을 한국어로 옮겼습니다.