Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Javier Carrasco <javier.carrasco@wolfvision.net>
To:     linux-input@vger.kernel.org, devicetree@vger.kernel.org,
        linux-kernel@vger.kernel.org
Cc:     Dmitry Torokhov <dmitry.torokhov@gmail.com>,
        Rob Herring <robh+dt@kernel.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        Henrik Rydberg <rydberg@bitmath.org>,
        Javier Carrasco <javier.carrasco@wolfvision.net>,
        Ulf Hansson <ulf.hansson@linaro.org>,
        Hans Verkuil <hverkuil-cisco@xs4all.nl>,
        Stephen Boyd <sboyd@kernel.org>,
        Sebastian Reichel <sre@kernel.org>,
        Linus Walleij <linus.walleij@linaro.org>,
        Jonathan Cameron <Jonathan.Cameron@huawei.com>,
        Uwe Kleine-g <u.kleine-koenig@pengutronix.de>,
        Bastian Hecht <hechtb@gmail.com>,
        Michael Riesch <michael.riesch@wolfvision.net>
Subject: [RFC v1 2/4] dt-bindings: touchscreen: add virtual-touchscreen and virtual-buttons properties
Date:   Tue, 25 Apr 2023 13:50:47 +0200
Message-Id: <20230425115049.870003-3-javier.carrasco@wolfvision.net>
In-Reply-To: <20230425115049.870003-1-javier.carrasco@wolfvision.net>
References: <20230425115049.870003-1-javier.carrasco@wolfvision.net>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?eAJrVTIHNiL4dnb4q1aMMLvqMzv2C1KE/y3J0L/H3fzDrbwMUqXC2xUBlQJt?=
 =?us-ascii?Q?A76vLmJ9hh5yGh209JZa6vPXNbrLb0q88uMNOcX21bh+vwfpf6bDofDPtTqb?=
 =?us-ascii?Q?TUPTmwhCZm7lMj506ems6fgKdIVEI+ThxJ5jegLhgZttUMKl0nwH1a9QjcZ6?=
 =?us-ascii?Q?URAe11d4PMsWCacySP7ZB/Q4XGWiFVNdOY6U9KlXXKC8qVtlZncUVgF4SCRP?=
 =?us-ascii?Q?y9O6aanst7/yX6NY6ThR5233iMofLgr5t72aTImkB3mD8qn3mGz8SODDFVTc?=
 =?us-ascii?Q?mTF+Cna864mPGIS16crWlt27akr1jquhG+Zg5c1zzwW9vd1aYnQoMrJGP7rC?=
 =?us-ascii?Q?aB+I+Wu/PNCsEw4FnwofsFwlj1T61aeLMIF7E1zy4+Uay/D5i4o+P1mqtIoW?=
 =?us-ascii?Q?c1s+3UZJ2aWCyanhMXq3FrbJqGq1eDXqZOP7qeD3bdkbeAyXBt17bXdECGM3?=
 =?us-ascii?Q?zt/rENmZ5xbTKUClnmp3+i2ri+9boNzrcwy5RFAF55uEeRyPjp8Hf60zBamG?=
 =?us-ascii?Q?Dt9VZiqpMz2F8pm23VnGvQ2lKdhbhQ3BRsCgv79WmLss6VzTkDBbGNeVZprN?=
 =?us-ascii?Q?yVSTEH/LqfL0dKhKp7Fewv4JoDkhuLpeNsFQvNgJhqMQeF8nHrXNY3F4KV6C?=
 =?us-ascii?Q?585cmjzFTmm2H92bI+Bq9R6oPluWcLHSd+TshrVbCl5nLoTmrmpilIuchyhP?=
 =?us-ascii?Q?JyH1IxCaRjSEVYWdjQ6+lVHO1lcnAvmneNgD7zIMDHwdeMfCR0Yx8yG2oOyC?=
 =?us-ascii?Q?H8hO5aCY3oc/fry1uNu+WBsM/vwbrvWDERu8ev27Y5ZQPQYRFW1s0VgqoxRU?=
 =?us-ascii?Q?Y3C3+sr7kLUflaRxUeqsnsHCOU5aqFzfbhmjS3PZTezGYnfGERnumcYnEzwX?=
 =?us-ascii?Q?51FMJKezvD3LGzYjgkdmIlj1iptoQyJLF6HgCXldr4piaI4h6LTRpidzzyi9?=
 =?us-ascii?Q?fHvvFPstVQMY+y8WWK8mdnkq2XoC84AxnGkHJyJ4AtKGwNKBpyzQYv6wU7Z6?=
 =?us-ascii?Q?bNf+pdtogY5H22Exh8BMfhlIloz294QWJ8V9IGFPklEGN5jJdQDY9n2CuUO4?=
 =?us-ascii?Q?4R7ePev43JX+nvPCwPAZAiY6cswzM5c3aX6uMkZ9WAe65XtvORdA6ZlURjlK?=
 =?us-ascii?Q?WP6R5A4PWMqAI4700b3KbpassfrKpC8JPf8sG94Zb0QyYxb2e18N9td8yGO/?=
 =?us-ascii?Q?tOfYoggV/S59hwPuyB4nprtWFgm4H6zI/FXP9/KqlsK20OuJAeH25j2EoL86?=
 =?us-ascii?Q?8LU45Iycj01MX6YF77G5z/BtOY6erZTwDFcSsRCpbIF9UifiMYxB5ugxfkf0?=
 =?us-ascii?Q?D2KmlAyDjitJlbkic4EKU75mSAKRxLlxSyxQuHCzZ86a5AqI84daE8Sb1iAH?=
 =?us-ascii?Q?YJUkTq7R0Ff9lzs25uo9f1XbFXaHWEGOTj2tCyyhoSG/57JRsZezIlEuTaYz?=
 =?us-ascii?Q?SGJs/ReJEAShbqlf1YQ5IR+ovduH37l2jRDtBmdlIotlW8aTKjsit6dZzmxH?=
 =?us-ascii?Q?ZzMmBPUtzwGVph1cLwIwwmDuR40iUBUKI/jxPp3HDJNyt0ykMJr1YYxH2Cly?=
 =?us-ascii?Q?AbzF5Y3Z9Op847PJfBbx33WI8ge6TiRFNkpK0wJHDp4fTr/NMMf0vuI149dJ?=
 =?us-ascii?Q?aA=3D=3D?=
