dt-bindings: input: touchscreen: fsl,imx6ul-tsc convert to YAML

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/input/touchscreen/fsl,imx6ul-tsc.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Freescale i.MX6UL Touch Controller

maintainers:

  - Haibo Chen <haibo.chen@nxp.com>

  - Shawn Guo <shawnguo@kernel.org>

  - Sascha Hauer <s.hauer@pengutronix.de>

properties:

  compatible:

    const: fsl,imx6ul-tsc

  reg:

    items:

      - description: touch controller address

      - description: ADC2 address

  interrupts:

    items:

      - description: touch controller address

      - description: ADC2 address

  clocks:

    maxItems: 2

  clock-names:

    items:

      - const: tsc

      - const: adc

  xnur-gpios:

    maxItems: 1

    description:

      The X- gpio this controller connect to. This xnur-gpio returns to

      low once the finger leave the touch screen (The last touch event

      the touch controller capture).

  measure-delay-time:

    $ref: /schemas/types.yaml#/definitions/uint32

    description:

      The value of measure delay time. Before X-axis or Y-axis measurement,

      the screen need some time before even potential distribution ready.

    default: 0xffff

    minimum: 0

    maximum: 0xffffff

  pre-charge-time:

    $ref: /schemas/types.yaml#/definitions/uint32

    description:

      The touch screen need some time to precharge.

    default: 0xfff

    minimum: 0

    maximum: 0xffffffff

  touchscreen-average-samples:

    $ref: /schemas/types.yaml#/definitions/uint32

    description: Number of data samples which are averaged for each read.

    enum: [ 1, 4, 8, 16, 32 ]

required:

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names

  - xnur-gpios

allOf:

  - $ref: touchscreen.yaml#

additionalProperties: false

examples:

  - |

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    #include <dt-bindings/clock/imx6ul-clock.h>

    #include <dt-bindings/gpio/gpio.h>

    touchscreen@2040000 {

        compatible = "fsl,imx6ul-tsc";

        reg = <0x02040000 0x4000>, <0x0219c000 0x4000>;

        interrupts = <GIC_SPI 3 IRQ_TYPE_LEVEL_HIGH>,

                     <GIC_SPI 101 IRQ_TYPE_LEVEL_HIGH>;

        clocks = <&clks IMX6UL_CLK_IPG>,

                 <&clks IMX6UL_CLK_ADC2>;

        clock-names = "tsc", "adc";

        pinctrl-names = "default";

        pinctrl-0 = <&pinctrl_tsc>;

        xnur-gpios = <&gpio1 3 GPIO_ACTIVE_LOW>;

        measure-delay-time = <0xfff>;

        pre-charge-time = <0xffff>;

        touchscreen-average-samples = <32>;

    };

* Freescale i.MX6UL Touch Controller

Required properties:

- compatible: must be "fsl,imx6ul-tsc".

- reg: this touch controller address and the ADC2 address.

- interrupts: the interrupt of this touch controller and ADC2.

- clocks: the root clock of touch controller and ADC2.

- clock-names; must be "tsc" and "adc".

- xnur-gpio: the X- gpio this controller connect to.

  This xnur-gpio returns to low once the finger leave the touch screen (The

  last touch event the touch controller capture).

Optional properties:

- measure-delay-time: the value of measure delay time.

  Before X-axis or Y-axis measurement, the screen need some time before

  even potential distribution ready.

  This value depends on the touch screen.

- pre-charge-time: the touch screen need some time to precharge.

  This value depends on the touch screen.

- touchscreen-average-samples: Number of data samples which are averaged for

  each read. Valid values are 1, 4, 8, 16 and 32.

Example:

	tsc: tsc@2040000 {

		compatible = "fsl,imx6ul-tsc";

		reg = <0x02040000 0x4000>, <0x0219c000 0x4000>;

		interrupts = <GIC_SPI 3 IRQ_TYPE_LEVEL_HIGH>,

			     <GIC_SPI 101 IRQ_TYPE_LEVEL_HIGH>;

		clocks = <&clks IMX6UL_CLK_IPG>,

			 <&clks IMX6UL_CLK_ADC2>;

		clock-names = "tsc", "adc";

		pinctrl-names = "default";

		pinctrl-0 = <&pinctrl_tsc>;

		xnur-gpio = <&gpio1 3 GPIO_ACTIVE_LOW>;

		measure-delay-time = <0xfff>;

		pre-charge-time = <0xffff>;

		touchscreen-average-samples = <32>;

	};