]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
docs: dt: writing-bindings: Extend compatible fallbacks guideline
authorKrzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com>
Mon, 27 Apr 2026 16:07:40 +0000 (18:07 +0200)
committerRob Herring (Arm) <robh@kernel.org>
Tue, 5 May 2026 15:40:08 +0000 (10:40 -0500)
commitcdd5ffcec0dd8320969623e3acd36811bc05852a
treee78aeb9e4ee4c7c93af538d9acc271587b3c3078
parent63353810c08499476efc1e1e85ca7b8e33d54ef7
docs: dt: writing-bindings: Extend compatible fallbacks guideline

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.  In the same time
commit message should clearly explain when the code suggests devices
are compatible, but the binding does not define them as such.

Acked-by: Conor Dooley <conor.dooley@microchip.com>
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com>
Link: https://patch.msgid.link/20260427160739.175451-2-krzysztof.kozlowski@oss.qualcomm.com
Signed-off-by: Rob Herring (Arm) <robh@kernel.org>
Documentation/devicetree/bindings/writing-bindings.rst