1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/input/matri 4 $id: http://devicetree.org/schemas/input/matrix-keymap.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Common Key Matrices on Matrix-connected 7 title: Common Key Matrices on Matrix-connected Key Boards
8 8
9 maintainers: 9 maintainers:
10 - Olof Johansson <olof@lixom.net> 10 - Olof Johansson <olof@lixom.net>
11 11
12 description: | 12 description: |
13 A simple common binding for matrix-connected 13 A simple common binding for matrix-connected key boards. Currently targeted at
14 defining the keys in the scope of linux key 14 defining the keys in the scope of linux key codes since that is a stable and
15 standardized interface at this time. 15 standardized interface at this time.
16 16
17 Some users of this binding might choose to s 17 Some users of this binding might choose to specify secondary keymaps for
18 cases where there is a modifier key such as 18 cases where there is a modifier key such as a Fn key. Proposed names
19 for said properties are "linux,fn-keymap" or 19 for said properties are "linux,fn-keymap" or with another descriptive
20 word for the modifier other from "Fn". 20 word for the modifier other from "Fn".
21 21
22 properties: 22 properties:
23 linux,keymap: 23 linux,keymap:
24 $ref: /schemas/types.yaml#/definitions/uin !! 24 $ref: '/schemas/types.yaml#/definitions/uint32-array'
25 description: | 25 description: |
26 An array of packed 1-cell entries contai 26 An array of packed 1-cell entries containing the equivalent of row,
27 column and linux key-code. The 32-bit bi 27 column and linux key-code. The 32-bit big endian cell is packed as:
28 row << 24 | column << 16 | key-code 28 row << 24 | column << 16 | key-code
29 29
30 keypad,num-rows: 30 keypad,num-rows:
31 $ref: /schemas/types.yaml#/definitions/uin 31 $ref: /schemas/types.yaml#/definitions/uint32
32 description: Number of row lines connected 32 description: Number of row lines connected to the keypad controller.
33 33
34 keypad,num-columns: 34 keypad,num-columns:
35 $ref: /schemas/types.yaml#/definitions/uin 35 $ref: /schemas/types.yaml#/definitions/uint32
36 description: Number of column lines connec 36 description: Number of column lines connected to the keypad controller.
37 37
38 additionalProperties: true 38 additionalProperties: true
39 39
40 examples: 40 examples:
41 - | 41 - |
42 keypad { 42 keypad {
43 /* ... */ 43 /* ... */
44 linux,keymap = < 0x00030012 44 linux,keymap = < 0x00030012
45 0x0102003a >; 45 0x0102003a >;
46 keypad,num-rows = <2>; 46 keypad,num-rows = <2>;
47 keypad,num-columns = <8>; 47 keypad,num-columns = <8>;
48 }; 48 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.