TI OMAP4 Keypad | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

omap-keypad.txt:1-28

2x8 matrix와 no-autorepeat 예제를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 * TI's Keypad Controller device tree bindings

3 TI's Keypad controller is used to interface a SoC with a matrix-type

4 keypad device. The keypad controller supports multiple row and column lines.

5 A key can be placed at each intersection of a unique row and a unique column.

6 The keypad controller can sense a key-press and key-release and report the

7 event using a interrupt to the cpu.

9 This binding is based on the matrix-keymap binding with the following

10 changes:

12 keypad,num-rows and keypad,num-columns are required.

14 Required SoC Specific Properties:

15 - compatible: should be one of the following

16 - "ti,omap4-keypad": For controllers compatible with omap4 keypad

17 controller.

19 Optional Properties specific to linux:

20 - linux,keypad-no-autorepeat: do no enable autorepeat feature.

22 Example:

23 keypad@4ae1c000{

24 compatible = "ti,omap4-keypad";

25 keypad,num-rows = <2>;

26 keypad,num-columns = <8>;

27 linux,keypad-no-autorepeat;

28 };

3. 한국어 전문 번역

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

OMAP4 matrix keypad 속성

1-21

TI Keypad controller는 SoC와 matrix keypad를 연결하고 여러 row/column 교차점의 key press와 release를 감지해 CPU interrupt로 보고합니다. `matrix-keymap` binding을 기반으로 하지만 `keypad,num-rows`와 `keypad,num-columns`가 필수입니다.

필수 SoC-specific `compatible`은 OMAP4 keypad controller와 호환되는 `ti,omap4-keypad`입니다. Linux-specific 선택 `linux,keypad-no-autorepeat`는 auto-repeat 기능을 활성화하지 않게 합니다.

OMAP keypad scan

Matrix rowsKey intersections

Matrix columnsOMAP4 keypad controller

Press/releaseCPU interrupt

linux,keypad-no-autorepeatRepeat disabled

Row/column 교차점에서 key event를 감지해 CPU에 전달합니다.

2x8 OMAP4 keypad 예제

22-28

예제는 address `0x4ae1c000`의 OMAP4 keypad를 2 row x 8 column으로 구성하고 auto-repeat를 끕니다.

keypad@4ae1c000{
        compatible = "ti,omap4-keypad";
        keypad,num-rows = <2>;
        keypad,num-columns = <8>;
        linux,keypad-no-autorepeat;
};