diff mbox series

[v2,3/5] dt-bindings: input: touchscreen: Move helper bindings to core

Message ID 1611459776-23265-4-git-send-email-jeff@labundy.com
State Changes Requested, archived
Headers show
Series Add support for Azoteq IQS626A | expand

Checks

Context Check Description
robh/checkpatch warning total: 0 errors, 5 warnings, 164 lines checked
robh/dt-meta-schema success
robh/dtbs-check fail build log

Commit Message

Jeff LaBundy Jan. 24, 2021, 3:42 a.m. UTC
With the helper functions moving to /drivers/input/ following the
discussion in [1], touchscreen.yaml and touchscreen.txt are moved
one level up as well to maintain a consistent directory structure.

No changes are made to either file except to update the $id field
in touchscreen.yaml to reflect the new path. The handful of .yaml
bindings that reference the original relative path are updated as
well.

Last but not least, the handful of .txt bindings that included an
absolute path to touchscreen.txt are updated too.

[1] https://patchwork.kernel.org/patch/11924029/

Signed-off-by: Jeff LaBundy <jeff@labundy.com>
---
Changes in v2:
 - Added this patch to the series

 .../devicetree/bindings/input/elan_i2c.txt         |  2 +-
 .../devicetree/bindings/input/touchscreen.txt      |  1 +
 .../devicetree/bindings/input/touchscreen.yaml     | 83 ++++++++++++++++++++++
 .../bindings/input/touchscreen/ads7846.txt         |  2 +-
 .../bindings/input/touchscreen/bu21013.txt         |  2 +-
 .../input/touchscreen/cypress,cy8ctma140.yaml      |  2 +-
 .../bindings/input/touchscreen/edt-ft5x06.yaml     |  2 +-
 .../bindings/input/touchscreen/eeti,exc3000.yaml   |  2 +-
 .../input/touchscreen/elan,elants_i2c.yaml         |  2 +-
 .../bindings/input/touchscreen/goodix.yaml         |  2 +-
 .../bindings/input/touchscreen/iqs5xx.txt          |  2 +-
 .../bindings/input/touchscreen/mms114.txt          |  2 +-
 .../bindings/input/touchscreen/touchscreen.txt     |  1 -
 .../bindings/input/touchscreen/touchscreen.yaml    | 83 ----------------------
 14 files changed, 94 insertions(+), 94 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/input/touchscreen.txt
 create mode 100644 Documentation/devicetree/bindings/input/touchscreen.yaml
 delete mode 100644 Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
 delete mode 100644 Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml

--
2.7.4

Comments

Rob Herring Feb. 9, 2021, 4:27 p.m. UTC | #1
On Sat, Jan 23, 2021 at 09:42:54PM -0600, Jeff LaBundy wrote:
> With the helper functions moving to /drivers/input/ following the
> discussion in [1], touchscreen.yaml and touchscreen.txt are moved
> one level up as well to maintain a consistent directory structure.
> 
> No changes are made to either file except to update the $id field
> in touchscreen.yaml to reflect the new path. The handful of .yaml
> bindings that reference the original relative path are updated as
> well.
> 
> Last but not least, the handful of .txt bindings that included an
> absolute path to touchscreen.txt are updated too.
> 
> [1] https://patchwork.kernel.org/patch/11924029/
> 
> Signed-off-by: Jeff LaBundy <jeff@labundy.com>
> ---
> Changes in v2:
>  - Added this patch to the series
> 
>  .../devicetree/bindings/input/elan_i2c.txt         |  2 +-
>  .../devicetree/bindings/input/touchscreen.txt      |  1 +
>  .../devicetree/bindings/input/touchscreen.yaml     | 83 ++++++++++++++++++++++
>  .../bindings/input/touchscreen/ads7846.txt         |  2 +-
>  .../bindings/input/touchscreen/bu21013.txt         |  2 +-
>  .../input/touchscreen/cypress,cy8ctma140.yaml      |  2 +-
>  .../bindings/input/touchscreen/edt-ft5x06.yaml     |  2 +-
>  .../bindings/input/touchscreen/eeti,exc3000.yaml   |  2 +-
>  .../input/touchscreen/elan,elants_i2c.yaml         |  2 +-
>  .../bindings/input/touchscreen/goodix.yaml         |  2 +-
>  .../bindings/input/touchscreen/iqs5xx.txt          |  2 +-
>  .../bindings/input/touchscreen/mms114.txt          |  2 +-
>  .../bindings/input/touchscreen/touchscreen.txt     |  1 -
>  .../bindings/input/touchscreen/touchscreen.yaml    | 83 ----------------------
>  14 files changed, 94 insertions(+), 94 deletions(-)
>  create mode 100644 Documentation/devicetree/bindings/input/touchscreen.txt
>  create mode 100644 Documentation/devicetree/bindings/input/touchscreen.yaml
>  delete mode 100644 Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
>  delete mode 100644 Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml

