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

Linux 6.18.37 · ABI / testing

PicoLCD operation and framebuffer sysfs ABI

PicoLCD의 firmware·bootloader operation mode 전환, reconnect delay와 defio framebuffer refresh rate controls를 설명합니다.

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

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

1. 요약·해설

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

Operation-mode switch and restart delay

sysfs-driver-hid-picolcd:1-27

Available mode list에서 active mode를 brackets로 표시하고 non-active mode를 write해 전환하며, device는 지정한 millisecond delay 뒤 reconnect합니다.

Framebuffer deferred-I/O refresh rate

sysfs-driver-hid-picolcd:28-43

Available Hz list에서 defio refresh rate를 선택하며 full-screen 처리 한계 때문에 작은 tile 일부만 자주 바뀌는 경우에 적합합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/operation_mode
2 Date: March 2010
3 Contact: Bruno Prémont <bonbons@linux-vserver.org>
4 Description: Make it possible to switch the PicoLCD device between LCD
5 (firmware) and bootloader (flasher) operation modes.
6
7 Reading: returns list of available modes, the active mode being
8 enclosed in brackets ('[' and ']')
9
10 Writing: causes operation mode switch. Permitted values are
11 the non-active mode names listed when read.
12
13 Note: when switching mode the current PicoLCD HID device gets
14 disconnected and reconnects after above delay (see attribute
15 operation_mode_delay for its value).
16
17
18 What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/operation_mode_delay
19 Date: April 2010
20 Contact: Bruno Prémont <bonbons@linux-vserver.org>
21 Description: Delay PicoLCD waits before restarting in new mode when
22 operation_mode has changed.
23
24 Reading/Writing: It is expressed in ms and permitted range is
25 0..30000ms.
26
27
28 What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/fb_update_rate
29 Date: March 2010
30 Contact: Bruno Prémont <bonbons@linux-vserver.org>
31 Description: Make it possible to adjust defio refresh rate.
32
33 Reading: returns list of available refresh rates (expressed in Hz),
34 the active refresh rate being enclosed in brackets ('[' and ']')
35
36 Writing: accepts new refresh rate expressed in integer Hz
37 within permitted rates.
38
39 Note: As device can barely do 2 complete refreshes a second
40 it only makes sense to adjust this value if only one or two
41 tiles get changed and it's not appropriate to expect the application
42 to flush its tiny changes explicitly at higher than default rate.
43
44

3. 한국어 전문 번역

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

LCD and bootloader operation mode

1-17
항목한국어 전문 번역
What/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/operation_mode
Date2010년 3월
ContactBruno Prémont <bonbons@linux-vserver.org>
DescriptionPicoLCD device를 LCD(firmware) mode와 bootloader(flasher) mode 사이에서 전환합니다. Read하면 available modes list를 반환하며 active mode를 "["와 "]"로 둘러쌉니다. Write에는 read list에 나온 non-active mode name만 허용됩니다. Mode를 전환하면 current PicoLCD HID device가 disconnect되고 operation_mode_delay의 delay 뒤 reconnect합니다.
PicoLCD operation-mode switch
Read available modes; active mode is bracketedWrite a listed non-active modeCurrent HID device disconnectsWait operation_mode_delayDevice reconnects in the new mode

Read list selection부터 disconnect와 delayed reconnect까지의 순서입니다.

Operation-mode restart delay

18-27
항목한국어 전문 번역
What/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/operation_mode_delay
Date2010년 4월
ContactBruno Prémont <bonbons@linux-vserver.org>
Descriptionoperation_mode이 변경된 뒤 PicoLCD가 new mode로 restart하기 전에 기다리는 delay를 read/write합니다. Milliseconds 단위이며 허용 범위는 0..30000ms입니다.
PicoLCD timing and refresh controls
AttributeUnitAllowed values
operation_mode_delayms0..30000
fb_update_rateinteger HzRates listed by read

Delay와 refresh-rate attribute의 단위와 write 범위를 구분합니다.

Deferred-I/O framebuffer refresh rate

28-43
항목한국어 전문 번역
What/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/fb_update_rate
Date2010년 3월
ContactBruno Prémont <bonbons@linux-vserver.org>
Descriptiondefio refresh rate를 조정합니다. Read하면 Hz 단위 available refresh rates list를 반환하고 active rate를 brackets로 둘러쌉니다. Write에는 permitted rates 중 하나를 integer Hz로 지정합니다. Device는 complete refresh를 초당 2회 정도밖에 처리하지 못하므로, 이 값을 조정하는 것은 한두 tile만 바뀌고 application이 작은 변경을 default보다 높은 rate로 명시적으로 flush할 것으로 기대하기 어려운 경우에만 의미가 있습니다.