From nobody Tue Oct 7 06:50:56 2025 Received: from mail-wr1-f51.google.com (mail-wr1-f51.google.com [209.85.221.51]) (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 AC1491F94A for ; Sun, 13 Jul 2025 12:46:48 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.51 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410810; cv=none; b=kSHneI1a+GQjbCUuK8kCN0FwTit2sUshxb9OvlbibL2E07vsbbvPEDndqqVRuQTj0FTbNtzWKOB6P4ITraxUuHzWcMndVeSAKAZhlf1iFeFr6bZr1kRHX0ALSI7tl5sDYuLUshvVNkmOK2ZXoufOR+xUKUdWUMINnAHZLSi7uuA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410810; c=relaxed/simple; bh=EFnV+IT3WMLvWKBJ+A8tOlHnCxdVYxzgQhUY+USgsKw=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=sMOGZukBYU7EqD3guVeNwSl2XUA5yC8LztOI9wEe6xb0smn0gqszPqLYdeU/5CbJyXs9Clk2KnQZTckJp9P+CMOHMrus68ScsZExbNDFgRg/aesgIgi3tPpVYycupLU0gRywurXSiOfZI6SlwX8c1KxZybw2AmYx6iQTiZ+8bM4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org; spf=pass smtp.mailfrom=linaro.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b=ekAYtfPC; arc=none smtp.client-ip=209.85.221.51 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linaro.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="ekAYtfPC" Received: by mail-wr1-f51.google.com with SMTP id ffacd0b85a97d-3a4e62619afso363538f8f.1 for ; Sun, 13 Jul 2025 05:46:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1752410807; x=1753015607; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=tsHRmEegKuDd3kJrHQl3Yy7EUVWyybJ3UX6f6F6mCeQ=; b=ekAYtfPCK5OPml+S/E+zJekFl92eHzRR6pbL49JSU1KCZBoUGA+Nrk23cAWQXZvK5t Vm8UWVaYJCqzLsicYA24exZAK8FpMh+XpNi3vah5j3L3wSfLwggQsFSPV7k+1a8gJrZl E3eRXOkP1oadlZ4Pp2WbXD0XnGNjwKfEIRT3a1xCr3sXVqTgtqVZnYU90XWknY/ddJ0W UcGq8ALabXJSgOb7xKKWHDTk9LnN5Ztge+gzCxqWxeAkBmeH0zGf7YCcCKQetC5n7COI GevGUDH81orG9IZjCX13WbhnFPycqveI4rerr72MHWasV5+LrEcj7fv5cyUceawl124R gHAQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1752410807; x=1753015607; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=tsHRmEegKuDd3kJrHQl3Yy7EUVWyybJ3UX6f6F6mCeQ=; b=Lcpe/XBtdKbFctwtxahxh8jjV2xWVKiiOtnzns56+zszzRRPeU9onIU8YeV9y7vbwM 3e0YgnCyPgJG6I2XakNAtanuhEGIPGgGjeh2nS/KX5enYmwbKof75iWBpjwKvHeqfNze HQJp0kBeMs8cMTXbfCbAiiyAtzqxLou3k+7WpZUzMrb/J9eBF5ckZ8PUOcNlcT6LbmrK qfNgiwGZ7GsEhG9AI0K/eAc3msAIzyGTeRXk00L2+S2b035HQNwFI9aHyZy78Pf7VGYp 26LI9E5lAQWTkJWeHx7m1Af/mgHW2OFf8rls49rTFK+BNFFucW6YgHn/gNJJ7xzVHCRq khYQ== X-Forwarded-Encrypted: i=1; AJvYcCV7IqvICpWqUO5KkbpRUjXYzwTqo2VlOmyy2lLGdMoe7hTQrK9OuZTeKNpYfpObTVYXgf6HfFesJrNq2yI=@vger.kernel.org X-Gm-Message-State: AOJu0Yxr/cwUD7zoFlZNcP4+jy42h/IDB/wTxiIuglddIP+Nkd3oPmgR /7mMZfC9HEZ4Z6j7mapBDMG3xlF5nQ7wA5VLcsV/zI/P3MKxuIHP+Ia/LVeJhpzDm0c= X-Gm-Gg: ASbGnctLZWhcSXScLQdiR3Pa3x/qp3SvKqFrPk1rbQAvLAm6HBCskWPASv8nfn9AL4n QFreydjQeJJmkMTVV56zGCs9NBnuKXksGuxfiFpi5qqbXIq5rnlKLBdREuWb6ovjZYXnxxCDS0f DES+l2Ad4bJVRM8e0jTXdPbRU2YTZSm16TEJ6MPbBP2rVGhSMr4tdr9JBONy0KoklrJrg5T8lt4 1mAO385m75a2gaM71lQ4sWZc16ESOc1RBorSkUkn8AhA+t7EutrrhSNvuvKkouGvGcoGhgnMeAG YsOnj/L/PhqLLRYu2WlHJFmMmyJwOlN2KfEdsnSViEDEIFo5xPenEYhxfYoMftwSwouzK0uaq+3 veFWwuNyUWT9FDBmCpNXvqNqu21JkNZT2R/yxnDirp+pAHoM= X-Google-Smtp-Source: AGHT+IFTstnrjdXM4TS5/Iksr3hAwMqkve0ZmV3EsyB4JGAGxrnN82uit9Rx/A34hGD36CuTf2kvdA== X-Received: by 2002:a7b:ce02:0:b0:456:c48:4907 with SMTP id 5b1f17b1804b1-4560c484c3cmr10560765e9.0.1752410806902; Sun, 13 Jul 2025 05:46:46 -0700 (PDT) Received: from [127.0.1.1] ([178.197.222.89]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b5e8e14d07sm9828835f8f.66.2025.07.13.05.46.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Jul 2025 05:46:46 -0700 (PDT) From: Krzysztof Kozlowski Date: Sun, 13 Jul 2025 14:46:36 +0200 Subject: [PATCH v2 1/4] docs: dt: submitting-patches: Avoid 'YAML' in the subject and add an example 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="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250713-dt-bindings-docs-v2-1-672c898054ae@linaro.org> References: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> In-Reply-To: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Krzysztof Kozlowski X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1995; i=krzysztof.kozlowski@linaro.org; h=from:subject:message-id; bh=EFnV+IT3WMLvWKBJ+A8tOlHnCxdVYxzgQhUY+USgsKw=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBoc6qweJaWH/TRT931L8OZ38HVdqa8pjCZqhxSK /dwLKoqIzqJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCaHOqsAAKCRDBN2bmhouD 1w/2D/95B+NllypkDLynxCCtdYG3KNi7EV7jEcL2XGFI47cF18YE1rv8vkPYdzt821JHMphrirn 4E6wnuFVigP7GY+RIOL4xAOOJRmXeIr+eLy7SmOREQb+BjDwCx7afe65jcvHapznbSNgZ45xN3F j1WIJou3TnUsJqoDDnI6FdNF0yv66y4LeBRa9SJjgca/KfMBwQhP417LabcHQ50CaGJEm4iVTZB zPsFi6+9pbvGgdRfH15MUeS+iyZqSepuqGZTQSQLn2OwUHofwGL6UbH6/MTjzgCMC6tqdozNL49 yAmjRjuSdhbHv9K/oIzF0ugpMJ4OieTCOuBiJaHsppLX16vOWCW8xAVuCHYObelbUONprkaGWSL riuSJ0jHv8OQ6UKlPwlXcTXTCdswYQL+rNdzMQqi3hY58GYZnea8oNzWpqhJID39ljAXytFuruE xTx1/9hNF+Z7v8xU/5pDl6nyyjX16bprT/5LBIrbtZYuyUkVlWtAWy39pr3OxZwQ+caPkjiJjIV 284GtX/1MYcdavKP4sVCojmhYRAcEAHEz9Vbmv3Ql8uVd2bO+70MvIdu7+aqOBC4EmcNIZvbsBG 4GzWeMMGgC3MxsGILY+eZyhF2RMCvCCMN2xMEowYRrVjiLPLsKsli3YBJlbjUGdchKWhpIafWWP 1BhvRlv4HYjoKHw== X-Developer-Key: i=krzysztof.kozlowski@linaro.org; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B Patches adding new device bindings should avoid 'YAML' keyword in the subject, because all bindings are supposed to be in DT schema format, which uses YAML. The DT schema is welcomed only in case of patches doing conversion. Effectively people get confused that subject should not contain anything else than device name after the prefix, so add two recommended examples. Signed-off-by: Krzysztof Kozlowski Reviewed-by: Conor Dooley --- Changes in v2: 1. Rephrase - use YAML instead of schema, add another example for conversion. --- Documentation/devicetree/bindings/submitting-patches.rst | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/Documentation/devicetree/bindings/submitting-patches.rst b/Doc= umentation/devicetree/bindings/submitting-patches.rst index f3e23e69a6389e7e5d8db66af5060978ecff8a9d..46d0b036c97eb531dec95ef5226= 1988d3bfa3aad 100644 --- a/Documentation/devicetree/bindings/submitting-patches.rst +++ b/Documentation/devicetree/bindings/submitting-patches.rst @@ -21,8 +21,16 @@ I. For patch submitters ": dt-bindings: ..." =20 The 80 characters of the subject are precious. It is recommended to n= ot - use "Documentation" or "doc" because that is implied. All bindings are - docs. Repeating "binding" again should also be avoided. + use "Documentation", "doc" or "YAML" because that is implied. All + bindings are docs and all new bindings are supposed to be in Devicetr= ee + schema format. Repeating "binding" again should also be avoided, so = for + a new device it is often enough for example:: + + "dt-bindings: iio: adc: Add ROHM BD79100G" + + Conversion of other formats to DT schema:: + + "dt-bindings: iio: adc: adi,ad7476: Convert to DT schema" =20 2) DT binding files are written in DT schema format using json-schema vocabulary and YAML file format. The DT binding files must pass valid= ation --=20 2.43.0 From nobody Tue Oct 7 06:50:56 2025 Received: from mail-wr1-f54.google.com (mail-wr1-f54.google.com [209.85.221.54]) (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 A2CBE22FAFD for ; Sun, 13 Jul 2025 12:46:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.54 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410812; cv=none; b=W5nvi9FP2BY4Y9H8khK3ToEcEFmHPx/5shPxF/1WWsjHe/qi6utnRBkeysvwetecijVw0DtTwsZWX0MxfGqkAgNsuKfT/ly4WbrPvLL47Y8tdEE6OO1pJLTmnou3vJlvUvv534XS/vBwP/Cmo8Mm47InBQPeHXZwBOX3Jc3/n7Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410812; c=relaxed/simple; bh=BlRvIRPzQQPUtCo+mAvAI8qOIImTdfvDN7bB+4kLIBU=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=hfl2wVQH3qtBORdgvVT9vkP4BqkwkIpgC21UsSEz4o1h8dOspsd/H1ztyIphi20HVSSzMesmExMwJww283YRcJzJJkhDNE/IgTQ7AXOE2WF0NjaHRxYxaFZV1hJe0Gx5bA5gG5+u8fzYAQbS1eozm6bpMT6mKT4aRJ7RhjZZBEs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org; spf=pass smtp.mailfrom=linaro.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b=y44pprNR; arc=none smtp.client-ip=209.85.221.54 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linaro.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="y44pprNR" Received: by mail-wr1-f54.google.com with SMTP id ffacd0b85a97d-3a524caf77eso406297f8f.3 for ; Sun, 13 Jul 2025 05:46:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1752410809; x=1753015609; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=XoZqNCvU/s4oHuYCydia6erGgc5X35yK1qc86vp7sCA=; b=y44pprNRPmtCZ6UkBpPZgIISN6bXIXiG5GdDO4RDjHK4Mu55Tj38zHP9qQocdNLL9Y o0xB4shAZOh80VbzCO60y6nxWEFSjhgtdVf3Ui0MEq2aDvJVMB6nwfYGqNvMTEuGvALO fo35OHpQfZrmFIF0iF4OEpBB0Jh7clp63KqW4MaocWHExgUDBorX17FP5slA2SYG7itd wdU5AFJ6FZKGRDjV0PRfzm7k0bw7tofRghreCoOG1AEBNfwY/KF2LkwHaeIcABTTZPVs jTlVM7YCMeHMrT8boiXn7LkDijyQfb7zO0qLS3KA+pZN5tqkIyM+Rsn6MFZNuuT65kiy JOTg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1752410809; x=1753015609; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=XoZqNCvU/s4oHuYCydia6erGgc5X35yK1qc86vp7sCA=; b=mMPXJXuN9usOamlZWcvYp/AtSeGuF8WxuKs9oFGwJ7nzusYhvH+c/ZBsKeEjb4np1M Q3BjY+2fGoyBaJgbgcXZphMa1aZ9jY/We6Aw5iKdizzkkCfr+duJIAaV/ZS/BKFSRZEX 5USjGDlcUp4x9uENtmFKU0J3Rfb9pCPaI2vXn4Tr/qL6M5acnG/PeavwTwfw18A0A9L3 Y7fYXQJ3nqYyyyElbGuGrgeExKxp8ZfZjSaEOpWzQ2fh2kWMJvk5TOQRl2eTIX40BtJd jiI7bMf3gVoiwv6IA+L3rLeWpRq2L14VkGeuN7LIJBFKRBpqCcyipGvy+J7mVC3Ni2+L ouXQ== X-Forwarded-Encrypted: i=1; AJvYcCWsBBchz8SSn9scHOFIsGHINKf8jA/yuP8+VgDnGLfac9hGFnVkxe62n1qAq2xbvFcburTv/BkKnAloONo=@vger.kernel.org X-Gm-Message-State: AOJu0YydzmoFR+fd7uVBoAQSqYc/43fmUmMcXBXuDL7pLclu7AOywphE /YIU+U7MEE88o475DSpUQ3T2AHoufPEyzzeE5o+moycCLe2svy13nAiIotsAOwACt/E= X-Gm-Gg: ASbGncs+3sR9lL3zN1Se1ZpYrmL+kSnhfLSb0BjiyoB0sSE5+9hZGxK/Zs+Rmf1LTD9 gxaHv6kp7LOJYWGus5qRcdMLWg8Os+0jmPWYHEsJXfsaAKYKmAoiFScmnTnKOKJBpY0bR+s2tns nFBbcyNqGuWKl2I5L5qK/nmDq/M8fuveuif+99Er2YG4JisJScO4SCern69ICm1rwENOPfFpDG7 p6/1bEVBk9JfqZd5hpB8sYrWvoSOpsiyHWnasphphXOm+kecFXMC7A4DkOn/ONuC3G8aSB2HG63 NdZNmqYRwsivk0aspePw/hFNBnhgfFtpR3sXwWjFdk4kTJKtZ8OVo2lhrq9nyA75r8B6q5niZcH mK7gHM5MyqYE6GZ8cZMnBcw0lGyoTrs/hQOuI X-Google-Smtp-Source: AGHT+IHAdIehjkYMlljSMzvvs/ySAlhEufMHsbD8ELSnM58asHwMaFX0gPfWp0eh8n5jJOi4cfz2JQ== X-Received: by 2002:a05:6000:24c6:b0:3a4:f744:e019 with SMTP id ffacd0b85a97d-3b5f19000a5mr2744926f8f.16.1752410808920; Sun, 13 Jul 2025 05:46:48 -0700 (PDT) Received: from [127.0.1.1] ([178.197.222.89]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b5e8e14d07sm9828835f8f.66.2025.07.13.05.46.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Jul 2025 05:46:47 -0700 (PDT) From: Krzysztof Kozlowski Date: Sun, 13 Jul 2025 14:46:37 +0200 Subject: [PATCH v2 2/4] docs: dt: writing-bindings: Document compatible and filename naming 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="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250713-dt-bindings-docs-v2-2-672c898054ae@linaro.org> References: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> In-Reply-To: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Krzysztof Kozlowski X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=2195; i=krzysztof.kozlowski@linaro.org; h=from:subject:message-id; bh=BlRvIRPzQQPUtCo+mAvAI8qOIImTdfvDN7bB+4kLIBU=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBoc6qxdV1Jq3JU6x7/ASYUlf69jDirm6DevtMGD LzbGveV35WJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCaHOqsQAKCRDBN2bmhouD 1w9LEACZor9MqYK3td8tiLCfJTxAZB+9nEXg0jBC/cKOwIsjA1fwzePixOo+eRo80wZnl/aQNVR yo2wFYpRGXCBTqOCC/etQ4GEr4VFg7M1KP/llGv1t0SW02rX+gHfpZQwJ5zU+uHqVG6y0/HM6fE om49GcCgRIXNzkPFlAmpSjA4yM5i/RCe9tjyldiCd+0/h/gb42tPEYWKUVhm92Bd0a9VVeQd/Ys EY1rn8lereCB1IVT73FqCcygkM/ZoNg1vdBFyFflS3rZkCM5R05LOKxZ3N5EQ/aWJoGbF4kZap3 JxiU8BJtyK8/QvxeC0CMHuSPn267r2sr1spsJO7EceoGpc2Df8x6SJFaEKAwNvvWunC+PXSqa4u zheDrc1ctKYp5WBUDKKJj0EYg+h0LDS/shhqojPihtRDkQB/PVoXCRNsupfRU4XvsyCjkr6xy18 sIDNMINqZcUzIKr0rukacY6Yr8M8GheJacSxB9CXr3MJNQqVRyrM4iGA0sCWOHlVHSxPckc0AdH isGiFfIEJ9bL1lN82vPZLBVHwbWea0vbBF2uAN9PtzwtopTBAmLyE8aKd7TxE35H/U21jqga6yy b2QyReCgx8AdbF+/ozF4OC/oOUxotABaV2u2LaGq6AUgaa3buIHwgcJ6NU9dLMCQK5r3R5cfrkz NpSeJpm3rbqP4yA== X-Developer-Key: i=krzysztof.kozlowski@linaro.org; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B Document established Devicetree bindings maintainers review practices: 1. Compatibles should not use bus suffixes to encode the type of interface, because the parent bus node defines that interface, e.g. "vendor,device" instead of "vendor,device-i2c" + "vendor,device-spi". 2. If the compatible represents the device as a whole, it should not contain the type of device in the name. 3. Filenames should match compatible. The best if match is 100%, but if binding has multiple compatibles, then one of the fallbacks should be used. Alternatively a genericish name is allowed if it follows "vendor,device" style. Signed-off-by: Krzysztof Kozlowski Reviewed-by: Conor Dooley --- Changes in v2: 1. New patch --- Documentation/devicetree/bindings/writing-bindings.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Documentation/devicetree/bindings/writing-bindings.rst b/Docum= entation/devicetree/bindings/writing-bindings.rst index a2d2afd099c0bd922cf12dcf49f5dffe6da748f1..e63de88385b5bc5859d8d9fca82= bcf30380f3e73 100644 --- a/Documentation/devicetree/bindings/writing-bindings.rst +++ b/Documentation/devicetree/bindings/writing-bindings.rst @@ -52,6 +52,10 @@ Properties fallback if appropriate. SoC-specific compatibles are also preferred = for the fallbacks. =20 + - DON'T use bus suffixes to encode the type of interface device is usin= g. + The parent bus node already implies that interface. DON'T add the ty= pe of + device, if the device cannot be anything else. + - DO use a vendor prefix on device-specific property names. Consider if properties could be common among devices of the same class. Check other existing bindings for similar devices. @@ -101,6 +105,10 @@ Typical cases and caveats - "syscon" is not a generic property. Use vendor and type, e.g. "vendor,power-manager-syscon". =20 +- Bindings files should be named like compatible: vendor,device.yaml. In c= ase + of multiple compatibles in the binding, use one of the fallbacks or a mo= re + generic name, yet still matching compatible style. + Board/SoC .dts Files =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 --=20 2.43.0 From nobody Tue Oct 7 06:50:56 2025 Received: from mail-wr1-f43.google.com (mail-wr1-f43.google.com [209.85.221.43]) (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 9700C277CAB for ; Sun, 13 Jul 2025 12:46:51 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.43 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410813; cv=none; b=A5b5FGwWbzYhqL73qF8zXq+e/EUDfXaMmRLTuSS4UgcxMSmDAN9rIXs6XgYnJeXgR2+bfZmJ/FRf4Rc5PwOhY7CPhVG2i6Y0Oqm4JBOqwoXHhjvHGD4zx6SWR4skOF+GrqqidgGqNZXrK4jJ+MRBXbBsr/h1uWYRh0wUwkQRfRQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410813; c=relaxed/simple; bh=8+8q0TMkDrtQtBtz0e5m92VGQkAbRgRxfKsnC+FyYTI=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=NqJRuvkIK7ljI+LVaXtLUzZ+Bac6Hfq3Pg+LRZkzyrEjs5+yE0k4+QecGJx8oC4ElAeht0pcQId/APEcKMkjnRKfkiA/M58q9KPm1cOH9lYbudDsHyIEKfebk53VAahamutdhNiI5mAtP5v3HDhc8fMUcXNZktN2ANSncrl4rKc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org; spf=pass smtp.mailfrom=linaro.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b=LnNGdb3R; arc=none smtp.client-ip=209.85.221.43 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linaro.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="LnNGdb3R" Received: by mail-wr1-f43.google.com with SMTP id ffacd0b85a97d-3a4eb4dfd8eso518461f8f.2 for ; Sun, 13 Jul 2025 05:46:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1752410810; x=1753015610; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=d1rMgC0VMbaAfL3THU5TCdqj9Xtp4wVUUntbOLnCVCk=; b=LnNGdb3RG5MwaNknbya/fs8+fIX+b8txUbTydpqwjeGBncgybthptrePhAxaX7dfDe LQqDbyZVoNiDPHPudwRY3LIBmlf7r8pGhcQ1QFHAKKmtI+aDiDX1PJCuLunkzM8QWvpD uPad40LF/N8BKpiRkxonc57nDSbtXinC27VMtsruCi1s3mHSeF0NIaJGOdPmEFHIttFM RNl8G59a60Q2L7v+4cEcqspCZAhMPzRHGiCAbYDQSDwtMCNCaLbXaonok3uV4fT80yZd HiNRnAmaxE/y6iH5jkedMYG7qLQ9afuzJUVhZ6JrSokHDdvkSh59fefW2qqprUdhvJhn 3wOQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1752410810; x=1753015610; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=d1rMgC0VMbaAfL3THU5TCdqj9Xtp4wVUUntbOLnCVCk=; b=UWO0QordZJadimZT/SEeja9u4AbbU2FQsDlAeVBiAVPtXKiC6Dy1AFK4hSyVh1eufu t+50reZpsSi+bv4AW93fHZY7gPsSdiaknPFwjRxn0n8KiIr3GIRhGUQ2arVVWG81aMq9 PsRY9MjMR7H6gW2ty8SkUn6LKwIjNO24shG8v49FJTsqgVWcLbWuVxPj/QAi1MTXKGle nWzO5aB78e6hmNs0xFHrHb1DRuKvf5SbSEXD0RAeTcXw6DGDQODQVG/LKFGsasKsWcyy sRnOeYqlvn8yZiBJybQSq7QneTmcjVoGwBDrhjNkPybC4cDJIBZhO5+G0yz1mErJdwNA KpzA== X-Forwarded-Encrypted: i=1; AJvYcCVW6qDHzsKWl52hCipmsv580bsyIaSMnPeR21x1grtBq0h67w6ZQnHad7ZvdVFw1qA9NlTSMtkltv/8Sis=@vger.kernel.org X-Gm-Message-State: AOJu0Yy161SlRz/SIv+VhBsDTfsSz3Y/UNFXrQALOSNeImQ24GsJBlNM lxw5A7bMYEjlVVzYHwIuaOV1xCLYk/iFaw5lC4sXBZOyaFAPrtIoVgtGxVR7r18zO3E= X-Gm-Gg: ASbGncvSVT+1sRHruMYFzlpktRu3CZhxRzDAY0hzWhAmd3MeL3aeYnkavpb5tMI/xOv bDUmqu8m3QmkZ7tZIGLEtSdIQwjllwVAHgOE9q2BupvlPa7K9C+g7GkPD9xyIOHMkku7lsECI2h kXctLX66wlnesPugEivCEayRXfFFtkTUwVVBi/PVpo5RgWQ94TkgZYlao8sDm5023lZHYnfEbg8 8zd1GQGlt1QdFecm3z1jEy1ARYXCr+M5i5NdxVUFFWOv23+YswDyRMUTeslY2M03La1Bn8q8Faf ksn8BEb2E+US0I2V+U1RH6UWNLbDzfXW8t2dp930S/NvYQSWqk4zNV+gHpnX2wi6u3Dakg7S9J7 YW2tEHDTtAGsB54myfJgXqrY3LrEuu+ImZNnT X-Google-Smtp-Source: AGHT+IHaPHlWTSX+HVtAn7Xx/hnaszgxvaM9uH+nb4rYb4IjKeSKjda1vzmB9UQGeEweEBfQgVcBBA== X-Received: by 2002:a5d:6e5e:0:b0:3a5:8934:4948 with SMTP id ffacd0b85a97d-3b5f18938eamr2656161f8f.12.1752410809915; Sun, 13 Jul 2025 05:46:49 -0700 (PDT) Received: from [127.0.1.1] ([178.197.222.89]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b5e8e14d07sm9828835f8f.66.2025.07.13.05.46.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Jul 2025 05:46:49 -0700 (PDT) From: Krzysztof Kozlowski Date: Sun, 13 Jul 2025 14:46:38 +0200 Subject: [PATCH v2 3/4] docs: dt: writing-bindings: Document discouraged instance IDs 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="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250713-dt-bindings-docs-v2-3-672c898054ae@linaro.org> References: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> In-Reply-To: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Krzysztof Kozlowski X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1535; i=krzysztof.kozlowski@linaro.org; h=from:subject:message-id; bh=8+8q0TMkDrtQtBtz0e5m92VGQkAbRgRxfKsnC+FyYTI=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBoc6qyCthLocNJQbIsZVbkfPwRi1FLjbJ+aith9 8x1drxedr+JAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCaHOqsgAKCRDBN2bmhouD 1wNqD/9ub0sicYrCmP3WZ1VimzPPYjPAiOvub7BaBmtUAN2PPN+BiF3aC3u8pfJTWHq1ZITJWNa /NXKDNjkBMGifuGveIenMGPNY/VD0m4MRoAw5wpN5CkYpG3MC5cLe4n5Z9D/HaU8Mwuu9LpDbfk dYKFIvmWSR/GdbrMKIRemSr6Olmk22zzRcMPYZkR7Oj0TMCpKNJapaM97bMVFzakq0hHEJPgPe4 WjlMoVwERd+Nsw56j3e1UEwSRahjY0XKlrZO/P50J5Dee9z2DjXeXv1Q8F8z1mSUiZYspZcceWw q4FPtABI6y3CB1HOjONIrUmrX33ECC9uPivKzGCUTXshYIuRBgH9N2DVH4kbDUgJQqCvhg0NnRC t9Hx1HT7j57pmV3+tGbxFb0Roi0yqCvIXbhFVwNxY9cFFKjSeFm3gZeWDNAamTmRhsGlP8A0cty HX2+99ebJEVLyllb/Q1ImCXBzLp23cJU+4AfH+W7QlsvEeEqsyYN7hOP1iJLipOYt4XGQh1vQP+ r7s2/9l41qxhP+IQcKbqFdnm+p0xvvuqiJrioZ4IH9fRVRRhdMCGJqXIDHgIUDgkIFdJAYpdFen +Ns7M6Knhzc3PGas1tLpNk/4gmXd4wIMbvXRyd4VORCSIt3tcGLemm5LTxhx9MIN+KW6WhDq5Wv WTynW0gB9h+7dZA== X-Developer-Key: i=krzysztof.kozlowski@linaro.org; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B Document established Devicetree bindings maintainers review practice: instance indexes, either as properties or as custom new OF alias, are not accepted. Recommended way is to use, depending on the situation/hardware: different compatible, cell arguments or syscon phandle arguments. Signed-off-by: Krzysztof Kozlowski Reviewed-by: Conor Dooley --- Changes in v2: 1. New patch --- Documentation/devicetree/bindings/writing-bindings.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/devicetree/bindings/writing-bindings.rst b/Docum= entation/devicetree/bindings/writing-bindings.rst index e63de88385b5bc5859d8d9fca82bcf30380f3e73..f8e0293a7c0621a343a493d4486= 24bff916ba021 100644 --- a/Documentation/devicetree/bindings/writing-bindings.rst +++ b/Documentation/devicetree/bindings/writing-bindings.rst @@ -105,6 +105,11 @@ Typical cases and caveats - "syscon" is not a generic property. Use vendor and type, e.g. "vendor,power-manager-syscon". =20 +- Do not add instance index (IDs) properties or custom OF aliases. If the + devices have different programming model, they might need different + compatibles. If such devices use some other device in a different way, = e.g. + they program the phy differently, use cell/phandle arguments. + - Bindings files should be named like compatible: vendor,device.yaml. In c= ase of multiple compatibles in the binding, use one of the fallbacks or a mo= re generic name, yet still matching compatible style. --=20 2.43.0 From nobody Tue Oct 7 06:50:56 2025 Received: from mail-wm1-f41.google.com (mail-wm1-f41.google.com [209.85.128.41]) (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 AE3A8278E41 for ; Sun, 13 Jul 2025 12:46:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.41 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410814; cv=none; b=BGiMgba8V4vB86KWmRgLmAiQclv0ZSAR8ChOgOHY4rnqqhrI1F7JgFOnvfP/RwSSpA0fuyLGkWA/iGgeTwiGRpHhulQdyVQ+3kJtiVS2BbFbDt64c/5ptv/bhko9qjJDuQ/ahxNt4yXrGqqaYQabGQceds/fEzbyi0ugD89GUGA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752410814; c=relaxed/simple; bh=BqgMniJzXKHilP+gLbSufcUqZU/KB3aXiupUf7qYDNc=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=YEkUNZhFLrL9F9k7DygSmW3pnOYGRDGorJiEOdT9SL8SZO6sZO2zOL2vozGNWzgVWiIKNXWcStBWFtK6oDlxj1ML6g5EFoScqYp2s8ncjoBOEYfDHIfO5aTaTKfSK5myyOZgVDT7jM4iXUQniOH7tAS1pDSUdEMioQ24q8dJYWw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org; spf=pass smtp.mailfrom=linaro.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b=b/cxjQ8a; arc=none smtp.client-ip=209.85.128.41 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linaro.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="b/cxjQ8a" Received: by mail-wm1-f41.google.com with SMTP id 5b1f17b1804b1-453486940fdso1545535e9.1 for ; Sun, 13 Jul 2025 05:46:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1752410811; x=1753015611; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=1ZOhfEEQtJ+jgJyLH84T3pMg0aDqoZmTteF5gFJWLNM=; b=b/cxjQ8aaYcxOx44l+vx8e2lD7oi3bgFkwtlYRJOsfjaDTGjsncXOzmYF/B1D/zM8Y 4ivR3i6QA6d8KhVxjsJJLpruKpKDDxkRaWEDbtdkyEtl6KlQU1XjeMRrpsj8yKh1WBWI LmMMXTzdYeLTUprFB8aOMeQhFQRAic3i1rF80+afNQTgkovgsGSNIi9YSFFrhuBgyNI2 yV4bcBpqbrkhVwYonSr7jOGBRbcOLUzhhurjxvC3Cmp66Cln4sCn+azO5UAOCXGH+nPA QUhBq7wGiQ14oBuE8dFHs4RbuWFqyZDSDrKgbPw+KZbHlMObGrfLUhrovAc2ePpAENz0 KRfQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1752410811; x=1753015611; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=1ZOhfEEQtJ+jgJyLH84T3pMg0aDqoZmTteF5gFJWLNM=; b=UKasFm2yV3zdRQexJCsbDXtFhR1XCTxvUJ4SJrsY5wfoOEgK6rluWzm0B+T97Vw02S ZVaa26y0pc4oay0RzFLqCFblEl/oSYRwQCrr9oWx7LEOJiB2A0c+dycIA18IATjCaVwx zWr9Zo+rK5B6smYtRo56TB4l5NNidjvuvJsVXIuliHrsi7hpbrUiK5YT1yZTrG/AD7tu FmqlXa3hUDfKUS/mNWUfR5QbiCqqT48BC50JYejr9Bx9Nnnb6BU0vIXSwdQcuT7FO2z/ MbNNmE/pRAzaP8yKo9DyDOLlxC2kC+gkN8yFDekfwQFkCZ7UXqWdngIzqKWZ9gnFLeCg A/jQ== X-Forwarded-Encrypted: i=1; AJvYcCU4GntfJJqKCmkNcBFxuILCqJ/o/9/dOB7+7lS7cm/Mk33ZoO5ste7JEcxkFZQECSP4dSNtoMk5MeqW9Aw=@vger.kernel.org X-Gm-Message-State: AOJu0YwY5Yg6l/a8SSkOF/ymFAJpsKj9bw12tNiJKvhJmwVci0ScWCcF EBwYUVZ0Qy6WAcHuFt7SmIiq9Y/wBTu/U1ib5JKHGBXfv0zx1OlTrBNUGoqwgnt2F2780GDhsDy tiIFc X-Gm-Gg: ASbGncvyVjIVWjtmVJlxBaTQDH+TEz6xXfkP0nB8sSjNgBktQJp7TgS+qFqllXh2BNg gpPMzHS10bQpPL+K1TKOFTkIKIg6rIcqrTfo0br5uqrA8x32sg+KIFOaXp+DOwdUUhvkFvblUt0 ww1yPxk86MlxiL5Aa55TmPcihksr7vj2TjCeysBV3ZEzvjMrNVWWI9qKEcV0+frRoNGM+7xQWJN jeetARpf/CX8z5hHhoFun2POsnDncPiuaLS0zd7YFR5KPVTjufamstTXfBR43pJO6TMT8QfqOZO Q2hyJhX18p4ETaXHfS5YLGL73t7PlY0uNN52YkZnZ+RMVEGLZ28ISsS+AY3A4HI32nmeSku26gT A77iRSLQxJ8ryKr57PLLmtW9/CvIgS41bDzop X-Google-Smtp-Source: AGHT+IFDcj6Sh7lolDAY0YGgJLGzZQLGX4fgdNN48lehGlCHMBeaV5pjO4JrzbzdR7GheeQ7xR258w== X-Received: by 2002:a05:6000:2285:b0:3a4:ec9c:fb58 with SMTP id ffacd0b85a97d-3b5f18e7c75mr2709558f8f.9.1752410811008; Sun, 13 Jul 2025 05:46:51 -0700 (PDT) Received: from [127.0.1.1] ([178.197.222.89]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3b5e8e14d07sm9828835f8f.66.2025.07.13.05.46.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 13 Jul 2025 05:46:50 -0700 (PDT) From: Krzysztof Kozlowski Date: Sun, 13 Jul 2025 14:46:39 +0200 Subject: [PATCH v2 4/4] docs: dt: writing-schema: Document preferred order of properties 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="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250713-dt-bindings-docs-v2-4-672c898054ae@linaro.org> References: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> In-Reply-To: <20250713-dt-bindings-docs-v2-0-672c898054ae@linaro.org> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Krzysztof Kozlowski X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1057; i=krzysztof.kozlowski@linaro.org; h=from:subject:message-id; bh=BqgMniJzXKHilP+gLbSufcUqZU/KB3aXiupUf7qYDNc=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBoc6qzSV9Mj4UnRnIQ4TJbHafuWWw66jH/SCDOa EYwfKFQ/JOJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCaHOqswAKCRDBN2bmhouD 1wczD/99LVY3VXTPzYKevxZTkK3TGnkeXgWlwmAhZN9Cfhxum3paVCH7vlKplwvN4R8DlYeq/zh YrBiQyDJpRzWCRMJXakkaOHf275IjMM2XMkjpQHMRVSJRrXRrEucUIbkd1lumzVcXw/m6xhx5ec nbPHVeHsP5EmrevKa4k1TJcNeJmu2R7MD6NzpIbpCHq+BoBP3cxjYcg20vhHdAaIrNb9TruA42+ w0NYRQbOrZuTVUm+N5Ei1nAzTZxb3sY4ayKPM44cb2KZXURSUtioQh0twUIZW/DDyMwKRb2/xyw WJhYY5fDEiCDk39Wo/s0f7P3kADiyq8c9woj1BWuHSK6d7dxcnCrKhVyczBACJo3WPMeJqYGyrQ 79cK+DEhQTyDpwRFbKPu7Y7S7M2T3m76HVXx9+k3S401YJzhh+Q3jDHNQ8g4UKmT8Qz4fMWQP+J IGQt3JxYYfKHNx1MevbcurR9bVIRk8TK79N5xcADNomDYasOlWcmannOD9E09TufQpU0x8kiZHR /5to7QBc+4Rq/T/gZQr2jeZohkFzfg9JJ2tz+Qhf2pb1eWqEp9m36Vm7zMdWhdwMi8B6puhm3tI rAxxbtUZMZJPiFktZjXNMzfYxE7Ij67PLjbRgOjmgYkVmrZuz/+zd7IOACyCGtdO+b20+MYvRsR x+vQXWLXJcDobqw== X-Developer-Key: i=krzysztof.kozlowski@linaro.org; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B Document established Devicetree bindings maintainers review practice: using DTS coding style property order in both 'properties' and 'required' secions. Signed-off-by: Krzysztof Kozlowski Reviewed-by: Conor Dooley --- Changes in v2: 1. New patch --- Documentation/devicetree/bindings/writing-schema.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/devicetree/bindings/writing-schema.rst b/Documen= tation/devicetree/bindings/writing-schema.rst index fc73072f12fc58dbaf3dea3eb8cc79cfac0341c8..470d1521fa174f4fac29004b95a= 9b1a8c37071d9 100644 --- a/Documentation/devicetree/bindings/writing-schema.rst +++ b/Documentation/devicetree/bindings/writing-schema.rst @@ -171,6 +171,9 @@ Coding style Use YAML coding style (two-space indentation). For DTS examples in the sch= ema, preferred is four-space indentation. =20 +Place entries in 'properties' and 'required' sections in the same order, u= sing +style from Documentation/devicetree/bindings/dts-coding-style.rst. + Testing ------- =20 --=20 2.43.0