mirror of
https://github.com/lkl/linux.git
synced 2025-12-19 08:03:01 +09:00
As talked about in the patch ("drm/panel: Add a way for other devices
to follow panel state"), touchscreens that are connected to panels are
generally expected to be power sequenced together with the panel
they're attached to. Today, nothing provides information allowing you
to find out that a touchscreen is connected to a panel. Let's add a
phandle for this.
The proerty is added to the generic touchscreen bindings and then
enabled in the bindings for the i2c-hid backed devices. This can and
should be added for other touchscreens in the future, but for now
let's start small.
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: Maxime Ripard <mripard@kernel.org>
Reviewed-by: Benjamin Tissoires <bentiss@kernel.org>
Acked-by: Benjamin Tissoires <bentiss@kernel.org>
Signed-off-by: Douglas Anderson <dianders@chromium.org>
Link: https://patchwork.freedesktop.org/patch/msgid/20230727101636.v4.1.Id68e30343bb1e11470582a9078b086176cfec46b@changeid
97 lines
3.1 KiB
YAML
97 lines
3.1 KiB
YAML
# 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
|
|
|
|
maintainers:
|
|
- Dmitry Torokhov <dmitry.torokhov@gmail.com>
|
|
|
|
properties:
|
|
panel:
|
|
description: If this touchscreen is integrally connected to a panel, this
|
|
is a reference to that panel. The presence of this reference indicates
|
|
that the touchscreen should be power sequenced together with the panel
|
|
and that they may share power and/or reset signals.
|
|
$ref: /schemas/types.yaml#/definitions/phandle
|
|
|
|
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
|
|
|
|
touchscreen-y-mm:
|
|
description: vertical length in mm of the touchscreen
|
|
|
|
touchscreen-x-plate-ohms:
|
|
description: Resistance of the X-plate in Ohms
|
|
|
|
touchscreen-y-plate-ohms:
|
|
description: Resistance of the Y-plate in Ohms
|
|
|
|
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 ]
|
|
|
|
additionalProperties: true
|