From patchwork Sat Apr 12 13:16:04 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?J=2E_Neusch=C3=A4fer?= X-Patchwork-Id: 14049010 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id ECA65C369BA for ; Sat, 12 Apr 2025 13:16:32 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 11B3C10E273; Sat, 12 Apr 2025 13:16:23 +0000 (UTC) Authentication-Results: gabe.freedesktop.org; dkim=pass (2048-bit key; unprotected) header.d=kernel.org header.i=@kernel.org header.b="iC8a/WC4"; dkim-atps=neutral Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by gabe.freedesktop.org (Postfix) with ESMTPS id 9A91810E110 for ; Sat, 12 Apr 2025 13:16:21 +0000 (UTC) Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id 395375C57E9; Sat, 12 Apr 2025 13:13:59 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPS id 98BD3C4CEED; Sat, 12 Apr 2025 13:16:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1744463775; bh=tVWlsHyHnXCIGSgizl8HG7hmSOJbp84SHZlXyFf90fw=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=iC8a/WC4yo3UI0nR+qdj4g9mJKJuSY3KdMM/puHRci2xFEhhKn+UIA1tIihfh0Vrk g87Mg2IRd0WuHbtTsf7/obAM44hE3Y21xcjLZqzSRaXU1m744l8hj8nx38fn0YpRa2 2Q+vRq9jZUF6eLjIqssRMVoTST99fRxF4uULxdmjbVcvqXbVYDBzrUys0CJZ9e+vYX JpqbGzka1Zm4Ia2pYuArzyOo2EHFdCoH94wflhO72zL9qky6LnBWWBbsbg8WwApLQ/ CduuWdars4/4ub4Bp+5YlfWxUHxGwnDN4MSG/o8DGpQIvnCm9aj9Lzk6DLyFdd+zJj sxX9SSrmCrrbg== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8ED57C369AE; Sat, 12 Apr 2025 13:16:15 +0000 (UTC) Date: Sat, 12 Apr 2025 15:16:04 +0200 Subject: [PATCH v5 3/4] dt-bindings: nand: Add fsl,elbc-fcm-nand MIME-Version: 1.0 Message-Id: <20250412-ppcyaml-elbc-v5-3-03f0e577139f@posteo.net> References: <20250412-ppcyaml-elbc-v5-0-03f0e577139f@posteo.net> In-Reply-To: <20250412-ppcyaml-elbc-v5-0-03f0e577139f@posteo.net> To: Krzysztof Kozlowski , Rob Herring , Conor Dooley , Miquel Raynal , Richard Weinberger , Vignesh Raghavendra , Krzysztof Kozlowski , Crystal Wood , Madhavan Srinivasan , Michael Ellerman , Nicholas Piggin , Christophe Leroy , Naveen N Rao , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann Cc: Frank Li , linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-mtd@lists.infradead.org, linuxppc-dev@lists.ozlabs.org, dri-devel@lists.freedesktop.org, =?utf-8?q?J=2E_Neusch=C3=A4fer?= X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1744463772; l=3440; i=j.ne@posteo.net; s=20240329; h=from:subject:message-id; bh=WvJoQK0edpJeqo++ZsYt3pS+SZc6YBUbltPH3xZQKbg=; b=ZlwLLrnr0tnVcUvMUkmKmZgmWUTcpmFXhK0evY0sU2YAfzQ+KWPr7Ghb7DGrYHdgyVPkEjTeW Nl3W6FN2QgOAF2xXhTWmmHy05LriYY32Tb0O27Jash1igxQHD2JFsns X-Developer-Key: i=j.ne@posteo.net; a=ed25519; pk=NIe0bK42wNaX/C4bi6ezm7NJK0IQE+8MKBm7igFMIS4= X-Endpoint-Received: by B4 Relay for j.ne@posteo.net/20240329 with auth_id=156 X-Original-From: =?utf-8?q?J=2E_Neusch=C3=A4fer?= X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: j.ne@posteo.net Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" From: =?utf-8?q?J=2E_Neusch=C3=A4fer?= From: "J. Neuschäfer" Formalize the binding already supported by the fsl_elbc_nand.c driver and used in several device trees in arch/powerpc/boot/dts/. raw-nand-chip.yaml is referenced in order to accommodate situations in which the ECC parameters settings are set in the device tree. One such example is in arch/powerpc/boot/dts/turris1x.dts: /* MT29F2G08ABAEAWP:E NAND */ nand@1,0 { compatible = "fsl,p2020-fcm-nand", "fsl,elbc-fcm-nand"; reg = <0x1 0x0 0x00040000>; nand-ecc-mode = "soft"; nand-ecc-algo = "bch"; partitions { ... }; }; Reviewed-by: Frank Li Reviewed-by: Rob Herring (Arm) Signed-off-by: J. Neuschäfer --- V5: - add Rob's review tag V4: - no changes V3: - remove unnecessary #address/size-cells from nand node in example - add Frank Li's review tag - add missing end of document marker (...) - explain choice to reference raw-nand-chip.yaml V2: - split out from fsl,elbc binding patch - constrain #address-cells and #size-cells - add a general description - use unevaluatedProperties=false instead of additionalProperties=false - fix property order to comply with dts coding style - include raw-nand-chip.yaml instead of nand-chip.yaml --- .../devicetree/bindings/mtd/fsl,elbc-fcm-nand.yaml | 68 ++++++++++++++++++++++ 1 file changed, 68 insertions(+) diff --git a/Documentation/devicetree/bindings/mtd/fsl,elbc-fcm-nand.yaml b/Documentation/devicetree/bindings/mtd/fsl,elbc-fcm-nand.yaml new file mode 100644 index 0000000000000000000000000000000000000000..91e8f2f9ff26da0f5a3f9bf276955ed32e9e7bc6 --- /dev/null +++ b/Documentation/devicetree/bindings/mtd/fsl,elbc-fcm-nand.yaml @@ -0,0 +1,68 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mtd/fsl,elbc-fcm-nand.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: NAND flash attached to Freescale eLBC + +description: + The Freescale Enhanced Local Bus controller (eLBC) contains logic to + interface with NAND flash, called the NAND Flash Control Machine (FCM). + This binding describes flash attached to an eLBC using the FCM. + +maintainers: + - J. Neuschäfer + +allOf: + - $ref: raw-nand-chip.yaml# + +properties: + compatible: + oneOf: + - items: + - enum: + - fsl,mpc8313-fcm-nand + - fsl,mpc8315-fcm-nand + - fsl,mpc8377-fcm-nand + - fsl,mpc8378-fcm-nand + - fsl,mpc8379-fcm-nand + - fsl,mpc8536-fcm-nand + - fsl,mpc8569-fcm-nand + - fsl,mpc8572-fcm-nand + - fsl,p1020-fcm-nand + - fsl,p1021-fcm-nand + - fsl,p1025-fcm-nand + - fsl,p2020-fcm-nand + - const: fsl,elbc-fcm-nand + - const: fsl,elbc-fcm-nand + + reg: + maxItems: 1 + + "#address-cells": + const: 1 + + "#size-cells": + const: 1 + +required: + - compatible + - reg + +unevaluatedProperties: false + +examples: + - | + localbus { + #address-cells = <2>; + #size-cells = <1>; + + nand@1,0 { + compatible = "fsl,mpc8315-fcm-nand", + "fsl,elbc-fcm-nand"; + reg = <0x1 0x0 0x2000>; + }; + }; + +...