Received-SPF: pass (google.com: domain of linux-kernel+bounces-153152-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161;
From: Javier Carrasco <javier.carrasco@wolfvision.net>
Date: Mon, 22 Apr 2024 12:07:39 +0200
Subject: [PATCH v9 3/4] dt-bindings: input: touchscreen: st1232: add
 touch-overlay example
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <20240422-feature-ts_virtobj_patch-v9-3-acf118d12a8a@wolfvision.net>
References: <20240422-feature-ts_virtobj_patch-v9-0-acf118d12a8a@wolfvision.net>
In-Reply-To: <20240422-feature-ts_virtobj_patch-v9-0-acf118d12a8a@wolfvision.net>
To: Dmitry Torokhov <dmitry.torokhov@gmail.com>, 
 Rob Herring <robh@kernel.org>, 
 Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, 
 Conor Dooley <conor+dt@kernel.org>, Bastian Hecht <hechtb@gmail.com>, 
 Michael Riesch <michael.riesch@wolfvision.net>
Cc: linux-input@vger.kernel.org, devicetree@vger.kernel.org, 
 linux-kernel@vger.kernel.org, 
 Javier Carrasco <javier.carrasco@wolfvision.net>
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?RlBmQUVuZXcrRkw0RTZ1MHFDRTF1bHgweU81ZjFvTlp0L1dydjlxWkJjZ2lE?=
 =?utf-8?B?emNhT3I0c2NYVFM5NXFRUlRaZmE1WXlGNEtjMjM1QS9kaEN0VFJLd0FUTTNy?=
 =?utf-8?B?T1NkMWw0TEZxdndtVklnODdlaTV5NDFhU1BxaEJZUkRXd3BjeitLVngvZUht?=
 =?utf-8?B?ZFZlYnRNUWhZd2hoL0JyRHNzNDdCUTM5SzFQUnlrKys1ZGloYVVmbi9MSi9p?=
 =?utf-8?B?WFo3SjMxUzg3WURJdkRxOG5HalBrbUdiZWNuNEliQngraFBWMkEralROQjNa?=
 =?utf-8?B?WDhqUnVrQSszSGp2WEw3Y2hoVlI2azNEbm9YcmJYNGRuYVVNNFZpdDlsZFli?=
 =?utf-8?B?YnM4bXZMb1djdGxzMDRqdmllUWx6aU9UNGpsUnhXL0Q2dGVCci9yY21VQWNv?=
 =?utf-8?B?Q0kraXJOeDVObTBFT1piRHJIVEJkY0Zsbk1LbDBHeXNRaHRzSkFHanl3b2I0?=
 =?utf-8?B?TENBVW5qR0s0WVZyZHJkcXNFRWNTSjYyUFBZRG9Ha2R6MHNhdU9XYiszbUti?=
 =?utf-8?B?ek0xRnBESk8xUkM5SGpxQ2JIaWZueUZJa2t3V1UxclZ2R2ZPQk5jdERoNTNP?=
 =?utf-8?B?c296dlJrWXlTS2RLQ3ArekVpeHI4R2Fmbm9jdzRpeVZXY3NkYVFGN25rTEo0?=
 =?utf-8?B?ZlRxWFNadUNxSi9sSXVva3RTVUZWdjhJRWZMKzhoNzRlR0I2R0RpaUc3d0Z5?=
 =?utf-8?B?Q0MxRVJEQ0FKUkk2QURyY0thcUdmVmFVVVBTallrK1I2cWgwaFp5Y0s3cWRt?=
 =?utf-8?B?T0RCdG54Y1NuWmJZUUZ4dU16N3Y5MUpxYmFVcjhVNE12b1pidTFIYmpUejJC?=
 =?utf-8?B?OGl4d2tKVFdvZVNHTTFOS1dncU5Xc3lRSC9TN3VuVUZtNnNVb1k2OGlWcTVO?=
 =?utf-8?B?blFsS1RUSDJBS3c4dzFuYjVOdkVtZ0lrSFBObHMyZWROWk5ZTVZZL2E0Sy9I?=
 =?utf-8?B?S3RqK2FRWnRrZ2RnOWg0REFvc0RkOFZHdVJJQ204TEVJNXdsVGxoNUhQZ01n?=
 =?utf-8?B?WGs1SFd5SzZyUC9vOEZGMnpwM2hVeFlhR3owSkVHc3NIRVNDeE9nRCt2UnFR?=
 =?utf-8?B?U29hc0VXWElRTVdic2dsb1RyS3gvdjhSaGJwZUNOMXhTUTdSUFBwejFsc05K?=
 =?utf-8?B?eWlBbHhUNG9MampPYUw0TWJQbWZVSll0SUxvbVVXSzVqS3pOOVZieXZRa1Zu?=
 =?utf-8?B?bHlrVzNkc2N5dldqY0tudWZIUExFdkNZckdLVDdTUU53dUs4MUsrWkxlMTFp?=
 =?utf-8?B?cmY5dzZKRWhWSk0wNjgzekhXOE5kZXZxaGdHNjg3YTNxQ1lVYkNKM05FLy9E?=
 =?utf-8?B?MkYwY0g1TVVML3RjZTR1OHllcjFNalJtd01IcUhMZEgreFlYc1NZY0JFLzNv?=
 =?utf-8?B?UklqZi9venJvdXdtRytKYkY3TmtscUFjTkxGSEV4SVNjcWJ4enA2dTBSeC84?=
 =?utf-8?B?ZE5GSTh5OXpyTHdsbnVxREFONG0vb0plNlltMHpDYkdiS0JUbmFSU2xldHAr?=
 =?utf-8?B?WkNCNjRmWXNIb2dLUm5TWm1Jb3M3LzhUaW9lQmxHOG1CSlNoUWNRV3pEMFhJ?=
 =?utf-8?B?UDViM3RteDRlUDdjckQzZTJQQnc4ZjllaXR6M3crUnFDdFVJQzNIVUtOZFdZ?=
 =?utf-8?B?bGdVVGxlNHlERUZ3Q1BjVG44TnZiWm5BU0xmWEpmVjZKMGpZK1ZNRWtpdExW?=
 =?utf-8?B?b0xSUU5VUmxHNm5KMzJpZlkxWkZhM3ZPY1diN3h3Y1VGeVBCRCs5TVQ4MkdV?=
 =?utf-8?B?bktxL1lRU25oSUtVQzFFd2xzZlU3aEtQWXNYZGZ2aFQ3YVhhZnlMUFdlZ1Ja?=
 =?utf-8?B?RXZBU1hBTHBYeXhJcUovcTJPRTF4UjhpSmxyRGxKWW9DSnAyNEFjdkNlTk04?=
 =?utf-8?B?ZmlRRUp0K0lGR2NkSjNaRnR6ZXJrb0IzK051RTMyR1FaMzRuN21tK2FQdTA1?=
 =?utf-8?B?eEZpMXZpQ3dMdjF3V2FCdkZBTnlLOWFDVGpFQk82UXhBVTVpVFRiTGJJNmk0?=
 =?utf-8?B?djBFUVhPQ2Zra2xIaGFXQnhJOHQ1clRZOWxSZWp1bDExbDliRFZDU0txc1BY?=
 =?utf-8?B?Z09jd3lsNlU4UnFrZk84ZkJjZno1cVhjb1cyc25uOVJSOWd0UE4rb0xBTmZa?=
 =?utf-8?B?cFpWV3VGeXhXYWgxemJNemVmVkdDTFFrdlBZb3dGYjRRTWRsTTJSckxBbzd4?=
 =?utf-8?Q?2rIQAC2IJSrMMCAT7DIOIUs=3D?=
X-OriginatorOrg: wolfvision.net
X-MS-Exchange-CrossTenant-Network-Message-Id: ad556cf8-82f5-4a56-99fd-08dc62b40e12
X-MS-Exchange-CrossTenant-AuthSource: VE1PR08MB4974.eurprd08.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Apr 2024 10:07:45.0867
 (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: dLwuz9JRpZepJLbpBsIBJgxVyrspAxlnRZRCKcjKVGx2RBmcoLc8Ckfl7YMem6W8Oe/I00Q4vMxcYQhogjLObt+aEBQbCKKw1jlll31CX04=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR08MB7885

The touch-overlay feature adds support for segments (touch areas) on the
touchscreen surface that represent overlays with clipped touchscreen
areas and printed buttons.

Add nodes for a clipped touchscreen and overlay buttons to the existing
example.

Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Javier Carrasco <javier.carrasco@wolfvision.net>
---
 .../input/touchscreen/sitronix,st1232.yaml         | 29 ++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/Documentation/devicetree/bindings/input/touchscreen/sitronix,st1232.yaml b/Documentation/devicetree/bindings/input/touchscreen/sitronix,st1232.yaml
index 1d8ca19fd37a..e7ee7a0d74c4 100644
--- a/Documentation/devicetree/bindings/input/touchscreen/sitronix,st1232.yaml
+++ b/Documentation/devicetree/bindings/input/touchscreen/sitronix,st1232.yaml
@@ -37,6 +37,7 @@ unevaluatedProperties: false
 
 examples:
   - |
+    #include <dt-bindings/input/linux-event-codes.h>
     i2c {
             #address-cells = <1>;
             #size-cells = <0>;
@@ -46,5 +47,33 @@ examples:
                     reg = <0x55>;
                     interrupts = <2 0>;
                     gpios = <&gpio1 166 0>;
+
+                    touch-overlay {
+                            segment-0 {
+                                    label = "Touchscreen";
+                                    x-origin = <0>;
+                                    x-size = <240>;
+                                    y-origin = <40>;
+                                    y-size = <280>;
+                            };
+
+                            segment-1a {
+                                    label = "Camera light";
+                                    linux,code = <KEY_LIGHTS_TOGGLE>;
+                                    x-origin = <40>;
+                                    x-size = <40>;
+                                    y-origin = <0>;
+                                    y-size = <40>;
+                            };
+
+                            segment-2a {
+                                    label = "Power";
+                                    linux,code = <KEY_POWER>;
+                                    x-origin = <160>;
+                                    x-size = <40>;
+                                    y-origin = <0>;
+                                    y-size = <40>;
+                            };
+                    };
             };
     };

-- 
2.40.1