No, I prefer the current structure. It's easier to find similar types of 
h/w as-is. In fact, if you wanted to move keyboards/keypads to their own 
subdir, I'd welcome that.

Rob
Jeff LaBundy Feb. 10, 2021, 3:12 a.m. UTC | #2
Hi Rob,

Thank you for taking a look at the series.

On Tue, Feb 09, 2021 at 10:27:40AM -0600, Rob Herring wrote:
> On Sat, Jan 23, 2021 at 09:42:54PM -0600, Jeff LaBundy wrote:
> > With the helper functions moving to /drivers/input/ following the
> > discussion in [1], touchscreen.yaml and touchscreen.txt are moved
> > one level up as well to maintain a consistent directory structure.
> > 
> > No changes are made to either file except to update the $id field
> > in touchscreen.yaml to reflect the new path. The handful of .yaml
> > bindings that reference the original relative path are updated as
> > well.
> > 
> > Last but not least, the handful of .txt bindings that included an
> > absolute path to touchscreen.txt are updated too.
> > 
> > [1] https://patchwork.kernel.org/patch/11924029/
> > 
> > Signed-off-by: Jeff LaBundy <jeff@labundy.com>
> > ---
> > Changes in v2:
> >  - Added this patch to the series
> > 
> >  .../devicetree/bindings/input/elan_i2c.txt         |  2 +-
> >  .../devicetree/bindings/input/touchscreen.txt      |  1 +
> >  .../devicetree/bindings/input/touchscreen.yaml     | 83 ++++++++++++++++++++++
> >  .../bindings/input/touchscreen/ads7846.txt         |  2 +-
> >  .../bindings/input/touchscreen/bu21013.txt         |  2 +-
> >  .../input/touchscreen/cypress,cy8ctma140.yaml      |  2 +-
> >  .../bindings/input/touchscreen/edt-ft5x06.yaml     |  2 +-
> >  .../bindings/input/touchscreen/eeti,exc3000.yaml   |  2 +-
> >  .../input/touchscreen/elan,elants_i2c.yaml         |  2 +-
> >  .../bindings/input/touchscreen/goodix.yaml         |  2 +-
> >  .../bindings/input/touchscreen/iqs5xx.txt          |  2 +-
> >  .../bindings/input/touchscreen/mms114.txt          |  2 +-
> >  .../bindings/input/touchscreen/touchscreen.txt     |  1 -
> >  .../bindings/input/touchscreen/touchscreen.yaml    | 83 ----------------------
> >  14 files changed, 94 insertions(+), 94 deletions(-)
> >  create mode 100644 Documentation/devicetree/bindings/input/touchscreen.txt
> >  create mode 100644 Documentation/devicetree/bindings/input/touchscreen.yaml
> >  delete mode 100644 Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
> >  delete mode 100644 Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml
> 
> No, I prefer the current structure. It's easier to find similar types of 
> h/w as-is. In fact, if you wanted to move keyboards/keypads to their own 
> subdir, I'd welcome that.

