* [PATCH v3] dt-bindings: nvidia,tegra20-kbc: Convert to json-schema
@ 2022-07-15 13:14 Max Buchholz
2022-07-20 21:54 ` Rob Herring
0 siblings, 1 reply; 3+ messages in thread
From: Max Buchholz @ 2022-07-15 13:14 UTC (permalink / raw)
To: Dmitry Torokhov, Rob Herring, Thierry Reding, Jonathan Hunter,
Sameer Pujar
Cc: Max Buchholz, David Heidelberg, Max Buchholz, linux-input,
devicetree, linux-tegra, linux-kernel
From: Max Buchholz <Max.Buchholz@gmx.de>
This converts the Nvidia Tegra keyboard controller bindings to YAML
and fix them up a bit.
Reviewed-by: David Heidelberg <david@ixit.cz>
Signed-off-by: Max Buchholz <max.buchholz@gmx.de>
---
v3:
- fixed maxItems for array properties
v2:
- rework the file according to the feedback
.../bindings/input/nvidia,tegra20-kbc.txt | 55 ---------
.../bindings/input/nvidia,tegra20-kbc.yaml | 111 ++++++++++++++++++
.../bindings/power/wakeup-source.txt | 2 +-
3 files changed, 112 insertions(+), 56 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..8e1eaad2fdc1
--- /dev/null
+++ b/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml
@@ -0,0 +1,111 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%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:
+ - Jon Hunter <jonathanh@nvidia.com>
+ - Sameer Pujar <spujar@nvidia.com>
+
+description: The key controller has maximum 24 pins to make matrix keypad. Any pin
+ can be configured as row or column.
+
+allOf:
+ - $ref: "/schemas/input/matrix-keymap.yaml#"
+
+properties:
+ compatible:
+ oneOf:
+ - items:
+ - const: nvidia,tegra30-kbc
+ - const: nvidia,tegra20-kbc
+ - items:
+ - const: nvidia,tegra20-kbc
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ nvidia,kbc-row-pins:
+ minItems: 1
+ maxItems: 16
+ description: KBC pins which are configured as row
+ $ref: /schemas/types.yaml#/definitions/uint32-array
+
+ nvidia,kbc-col-pins:
+ minItems: 1
+ maxItems: 8
+ description: KBC pins which are configured as column
+ $ref: /schemas/types.yaml#/definitions/uint32-array
+
+ clocks:
+ maxItems: 1
+
+ resets:
+ maxItems: 1
+
+ reset-names:
+ const: kbc
+
+ linux,fn-keymap:
+ description: a secondary keymap 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
+ type: boolean
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - nvidia,kbc-row-pins
+ - nvidia,kbc-col-pins
+ - linux,keymap
+ - clocks
+ - resets
+ - reset-names
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/arm-gic.h>
+
+ kbc@7000e200 {
+ compatible = "nvidia,tegra20-kbc";
+ reg = <0x7000e200 0x100>;
+ interrupts = <GIC_SPI 85 IRQ_TYPE_LEVEL_HIGH>;
+ 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/power/wakeup-source.txt b/Documentation/devicetree/bindings/power/wakeup-source.txt
index cfd74659fbed..728f88de371d 100644
--- a/Documentation/devicetree/bindings/power/wakeup-source.txt
+++ b/Documentation/devicetree/bindings/power/wakeup-source.txt
@@ -25,7 +25,7 @@ List of legacy properties and respective binding document
Documentation/devicetree/bindings/input/touchscreen/ads7846.txt
5. "linux,keypad-wakeup" Documentation/devicetree/bindings/input/qcom,pm8xxx-keypad.txt
6. "linux,input-wakeup" Documentation/devicetree/bindings/input/samsung-keypad.txt
-7. "nvidia,wakeup-source" Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt
+7. "nvidia,wakeup-source" Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml
Examples
--------
--
2.37.0
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH v3] dt-bindings: nvidia,tegra20-kbc: Convert to json-schema
2022-07-15 13:14 [PATCH v3] dt-bindings: nvidia,tegra20-kbc: Convert to json-schema Max Buchholz
@ 2022-07-20 21:54 ` Rob Herring
2022-08-27 13:05 ` Aw: " Max.Buchholz
0 siblings, 1 reply; 3+ messages in thread
From: Rob Herring @ 2022-07-20 21:54 UTC (permalink / raw)
To: Max Buchholz
Cc: Dmitry Torokhov, Thierry Reding, Jonathan Hunter, Sameer Pujar,
David Heidelberg, linux-input, devicetree, linux-tegra,
linux-kernel
On Fri, Jul 15, 2022 at 03:14:21PM +0200, Max Buchholz wrote:
> From: Max Buchholz <Max.Buchholz@gmx.de>
>
> This converts the Nvidia Tegra keyboard controller bindings to YAML
> and fix them up a bit.
>
> Reviewed-by: David Heidelberg <david@ixit.cz>
> Signed-off-by: Max Buchholz <max.buchholz@gmx.de>
> ---
> v3:
> - fixed maxItems for array properties
> v2:
> - rework the file according to the feedback
>
> .../bindings/input/nvidia,tegra20-kbc.txt | 55 ---------
> .../bindings/input/nvidia,tegra20-kbc.yaml | 111 ++++++++++++++++++
> .../bindings/power/wakeup-source.txt | 2 +-
> 3 files changed, 112 insertions(+), 56 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..8e1eaad2fdc1
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml
> @@ -0,0 +1,111 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%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:
> + - Jon Hunter <jonathanh@nvidia.com>
> + - Sameer Pujar <spujar@nvidia.com>
> +
> +description: The key controller has maximum 24 pins to make matrix keypad. Any pin
> + can be configured as row or column.
> +
> +allOf:
> + - $ref: "/schemas/input/matrix-keymap.yaml#"
> +
> +properties:
> + compatible:
> + oneOf:
> + - items:
> + - const: nvidia,tegra30-kbc
> + - const: nvidia,tegra20-kbc
> + - items:
> + - const: nvidia,tegra20-kbc
> +
> + reg:
> + maxItems: 1
> +
> + interrupts:
> + maxItems: 1
> +
> + nvidia,kbc-row-pins:
> + minItems: 1
> + maxItems: 16
> + description: KBC pins which are configured as row
> + $ref: /schemas/types.yaml#/definitions/uint32-array
items:
maximum: 24 (or 23?)
Also, put 'description' either first or last, not in the middle of
constraints.
> +
> + nvidia,kbc-col-pins:
> + minItems: 1
> + maxItems: 8
> + description: KBC pins which are configured as column
> + $ref: /schemas/types.yaml#/definitions/uint32-array
Same here.
> +
> + clocks:
> + maxItems: 1
> +
> + resets:
> + maxItems: 1
> +
> + reset-names:
> + const: kbc
> +
> + linux,fn-keymap:
While mentioned in matrix-keymap.yaml, it is not defined as a schema
anywhere. It needs a type. I guess here is fine as this doesn't seem
to be used much.
> + description: a secondary keymap 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
> + type: boolean
Deprecated for 7 years. Could be dropped?
> +
> +required:
> + - compatible
> + - reg
> + - interrupts
> + - nvidia,kbc-row-pins
> + - nvidia,kbc-col-pins
> + - linux,keymap
> + - clocks
> + - resets
> + - reset-names
> +
> +unevaluatedProperties: false
> +
> +examples:
> + - |
> + #include <dt-bindings/interrupt-controller/arm-gic.h>
> +
> + kbc@7000e200 {
keyboard@...
> + compatible = "nvidia,tegra20-kbc";
> + reg = <0x7000e200 0x100>;
> + interrupts = <GIC_SPI 85 IRQ_TYPE_LEVEL_HIGH>;
> + 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/power/wakeup-source.txt b/Documentation/devicetree/bindings/power/wakeup-source.txt
> index cfd74659fbed..728f88de371d 100644
> --- a/Documentation/devicetree/bindings/power/wakeup-source.txt
> +++ b/Documentation/devicetree/bindings/power/wakeup-source.txt
> @@ -25,7 +25,7 @@ List of legacy properties and respective binding document
> Documentation/devicetree/bindings/input/touchscreen/ads7846.txt
> 5. "linux,keypad-wakeup" Documentation/devicetree/bindings/input/qcom,pm8xxx-keypad.txt
> 6. "linux,input-wakeup" Documentation/devicetree/bindings/input/samsung-keypad.txt
> -7. "nvidia,wakeup-source" Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt
> +7. "nvidia,wakeup-source" Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml
>
> Examples
> --------
> --
> 2.37.0
>
>
^ permalink raw reply [flat|nested] 3+ messages in thread
* Aw: Re: [PATCH v3] dt-bindings: nvidia,tegra20-kbc: Convert to json-schema
2022-07-20 21:54 ` Rob Herring
@ 2022-08-27 13:05 ` Max.Buchholz
0 siblings, 0 replies; 3+ messages in thread
From: Max.Buchholz @ 2022-08-27 13:05 UTC (permalink / raw)
To: Rob Herring
Cc: Dmitry Torokhov, Thierry Reding, Jonathan Hunter, Sameer Pujar,
David Heidelberg, linux-input, devicetree, linux-tegra,
linux-kernel
Hi,
> items:
> maximum: 24 (or 23?)
I do not exactly get what you mean with this and how you get to 24, which isn't the maximum of the kbc-row-pins, but the maximum of kbc-row-pins and kbc-col-pins added. I would be glad to get some more clarification abou that.
Additionally thanks for yll the feedback so far, really appreciate it.
regards
Max Buchholz
> From: Max Buchholz <Max.Buchholz@gmx.de>
>
> This converts the Nvidia Tegra keyboard controller bindings to YAML
> and fix them up a bit.
>
> Reviewed-by: David Heidelberg <david@ixit.cz>
> Signed-off-by: Max Buchholz <max.buchholz@gmx.de>
> ---
> v3:
> - fixed maxItems for array properties
> v2:
> - rework the file according to the feedback
>
> .../bindings/input/nvidia,tegra20-kbc.txt | 55 ---------
> .../bindings/input/nvidia,tegra20-kbc.yaml | 111 ++++++++++++++++++
> .../bindings/power/wakeup-source.txt | 2 +-
> 3 files changed, 112 insertions(+), 56 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..8e1eaad2fdc1
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml
> @@ -0,0 +1,111 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: "http://devicetree.org/schemas/input/nvidia,tegra20-kbc.yaml#"
> +$schema: "http://devicetree.org/meta-schemas/core.yaml#[http://devicetree.org/meta-schemas/core.yaml#]"
> +
> +title: Nvidia Tegra keyboard controller
> +
> +maintainers:
> + - Jon Hunter <jonathanh@nvidia.com>
> + - Sameer Pujar <spujar@nvidia.com>
> +
> +description: The key controller has maximum 24 pins to make matrix keypad. Any pin
> + can be configured as row or column.
> +
> +allOf:
> + - $ref: "/schemas/input/matrix-keymap.yaml#"
> +
> +properties:
> + compatible:
> + oneOf:
> + - items:
> + - const: nvidia,tegra30-kbc
> + - const: nvidia,tegra20-kbc
> + - items:
> + - const: nvidia,tegra20-kbc
> +
> + reg:
> + maxItems: 1
> +
> + interrupts:
> + maxItems: 1
> +
> + nvidia,kbc-row-pins:
> + minItems: 1
> + maxItems: 16
> + description: KBC pins which are configured as row
> + $ref: /schemas/types.yaml#/definitions/uint32-array
items:
maximum: 24 (or 23?)
> +
> + nvidia,kbc-col-pins:
> + minItems: 1
> + maxItems: 8
> + description: KBC pins which are configured as column
> + $ref: /schemas/types.yaml#/definitions/uint32-array
Same here.
> +
> + clocks:
> + maxItems: 1
> +
> + resets:
> + maxItems: 1
> +
> + reset-names:
> + const: kbc
> +
> + linux,fn-keymap:
While mentioned in matrix-keymap.yaml, it is not defined as a schema
anywhere. It needs a type. I guess here is fine as this doesn't seem
to be used much.
> + description: a secondary keymap 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
> + type: boolean
Deprecated for 7 years. Could be dropped?
> +
> +required:
> + - compatible
> + - reg
> + - interrupts
> + - nvidia,kbc-row-pins
> + - nvidia,kbc-col-pins
> + - linux,keymap
> + - clocks
> + - resets
> + - reset-names
> +
> +unevaluatedProperties: false
> +
> +examples:
> + - |
> + #include <dt-bindings/interrupt-controller/arm-gic.h>
> +
> + kbc@7000e200 {
keyboard@...
> + compatible = "nvidia,tegra20-kbc";
> + reg = <0x7000e200 0x100>;
> + interrupts = <GIC_SPI 85 IRQ_TYPE_LEVEL_HIGH>;
> + 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/power/wakeup-source.txt b/Documentation/devicetree/bindings/power/wakeup-source.txt
> index cfd74659fbed..728f88de371d 100644
> --- a/Documentation/devicetree/bindings/power/wakeup-source.txt
> +++ b/Documentation/devicetree/bindings/power/wakeup-source.txt
> @@ -25,7 +25,7 @@ List of legacy properties and respective binding document
> Documentation/devicetree/bindings/input/touchscreen/ads7846.txt
> 5. "linux,keypad-wakeup" Documentation/devicetree/bindings/input/qcom,pm8xxx-keypad.txt
> 6. "linux,input-wakeup" Documentation/devicetree/bindings/input/samsung-keypad.txt
> -7. "nvidia,wakeup-source" Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.txt
> +7. "nvidia,wakeup-source" Documentation/devicetree/bindings/input/nvidia,tegra20-kbc.yaml
>
> Examples
> --------
> --
> 2.37.0
>
>
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2022-08-27 13:05 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-07-15 13:14 [PATCH v3] dt-bindings: nvidia,tegra20-kbc: Convert to json-schema Max Buchholz
2022-07-20 21:54 ` Rob Herring
2022-08-27 13:05 ` Aw: " Max.Buchholz
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.