요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
VBUS error clear
sysfs-platform-chipidea-usb-otg:48-56A-device VBUS error를 clear한 뒤 bus power를 내리는 write-only trigger입니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/platform/devices/ci_hdrc.0/inputs/a_bus_req
2
Date: Feb 2014
3
Contact: Li Jun <[email protected]>
4
Description:
5
Can be set and read.
6
Set a_bus_req(A-device bus request) input to be 1 if
7
the application running on the A-device wants to use the bus,
8
and to be 0 when the application no longer wants to use
9
the bus(or wants to work as peripheral). a_bus_req can also
10
be set to 1 by kernel in response to remote wakeup signaling
11
from the B-device, the A-device should decide to resume the bus.
13
Valid values are "1" and "0".
15
Reading: returns 1 if the application running on the A-device
16
is using the bus as host role, otherwise 0.
18
What: /sys/bus/platform/devices/ci_hdrc.0/inputs/a_bus_drop
19
Date: Feb 2014
20
Contact: Li Jun <[email protected]>
21
Description:
22
Can be set and read
23
The a_bus_drop(A-device bus drop) input is 1 when the
24
application running on the A-device wants to power down
25
the bus, and is 0 otherwise, When a_bus_drop is 1, then
26
the a_bus_req shall be 0.
28
Valid values are "1" and "0".
30
Reading: returns 1 if the bus is off(vbus is turned off) by
31
A-device, otherwise 0.
33
What: /sys/bus/platform/devices/ci_hdrc.0/inputs/b_bus_req
34
Date: Feb 2014
35
Contact: Li Jun <[email protected]>
36
Description:
37
Can be set and read.
38
The b_bus_req(B-device bus request) input is 1 during the time
39
that the application running on the B-device wants to use the
40
bus as host, and is 0 when the application no longer wants to
41
work as host and decides to switch back to be peripheral.
43
Valid values are "1" and "0".
45
Reading: returns if the application running on the B device
46
is using the bus as host role, otherwise 0.
48
What: /sys/bus/platform/devices/ci_hdrc.0/inputs/a_clr_err
49
Date: Feb 2014
50
Contact: Li Jun <[email protected]>
51
Description:
52
Only can be set.
53
The a_clr_err(A-device Vbus error clear) input is used to clear
54
vbus error, then A-device will power down the bus.
56
Valid value is "1"
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ChipIdea USB OTG input sysfs ABI: a bus req
1-17| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/ci_hdrc.0/inputs/a_bus_req |
| Date | 2014년 2월 |
| Contact | Li Jun <[email protected]> |
| Description | `/sys/bus/platform/devices/ci_hdrc.0/inputs/a_bus_req`는 read/write할 수 있습니다. A-device에서 실행 중인 application이 bus를 사용하려면 A-device bus request인 `a_bus_req`를 `1`로 설정하고, 더 이상 bus를 사용하지 않거나 peripheral로 동작하려면 `0`으로 설정합니다. B-device의 remote wakeup signaling에 응답해 kernel도 `a_bus_req`를 `1`로 설정할 수 있으며, 이때 A-device는 bus를 resume할지 결정해야 합니다. Valid values는 `1`과 `0`입니다. Read하면 A-device application이 host role로 bus를 사용 중일 때 `1`, 그 외에는 `0`을 반환합니다. |
InputAccessValue 1Value 0
a_bus_reqRead/writeA-device requests host busRelease bus or peripheral
a_bus_dropRead/writeA-device powers bus downDo not drop bus
b_bus_reqRead/writeB-device requests host busReturn to peripheral
a_clr_errWrite-onlyClear VBUS errorInvalid
A/B-device request와 A-device drop·error-clear inputs의 access와 values를 비교합니다.
a_bus_drop = 1→Require a_bus_req = 0→Turn VBUS off
B-device remote wakeup→Kernel may set a_bus_req = 1→A-device decides whether to resume
`a_bus_drop = 1`이면 A-device가 bus를 요구할 수 없으므로 `a_bus_req`가 0이어야 합니다.
ChipIdea USB OTG input sysfs ABI: a bus drop
18-32| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/ci_hdrc.0/inputs/a_bus_drop |
| Date | 2014년 2월 |
| Contact | Li Jun <[email protected]> |
| Description | `/sys/bus/platform/devices/ci_hdrc.0/inputs/a_bus_drop`은 read/write할 수 있습니다. A-device application이 bus power를 끄려 할 때 A-device bus drop인 `a_bus_drop`은 `1`, 그 외에는 `0`입니다. `a_bus_drop`이 `1`이면 `a_bus_req`는 반드시 `0`이어야 합니다. Valid values는 `1`과 `0`입니다. Read하면 A-device가 bus를 off해 VBUS가 꺼진 경우 `1`, 그 외에는 `0`을 반환합니다. |
ChipIdea USB OTG input sysfs ABI: b bus req
33-47| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/ci_hdrc.0/inputs/b_bus_req |
| Date | 2014년 2월 |
| Contact | Li Jun <[email protected]> |
| Description | `/sys/bus/platform/devices/ci_hdrc.0/inputs/b_bus_req`는 read/write할 수 있습니다. B-device application이 host로 bus를 사용하려는 동안 B-device bus request인 `b_bus_req`는 `1`이며, 더 이상 host로 동작하지 않고 peripheral로 돌아가려 하면 `0`입니다. Valid values는 `1`과 `0`입니다. Read하면 B-device application이 host role로 bus를 사용 중일 때 `1`, 그 외에는 `0`을 반환합니다. |
ChipIdea USB OTG input sysfs ABI: a clr err
48-56| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/ci_hdrc.0/inputs/a_clr_err |
| Date | 2014년 2월 |
| Contact | Li Jun <[email protected]> |
| Description | `/sys/bus/platform/devices/ci_hdrc.0/inputs/a_clr_err`는 write-only입니다. A-device VBUS error clear input인 `a_clr_err`는 VBUS error를 clear하는 데 사용하며, 그 뒤 A-device는 bus power를 끕니다. Valid value는 `1`뿐입니다. |
A/B-device host requests
sysfs-platform-chipidea-usb-otg:1-47양쪽 device가 host role을 요청하거나 peripheral role로 돌아가는 의도를 0/1 inputs로 전달하며 A-device에는 bus-drop 상호 제약이 있습니다.