No problem, I will drop this patch from the series and update the $ref in
patch [4/5] to reference the original touchscreen.yaml.

> 
> Rob

Kind regards,
Jeff LaBundy
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/input/elan_i2c.txt b/Documentation/devicetree/bindings/input/elan_i2c.txt
index 9963247..f11c8e1 100644
--- a/Documentation/devicetree/bindings/input/elan_i2c.txt
+++ b/Documentation/devicetree/bindings/input/elan_i2c.txt
@@ -26,7 +26,7 @@  Optional properties:

 [0]: Documentation/devicetree/bindings/interrupt-controller/interrupts.txt
 [1]: Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt
-[2]: Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
+[2]: Documentation/devicetree/bindings/input/touchscreen.txt

 Example:
 	&i2c1 {
diff --git a/Documentation/devicetree/bindings/input/touchscreen.txt b/Documentation/devicetree/bindings/input/touchscreen.txt
new file mode 100644
index 0000000..e1adb90
--- /dev/null
+++ b/Documentation/devicetree/bindings/input/touchscreen.txt
@@ -0,0 +1 @@ 
+See touchscreen.yaml
diff --git a/Documentation/devicetree/bindings/input/touchscreen.yaml b/Documentation/devicetree/bindings/input/touchscreen.yaml
new file mode 100644
index 0000000..e2e27c3
--- /dev/null
+++ b/Documentation/devicetree/bindings/input/touchscreen.yaml
@@ -0,0 +1,83 @@ 
+# SPDX-License-Identifier: GPL-2.0
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/input/touchscreen.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Common touchscreen Bindings
+
+maintainers:
+  - Dmitry Torokhov <dmitry.torokhov@gmail.com>
+
+properties:
+  touchscreen-min-x:
+    description: minimum x coordinate reported
+    $ref: /schemas/types.yaml#/definitions/uint32
+    default: 0
+
+  touchscreen-min-y:
+    description: minimum y coordinate reported
+    $ref: /schemas/types.yaml#/definitions/uint32
+    default: 0
+
+  touchscreen-size-x:
+    description: horizontal resolution of touchscreen (maximum x coordinate reported + 1)
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-size-y:
+    description: vertical resolution of touchscreen (maximum y coordinate reported + 1)
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-max-pressure:
+    description: maximum reported pressure (arbitrary range dependent on the controller)
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-min-pressure:
+    description: minimum pressure on the touchscreen to be achieved in order
+      for the touchscreen driver to report a touch event.
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-fuzz-x:
+    description: horizontal noise value of the absolute input device (in pixels)
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-fuzz-y:
+    description: vertical noise value of the absolute input device (in pixels)
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-fuzz-pressure:
+    description: pressure noise value of the absolute input device (arbitrary
+      range dependent on the controller)
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-average-samples:
+    description: Number of data samples which are averaged for each read (valid
+      values dependent on the controller)
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-inverted-x:
+    description: X axis is inverted
+    type: boolean
+
+  touchscreen-inverted-y:
+    description: Y axis is inverted
+    type: boolean
+
+  touchscreen-swapped-x-y:
+    description: X and Y axis are swapped
+                 Swapping is done after inverting the axis
+    type: boolean
+
+  touchscreen-x-mm:
+    description: horizontal length in mm of the touchscreen
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+  touchscreen-y-mm:
+    description: vertical length in mm of the touchscreen
+    $ref: /schemas/types.yaml#/definitions/uint32
+
+dependencies:
+  touchscreen-size-x: [ touchscreen-size-y ]
+  touchscreen-size-y: [ touchscreen-size-x ]
+  touchscreen-x-mm: [ touchscreen-y-mm ]
+  touchscreen-y-mm: [ touchscreen-x-mm ]
diff --git a/Documentation/devicetree/bindings/input/touchscreen/ads7846.txt b/Documentation/devicetree/bindings/input/touchscreen/ads7846.txt
index 81f6bda..b158a86 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/ads7846.txt
+++ b/Documentation/devicetree/bindings/input/touchscreen/ads7846.txt
@@ -69,7 +69,7 @@  Optional properties:
 	touchscreen-swapped-x-y		General touchscreen binding, see [1].

 [1] All general touchscreen properties are described in
-    Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt.
+    Documentation/devicetree/bindings/input/touchscreen.txt.

 Deprecated properties:

diff --git a/Documentation/devicetree/bindings/input/touchscreen/bu21013.txt b/Documentation/devicetree/bindings/input/touchscreen/bu21013.txt
index da4c9d8..e056a5f 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/bu21013.txt
+++ b/Documentation/devicetree/bindings/input/touchscreen/bu21013.txt
@@ -17,7 +17,7 @@  Optional properties:
  - touchscreen-swapped-x-y : General touchscreen binding, see [1].

 [1] All general touchscreen properties are described in
-    Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt.
+    Documentation/devicetree/bindings/input/touchscreen.txt.

 Deprecated properties:
  - rohm,touch-max-x        : Maximum outward permitted limit in the X axis
diff --git a/Documentation/devicetree/bindings/input/touchscreen/cypress,cy8ctma140.yaml b/Documentation/devicetree/bindings/input/touchscreen/cypress,cy8ctma140.yaml
index 3225c8d..900e112 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/cypress,cy8ctma140.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/cypress,cy8ctma140.yaml
@@ -10,7 +10,7 @@  maintainers:
   - Linus Walleij <linus.walleij@linaro.org>

 allOf:
-  - $ref: touchscreen.yaml#
+  - $ref: ../touchscreen.yaml#

 properties:
   compatible:
diff --git a/Documentation/devicetree/bindings/input/touchscreen/edt-ft5x06.yaml b/Documentation/devicetree/bindings/input/touchscreen/edt-ft5x06.yaml
index 4ce1094..3d73fe3 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/edt-ft5x06.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/edt-ft5x06.yaml
@@ -18,7 +18,7 @@  maintainers:
   - Dmitry Torokhov <dmitry.torokhov@gmail.com>

 allOf:
-  - $ref: touchscreen.yaml#
+  - $ref: ../touchscreen.yaml#
   - if:
       properties:
         compatible:
diff --git a/Documentation/devicetree/bindings/input/touchscreen/eeti,exc3000.yaml b/Documentation/devicetree/bindings/input/touchscreen/eeti,exc3000.yaml
index 007adbc..b1beb61 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/eeti,exc3000.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/eeti,exc3000.yaml
@@ -10,7 +10,7 @@  maintainers:
   - Dmitry Torokhov <dmitry.torokhov@gmail.com>

 allOf:
-  - $ref: touchscreen.yaml#
+  - $ref: ../touchscreen.yaml#

 properties:
   compatible:
diff --git a/Documentation/devicetree/bindings/input/touchscreen/elan,elants_i2c.yaml b/Documentation/devicetree/bindings/input/touchscreen/elan,elants_i2c.yaml
index a792d63..d3fabaf 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/elan,elants_i2c.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/elan,elants_i2c.yaml
@@ -10,7 +10,7 @@  maintainers:
   - David Heidelberg <david@ixit.cz>

 allOf:
-  - $ref: touchscreen.yaml#
+  - $ref: ../touchscreen.yaml#

 properties:
   compatible:
diff --git a/Documentation/devicetree/bindings/input/touchscreen/goodix.yaml b/Documentation/devicetree/bindings/input/touchscreen/goodix.yaml
index da5b0d8..5bea19a 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/goodix.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/goodix.yaml
@@ -10,7 +10,7 @@  maintainers:
   - Dmitry Torokhov <dmitry.torokhov@gmail.com>

 allOf:
-  - $ref: touchscreen.yaml#
+  - $ref: ../touchscreen.yaml#

 properties:
   compatible:
diff --git a/Documentation/devicetree/bindings/input/touchscreen/iqs5xx.txt b/Documentation/devicetree/bindings/input/touchscreen/iqs5xx.txt
index efa0820..d9c107e 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/iqs5xx.txt
+++ b/Documentation/devicetree/bindings/input/touchscreen/iqs5xx.txt
@@ -56,7 +56,7 @@  Optional properties:

 [0]: Documentation/devicetree/bindings/interrupt-controller/interrupts.txt
 [1]: Documentation/devicetree/bindings/gpio/gpio.txt
-[2]: Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
+[2]: Documentation/devicetree/bindings/input/touchscreen.txt

 Example:

diff --git a/Documentation/devicetree/bindings/input/touchscreen/mms114.txt b/Documentation/devicetree/bindings/input/touchscreen/mms114.txt
index 707234c..4c28a30 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/mms114.txt
+++ b/Documentation/devicetree/bindings/input/touchscreen/mms114.txt
@@ -18,7 +18,7 @@  Optional properties:
 - touchscreen-inverted-y: See [1]
 - touchscreen-swapped-x-y: See [1]

-[1]: Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
+[1]: Documentation/devicetree/bindings/input/touchscreen.txt

 Example:

diff --git a/Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt b/Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
deleted file mode 100644
index e1adb90..0000000
--- a/Documentation/devicetree/bindings/input/touchscreen/touchscreen.txt
+++ /dev/null
@@ -1 +0,0 @@ 
-See touchscreen.yaml
diff --git a/Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml b/Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml
deleted file mode 100644
index 36dc7b5..0000000
--- a/Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml
+++ /dev/null
@@ -1,83 +0,0 @@ 
-# SPDX-License-Identifier: GPL-2.0
-%YAML 1.2
----
-$id: http://devicetree.org/schemas/input/touchscreen/touchscreen.yaml#
-$schema: http://devicetree.org/meta-schemas/core.yaml#
-
-title: Common touchscreen Bindings
-
-maintainers:
-  - Dmitry Torokhov <dmitry.torokhov@gmail.com>
-
-properties:
-  touchscreen-min-x:
-    description: minimum x coordinate reported
-    $ref: /schemas/types.yaml#/definitions/uint32
-    default: 0
-
-  touchscreen-min-y:
-    description: minimum y coordinate reported
-    $ref: /schemas/types.yaml#/definitions/uint32
-    default: 0
-
-  touchscreen-size-x:
-    description: horizontal resolution of touchscreen (maximum x coordinate reported + 1)
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-size-y:
-    description: vertical resolution of touchscreen (maximum y coordinate reported + 1)
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-max-pressure:
-    description: maximum reported pressure (arbitrary range dependent on the controller)
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-min-pressure:
-    description: minimum pressure on the touchscreen to be achieved in order
-      for the touchscreen driver to report a touch event.
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-fuzz-x:
-    description: horizontal noise value of the absolute input device (in pixels)
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-fuzz-y:
-    description: vertical noise value of the absolute input device (in pixels)
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-fuzz-pressure:
-    description: pressure noise value of the absolute input device (arbitrary
-      range dependent on the controller)
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-average-samples:
-    description: Number of data samples which are averaged for each read (valid
-      values dependent on the controller)
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-inverted-x:
-    description: X axis is inverted
-    type: boolean
-
-  touchscreen-inverted-y:
-    description: Y axis is inverted
-    type: boolean
-
-  touchscreen-swapped-x-y:
-    description: X and Y axis are swapped
-                 Swapping is done after inverting the axis
-    type: boolean
-
-  touchscreen-x-mm:
-    description: horizontal length in mm of the touchscreen
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-  touchscreen-y-mm:
-    description: vertical length in mm of the touchscreen
-    $ref: /schemas/types.yaml#/definitions/uint32
-
-dependencies:
-  touchscreen-size-x: [ touchscreen-size-y ]
-  touchscreen-size-y: [ touchscreen-size-x ]
-  touchscreen-x-mm: [ touchscreen-y-mm ]
-  touchscreen-y-mm: [ touchscreen-x-mm ]