From nobody Sat Jun 20 13:08:23 2026 Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 94FCE330652 for ; Wed, 15 Apr 2026 08:21:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.180.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776241314; cv=none; b=lvlm3oiFGjGCkAB5DJV4xWO3N1TjhCG8n6+frX848OyUcwuERJTKdlDmIoCMo3jIlcedXjNZxBz7c9c4ApIOIznbWzGb5QAWvSNGhKvwKobeFe35i6AIDLwQLh/UKtokf5bnVrQ4NeZ7kYma95jzbIiqw4QYE48mJKojfZGibl8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776241314; c=relaxed/simple; bh=QRV4MLHxKSpNcqM4BDf+UW00MmNeU+zesBUiRCyk4VM=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=pwq/nFsI39B3WQ5/hD31uvbLZLiBxT4H4RemxLXNfkDy+Wh+SpXgadQBP6OacsT2uPQskSyCasPMvbJaxLy0TMiARV9K3DIYBlzz1BUqa7j/X+x8L+00PP5r6ZvQaUqjuoroIhIntYpTYnzj0cfwEVvOciTUsGHr3loXIZZK940= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=Oj/6ZZKk; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=eJen0dVq; arc=none smtp.client-ip=205.220.180.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="Oj/6ZZKk"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="eJen0dVq" Received: from pps.filterd (m0279870.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 63F4CSI33126617 for ; Wed, 15 Apr 2026 08:21:52 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:date:from:message-id:mime-version :subject:to; s=qcppdkim1; bh=I0eqagUMBzZb/Qop6f7WgKx7bP7+THfDsWO e5fhJtE0=; b=Oj/6ZZKk7FvsHVVWJGiDc1oUwdFN9G6s5bNN+57X1IJIIRISSdZ v4ht5yl+6/aSuoTyhuSXNKpJm3EvXrkLbE6sBA+x0nbLVC/rNG4p5iTOc0sHKBhy sAY7l+4u5GchpFKQkaZv9e7wo42W2lRXWfanWbvgEj0AMSYbsXIA1hduBQKqrJ9f 9Sc/30l6njFK+VhHfm67zf/vkdzG5zWLukOA5omc03uf77f8CzBa1EpXcF6BjlTO 6Xowi2UuMpttqjxJ8FP+wYpA732GDeueACVZjkYwcC+uLNi+AFgePSzV5Mp+Syr5 1f9FsOV2uZyWmfqQd1RK7PucETA7Cg2/xGw== Received: from mail-qt1-f197.google.com (mail-qt1-f197.google.com [209.85.160.197]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4dht56td0t-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Wed, 15 Apr 2026 08:21:52 +0000 (GMT) Received: by mail-qt1-f197.google.com with SMTP id d75a77b69052e-50b4b81c632so101502261cf.1 for ; Wed, 15 Apr 2026 01:21:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1776241312; x=1776846112; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=I0eqagUMBzZb/Qop6f7WgKx7bP7+THfDsWOe5fhJtE0=; b=eJen0dVqJXJJQ1IyKSN7UHAqvmK49VMJ49QSvMwIULAmGkoF0vheZiDmHBTvZcBhhn wP9kMxZsh/Sd/cbzC1p263qc3LzbJRdSAKEFjUpzX6+dbjnmuPZ8rRfp36uYwIqVSMMs pWh6iyywkIGCopXHBbP+d4QOcLvdAKm7z+wGoedEvfa5Uhlla6EG8kQkykgR8h1AjUB7 YtExQMtcRjLV4S+9iXJRg1AeWDUFQpyk9teE9wkP/8Fsc6KM5cgCXGjOVrDmVpw8On/F nNl/hMx0ODuD41vvuWXvDN6DzXhif3U5Z18wgZXj1XhyGu/6HOs8bqymRFSlZ8aQkzdn ueiw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1776241312; x=1776846112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=I0eqagUMBzZb/Qop6f7WgKx7bP7+THfDsWOe5fhJtE0=; b=Hjp32Ec686JyLOTo6ncFblGfNX4o4z40u/j64ynJNrc+lWzOwxuKohCvFJ9vX5cX52 rRx4M5YlqX9lRlOjuB8QEbHaBSfwSP8rwtVf3KxFms8AZjoWWjJ/oMxL0jWLs0Ajt94m otsmGikuGEImsgt8OTrKTJdvlzptQGzWA1Z6VHlRi3AvFw2rAlw9JBEBA9Se4h6CieUg y+tpL3q1IFTmfy4p8zags8QXEH8wU9yMFXEqp6hiNt1EQlFnLf1EmI+r7Q7LBjV/4Mri ruqFngtbQM8YRtu87mCe/XVLuxhXEZ91pBiKkVWAj/pV5VNT+7zhRHL71TBxiJTZr2K+ SKqw== X-Forwarded-Encrypted: i=1; AFNElJ9F+9GLDCE+yJmfnd+Gi0WVxKbiIMRSsqzRznZEya6aJ9TiDY2T6hQRtLDwtEqkPbhFzqZXAQDylEO9Ako=@vger.kernel.org X-Gm-Message-State: AOJu0YzUEJQlH5AuUF0SNZZveU29H49FlEpzAj1BRWbDsndJ2/mtnWZD M8OEqMnQsAkYnR5J1sAjbF9+QWGoGi+WjV/zCUDYqn19biIBMquRxB3KSRsAcRySRzDxe3bbDt+ zQ7J2xf8jtS0Ve3VQ8sWoxf46hJQMCZMDKgsB6kN11BhYKQqEIS1+JcnjT/aYfTJxGoKFt31a5m o= X-Gm-Gg: AeBDievF8uO/Nf5NvezXJOgdaXB+Lz9qU+OigrByyw5BtoYJmFgBVIcwFLxEfflCdlc hVsLU1CoySTKLxGh3sxBTlstVZji1ukFGnXpunQr69iE0J5WHfvkC8qzXgQ09jFI7BpR6CjwxKb yPZVEScsp4dq9xiePqiJPBGjZTN/5NZEBhkix9cc/RQ2PAYf1coQN9iy8q+WKEqnEKAPkrxAOtH 426MQXRdhoQcDB3EPwavIhJohpLpwne43tu5+KvtCYNrrrCTVY9We3tsUzPrEkz9KLqf1T87nV+ pXhoiU4dlKsCrBdkWkvm+kKo2JSyQclw2b5atm2duXp7+I2g5JDW5JesbW4+oLDg4V5aZH+4xr4 nJrB/CHY4Cit+TfF4ThhmQ8yzK/hmeZUFaYnS X-Received: by 2002:a05:622a:24c:b0:509:2677:68f7 with SMTP id d75a77b69052e-50dd5aab64emr303838741cf.5.1776241311571; Wed, 15 Apr 2026 01:21:51 -0700 (PDT) X-Received: by 2002:a05:622a:24c:b0:509:2677:68f7 with SMTP id d75a77b69052e-50dd5aab64emr303838431cf.5.1776241311100; Wed, 15 Apr 2026 01:21:51 -0700 (PDT) Received: from quoll ([178.197.219.94]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-488f0ebd0e1sm14333445e9.28.2026.04.15.01.21.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 15 Apr 2026 01:21:50 -0700 (PDT) From: Krzysztof Kozlowski To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Krzysztof Kozlowski Subject: [PATCH] docs: dt: writing-bindings: Extend compatible fallbacks guideline Date: Wed, 15 Apr 2026 10:21:14 +0200 Message-ID: <20260415082113.22775-2-krzysztof.kozlowski@oss.qualcomm.com> X-Mailer: git-send-email 2.51.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1654; i=krzysztof.kozlowski@oss.qualcomm.com; h=from:subject; bh=QRV4MLHxKSpNcqM4BDf+UW00MmNeU+zesBUiRCyk4VM=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBp30p5mBuRVBsm75haPO57WuvBG3SRGoHHe/bYh hZdlMqGMsiJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCad9KeQAKCRDBN2bmhouD 16WcD/9KdRDL5BEuBDX6uUevh6nOyhWdilO4PVAczQp1ENTFj+9EyLHVux7xHudi1uVkBOTf5xo BxK1MmvqosCBX2xSFVxeXEssP6ERQ0n9n+FX1mbotP2wNhdcIv1OS7279Kx5tDSlzSLakRyO5Zb 71LHGQq3ARKsBUZS/zHo7byjoZ0BwwKByMsE2mR5STvdTOlPnsEcM/LdZe8584WqLdQ/t3oOj1q bpiQYBuGXBnjgz2V9CwvSATNUR3higzGICIzLUanafLr8fuDIJtn0f4Efq5Zg1Z7kQMWZDTZIz5 km7x91NAt7NsJ7B8JFTB81mhiOyXrHL9AHD/iCiKTWvPcpH0T5utrZoO9T0OhUUHu9ESBGZsBaA qPr2d20hQ+dcWYc3abTy1YIBGfUWHEVZ1amlPbqElEHPIXoLYT08xtNb73IqujXNXYG3uqKb/G4 sn7xKE6n20CV+fdlUp4MUftM+KC2OBAP3KJLwbHzbLl1Iuxbw1bGjRPpPFXA8e5kOACgfYsiVhH h1RhBXZJM5sohYwyNOw2Ofky2TdMH9RY9OGVRjOVvG+dQSan1bD+H46rXeXsUIU++DTO0nCE+0O lxYAqctWTitkNgOwZrH45b+38Ys9mMGuCTD499hlU8MWu17njU6pAzIBQkh5vQ776xb6KEbwNxW qv28Yqp6O/GHkKg== X-Developer-Key: i=krzysztof.kozlowski@oss.qualcomm.com; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B Content-Transfer-Encoding: quoted-printable X-Authority-Analysis: v=2.4 cv=LuiiDHdc c=1 sm=1 tr=0 ts=69df4aa0 cx=c_pps a=EVbN6Ke/fEF3bsl7X48z0g==:117 a=gOEeR9iKwsj33Yj5oN/cWg==:17 a=A5OVakUREuEA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=gowsoOTTUOVcmtlkKump:22 a=EUspDBNiAAAA:8 a=YRjzyCTZZ4-ze7UGkugA:9 a=a_PwQJl-kcHnX1M80qC6:22 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNDE1MDA3NSBTYWx0ZWRfX0sqGWrYqR6QB mv8XPGO/MSMfvr19JkllmpryOZkYYRFpS43NirUJblq5VVFi0YD4ZYT0Gj7SjWD6+VU3Cvt1yPJ cNfTaoozC8lnIyIAiL3K/hjTtmcKt/2TOeFrfDaKptVXidvQ9FyRfDj0aoxbS2DTZyjG1k4s6po Tv5RWhcHonIdDXs+8gvjU3zBxjXA1z5BgYbbkFrzai5yODpmYcsEH7P2QgIimpjbAeSjrQRsTpM EbCVu8vJbBqAHEqj/40arXxS/Smn6GP3DW8WIcjqoJRhxleo6CUWQEjkVtItw9l+o8NoYnI3B+1 Uk2TaN7mPeaJherPpvAATNGEe/XLH/CBfEq5fM4AgFwfBfhQdVi72RhspCn66GDMEMRjjcaNqtF 2XgeCLuv3EJm2l0MZvjSjoTI9QKELwti63WU1ZI5FFmge+6xJgXnTCTiSSAQmH1jur3oHa6lyF8 cMAtMyd2edI9uw+RNRA== X-Proofpoint-ORIG-GUID: qHNKDLT3condnrJfGYfGvUvH8EmnttkO X-Proofpoint-GUID: qHNKDLT3condnrJfGYfGvUvH8EmnttkO X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-04-14_04,2026-04-13_04,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 bulkscore=0 clxscore=1015 priorityscore=1501 adultscore=0 spamscore=0 suspectscore=0 malwarescore=0 phishscore=0 lowpriorityscore=0 impostorscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2604070000 definitions=main-2604150075 Content-Type: text/plain; charset="utf-8" Extend the guidelines when to use fallback compatibles to cover to common review responses. Devices are most likely compatible and should use fallbacks when having: 1. Compatible programming interface, meaning one is a subset, and Linux device drivers can use the subset to correctly match/bind and still operate with the subset features. 2. Device variant discovery through some means, like registers. Devices are incompatible and fallback is not suitable when that fallback cannot be used by the drivers to match/bind. Signed-off-by: Krzysztof Kozlowski Acked-by: Conor Dooley --- Documentation/devicetree/bindings/writing-bindings.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindings/writing-bindings.rst b/Docum= entation/devicetree/bindings/writing-bindings.rst index 667816dd7d50..03e29e2d50af 100644 --- a/Documentation/devicetree/bindings/writing-bindings.rst +++ b/Documentation/devicetree/bindings/writing-bindings.rst @@ -53,7 +53,12 @@ Properties - DON'T use wildcards or device-family names in compatible strings. =20 - DO use fallback compatibles when devices are the same as or a superse= t of - prior implementations. + prior implementations. Fallback compatibles are applicable especially + when sharing a programming interface or when able to discover the + variants. + + - DON'T add fake fallback compatibles when software cannot use such to = match + and bind to a device, and still operate correctly. =20 - DO add new compatibles in case there are new features or bugs. =20 --=20 2.51.0