Documentation/devicetree/bindings/input/st-keyscan.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

ST Keyscan Controller

ST 4x4 keyscan의 clock, pinctrl와 debounce 바인딩입니다.

Source pathDocumentation/devicetree/bindings/input/st-keyscan.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

st-keyscan.txt:1-60

F1~F16 function-key matrix를 설명합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 * ST Keyscan controller Device Tree bindings
2
3 The ST keyscan controller Device Tree binding is based on the
4 matrix-keymap.
5
6 Required properties:
7 - compatible: "st,sti-keyscan"
8
9 - reg: Register base address and size of st-keyscan controller.
10
11 - interrupts: Interrupt number for the st-keyscan controller.
12
13 - clocks: Must contain one entry, for the module clock.
14 See ../clocks/clock-bindings.txt for details.
15
16 - pinctrl: Should specify pin control groups used for this controller.
17 See ../pinctrl/pinctrl-bindings.txt for details.
18
19 - linux,keymap: The keymap for keys as described in the binding document
20 devicetree/bindings/input/matrix-keymap.txt.
21
22 - keypad,num-rows: Number of row lines connected to the keypad controller.
23
24 - keypad,num-columns: Number of column lines connected to the keypad
25 controller.
26
27 Optional property:
28 - st,debounce_us: Debouncing interval time in microseconds
29
30 Example:
31
32 keyscan: keyscan@fe4b0000 {
33 compatible = "st,sti-keyscan";
34 reg = <0xfe4b0000 0x2000>;
35 interrupts = <GIC_SPI 212 IRQ_TYPE_NONE>;
36 clocks = <&CLK_SYSIN>;
37 pinctrl-names = "default";
38 pinctrl-0 = <&pinctrl_keyscan>;
39
40 keypad,num-rows = <4>;
41 keypad,num-columns = <4>;
42 st,debounce_us = <5000>;
43
44 linux,keymap = < MATRIX_KEY(0x00, 0x00, KEY_F13)
45 MATRIX_KEY(0x00, 0x01, KEY_F9)
46 MATRIX_KEY(0x00, 0x02, KEY_F5)
47 MATRIX_KEY(0x00, 0x03, KEY_F1)
48 MATRIX_KEY(0x01, 0x00, KEY_F14)
49 MATRIX_KEY(0x01, 0x01, KEY_F10)
50 MATRIX_KEY(0x01, 0x02, KEY_F6)
51 MATRIX_KEY(0x01, 0x03, KEY_F2)
52 MATRIX_KEY(0x02, 0x00, KEY_F15)
53 MATRIX_KEY(0x02, 0x01, KEY_F11)
54 MATRIX_KEY(0x02, 0x02, KEY_F7)
55 MATRIX_KEY(0x02, 0x03, KEY_F3)
56 MATRIX_KEY(0x03, 0x00, KEY_F16)
57 MATRIX_KEY(0x03, 0x01, KEY_F12)
58 MATRIX_KEY(0x03, 0x02, KEY_F8)
59 MATRIX_KEY(0x03, 0x03, KEY_F4) >;
60 };
61

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

ST keyscan 필수 자원

1-29

ST keyscan binding은 `matrix-keymap`을 기반으로 합니다. 필수 `compatible`은 `st,sti-keyscan`, `reg`는 controller register base와 size, `interrupts`는 controller interrupt입니다.

`clocks`는 module clock entry 하나를 포함하고 `../clocks/clock-bindings.txt`를 참조합니다. `pinctrl`은 controller가 쓰는 pin-control group을 지정하고 `../pinctrl/pinctrl-bindings.txt`를 따릅니다. `linux,keymap`은 `devicetree/bindings/input/matrix-keymap.txt` 형식입니다.

`keypad,num-rows`와 `keypad,num-columns`는 연결된 row/column line 수입니다. 선택 `st,debounce_us`는 microsecond 단위 debounce interval입니다.

ST keyscan datapath
pinctrl4 row + 4 column lines
CLK_SYSINKeyscan timing
Matrix keymap16 function keys
GIC interrupt 212Input events

Pin group과 module clock으로 matrix를 scan하고 interrupt로 key event를 보고합니다.

4x4 function-key 예제

30-60

예제는 register `0xfe4b0000`의 0x2000-byte 영역, GIC SPI 212, system input clock과 `pinctrl_keyscan`을 사용합니다. 4x4 matrix, 5000 us debounce를 설정하고 F1부터 F16까지 16개 function key를 row/column 조합에 mapping합니다.

keyscan: keyscan@fe4b0000 {
        compatible = "st,sti-keyscan";
        reg = <0xfe4b0000 0x2000>;
        interrupts = <GIC_SPI 212 IRQ_TYPE_NONE>;
        clocks        = <&CLK_SYSIN>;
        pinctrl-names = "default";
        pinctrl-0 = <&pinctrl_keyscan>;

        keypad,num-rows = <4>;
        keypad,num-columns = <4>;
        st,debounce_us = <5000>;

        linux,keymap = < MATRIX_KEY(0x00, 0x00, KEY_F13)
                         MATRIX_KEY(0x00, 0x01, KEY_F9)
                         MATRIX_KEY(0x00, 0x02, KEY_F5)
                         MATRIX_KEY(0x00, 0x03, KEY_F1)
                         MATRIX_KEY(0x01, 0x00, KEY_F14)
                         MATRIX_KEY(0x01, 0x01, KEY_F10)
                         MATRIX_KEY(0x01, 0x02, KEY_F6)
                         MATRIX_KEY(0x01, 0x03, KEY_F2)
                         MATRIX_KEY(0x02, 0x00, KEY_F15)
                         MATRIX_KEY(0x02, 0x01, KEY_F11)
                         MATRIX_KEY(0x02, 0x02, KEY_F7)
                         MATRIX_KEY(0x02, 0x03, KEY_F3)
                         MATRIX_KEY(0x03, 0x00, KEY_F16)
                         MATRIX_KEY(0x03, 0x01, KEY_F12)
                         MATRIX_KEY(0x03, 0x02, KEY_F8)
                         MATRIX_KEY(0x03, 0x03, KEY_F4) >;
        };