From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f49.google.com (mail-wm1-f49.google.com [209.85.128.49]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7CD08329396 for ; Mon, 29 Dec 2025 15:39:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.49 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767022774; cv=none; b=G12rozSUFThSIc2r+aanlc+7oxAKDTIur0tr6vqq+MbERTe4yv5Lji1KSrxb8mx6zQ5JigaJZdpZNtEJxaFkiIJ6CT4G+1tXoh/N5he9Wt80r3z3f0pKy87tMbdo/uXvHbqh6coa8Fx5uFssg+KvRCPcdpPmCzUIAf6L0chwEKI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1767022774; c=relaxed/simple; bh=RcDGedmXwSRUgRLTsRrQXPhrzcqVDmty+VallOtpd/8=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=U/f/uDmi5pSrVYtNZcx321FGpn2r2tLgxIyXIPBPlGNVfOfDnGa3bjzvsovxXhs+YhhzjtzW8JDgUOMzB8en9YviRNZ0d938hGWIZaqDMqNGntdoun1nkXoLVjA/xRIAzGOqpUZaZmw/ucSC8+rZkQDx9BI2DAu0RFV7fKpCV4o= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org; spf=pass smtp.mailfrom=chromium.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b=H73NCP0E; arc=none smtp.client-ip=209.85.128.49 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=chromium.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=chromium.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b="H73NCP0E" Received: by mail-wm1-f49.google.com with SMTP id 5b1f17b1804b1-47775fb6cb4so53363545e9.0 for ; Mon, 29 Dec 2025 07:39:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; t=1767022771; x=1767627571; darn=vger.kernel.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=SGYWl17fxV3/QSiEObh01QR9aeCd8OVP6SgH7H57To8=; b=H73NCP0E4n/FY1Kx285YMugsoVY8U/mFz5cVF0U06c7i85Nw/xDnpx2Vx/16uMVev+ QvLdBGUg6Aap+ry57wq95W7xVFXS2at+0gXp0QgI7iF8CEq8BJitlxIEMY7ZMaUHiZYj hsvFpRWFn5eqKqKgMOWejeQ0tPVSrIHhnvZL4= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1767022771; x=1767627571; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-gg:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=SGYWl17fxV3/QSiEObh01QR9aeCd8OVP6SgH7H57To8=; b=jsHA3VW8vtQPB+Mke2O6eUcaEcqGw5mJjn8YzL8X7D20ETUEQQobWjjAjLxbQHv6om QXKQw4KNpKbxaE16R2JEA2n3iu10J5WwtV0fPoZSHpedDwl5LaujvEp3sMA+hoqpSh26 cv4KpBtxPFPGeS5FbVcX7Scpk1bTf6Zoa9ZBleOAryL9BhWmqWAuULDyPkgrqUuUYI2T /0pVjqBr61HdyDGb8uIdcvLq6hyGRZwLT4TvfsjtKVbCz8MW/hg0W2xKw+nFKf/+sE7d 00j69w75qZ/lRcH7oHI5kwaQMPSr+Rb+tVMdormQn7mN6Je1T6wA4mpcIL9FsRR2vee6 s34Q== X-Forwarded-Encrypted: i=1; AJvYcCVC7mD0Mv8EDkxgMh9vLWcYTtoelEPvt6j3mDYMKoKhNDypNEM/FqOnPcwFwUwFseIVo8hXC/p+nRfFZhw=@vger.kernel.org X-Gm-Message-State: AOJu0Yzh2Az9DFgHWCs6ZNApBFqI8HBrVEkGSHA0soIwjw6woGVRVQNi zv1Q0D6RtHS+6mZ3oxpyWGOmPFnH5tw3RcYce+YKWYuYc6i2SXNtyvg8SkLZNwUuRQ== X-Gm-Gg: AY/fxX5aqOsdw0u1CSGfp2HZ8yaI/EeHYvQm2DLUP644vwogTnN+il7TxsK74Ux9L3K bSx4QSdRcYRNlb0DhhKKVWT1h/tVUeLLaEEvVDjPXlSXF8Fo8XDl+hXyy+VwuwTMl2u6aa0vmt3 4FoTGsz0a34ygO2FACwV1962TByS5JfsP4qz4A1oTsdsqgNJnPxOhrZeY0zHyvrW5kefH2ivH2I WleHphcbyGia0VnLhp9a0AP2onk89Uy0rjr/JGag02SHTMpglR2AmPBa7yFwN78ae+5mH9hkZc5 5effPoXiNI7tWlc1MtdvmPBvH5E8kkIRBsJ2cZY7S4m7NrC62FoXbz51PDMRE8g9qi7Zofj+O5v HDVFKd3IVam8k4KfgAy1kcSrtGh1HhqtCYCSQXzmcXuF53QhWCQGNAWTDJ4c/8xEPENSTw56qBk +pJ3rwrNbg8uZKZepI1g== X-Google-Smtp-Source: AGHT+IFl14WZKwhPmiisq47nhuqUJz7ve89LSx2Bze9QplnBFGeno8tXs3tel78LX13pZskSo/9nSA== X-Received: by 2002:a05:600c:4f15:b0:477:b734:8c41 with SMTP id 5b1f17b1804b1-47d19538dfbmr400115935e9.1.1767022770807; Mon, 29 Dec 2025 07:39:30 -0800 (PST) Received: from google.com ([37.228.206.31]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-43277b0efefsm29752839f8f.25.2025.12.29.07.39.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Dec 2025 07:39:30 -0800 (PST) Date: Mon, 29 Dec 2025 15:39:28 +0000 From: Fabio Baltieri To: Krzysztof Kozlowski Cc: Dmitry Torokhov , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Benson Leung , Guenter Roeck , Tzung-Bi Shih , Simon Glass , linux-input@vger.kernel.org, devicetree@vger.kernel.org, chrome-platform@lists.linux.dev, linux-kernel@vger.kernel.org Subject: Re: [PATCH v2 2/2] dt-bindings: google,cros-ec-keyb: add use-fn-overlay prop Message-ID: References: <20251224152238.485415-1-fabiobaltieri@chromium.org> <20251224152238.485415-3-fabiobaltieri@chromium.org> <20251227-laughing-white-dalmatian-f9d98a@quoll> <0c01fa63-670f-4c82-aa74-dc855cb12a78@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: On Mon, Dec 29, 2025 at 03:59:44PM +0100, Krzysztof Kozlowski wrote: > On 29/12/2025 14:33, Fabio Baltieri wrote: > > On Mon, Dec 29, 2025 at 01:49:05PM +0100, Krzysztof Kozlowski wrote: > >> On 27/12/2025 16:48, Fabio Baltieri wrote: > >>> On Sat, Dec 27, 2025 at 01:44:26PM +0100, Krzysztof Kozlowski wrote: > >>>>> diff --git a/Documentation/devicetree/bindings/input/google,cros-ec-keyb.yaml b/Documentation/devicetree/bindings/input/google,cros-ec-keyb.yaml > >>>>> index fefaaf46a240..437575cdf352 100644 > >>>>> --- a/Documentation/devicetree/bindings/input/google,cros-ec-keyb.yaml > >>>>> +++ b/Documentation/devicetree/bindings/input/google,cros-ec-keyb.yaml > >>>>> @@ -44,6 +44,14 @@ properties: > >>>>> where the lower 16 bits are reserved. This property is specified only > >>>>> when the keyboard has a custom design for the top row keys. > >>>>> > >>>>> + google,use-fn-overlay: > >>>>> + description: | > >>>>> + Use a function key overlay. This allows defining an extra set of codes > >>>> > >>>> What is a function key overlay? Overlays are DT term and therefore are > >>>> not suitable for bindings. > >>> > >>> Ok, guess I can rename it to `use-fn-key` or `use-fn-layer`, open to > >>> suggestions really. > >> > >> Use as Linux should use? Then it's software, so not suitable for DT. > > > > Sorry I'm not sure how I understand the comment, this describes how the > > driver handles a keyboard with Fn keys, the codes are defined in the DT > > Exactly. The purpose of DT is not to describe how driver should handle > anything. > > See also DTS101 from this year's ELCE. Sure so I guess this falls into the "describe the hardware feature" category, so is the suggestion to rename it to something like "has-fn-key"? That would be the hardware feature.