X-OriginatorOrg: wolfvision.net
X-MS-Exchange-CrossTenant-Network-Message-Id: b8a5d37d-0025-4342-7666-08db4583645c
X-MS-Exchange-CrossTenant-AuthSource: VE1PR08MB4974.eurprd08.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 Apr 2023 11:51:23.1316
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: e94ec9da-9183-471e-83b3-51baa8eb804f
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: AObV77R7Ve/OcH4ofS0DvhIoIiI0bUAkC/B6HWI8B5ukuLour0QPS4wwju+OHrLkXocUE/ZJfbcwkInNyBYbrH4ObMU+/6sUoDOZuEokFx0=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU2PR08MB10203
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,T_SCC_BODY_TEXT_LINE,
        URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

The virtual-touchscreen object defines an area within the touchscreen
where touch events are reported and their coordinates get converted to
the virtual origin. This object avoids getting events from areas that
are physically hidden by overlay frames.

For touchscreens where overlay buttons on the touchscreen surface are
provided, the virtual-buttons object contains a node for every button
and the key event that should be reported when pressed.

Signed-off-by: Javier Carrasco <javier.carrasco@wolfvision.net>
---
 .../input/touchscreen/touchscreen.yaml        | 54 +++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml b/Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml
index 895592da9626..869be007eb6f 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/touchscreen.yaml
@@ -80,6 +80,60 @@ properties:
   touchscreen-y-plate-ohms:
     description: Resistance of the Y-plate in Ohms
 
+  virtual-touchscreen:
+    description: Clipped touchscreen area
+    type: object
+
+    properties:
+      x-origin:
+        description: horizontal origin of the clipped area
+        $ref: /schemas/types.yaml#/definitions/uint32
+
+      y-origin:
+        description: vertical origin of the clipped area
+        $ref: /schemas/types.yaml#/definitions/uint32
+
+      x-size:
+        description: horizontal resolution of the clipped area
+        $ref: /schemas/types.yaml#/definitions/uint32
+
+      y-size:
+        description: vertical resolution of the clipped area
+        $ref: /schemas/types.yaml#/definitions/uint32
+
+  virtual-buttons:
+    description: list of nodes defining the buttons on the touchscreen
+    type: object
+
+    patternProperties:
+      '^button-':
+        type: object
+        description:
+          Each button (key) is represented as a sub-node.
+
+        properties:
+          label:
+            $ref: /schemas/types.yaml#/definitions/string
+            description: descriptive name of the button
+
+          linux,code: true
+
+          x-origin:
+            description: horizontal origin of the button area
+            $ref: /schemas/types.yaml#/definitions/uint32
+
+          y-origin:
+            description: vertical origin of the button area
+            $ref: /schemas/types.yaml#/definitions/uint32
+
+          x-size:
+            description: horizontal resolution of the button area
+            $ref: /schemas/types.yaml#/definitions/uint32
+
+          y-size:
+            description: vertical resolution of the button area
+            $ref: /schemas/types.yaml#/definitions/uint32
+
 dependencies:
   touchscreen-size-x: [ touchscreen-size-y ]
   touchscreen-size-y: [ touchscreen-size-x ]
-- 
2.37.2