Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: input: qcom,pm8921-keypad: convert to YAML format

Convert the bindings for the keypad subdevices of Qualcomm PM8921 and
PM8058 PMICs from text to YAML format.

While doing the conversion also drop the linux,keypad-no-autorepeat
The property was never used by DT files. Both input and DT binding
maintainers consider that bindings should switch to assertive
(linux,autorepeat) instead of negating (no-autorepeat) property.

Cc: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Signed-off-by: Dmitry Baryshkov <dmitry.baryshkov@linaro.org>
Link: https://lore.kernel.org/r/20230928110309.1212221-2-dmitry.baryshkov@linaro.org
Signed-off-by: Rob Herring <robh@kernel.org>

authored by

Dmitry Baryshkov and committed by
Rob Herring
53ed3233 88862247

+89 -90
+89
Documentation/devicetree/bindings/input/qcom,pm8921-keypad.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/input/qcom,pm8921-keypad.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Qualcomm PM8921 PMIC KeyPad 8 + 9 + maintainers: 10 + - Dmitry Baryshkov <dmitry.baryshkov@linaro.org> 11 + 12 + allOf: 13 + - $ref: input.yaml# 14 + - $ref: matrix-keymap.yaml# 15 + 16 + properties: 17 + compatible: 18 + enum: 19 + - qcom,pm8058-keypad 20 + - qcom,pm8921-keypad 21 + 22 + reg: 23 + maxItems: 1 24 + 25 + interrupts: 26 + items: 27 + - description: key sense 28 + - description: key stuck 29 + 30 + wakeup-source: 31 + type: boolean 32 + description: use any event on keypad as wakeup event 33 + 34 + linux,keypad-wakeup: 35 + type: boolean 36 + deprecated: true 37 + description: legacy version of the wakeup-source property 38 + 39 + debounce: 40 + description: 41 + Time in microseconds that key must be pressed or 42 + released for state change interrupt to trigger. 43 + $ref: /schemas/types.yaml#/definitions/uint32 44 + 45 + scan-delay: 46 + $ref: /schemas/types.yaml#/definitions/uint32 47 + description: time in microseconds to pause between successive scans of the 48 + matrix array 49 + 50 + row-hold: 51 + $ref: /schemas/types.yaml#/definitions/uint32 52 + description: time in nanoseconds to pause between scans of each row in the 53 + matrix array. 54 + 55 + required: 56 + - compatible 57 + - reg 58 + - interrupts 59 + - linux,keymap 60 + 61 + unevaluatedProperties: false 62 + 63 + examples: 64 + - | 65 + #include <dt-bindings/input/input.h> 66 + #include <dt-bindings/interrupt-controller/irq.h> 67 + pmic { 68 + #address-cells = <1>; 69 + #size-cells = <0>; 70 + 71 + keypad@148 { 72 + compatible = "qcom,pm8921-keypad"; 73 + reg = <0x148>; 74 + interrupt-parent = <&pmicintc>; 75 + interrupts = <74 IRQ_TYPE_EDGE_RISING>, <75 IRQ_TYPE_EDGE_RISING>; 76 + linux,keymap = < 77 + MATRIX_KEY(0, 0, KEY_VOLUMEUP) 78 + MATRIX_KEY(0, 1, KEY_VOLUMEDOWN) 79 + MATRIX_KEY(0, 2, KEY_CAMERA_FOCUS) 80 + MATRIX_KEY(0, 3, KEY_CAMERA) 81 + >; 82 + keypad,num-rows = <1>; 83 + keypad,num-columns = <5>; 84 + debounce = <15>; 85 + scan-delay = <32>; 86 + row-hold = <91500>; 87 + }; 88 + }; 89 + ...
-90
Documentation/devicetree/bindings/input/qcom,pm8xxx-keypad.txt
··· 1 - Qualcomm PM8xxx PMIC Keypad 2 - 3 - PROPERTIES 4 - 5 - - compatible: 6 - Usage: required 7 - Value type: <string> 8 - Definition: must be one of: 9 - "qcom,pm8058-keypad" 10 - "qcom,pm8921-keypad" 11 - 12 - - reg: 13 - Usage: required 14 - Value type: <prop-encoded-array> 15 - Definition: address of keypad control register 16 - 17 - - interrupts: 18 - Usage: required 19 - Value type: <prop-encoded-array> 20 - Definition: the first interrupt specifies the key sense interrupt 21 - and the second interrupt specifies the key stuck interrupt. 22 - The format of the specifier is defined by the binding 23 - document describing the node's interrupt parent. 24 - 25 - - linux,keymap: 26 - Usage: required 27 - Value type: <prop-encoded-array> 28 - Definition: the linux keymap. More information can be found in 29 - input/matrix-keymap.txt. 30 - 31 - - linux,keypad-no-autorepeat: 32 - Usage: optional 33 - Value type: <bool> 34 - Definition: don't enable autorepeat feature. 35 - 36 - - wakeup-source: 37 - Usage: optional 38 - Value type: <bool> 39 - Definition: use any event on keypad as wakeup event. 40 - (Legacy property supported: "linux,keypad-wakeup") 41 - 42 - - keypad,num-rows: 43 - Usage: required 44 - Value type: <u32> 45 - Definition: number of rows in the keymap. More information can be found 46 - in input/matrix-keymap.txt. 47 - 48 - - keypad,num-columns: 49 - Usage: required 50 - Value type: <u32> 51 - Definition: number of columns in the keymap. More information can be 52 - found in input/matrix-keymap.txt. 53 - 54 - - debounce: 55 - Usage: optional 56 - Value type: <u32> 57 - Definition: time in microseconds that key must be pressed or release 58 - for key sense interrupt to trigger. 59 - 60 - - scan-delay: 61 - Usage: optional 62 - Value type: <u32> 63 - Definition: time in microseconds to pause between successive scans 64 - of the matrix array. 65 - 66 - - row-hold: 67 - Usage: optional 68 - Value type: <u32> 69 - Definition: time in nanoseconds to pause between scans of each row in 70 - the matrix array. 71 - 72 - EXAMPLE 73 - 74 - keypad@148 { 75 - compatible = "qcom,pm8921-keypad"; 76 - reg = <0x148>; 77 - interrupt-parent = <&pmicintc>; 78 - interrupts = <74 1>, <75 1>; 79 - linux,keymap = < 80 - MATRIX_KEY(0, 0, KEY_VOLUMEUP) 81 - MATRIX_KEY(0, 1, KEY_VOLUMEDOWN) 82 - MATRIX_KEY(0, 2, KEY_CAMERA_FOCUS) 83 - MATRIX_KEY(0, 3, KEY_CAMERA) 84 - >; 85 - keypad,num-rows = <1>; 86 - keypad,num-columns = <5>; 87 - debounce = <15>; 88 - scan-delay = <32>; 89 - row-hold = <91500>; 90 - };