요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
1
What: /sys/kernel/debug/olpc-ec/cmd
2
Date: Dec 2011
3
KernelVersion: 3.4
4
Contact: [email protected]
5
Description:
7
A generic interface for executing OLPC Embedded Controller commands and
8
reading their responses.
10
To execute a command, write data with the format: CC:N A A A A
11
CC is the (hex) command, N is the count of expected reply bytes, and A A A A
12
are optional (hex) arguments.
14
To read the response (if any), read from the generic node after executing
15
a command. Hex reply bytes will be returned, *whether or not* they came from
16
the immediately previous command.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
OLPC EC command 실행과 응답
1-16| 항목 | 내용 |
|---|---|
| What | /sys/kernel/debug/olpc-ec/cmd |
| Date | 2011년 12월 |
| KernelVersion | 3.4 |
| Contact | [email protected] |
| Description | OLPC Embedded Controller command를 실행하고 그 응답을 읽기 위한 generic interface입니다. |
Command를 실행하려면 다음 형식으로 data를 씁니다.
CC:N A A A A| Field | 의미 |
|---|---|
| CC | Hexadecimal command |
| N | 예상하는 reply byte 수 |
| A A A A | 선택적인 hexadecimal arguments |
응답이 있다면 command를 실행한 뒤 generic node에서 읽습니다. Hexadecimal reply bytes가 반환되지만, 그 bytes가 즉시 직전에 실행한 command에서 왔는지 여부와는 무관합니다.
Write CC:N plus optional A bytes→Execute EC command CC→Expect N reply bytes→Read hexadecimal response
Returned reply bytes→May or may not belong to immediately previous command→Caller must not assume strict pairing
Write는 command와 예상 reply 길이를 전달하지만, 뒤따르는 read 결과를 직전 command의 응답이라고 단정할 수 없다.
EC command framing과 response read
debugfs-olpc:1-16cmd node는 hex command CC, 예상 reply byte 수 N, 선택적 hex arguments A를 받아 실행합니다. 이후 읽은 reply는 즉시 직전 command에서 온 응답이 아닐 수도 있습니다.