lkml.org 
[lkml]   [2022]   [Feb]   [18]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
Patch in this message
/
From
Subject[PATCH] dt-bindings: nvidia,tegra20-kbc: Convert to json-schema
Date
From: Max Buchholz <Max.Buchholz@gmx.de>

This converts the Nvidia Tegra keyboard controller bindings to YAML
and fix them up a bit.

Acked-by: David Heidelberg <david@ixit.cz>
Signed-off-by: Max Buchholz <max.buchholz@gmx.de>
---
.../bindings/input/nvidia,tegra20-kbc.txt | 55 ---------
.../bindings/input/nvidia,tegra20-kbc.yaml | 114 ++++++++++++++++++
2 files changed, 114 insertions(+), 55 deletions(-)
delete mode 100644 Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt
create mode 100644 Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml

diff --git a/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt b/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt
deleted file mode 100644
index 1faa7292e21f..000000000000
--- a/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt
+++ /dev/null
@@ -1,55 +0,0 @@
-* Tegra keyboard controller
-The key controller has maximum 24 pins to make matrix keypad. Any pin
-can be configured as row or column. The maximum column pin can be 8
-and maximum row pins can be 16 for Tegra20/Tegra30.
-
-Required properties:
-- compatible: "nvidia,tegra20-kbc"
-- reg: Register base address of KBC.
-- interrupts: Interrupt number for the KBC.
-- nvidia,kbc-row-pins: The KBC pins which are configured as row. This is an
- array of pin numbers which is used as rows.
-- nvidia,kbc-col-pins: The KBC pins which are configured as column. This is an
- array of pin numbers which is used as column.
-- linux,keymap: The keymap for keys as described in the binding document
- devicetree/bindings/input/matrix-keymap.txt.
-- clocks: Must contain one entry, for the module clock.
- See ../clocks/clock-bindings.txt for details.
-- resets: Must contain an entry for each entry in reset-names.
- See ../reset/reset.txt for details.
-- reset-names: Must include the following entries:
- - kbc
-
-Optional properties, in addition to those specified by the shared
-matrix-keyboard bindings:
-
-- linux,fn-keymap: a second keymap, same specification as the
- matrix-keyboard-controller spec but to be used when the KEY_FN modifier
- key is pressed.
-- nvidia,debounce-delay-ms: delay in milliseconds per row scan for debouncing
-- nvidia,repeat-delay-ms: delay in milliseconds before repeat starts
-- nvidia,ghost-filter: enable ghost filtering for this device
-- wakeup-source: configure keyboard as a wakeup source for suspend/resume
- (Legacy property supported: "nvidia,wakeup-source")
-
-Example:
-
-keyboard: keyboard {
- compatible = "nvidia,tegra20-kbc";
- reg = <0x7000e200 0x100>;
- interrupts = <0 85 0x04>;
- clocks = <&tegra_car 36>;
- resets = <&tegra_car 36>;
- reset-names = "kbc";
- nvidia,ghost-filter;
- nvidia,debounce-delay-ms = <640>;
- nvidia,kbc-row-pins = <0 1 2>; /* pin 0, 1, 2 as rows */
- nvidia,kbc-col-pins = <11 12 13>; /* pin 11, 12, 13 as columns */
- linux,keymap = <0x00000074
- 0x00010067
- 0x00020066
- 0x01010068
- 0x02000069
- 0x02010070
- 0x02020071>;
-};
diff --git a/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml b/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml
new file mode 100644
index 000000000000..076b347a6f07
--- /dev/null
+++ b/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml
@@ -0,0 +1,114 @@
+# SPDX-License-Identifier: GPL-2.0-only
+%YAML 1.2
+---
+$id: "http://devicetree.org/schemas/input/nvidia,tegra20-kbc.yaml#"
+$schema: "http://devicetree.org/meta-schemas/core.yaml#"
+
+title: Nvidia Tegra keyboard controller
+
+maintainers:
+ - Max Buchholz <max.buchholz@gmx.de>
+
+description: >
+ The key controller has maximum 24 pins to make matrix keypad. Any pin
+ can be configured as row or column. The maximum column pin can be 8
+ and maximum row pins can be 16 for Tegra20/Tegra30.
+
+properties:
+ compatible:
+ const: nvidia,tegra20-kbc
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ description: Interrupt number for the KBC.
+
+ nvidia,kbc-row-pins:
+ description: >
+ The KBC pins which are configured as row. This is an
+ array of pin numbers which is used as rows.
+ $ref: /schemas/types.yaml#/definitions/uint32-array
+
+ nvidia,kbc-col-pins:
+ description: >
+ The KBC pins which are configured as column. This is an
+ array of pin numbers which is used as column.
+ $ref: /schemas/types.yaml#/definitions/uint32-array
+
+ linux,keymap:
+ description: >
+ The keymap for keys as described in the binding document
+ devicetree/bindings/input/matrix-keymap.txt.
+
+ clocks:
+ maxItems: 1
+ description: >
+ Must contain one entry, for the module clock.
+ See ../clocks/clock-bindings.txt for details.
+
+ resets:
+ description: >
+ Must contain an entry for each entry in reset-names.
+ See ../reset/reset.txt for details.
+
+ reset-names:
+ const: kbc
+
+ linux,fn-keymap:
+ description: >
+ a second keymap, same specification as the
+ matrix-keyboard-controller spec but to be used when the KEY_FN modifier
+ key is pressed.
+
+ nvidia,debounce-delay-ms:
+ description: delay in milliseconds per row scan for debouncing
+
+ nvidia,repeat-delay-ms:
+ description: delay in milliseconds before repeat starts
+
+ nvidia,ghost-filter:
+ description: enable ghost filtering for this device
+ type: boolean
+
+ wakeup-source:
+ description: configure keyboard as a wakeup source for suspend/resume
+
+ nvidia,wakeup-source:
+ description: configure keyboard as a wakeup source for suspend/resume
+ deprecated: true
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - nvidia,kbc-row-pins
+ - nvidia,kbc-col-pins
+ - linux,keymap
+ - clocks
+ - resets
+ - reset-names
+
+additionalProperties: false
+
+examples:
+ - |
+ keyboard: {
+ compatible = "nvidia,tegra20-kbc";
+ reg = <0x7000e200 0x100>;
+ interrupts = <0 85 0x04>;
+ clocks = <&tegra_car 36>;
+ resets = <&tegra_car 36>;
+ reset-names = "kbc";
+ nvidia,ghost-filter;
+ nvidia,debounce-delay-ms = <640>;
+ nvidia,kbc-row-pins = <0 1 2>; /* pin 0, 1, 2 as rows */
+ nvidia,kbc-col-pins = <11 12 13>; /* pin 11, 12, 13 as columns */
+ linux,keymap = <0x00000074
+ 0x00010067
+ 0x00020066
+ 0x01010068
+ 0x02000069
+ 0x02010070
+ 0x02020071>;
+ };
--
2.35.1
\
 
 \ /
  Last update: 2022-02-18 11:12    [W:0.046 / U:1.208 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site