Received-SPF: pass (google.com: domain of linux-kernel+bounces-30858-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1;
From: Javier Carrasco <javier.carrasco@wolfvision.net>
Date: Fri, 19 Jan 2024 08:43:35 +0100
Subject: [PATCH v7 3/4] dt-bindings: input: touchscreen: st1232: add
 touch-overlay example
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
Message-Id: <20240119-feature-ts_virtobj_patch-v7-3-eda70985808f@wolfvision.net>
References: <20240119-feature-ts_virtobj_patch-v7-0-eda70985808f@wolfvision.net>
In-Reply-To: <20240119-feature-ts_virtobj_patch-v7-0-eda70985808f@wolfvision.net>
To: Dmitry Torokhov <dmitry.torokhov@gmail.com>, 
 Rob Herring <robh+dt@kernel.org>, 
 Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>, 
 Conor Dooley <conor+dt@kernel.org>, Henrik Rydberg <rydberg@bitmath.org>, 
 Bastian Hecht <hechtb@gmail.com>, 
 Michael Riesch <michael.riesch@wolfvision.net>, 
 Jeff LaBundy <jeff@labundy.com>
Cc: linux-kernel@vger.kernel.org, linux-input@vger.kernel.org, 
 devicetree@vger.kernel.org, 
 Javier Carrasco <javier.carrasco@wolfvision.net>, 
 Rob Herring <robh@kernel.org>
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?utf-8?B?a1Jya2VJVmN4bGY3QkZDc2dQZ25GYnZKNWpYc1VJNWREY2U0aUxsMUdIektG?=
 =?utf-8?B?YlBFZlEySEkxTzltV3gyK1NMV1NVUUZTQ1pWT2dkYlZ1dHdyT29ZdTlTenM5?=
 =?utf-8?B?QUxwZG9DejAyQmhuMzlCdEVYYWVsbE9Lbk53UHQ1VWl0NGpBeGZVSy9EaERN?=
 =?utf-8?B?Q3p4Vkw4SVZCa1ZGZjh3OHpWNTdoS3VYMHY1cVBEUm1qeE50aUY5MkVBT3ZS?=
 =?utf-8?B?YW9EclhDRVdiRkNBNzYrSkRHVjE5TWVKRlRNUDcrVTczcmJuV1JTaWw0WFZ0?=
 =?utf-8?B?U3A4a0JrSG5qemtEWnFyUC93M3dTdW52ZFhLVldqZ09NdW5pMURId1VzZ042?=
 =?utf-8?B?L3AyRVdtWjhpRTFJOS8yRTkwY05sbGFuTVdiWFMrbkVYV21nd25ZU3cvLzhn?=
 =?utf-8?B?dDRuUUU1dDE5RzJ3OTI0T1NiTU9DR2dQcTdUTjVtU0NZb0htclRlZVdJWTM5?=
 =?utf-8?B?WTRqaGdFNkxJN2RldHhJQXJTTlZjdFNtKzBtdmlIOVRvOHlrUFRGMVRETFJn?=
 =?utf-8?B?MGdrSGVYbERGS0RseG1VdVhJd0IwRGtESm04Umd1Wkw1cFliVkk4S2wvMGNO?=
 =?utf-8?B?YmxObXoyV3NidDcyZFI4MFVMSXFMTWY2NGFvLzRjTFFmWHNiSFFtUks5emxQ?=
 =?utf-8?B?SGJoenJTc3hzeHJRei9LUnBheWl6ekxMV0ZIclh5UG1BRXVLV3dGSlpTZ0lO?=
 =?utf-8?B?VU9xdnJMRE9qSlJKYUIwemhDa0lWNU5rcEt1cGJsc2RzOHlUbDNiYU5tMkNk?=
 =?utf-8?B?N3pnTmpORWFhTW41VmdrWXhpa0pZSHNJY3o4WlAyWExKWUJraUxtMEFaYUVO?=
 =?utf-8?B?dEF0U0t1NytkUkpiL3lXdk5tUmljdXRGWmhOK1kwUGFoMk1Fdk81NzJCYmow?=
 =?utf-8?B?aTVnSTNXRjdYTVpUekppWVkxRnVUUWU3SldBWjdFaFRjRmNMeUlxQTZTV1RL?=
 =?utf-8?B?U095WDlsMTdjZTI3U2RqcSt6VFB2eVE5R0NwZkxubVNyam92Y2RiZDZQem1n?=
 =?utf-8?B?cUZGMFA1akd5TnA2UDl6K1lPZHBtYmtaU256U0JYOXZKSTdLRGwzaHpSUThk?=
 =?utf-8?B?TXMwS3AyUVlkaVBuUlVWcEpLOWNqWWJMRFZyYmxFdVhja2NkTk1qY3lzRTFE?=
 =?utf-8?B?aHNLb2xyV3lRSS9kUS9BNExrM3hxT0U2NkE3Qjk0SUZRbURKbGoyMFlyaVl4?=
 =?utf-8?B?M2wrdktyNWZOM2krV1FDNU9xeUxpWmN2QlBwT3lSNnUxSXE5QTluTWdQaTZv?=
 =?utf-8?B?bU1qMURFdVN5WnFnQ3h4cFliOEd6ZjVNa1dYN2Z1dHZSeDFrS2hpdFl5am1q?=
 =?utf-8?B?dXRuZXozOGJkVG10SWRDakZRRGFLQi9qMWt3ZlZIT3BVUUJlc3dXcHg3SU9l?=
 =?utf-8?B?NXdPK0d6VVFabzNaMFV0alQ2UVJ5ZTErWkVvZ0dQclN0bkRyVFU4S0tUajB2?=
 =?utf-8?B?VHgwL3BBY1FsYVhsSUNicEV1aUhOemoxZXN4UG1zUUxXZ0lGSnh6eSt2dWlT?=
 =?utf-8?B?OVJZdGlCRUdxLzA2NjViZVo3ajNaRHlCT2xYaExhRml4Nktaa1R1MXpWejNx?=
 =?utf-8?B?MnFQalZxZyt1cUFlQ2xlRFN0bnYyWnptTlNrQnErOGxydUh4cGdQWEdXNE5C?=
 =?utf-8?B?cHlsZVZJTXVlNFJUWjdTdzMwcG5yYmNpS2pab1ovNWVFTWREZThiMDR1bGph?=
 =?utf-8?B?RExrcTZRZDY0cThJREpzc2w3WkExT2psZmh0c3h6UnkxS3IvU2hsNXNiVm9k?=
 =?utf-8?B?Z1NTcE90Y1hZc0xWRE5ycXhTd1VtS2k4MjI1MnorOXcrczczNlVWVEVVSkNM?=
 =?utf-8?B?UkZjeUlNQzViTithcVU4WEpObStQSjlsS29YUGNLbFgyRWxoL3hPVFZ4Z0Ez?=
 =?utf-8?B?Q1dEblFRYmZLWDhOT21lUzRKMjhSeVNMWnF1aHQxWlIyZHFyMDJwUi9sUGgr?=
 =?utf-8?B?TXN6ZGdrU2ltZ0R5bGo2TWNpZ0JyLzM0RURqMnFXN2x3QVZVMSsraTVxaGJ2?=
 =?utf-8?B?SEZBKzJJVHVlck9ZS0VhMDhqVVJMMnYyMzJpWDBhUEJlZ1hnTmtLQXoxQndi?=
 =?utf-8?B?alBva1MrUXpLRXVkZm5UWHpJWUhYMFpPNys5Z3BhMktyQkdrZ1RTc1FaVFpV?=
 =?utf-8?B?VmkzYkoyRWNubnpUTGgyV0JJMW0rcmY5dlljMkVleUpmS3M1UEZGQUJXZjNa?=
 =?utf-8?Q?8TEgwxIuHCnN5cOmfAywOxc=3D?=
X-OriginatorOrg: wolfvision.net
X-MS-Exchange-CrossTenant-Network-Message-Id: 06261025-8dfb-4479-745d-08dc18c25b8d
X-MS-Exchange-CrossTenant-AuthSource: VE1PR08MB4974.eurprd08.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Jan 2024 07:43:41.9516
 (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: ODHvnXwe3NbhSBlIs6uQ7SKj5PhSjGut2v0kiB/80dwjGG5A+rbt5Q2W2FYWqg13OAgT+HfRqNOKOdddk5NnyqXtuZLdCD+OtnuYaiIQs+A=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM8PR08MB6578

The touch-overaly 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.39.2