← Documents Documentation/ABI/testing/sysfs-driver-wacom GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Wacom HID tablet sysfs ABI

Wacom Bluetooth reporting speed, legacy LED/OLED controls, button raw-image interleave와 wireless remote pairing 상태를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-driver-wacom
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

Reporting speed and legacy LED controls

sysfs-driver-wacom:1-67

Bluetooth speed를 0/1로 선택하고 device별 LEDs와 OLED luminance·selection을 제어하며 여러 LED entries는 class API로 대체되었습니다.

Button images and wireless remotes

sysfs-driver-wacom:68-105

USB와 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
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.
11
12 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/led
13 Date: August 2014
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.
22
23 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status0_luminance
24 Date: August 2014
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.
32
33 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status1_luminance
34 Date: August 2014
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.
41
42 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led0_select
43 Date: August 2014
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.
51
52 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led1_select
53 Date: August 2014
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.
60
61 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/buttons_luminance
62 Date: August 2014
64 Description:
65 Writing to this file sets the overall luminance level (0..15)
66 of all eight button OLED displays.
67
68 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/button<n>_rawimg
69 Date: August 2014
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::
83
84 76543210 into GECA6420.
85 HGFEDCBA HFDB7531
86
87 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_remote/unpair_remote
88 Date: July 2015
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.
95
96 What: /sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_remote/<serial_number>/remote_mode
97 Date: July 2015
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.
106

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Wacom Bluetooth reporting speed

1-11
항목한국어 전문 번역
What/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/speed
Date2010년 4월
KernelVersion2.6.35
Contact[email protected]
DescriptionWacom Bluetooth tablet의 reporting speed를 제어합니다. Read는 high-speed mode이면 1, 아니면 0을 반환하고 0 또는 1을 쓰면 reporting speed를 전환합니다.
AccessRead-write
Wacom Bluetooth speed values
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
Date2014년 8월
Contact[email protected]
DescriptionStatus 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가 있음을 뜻합니다.
AccessAttribute group

Obsolete Wacom idle LED luminance

23-32
항목한국어 전문 번역
What/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status0_luminance
Date2014년 8월
Contact[email protected]
Description현재 driver가 export하는 LED class API로 대체되었습니다. Stylus가 tablet surface에 닿지 않고 stylus button도 pressed되지 않았을 때 status LED luminance를 1~127로 설정합니다. 일반적으로 button press 상태보다 낮은 level입니다.
AccessWrite-only; obsolete

Obsolete Wacom active LED luminance

33-41
항목한국어 전문 번역
What/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status1_luminance
Date2014년 8월
Contact[email protected]
Description현재 driver가 export하는 LED class API로 대체되었습니다. Stylus가 tablet surface에 닿거나 stylus button이 pressed되었을 때 status LED luminance를 1~127로 설정합니다.
AccessWrite-only; obsolete

Obsolete Wacom right LED selection

42-51
항목한국어 전문 번역
What/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led0_select
Date2014년 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입니다.
AccessWrite-only; obsolete

Obsolete Wacom left LED selection

52-60
항목한국어 전문 번역
What/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/status_led1_select
Date2014년 8월
Contact[email protected]
Description현재 driver가 export하는 LED class API로 대체되었습니다. Cintiq 21UX2/24HD 왼쪽 네 status LEDs 중 active LED 하나를 0~3으로 선택하며 나머지 세 LEDs는 inactive입니다.
AccessWrite-only; obsolete

Wacom button OLED luminance

61-67
항목한국어 전문 번역
What/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/buttons_luminance
Date2014년 8월
Contact[email protected]
Description여덟 button OLED displays 전체의 luminance level을 0~15로 설정합니다.
AccessWrite-only

Wacom button raw image

68-86
항목한국어 전문 번역
What/sys/bus/hid/devices/<bus>:<vid>:<pid>.<n>/wacom_led/button<n>_rawimg
Date2014년 8월
Contact[email protected]
DescriptionWacom 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`입니다.
AccessWrite-only
Wacom raw-image formats
TransportBytesPixelsDepth
USB102464x324-bit gray
Bluetooth25664x321-bit color

USB와 Bluetooth payload layout입니다.

USB nibble interleave
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
Date2015년 7월
Contact[email protected]
DescriptionAsterisk `*` 뒤에 newline을 붙여 쓰면 device의 current pairings를 모두 삭제합니다. 다른 character sequences는 reserved입니다.
AccessWrite-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
Date2015년 7월
Contact[email protected]
Description현재 driver가 export하는 LED class API로 대체되었습니다. Device LED lights가 나타내는 remote mode status를 보고합니다. Paired device에서 아직 report를 받지 못했다면 `-1`을 반환하며 driver를 통해 mode를 설정할 수 없습니다.
AccessRead-only; obsolete