From nobody Wed Dec 17 23:30:23 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 C27F61F542A; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741901747; cv=none; b=OJRMSROu8cf4Jd4FgJV7csI+x2OtBqV0ZSiQYId5UPv2hBbZTv/5CxubKeuDkl1AmK6FEkH0cpBUHFlMBbJ72aOoWwPfaATw1DuAEaCRuqEfOagf/2V4R2qV2k5e9M0NBO5AQ8PJNDw1uaUyVnisYLLl7GEnhVvnlCF3Ucz5sMc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741901747; c=relaxed/simple; bh=29z3wRwOCbrYFJhrHEd02uoJUqdaA1ekxWQFQrQotpk=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=i0QyzTlyR1LXrYZasuqwg3KIBtqr/0zX5T+CMud7AsdCb8Av9pXb3rYxFaVDn8YYHQ3y2UyCr0oNtmXHkOevTeU0r7x93H0jeGFzg8fvxnI7rulEtCvzPwca+L2ZkDBMlGfY1QfNDz22yZrjLoOIfCWiXOVXKlapTSoK8thXr0A= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=qi8Mb83D; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="qi8Mb83D" Received: by smtp.kernel.org (Postfix) with ESMTPS id 4A823C4CEEA; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1741901747; bh=29z3wRwOCbrYFJhrHEd02uoJUqdaA1ekxWQFQrQotpk=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=qi8Mb83DPQcxOwpJUpOwU451pOwTebiNJrgNeBrTpA63J83AZg30QoQcIkQYSfrhv 46oGohIuYsvQic6z6AfrPaIDD684kHCRjF/2Q6zh/DwyWZ9nQGcDY73lFKEF1puK5C rc4O09wp5+NkrwsqZ+WbZuQuF1r0OH3OXnZ2e1FhAO4R2MFrpJvx8ji9yDK8T4Qe/D sUfecbB+ZCvXjKxAzOtJlbGd2ws4t3OdbrNWJNJ2/F7UKnkeHILWUU5rGL4kklMg4Y t8+hERQzWu5cl1c8EiM+K4dmXYpJo/A07MJpBneXJ0rSfTr8m/ylv198gPXsR9oJ0f NEOTN5yFg+buw== 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 3075AC35FF1; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) From: =?utf-8?q?J=2E_Neusch=C3=A4fer_via_B4_Relay?= Date: Thu, 13 Mar 2025 22:35:44 +0100 Subject: [PATCH v4 1/4] dt-bindings: mtd: raw-nand-chip: Relax node name pattern 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: <20250313-ppcyaml-elbc-v4-1-55903722d9ea@posteo.net> References: <20250313-ppcyaml-elbc-v4-0-55903722d9ea@posteo.net> In-Reply-To: <20250313-ppcyaml-elbc-v4-0-55903722d9ea@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 Cc: Frank Li , linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-mtd@lists.infradead.org, linuxppc-dev@lists.ozlabs.org, =?utf-8?q?J=2E_Neusch=C3=A4fer?= X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1741901745; l=1483; i=j.ne@posteo.net; s=20240329; h=from:subject:message-id; bh=yPgY1z7mg/3dcZuzAQmURU+bDX68s9E0YWQYCk73u2A=; b=TiGBn5/omWDqmmLaDYByMyKwn3FP8MKFA347zo4v6yuRXDARcPhBHg/qDZ7YtYAYDRNFvDA0h 53muitjhV2cDO/0YZJ+D5+FcGeK2zPgVfVIqJHclzEtsmonRa/ttpQ9 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?= Reply-To: j.ne@posteo.net From: "J. Neusch=C3=A4fer" In some scenarios, such as under the Freescale eLBC bus, there are raw NAND chips with a unit address that has a comma in it (cs,offset). For reasons of compatibility with historical device trees and readability of the unit addresses, this format is kept. Relax the $nodename pattern in raw-nand-chip.yaml to allow such unit addresses. Unfortunately $nonenames defined in bindings that reference raw-nand Signed-off-by: J. Neusch=C3=A4fer Reviewed-by: Rob Herring (Arm) --- V4: - reintroduce patch to silence dtc validation error, after discussion with Rob Herring and Miqu=C3=A8l Raynal - add some more detail to the commit message - remove unit address format rather than extending it (old pattern: "^nand@[a-f0-9](,[0-9a-f]*)?$") V3: - remove patch after discussion with Miqu=C3=A8l Raynal V2: - new patch --- Documentation/devicetree/bindings/mtd/raw-nand-chip.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindings/mtd/raw-nand-chip.yaml b/Doc= umentation/devicetree/bindings/mtd/raw-nand-chip.yaml index 092448d7bfc5ccd246ca4b2341464e18722a2d51..d655f6673fc31b1d9ee7cd734cb= e1d310f88090b 100644 --- a/Documentation/devicetree/bindings/mtd/raw-nand-chip.yaml +++ b/Documentation/devicetree/bindings/mtd/raw-nand-chip.yaml @@ -25,7 +25,7 @@ description: | =20 properties: $nodename: - pattern: "^nand@[a-f0-9]$" + pattern: "^nand@" =20 reg: description: --=20 2.48.0.rc1.219.gb6b6757d772 From nobody Wed Dec 17 23:30:23 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 9CEB12AD22; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741901747; cv=none; b=ZZoNkuI/w3UtFzM72Cjl6NYWpoWOU6EpgAZb+9kyBxNLa3pWHyv9b254irTJZs7RT6HcpXekNikS6Q1IJ4YlxcvVLsyL+es2Fyf7FtcTGShmXyeiSFv1oks5j/egZ/5Tp69t4+wqY49bBwJoyAoCjOhh66KPpElFvzphGfUq1kc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741901747; c=relaxed/simple; bh=6jT7E3dszeoggTWfBvp5Ah7Bk+esnWTVsyo2RUzuXeY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=nj7/lomD5tXvdbMb2ezr+jvxwlzq8WAKEVMT7KB8ptgoZioN3Ao/9rDSIVvhg0f46HDTdtJf8iONdyDsDcIjTYqHSszgeScWEpwaK8r+vkNdRpKgPThv5UvUbKFYh5EGebVaow3/m9e06h1z0pTfTABETluMXoFZKmMlMSZUQho= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=lAgXyM8b; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="lAgXyM8b" Received: by smtp.kernel.org (Postfix) with ESMTPS id 50B8EC4CEE5; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1741901747; bh=6jT7E3dszeoggTWfBvp5Ah7Bk+esnWTVsyo2RUzuXeY=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=lAgXyM8bqhkLfV1VkAiUtvDuwN9EfxEjA44VgoGzD8Qh9aMAaTZv15+KjP/XGL6I+ blmU8GiIAlmPQD2CKmWE42tgBfvZEgMYvCpfsCl6ehT+xROnlb6JQtsfxbJMtnj3K1 T2KBiaJd7De3zKIbjADB+2TrjrZw4JwpUA9z0W1ObjU26J3gjEwJqrkrkcRgNLKfh/ nzMN/PaIErScaA1qk52SEY9jlx0TsMBrWGHASK5y+92FRYklF0akTbjcQhLz5wfYVP G+4IN4xsNwU9h1FpW3H/IV33pWjg+A3YLgndw5Cs/b2n8N79dW/IetTgSU1G43IocU azqKqeNPJasSg== 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 3EF55C35FF6; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) From: =?utf-8?q?J=2E_Neusch=C3=A4fer_via_B4_Relay?= Date: Thu, 13 Mar 2025 22:35:45 +0100 Subject: [PATCH v4 2/4] dt-bindings: memory-controllers: Add fsl,elbc-gpcm-uio 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: <20250313-ppcyaml-elbc-v4-2-55903722d9ea@posteo.net> References: <20250313-ppcyaml-elbc-v4-0-55903722d9ea@posteo.net> In-Reply-To: <20250313-ppcyaml-elbc-v4-0-55903722d9ea@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 Cc: Frank Li , linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-mtd@lists.infradead.org, linuxppc-dev@lists.ozlabs.org, =?utf-8?q?J=2E_Neusch=C3=A4fer?= X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1741901745; l=2466; i=j.ne@posteo.net; s=20240329; h=from:subject:message-id; bh=GqmRkAlOewBuTl80Xuqu1vck/4Qgv6V5ggfAWvSwWKQ=; b=wZeK9XEU61C7ky528WxfxleojI3r9yrM8qUzgijGXLV4l9QQ4TjOLOv5yUDEA4CBKOtuWtlnT HTOsyhSE2xTBXvX8GopYmSWIBsRpEmgSPf795+QssgqqpNTNNRkl6Yq 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?= Reply-To: j.ne@posteo.net From: "J. Neusch=C3=A4fer" Formalize the binding already supported by the uio_fsl_elbc_gpcm.c driver. Reviewed-by: Frank Li Reviewed-by: Rob Herring (Arm) Signed-off-by: J. Neusch=C3=A4fer --- V4: - no changes V3: - add review tags V2: - split out from fsl,elbc patch - add description - remove "device_type" property - move to bindings/memory-controllers --- .../memory-controllers/fsl,elbc-gpcm-uio.yaml | 59 ++++++++++++++++++= ++++ 1 file changed, 59 insertions(+) diff --git a/Documentation/devicetree/bindings/memory-controllers/fsl,elbc-= gpcm-uio.yaml b/Documentation/devicetree/bindings/memory-controllers/fsl,el= bc-gpcm-uio.yaml new file mode 100644 index 0000000000000000000000000000000000000000..381584b400a0ad98c6d9e0b38f2= 877d44603ed84 --- /dev/null +++ b/Documentation/devicetree/bindings/memory-controllers/fsl,elbc-gpcm-ui= o.yaml @@ -0,0 +1,59 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/memory-controllers/fsl,elbc-gpcm-uio.ya= ml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Userspace I/O interface for Freescale eLBC devices + +description: + The Freescale Enhanced Local Bus controller (eLBC) supports flexible acc= ess + to memory devices, through the General-Purpose Chip-select Machine (GPCM= ). + The purpose of this binding is to designate devices attached to eLBC/GPM= C for + use by userspace. + +maintainers: + - J. Neusch=C3=A4fer + +properties: + compatible: + const: fsl,elbc-gpcm-uio + + reg: + maxItems: 1 + + elbc-gpcm-br: + description: Base Register (BR) value to set + $ref: /schemas/types.yaml#/definitions/uint32 + + elbc-gpcm-or: + description: Option Register (OR) value to set + $ref: /schemas/types.yaml#/definitions/uint32 + + interrupts: + maxItems: 1 + + uio_name: + $ref: /schemas/types.yaml#/definitions/string + +required: + - compatible + - reg + - elbc-gpcm-br + - elbc-gpcm-or + +additionalProperties: false + +examples: + - | + localbus { + #address-cells =3D <2>; + #size-cells =3D <1>; + + simple-periph@2,0 { + compatible =3D "fsl,elbc-gpcm-uio"; + reg =3D <0x2 0x0 0x10000>; + elbc-gpcm-br =3D <0xfd810800>; + elbc-gpcm-or =3D <0xffff09f7>; + }; + }; --=20 2.48.0.rc1.219.gb6b6757d772 From nobody Wed Dec 17 23:30:23 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 ACB891F5425; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741901747; cv=none; b=P7ZTOdel1Z0Y55OdgeLM8+DgQyrZU1mPZxfoH5U8/7s0HGIPGzrge53fhEq35TEZfUN+UmTal9d8+kHEvMk8lpAbkpn2q4dlrJn1Rtg56uDcYj9YzVk6xZbbgQCc/y/DcXT+2tG3CGOy/QvqDuSYqa/g0vJ87csweck00ZLoNwI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741901747; c=relaxed/simple; bh=N9vjOO0ppP0Y2mdFuJUbpBLs8pEFcObKLSdjXsIWfMw=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=HipdC9XBpe0WdxiVvI/b37JvU7HA2Sy3J73lFsc+J2BsdDiDByGSK9iMaoc8EdZbf9bvsVqeIflGUF7qDWEx2eK7yWb0skTTXawKYy7h6MbCa4lwfrFnlxoR8B/mfJzPt9lJuWyrJEL3DAfisaERIzQDF+zuaTaH0dvk12IqVOA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=noqCH8N/; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="noqCH8N/" Received: by smtp.kernel.org (Postfix) with ESMTPS id 5E616C4CEEF; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1741901747; bh=N9vjOO0ppP0Y2mdFuJUbpBLs8pEFcObKLSdjXsIWfMw=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=noqCH8N/bx1mUQjnBXRnaVuZD5iVgUmz18QmQBioCf0PHuKzYJbUN/DQLnWTuog2o IbJfpCmRc645H/03pMaAkz2xHre1ZFt6pO9cXfeZ1ww5NgD9wFTR9Z1CExr01aNGJA +e60svISAgYKnyNrt62iDXDo8zaMxb8+wX9AZkWvvFCLuav8zStJC7Halx+T7pOUU4 l3QeSeyPcpAsCC5KV8ruauvO3rUTmVzQogUyVkQRYvsSueXCSzVZdOF0M7+yre8KFd DIJV3RmHnI/CsfSTXQsMg5C+i2jhvWTlDj+Gu68C9iuoHoUBzXn9CGg0LiWaF2ixMv NBCWU5O+8raIA== 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 4CE7DC35FF3; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) From: =?utf-8?q?J=2E_Neusch=C3=A4fer_via_B4_Relay?= Date: Thu, 13 Mar 2025 22:35:46 +0100 Subject: [PATCH v4 3/4] dt-bindings: nand: Add fsl,elbc-fcm-nand 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: <20250313-ppcyaml-elbc-v4-3-55903722d9ea@posteo.net> References: <20250313-ppcyaml-elbc-v4-0-55903722d9ea@posteo.net> In-Reply-To: <20250313-ppcyaml-elbc-v4-0-55903722d9ea@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 Cc: Frank Li , linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-mtd@lists.infradead.org, linuxppc-dev@lists.ozlabs.org, =?utf-8?q?J=2E_Neusch=C3=A4fer?= X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1741901745; l=3359; i=j.ne@posteo.net; s=20240329; h=from:subject:message-id; bh=/umUf9hJGqJZQnH4lp0VYOs75H+hiudpQPeFtynlqq0=; b=rut2FT9YxXNoUww0z5Ik0lSdReicEKdzbFg0FYIlmovOGHWwcVanj66uf0QrEhrZv+Z7u1jeu 6hjm8X+fciVCNioGM8E33XDtOLxgnpaaWy/0lbuwKT8QtBAFfcftpKY 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?= Reply-To: j.ne@posteo.net From: "J. Neusch=C3=A4fer" 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 =3D "fsl,p2020-fcm-nand", "fsl,elbc-fcm-nand"; reg =3D <0x1 0x0 0x00040000>; nand-ecc-mode =3D "soft"; nand-ecc-algo =3D "bch"; partitions { ... }; }; Reviewed-by: Frank Li Signed-off-by: J. Neusch=C3=A4fer Reviewed-by: Rob Herring (Arm) --- 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=3Dfalse instead of additionalProperties=3Dfalse - 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..91e8f2f9ff26da0f5a3f9bf2769= 55ed32e9e7bc6 --- /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=C3=A4fer + +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 =3D <2>; + #size-cells =3D <1>; + + nand@1,0 { + compatible =3D "fsl,mpc8315-fcm-nand", + "fsl,elbc-fcm-nand"; + reg =3D <0x1 0x0 0x2000>; + }; + }; + +... --=20 2.48.0.rc1.219.gb6b6757d772 From nobody Wed Dec 17 23:30:23 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 AA6191F4606; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741901747; cv=none; b=SZeKubC/HUTLbD7Fsvkv1ebO1pWRZctXXJQerZ4VHfkJDbgOx+di3ZIatdW6YjdjmirSOtS/Hf4H1Vgmw7HyfCm+GSfY573DJul76CYr5N5LoQC10GlbGE9GZTkuuoyue0YGX/ifVGLG32dxUrKUxei2MXgMENv/uwMRnOPMnE0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1741901747; c=relaxed/simple; bh=xfVlDIWb7tBNG5u+qIrOed5prmrJQ6hlz/f8edR8WxA=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=ly1w7EzA5XoKDedfz1BBKOEUuc0Og723Gn0unVZYS/NM/EM8Si0nkfHm5qPedHoryVjxXSaF6W0sXMnhselewssS2dS6Y0jLs5I63PVFp3gYjg6BA7MhdpZUcTTlO/uZWUp2pZFzWWz8JQU/Eyv82a6l/fxGA/DIVykBdPtRLjM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=QW0MLg40; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="QW0MLg40" Received: by smtp.kernel.org (Postfix) with ESMTPS id 6D90AC4CEF4; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1741901747; bh=xfVlDIWb7tBNG5u+qIrOed5prmrJQ6hlz/f8edR8WxA=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=QW0MLg40IdheqHPcb3xjiXJ8ETQy/FY4z4AckSkbJdAwtLilGqV9gkWbk476Vzbzf /v+XtBfBZu5mF3065TT59lE0+JMyg/Gb+kGrqHLv9rHuzD59NZ7sh8eAXzYgUO65HR xzfFTdeYzU48LSHgi/qOF8xFb1m5fL9qxVivo5GE/dTclwgAosVrheqDjshKSzdGU5 hUcoLGmTbkmEah6YQ0ZfVM1RVli+M98n1m6MizkOLjmy/OB8E2qS6gK+6ReFi7V48F cpZ+nTXkMgekd2psuVqrb3ijSHEQDt5SaQa7XZAiMjhJDcEMsr/ZvCXIZEjdgkITgT BgZoR1FbBsdlA== 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 5C248C282DE; Thu, 13 Mar 2025 21:35:47 +0000 (UTC) From: =?utf-8?q?J=2E_Neusch=C3=A4fer_via_B4_Relay?= Date: Thu, 13 Mar 2025 22:35:47 +0100 Subject: [PATCH v4 4/4] dt-bindings: memory-controllers: Convert fsl,elbc to YAML 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: <20250313-ppcyaml-elbc-v4-4-55903722d9ea@posteo.net> References: <20250313-ppcyaml-elbc-v4-0-55903722d9ea@posteo.net> In-Reply-To: <20250313-ppcyaml-elbc-v4-0-55903722d9ea@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 Cc: Frank Li , linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-mtd@lists.infradead.org, linuxppc-dev@lists.ozlabs.org, =?utf-8?q?J=2E_Neusch=C3=A4fer?= X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1741901745; l=8374; i=j.ne@posteo.net; s=20240329; h=from:subject:message-id; bh=8cRBcRI9qOww6+AJHQMBFzW6gxF7aVnTPI6Wpertk80=; b=2a9l+KHpTRc0QQI1uJ4zWN3wm+6XMRM/z34UuZ9c5W7KoqGEjSuTsnKw4zJZyDM+cFdqsZz80 qRjCZJMOvK4Dqj8b218YyDfxnwMs8+8rUK6Rvkel0MQcuqT3rUppfpu 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?= Reply-To: j.ne@posteo.net From: "J. Neusch=C3=A4fer" Convert the Freescale localbus controller bindings from text form to YAML. Compared to the .txt version, the YAML binding contains a new usage example with FCM NAND flash, and a full list of compatible strings based on current usage in arch/powerpc/boot/dts/. Note that the both the compatible strings and the unit address format are kept as-is, for compatibility with existing kernels and device trees, as well as unit address readability. This results in dts validation warnings: Warning (simple_bus_reg): /example-0/localbus@f0010100/board-control@1,0: simple-bus unit address format error, expected "100000000" Signed-off-by: J. Neusch=C3=A4fer --- V4: - no changes V3: - move this patch after the GPCM/FCM patches to dtschema/dtc warnings due to missing bindings for fsl,elbc-gpcm-uio and fsl,elbc-fcm-nand - add "simple-bus" again, for compatibility with existing DTs/drivers based on discussion with Crystal Wood and Rob Herring - fix fsl,pq2-localbus compatible properties based on mgcoge.dts / ep8248e.= dts (was missing "simple-bus") - add board-control (bcsr) example again, now using the compatible string listed in Documentation/devicetree/bindings/board/fsl,bcsr.yaml - remove interrupt-parent property from example - rework the commit message V2: - fix order of properties in examples, according to dts coding style - move to Documentation/devicetree/bindings/memory-controllers - clarify the commit message a tiny bit - remove unnecessary multiline markers (|) - define address format in patternProperties - trim subject line (remove "binding") - remove use of "simple-bus", because it's technically incorrect --- .../bindings/memory-controllers/fsl,elbc.yaml | 158 +++++++++++++++++= ++++ .../devicetree/bindings/powerpc/fsl/lbc.txt | 43 ------ 2 files changed, 158 insertions(+), 43 deletions(-) diff --git a/Documentation/devicetree/bindings/memory-controllers/fsl,elbc.= yaml b/Documentation/devicetree/bindings/memory-controllers/fsl,elbc.yaml new file mode 100644 index 0000000000000000000000000000000000000000..620d7e7c62df35c754a01498391= d35ede03cdf87 --- /dev/null +++ b/Documentation/devicetree/bindings/memory-controllers/fsl,elbc.yaml @@ -0,0 +1,158 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/memory-controllers/fsl,elbc.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale Enhanced Local Bus Controller + +maintainers: + - J. Neusch=C3=A4fer + +properties: + $nodename: + pattern: "^localbus@[0-9a-f]+$" + + compatible: + oneOf: + - items: + - enum: + - fsl,mpc8313-elbc + - fsl,mpc8315-elbc + - fsl,mpc8377-elbc + - fsl,mpc8378-elbc + - fsl,mpc8379-elbc + - fsl,mpc8536-elbc + - fsl,mpc8569-elbc + - fsl,mpc8572-elbc + - fsl,p1020-elbc + - fsl,p1021-elbc + - fsl,p1023-elbc + - fsl,p2020-elbc + - fsl,p2041-elbc + - fsl,p3041-elbc + - fsl,p4080-elbc + - fsl,p5020-elbc + - fsl,p5040-elbc + - const: fsl,elbc + - const: simple-bus + + - items: + - enum: + - fsl,mpc8247-localbus + - fsl,mpc8248-localbus + - fsl,mpc8272-localbus + - const: fsl,pq2-localbus + - const: simple-bus + + - items: + - enum: + - fsl,mpc8247-localbus + - fsl,mpc8248-localbus + - fsl,mpc8360-localbus + - const: fsl,pq2pro-localbus + - const: simple-bus + + - items: + - enum: + - fsl,mpc8540-localbus + - fsl,mpc8544-lbc + - fsl,mpc8544-localbus + - fsl,mpc8548-lbc + - fsl,mpc8548-localbus + - fsl,mpc8560-localbus + - fsl,mpc8568-localbus + - const: fsl,pq3-localbus + - const: simple-bus + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + "#address-cells": + enum: [2, 3] + description: + The first cell is the chipselect number, and the remaining cells are= the + offset into the chipselect. + + "#size-cells": + enum: [1, 2] + description: + Either one or two, depending on how large each chipselect can be. + + ranges: + description: + Each range corresponds to a single chipselect, and covers the entire + access window as configured. + +patternProperties: + # format: name@chipselect,address + "^.*@[0-9a-f]+,[0-9a-f]+$": + type: object + +additionalProperties: false + +examples: + - | + localbus@f0010100 { + compatible =3D "fsl,mpc8272-localbus", + "fsl,pq2-localbus", + "simple-bus"; + reg =3D <0xf0010100 0x40>; + ranges =3D <0x0 0x0 0xfe000000 0x02000000 + 0x1 0x0 0xf4500000 0x00008000 + 0x2 0x0 0xfd810000 0x00010000>; + #address-cells =3D <2>; + #size-cells =3D <1>; + + flash@0,0 { + compatible =3D "jedec-flash"; + reg =3D <0x0 0x0 0x2000000>; + bank-width =3D <4>; + device-width =3D <1>; + }; + + board-control@1,0 { + reg =3D <0x1 0x0 0x20>; + compatible =3D "fsl,mpc8360mds-bcsr"; + }; + + simple-periph@2,0 { + compatible =3D "fsl,elbc-gpcm-uio"; + reg =3D <0x2 0x0 0x10000>; + elbc-gpcm-br =3D <0xfd810800>; + elbc-gpcm-or =3D <0xffff09f7>; + }; + }; + + - | + localbus@e0005000 { + compatible =3D "fsl,mpc8315-elbc", "fsl,elbc", "simple-bus"; + reg =3D <0xe0005000 0x1000>; + ranges =3D <0x0 0x0 0xfe000000 0x00800000 + 0x1 0x0 0xe0600000 0x00002000 + 0x2 0x0 0xf0000000 0x00020000 + 0x3 0x0 0xfa000000 0x00008000>; + #address-cells =3D <2>; + #size-cells =3D <1>; + interrupts =3D <77 0x8>; + + flash@0,0 { + compatible =3D "cfi-flash"; + reg =3D <0x0 0x0 0x800000>; + #address-cells =3D <1>; + #size-cells =3D <1>; + bank-width =3D <2>; + device-width =3D <1>; + }; + + nand@1,0 { + compatible =3D "fsl,mpc8315-fcm-nand", + "fsl,elbc-fcm-nand"; + reg =3D <0x1 0x0 0x2000>; + #address-cells =3D <1>; + #size-cells =3D <1>; + }; + }; diff --git a/Documentation/devicetree/bindings/powerpc/fsl/lbc.txt b/Docume= ntation/devicetree/bindings/powerpc/fsl/lbc.txt deleted file mode 100644 index 1c80fcedebb52049721fbd61c4dd4c57133bd47c..000000000000000000000000000= 0000000000000 --- a/Documentation/devicetree/bindings/powerpc/fsl/lbc.txt +++ /dev/null @@ -1,43 +0,0 @@ -* Chipselect/Local Bus - -Properties: -- name : Should be localbus -- #address-cells : Should be either two or three. The first cell is the - chipselect number, and the remaining cells are the - offset into the chipselect. -- #size-cells : Either one or two, depending on how large each chipselect - can be. -- ranges : Each range corresponds to a single chipselect, and cover - the entire access window as configured. - -Example: - localbus@f0010100 { - compatible =3D "fsl,mpc8272-localbus", - "fsl,pq2-localbus"; - #address-cells =3D <2>; - #size-cells =3D <1>; - reg =3D <0xf0010100 0x40>; - - ranges =3D <0x0 0x0 0xfe000000 0x02000000 - 0x1 0x0 0xf4500000 0x00008000 - 0x2 0x0 0xfd810000 0x00010000>; - - flash@0,0 { - compatible =3D "jedec-flash"; - reg =3D <0x0 0x0 0x2000000>; - bank-width =3D <4>; - device-width =3D <1>; - }; - - board-control@1,0 { - reg =3D <0x1 0x0 0x20>; - compatible =3D "fsl,mpc8272ads-bcsr"; - }; - - simple-periph@2,0 { - compatible =3D "fsl,elbc-gpcm-uio"; - reg =3D <0x2 0x0 0x10000>; - elbc-gpcm-br =3D <0xfd810800>; - elbc-gpcm-or =3D <0xffff09f7>; - }; - }; --=20 2.48.0.rc1.219.gb6b6757d772