Commit d9b11fcc authored by Maxime Ripard's avatar Maxime Ripard Committed by Rob Herring
Browse files

dt-bindings: serio: Convert Allwinner PS2 controller to a schema



The older Allwinner SoCs have a PS2 controller that is supported in Linux,
with a matching Device Tree binding.

Now that we have the DT validation in place, let's convert the device tree
bindings for that controller over to a YAML schemas.

Signed-off-by: default avatarMaxime Ripard <mripard@kernel.org>
Acked-by: default avatarChen-Yu Tsai <wens@csie.org>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent 3130c26a
Loading
Loading
Loading
Loading
+51 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: GPL-2.0
%YAML 1.2
---
$id: http://devicetree.org/schemas/serio/allwinner,sun4i-a10-ps2.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Allwinner A10 PS2 Host Controller Device Tree Bindings

maintainers:
  - Chen-Yu Tsai <wens@csie.org>
  - Maxime Ripard <maxime.ripard@bootlin.com>

description:
  A20 PS2 is dual role controller (PS2 host and PS2 device). These
  bindings for PS2 A10/A20 host controller. IBM compliant IBM PS2 and
  AT-compatible keyboard and mouse can be connected.

properties:
  compatible:
    const: allwinner,sun4i-a10-ps2

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 1

required:
  - compatible
  - reg
  - interrupts
  - clocks

additionalProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/clock/sun7i-a20-ccu.h>

    ps20: ps2@1c2a000 {
        compatible = "allwinner,sun4i-a10-ps2";
        reg = <0x01c2a000 0x400>;
        interrupts = <GIC_SPI 62 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&ccu CLK_APB1_PS20>;
    };

...
+0 −22
Original line number Diff line number Diff line
* Device tree bindings for Allwinner A10, A20 PS2 host controller

A20 PS2 is dual role controller (PS2 host and PS2 device). These bindings are
for PS2 A10/A20 host controller. IBM compliant IBM PS2 and AT-compatible keyboard
and mouse can be connected.

Required properties:

 - reg             : Offset and length of the register set for the device.
 - compatible      : Should be as of the following:
                     - "allwinner,sun4i-a10-ps2"
 - interrupts      : The interrupt line connected to the PS2.
 - clocks          : The gate clk connected to the PS2.


Example:
	ps20: ps2@01c2a000 {
		compatible = "allwinner,sun4i-a10-ps2";
		reg = <0x01c2a000 0x400>;
		interrupts = <0 62 4>;
		clocks = <&apb1_gates 6>;
	};