요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Button images and wireless remotes
sysfs-driver-wacom:68-105USB와 Bluetooth button images는 서로 다른 depth와 payload size를 사용하고 remote pairings는 명시적 write command로 제거합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/speed
2
Date: April 2010
3
KernelVersion: 2.6.35
4
Contact: [email protected]
5
Description:
6
The /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/speed file
7
controls reporting speed of Wacom bluetooth tablet. Reading
8
from this file returns 1 if tablet reports in high speed mode
9
or 0 otherwise. Writing to this file one of these values
10
switches reporting speed.
12
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/led
13
Date: August 2014
14
Contact: [email protected]
15
Description:
16
Attribute group for control of the status LEDs and the OLEDs.
17
This attribute group is only available for Intuos 4 M, L,
18
and XL (with LEDs and OLEDs), Intuos 4 WL, Intuos 5 (LEDs only),
19
Intuos Pro (LEDs only) and Cintiq 21UX2 and Cintiq 24HD
20
(LEDs only). Therefore its presence implicitly signifies the
21
presence of said LEDs and OLEDs on the tablet device.
23
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status0_luminance
24
Date: August 2014
25
Contact: [email protected]
26
Description:
27
<obsoleted by the LED class API now exported by the driver>
28
Writing to this file sets the status LED luminance (1..127)
29
when the stylus does not touch the tablet surface, and no
30
button is pressed on the stylus. This luminance level is
31
normally lower than the level when a button is pressed.
33
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status1_luminance
34
Date: August 2014
35
Contact: [email protected]
36
Description:
37
<obsoleted by the LED class API now exported by the driver>
38
Writing to this file sets the status LED luminance (1..127)
39
when the stylus touches the tablet surface, or any button is
40
pressed on the stylus.
42
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led0_select
43
Date: August 2014
44
Contact: [email protected]
45
Description:
46
<obsoleted by the LED class API now exported by the driver>
47
Writing to this file sets which one of the four (for Intuos 4
48
and Intuos 5) or of the right four (for Cintiq 21UX2 and Cintiq
49
24HD) status LEDs is active (0..3). The other three LEDs on the
50
same side are always inactive.
52
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led1_select
53
Date: August 2014
54
Contact: [email protected]
55
Description:
56
<obsoleted by the LED class API now exported by the driver>
57
Writing to this file sets which one of the left four (for Cintiq 21UX2
58
and Cintiq 24HD) status LEDs is active (0..3). The other three LEDs on
59
the left are always inactive.
61
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/buttons_luminance
62
Date: August 2014
63
Contact: [email protected]
64
Description:
65
Writing to this file sets the overall luminance level (0..15)
66
of all eight button OLED displays.
68
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/button<n>_rawimg
69
Date: August 2014
70
Contact: [email protected]
71
Description:
72
When writing a 1024 byte raw image in Wacom Intuos 4
73
interleaving format to the file, the image shows up on Button N
74
of the device. The image is a 64x32 pixel 4-bit gray image. The
75
1024 byte binary is split up into 16x 64 byte chunks. Each 64
76
byte chunk encodes the image data for two consecutive lines on
77
the display. The low nibble of each byte contains the first
78
line, and the high nibble contains the second line.
79
When the Wacom Intuos 4 is connected over Bluetooth, the
80
image has to contain 256 bytes (64x32 px 1 bit colour).
81
The format is also scrambled, like in the USB mode, and it can
82
be summarized by converting::
84
76543210 into GECA6420.
85
HGFEDCBA HFDB7531
87
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_remote/unpair_remote
88
Date: July 2015
89
Contact: [email protected]
90
Description:
91
Writing the character sequence '*' followed by a newline to
92
this file will delete all of the current pairings on the
93
device. Other character sequences are reserved. This file is
94
write only.
96
What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_remote/<serial_number>/remote_mode
97
Date: July 2015
98
Contact: [email protected]
99
Description:
100
<obsoleted by the LED class API now exported by the driver>
101
Reading from this file reports the mode status of the
102
remote as indicated by the LED lights on the device. If no
103
reports have been received from the paired device, reading
104
from this file will report '-1'. The mode is read-only
105
and cannot be set through the driver.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Wacom Bluetooth reporting speed
1-11| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/speed |
| Date | 2010년 4월 |
| KernelVersion | 2.6.35 |
| Contact | [email protected] |
| Description | Wacom Bluetooth tablet의 reporting speed를 제어합니다. Read는 high-speed mode이면 1, 아니면 0을 반환하고 0 또는 1을 쓰면 reporting speed를 전환합니다. |
| Access | Read-write |
ValueMode
0Normal speed
1High speed
Reporting mode의 boolean encoding입니다.
Wacom LED and OLED control group
12-22| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/led |
| Date | 2014년 8월 |
| Contact | [email protected] |
| Description | Status LEDs와 OLEDs를 제어하는 attribute group입니다. Intuos 4 M/L/XL은 LEDs와 OLEDs, Intuos 4 WL, Intuos 5, Intuos Pro, Cintiq 21UX2와 Cintiq 24HD는 LEDs를 지원합니다. 이 group의 존재 자체가 tablet device에 해당 LEDs 또는 OLEDs가 있음을 뜻합니다. |
| Access | Attribute group |
Obsolete Wacom idle LED luminance
23-32| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status0_luminance |
| Date | 2014년 8월 |
| Contact | [email protected] |
| Description | 현재 driver가 export하는 LED class API로 대체되었습니다. Stylus가 tablet surface에 닿지 않고 stylus button도 pressed되지 않았을 때 status LED luminance를 1~127로 설정합니다. 일반적으로 button press 상태보다 낮은 level입니다. |
| Access | Write-only; obsolete |
Obsolete Wacom active LED luminance
33-41| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status1_luminance |
| Date | 2014년 8월 |
| Contact | [email protected] |
| Description | 현재 driver가 export하는 LED class API로 대체되었습니다. Stylus가 tablet surface에 닿거나 stylus button이 pressed되었을 때 status LED luminance를 1~127로 설정합니다. |
| Access | Write-only; obsolete |
Obsolete Wacom right LED selection
42-51| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led0_select |
| Date | 2014년 8월 |
| Contact | [email protected] |
| Description | 현재 driver가 export하는 LED class API로 대체되었습니다. Intuos 4/5의 네 status LEDs 또는 Cintiq 21UX2/24HD 오른쪽 네 LEDs 중 active LED 하나를 0~3으로 선택합니다. 같은 side의 나머지 세 LEDs는 항상 inactive입니다. |
| Access | Write-only; obsolete |
Obsolete Wacom left LED selection
52-60| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led1_select |
| Date | 2014년 8월 |
| Contact | [email protected] |
| Description | 현재 driver가 export하는 LED class API로 대체되었습니다. Cintiq 21UX2/24HD 왼쪽 네 status LEDs 중 active LED 하나를 0~3으로 선택하며 나머지 세 LEDs는 inactive입니다. |
| Access | Write-only; obsolete |
Wacom button OLED luminance
61-67| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/buttons_luminance |
| Date | 2014년 8월 |
| Contact | [email protected] |
| Description | 여덟 button OLED displays 전체의 luminance level을 0~15로 설정합니다. |
| Access | Write-only |
Wacom button raw image
68-86| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/button<n>_rawimg |
| Date | 2014년 8월 |
| Contact | [email protected] |
| Description | Wacom Intuos 4 interleaving format의 1024-byte raw image를 쓰면 device의 Button N에 표시됩니다. USB image는 64x32 pixels, 4-bit gray이며 1024-byte binary를 16개의 64-byte chunks로 나눕니다. 각 chunk는 display의 consecutive lines 두 줄을 encoding하고 각 byte의 low nibble은 첫 줄, high nibble은 둘째 줄입니다. Bluetooth 연결에서는 64x32 pixels, 1-bit color인 256-byte image를 사용하며 USB mode와 마찬가지로 scrambled됩니다. Bit conversion은 `76543210`에서 `GECA6420`, `HGFEDCBA`에서 `HFDB7531`입니다. |
| Access | Write-only |
TransportBytesPixelsDepth
USB102464x324-bit gray
Bluetooth25664x321-bit color
USB와 Bluetooth payload layout입니다.
NibbleImage line
Low nibbleFirst line
High nibbleSecond line
각 64-byte chunk의 byte nibbles가 두 consecutive lines에 대응합니다.
76543210 -> GECA6420
HGFEDCBA -> HFDB7531
Unpair all Wacom remotes
87-95| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_remote/unpair_remote |
| Date | 2015년 7월 |
| Contact | [email protected] |
| Description | Asterisk `*` 뒤에 newline을 붙여 쓰면 device의 current pairings를 모두 삭제합니다. 다른 character sequences는 reserved입니다. |
| Access | Write-only |
printf '*\n' > unpair_remote
Obsolete Wacom remote mode
96-105| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_remote/<serial_number>/remote_mode |
| Date | 2015년 7월 |
| Contact | [email protected] |
| Description | 현재 driver가 export하는 LED class API로 대체되었습니다. Device LED lights가 나타내는 remote mode status를 보고합니다. Paired device에서 아직 report를 받지 못했다면 `-1`을 반환하며 driver를 통해 mode를 설정할 수 없습니다. |
| Access | Read-only; obsolete |
Reporting speed and legacy LED controls
sysfs-driver-wacom:1-67Bluetooth speed를 0/1로 선택하고 device별 LEDs와 OLED luminance·selection을 제어하며 여러 LED entries는 class API로 대체되었습니다.