From nobody Thu Sep 24 16:09:27 2026 Received: from m16.mail.163.com (m16.mail.163.com [220.197.31.5]) (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 B4AA55349C3; Tue, 22 Sep 2026 10:23:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=220.197.31.5 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790072620; cv=none; b=P2qMA8bMfc9aKkma+AE3/WUi9SRreTeE/4WYt0QWw3MZc37Xw1Ohu8JXDntCjyOxz91DxYJxGP2AKHP5AXy1IdACtO38ccMKuc4/ISM5tsctTYfp+TOicXOSJXtb0OlTJB1+q0vzuBuBcykQVmKpex/NUVHBwfwP1KMKBsvYDNw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790072620; c=relaxed/simple; bh=9Aq0JtnKM8jdBLGGFkl7cw4LZiKU2cotGSwI8jMZE4s=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=NxBZIr4a4zsL4c7x7V6QnmQlEZj6/LrUlz7qVB3ZnK6eVT6Qbf19mT+rtWWLBmXkXtUIjym0kmWcqgRqiIk+QPR3rO8s99hb4Co5Wa/QCquM6ysAEjrzDu8tFPsi7t84CKA684tgxR71ZiVZlSI6Disv5GjhmoXmUKdc4sTCWIE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=163.com; spf=pass smtp.mailfrom=163.com; dkim=pass (1024-bit key) header.d=163.com header.i=@163.com header.b=Smo6RjAe; arc=none smtp.client-ip=220.197.31.5 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=163.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=163.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=163.com header.i=@163.com header.b="Smo6RjAe" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=163.com; s=s110527; h=From:To:Subject:Date:Message-ID:MIME-Version; bh=uh GBAqnxS0vw7wtn2TAoHyukDdba3M9Q796BAU6i29I=; b=Smo6RjAe83+v5Rw5ON f1hijL9Hzrj997s81dh4tIkFudjwfjiGuTlAdY7NSfiYli2m4jtpBlT7bZr7bnhe SVgZ6h6NbJXMpynge1lRQGWh5PNkuybdMfJ1b8CuiDt4bPiyAKxdMSQJ4BLOVT2A Ao433wIvBg31pBMLYddC3fCNc= Received: from chaosheng-ASUS-TUF-Gaming-F16-FX607JV-FX607JV.lan (unknown []) by gzga-smtp-mtada-g0-3 (Coremail) with SMTP id _____wD3X+0LV7Jq8o9oAA--.39710S3; Tue, 22 Sep 2026 18:23:08 +0800 (CST) From: Quchaosheng To: Marc Kleine-Budde , Vincent Mailhol , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: linux-can@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, quchaosheng000406@163.com Subject: [PATCH v8 1/3] dt-bindings: net: can: ifi,canfd-1.0: Convert to DT schema Date: Tue, 22 Sep 2026 18:22:56 +0800 Message-ID: <20260922102258.138753-2-quchaosheng000406@163.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260922102258.138753-1-quchaosheng000406@163.com> References: <20260922102258.138753-1-quchaosheng000406@163.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-CM-TRANSID: _____wD3X+0LV7Jq8o9oAA--.39710S3 X-Coremail-Antispam: 1Uf129KBjvJXoWxXF1kGry3AF13GF4DXF47Jwb_yoW5ArWfpa 43CFsrXF4IqF43Gws7K3W8A3W3XF95ZF15Gr9rXw10yas09Fy5tw4akr95Za4jqrZ2vFy7 XF1Yga1Ut3WxXaUanT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDUYxBIdaVFxhVjvjDU0xZFpf9x0pRe6wAUUUUU= X-CM-SenderInfo: xtxfxtprvkv0bjqqikiqw6il2tof0z/xtbC4w0glWqyVw01xwAA3r Content-Type: text/plain; charset="utf-8" Convert the IFI CAN-FD controller binding from free-form text to DT schema. Reference can-controller.yaml. interrupts is required: the driver obtains it with platform_get_irq(). The example now uses the GIC and irq header defines instead of raw numbers. The values are unchanged: GIC_SPI is 0, IRQ_TYPE_NONE is 0 and 1 is IRQ_TYPE_EDGE_RISING. Rename the example node from canfd to can so that it matches the $nodename pattern in can-controller.yaml. Assisted-by: LLM Signed-off-by: Quchaosheng Reviewed-by: Rob Herring (Arm) --- v8: - No change. .../bindings/net/can/ifi,canfd.yaml | 46 +++++++++++++++++++ .../devicetree/bindings/net/can/ifi_canfd.txt | 15 ------ 2 files changed, 46 insertions(+), 15 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/can/ifi,canfd.yaml delete mode 100644 Documentation/devicetree/bindings/net/can/ifi_canfd.txt diff --git a/Documentation/devicetree/bindings/net/can/ifi,canfd.yaml b/Doc= umentation/devicetree/bindings/net/can/ifi,canfd.yaml new file mode 100644 index 000000000000..c8c3105c727b --- /dev/null +++ b/Documentation/devicetree/bindings/net/can/ifi,canfd.yaml @@ -0,0 +1,46 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/net/can/ifi,canfd.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: IFI CAN-FD Controller + +maintainers: + - Marc Kleine-Budde + +description: + The I/F/I CAN-FD soft IP block connected to the platform bus. It is most + often synthesised into an FPGA or CPLD. + +allOf: + - $ref: can-controller.yaml# + +properties: + compatible: + const: ifi,canfd-1.0 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + +required: + - compatible + - reg + - interrupts + +unevaluatedProperties: false + +examples: + - | + #include + #include + + can@ff220000 { + compatible =3D "ifi,canfd-1.0"; + reg =3D <0xff220000 0x1000>; + interrupts =3D ; + }; +... diff --git a/Documentation/devicetree/bindings/net/can/ifi_canfd.txt b/Docu= mentation/devicetree/bindings/net/can/ifi_canfd.txt deleted file mode 100644 index 20ea5c70ab82..000000000000 --- a/Documentation/devicetree/bindings/net/can/ifi_canfd.txt +++ /dev/null @@ -1,15 +0,0 @@ -IFI CANFD controller --------------------- - -Required properties: - - compatible: Should be "ifi,canfd-1.0" - - reg: Should contain CAN controller registers location and length - - interrupts: Should contain IRQ line for the CAN controller - -Example: - - canfd0: canfd@ff220000 { - compatible =3D "ifi,canfd-1.0"; - reg =3D <0xff220000 0x00001000>; - interrupts =3D <0 43 0>; - }; --=20 2.43.0 From nobody Thu Sep 24 16:09:27 2026 Received: from m16.mail.163.com (m16.mail.163.com [220.197.31.4]) (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 48C6B5372CC; Tue, 22 Sep 2026 10:23:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=220.197.31.4 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790072621; cv=none; b=NmwwmEeLZ6pGr6eM4aVVRVbvqiWDXsM2YNpd/xKnravzV9hL7WOqYbvoRgRlNT7NvVhS1xb9QdJewhFsMOKqm8EuyXh/G9WhOVvk3TaKqy9SuRLBh53rYZgHu9l1QxdvxL/9FK28wHs3Wrz8wRZiO8wOfHw0dPeeMjFUZt4b31M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790072621; c=relaxed/simple; bh=DSpUMDZFL/RsZ0gpO+Ch6V/5TXFqhhArQHQq3AOwwpc=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=m2Vu/q7eDOB6x0eW8fusg6gNEpcAr/OC2RgR/IBjg7SYnGiU/h9Jmp/mcUcSZwAoUKUBfOcPJBCXb5S46yLblJb86afl3FlEr+n+cK30kSz83xLne92ep+ob9NxtFu83PCpPI2P7hfzuD+ePhjzKWECm5RFW0kHJfsDwO9CrxrI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=163.com; spf=pass smtp.mailfrom=163.com; dkim=pass (1024-bit key) header.d=163.com header.i=@163.com header.b=CNvKPoJ/; arc=none smtp.client-ip=220.197.31.4 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=163.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=163.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=163.com header.i=@163.com header.b="CNvKPoJ/" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=163.com; s=s110527; h=From:To:Subject:Date:Message-ID:MIME-Version; bh=lM 1lEZA8Ffcb1iNg5lVKJ5TmLKedzZNS5PzvoeLExbE=; b=CNvKPoJ/F8jIrEDVkY TWnf4aLsBbs9VX7ZoAcqcQ975Y4o+shcp3hXFIolA90EAldUki6pCVEUJR2Ez2Ue SOYTCQEPU1VRnbJFQYIUX5UGixLLOgKx3Q2/1fQ0ZdxiQWYUW6bMBGVv41hGlxmh mb8l+tEYneA00R/8eQ1WS+N0o= Received: from chaosheng-ASUS-TUF-Gaming-F16-FX607JV-FX607JV.lan (unknown []) by gzga-smtp-mtada-g0-3 (Coremail) with SMTP id _____wD3X+0LV7Jq8o9oAA--.39710S4; Tue, 22 Sep 2026 18:23:10 +0800 (CST) From: Quchaosheng To: Marc Kleine-Budde , Vincent Mailhol , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: linux-can@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, quchaosheng000406@163.com, Sashiko Subject: [PATCH v8 2/3] dt-bindings: net: can: holt,hi311x: Convert to DT schema Date: Tue, 22 Sep 2026 18:22:57 +0800 Message-ID: <20260922102258.138753-3-quchaosheng000406@163.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260922102258.138753-1-quchaosheng000406@163.com> References: <20260922102258.138753-1-quchaosheng000406@163.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-CM-TRANSID: _____wD3X+0LV7Jq8o9oAA--.39710S4 X-Coremail-Antispam: 1Uf129KBjvJXoWxXF4xWw4DGr1fuF43XFW5ZFb_yoWruFy3pa y5GFsxWF4vqF1xXa1Iq3W8AF93XaykZF47GrWDXr18Ja4qva15trWSkryYvF17ZFs7AFyI 9Fy093W8tw15AaUanT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDUYxBIdaVFxhVjvjDU0xZFpf9x0pR1GQDUUUUU= X-CM-SenderInfo: xtxfxtprvkv0bjqqikiqw6il2tof0z/xtbC5A4glWqyVw4J4gAA31 Content-Type: text/plain; charset="utf-8" Convert the Holt HI-311X binding from free-form text to DT schema. Reference can-controller.yaml and spi/spi-peripheral-props.yaml. The HI-3110 sits on an SPI bus, so its node carries the standard SPI properties, spi-max-frequency among them. With unevaluatedProperties: false and no reference to spi-peripheral-props.yaml, dtbs_check rejects those properties: can@1 (holt,hi3110): Unevaluated properties are not allowed ('spi-max-frequency' was unexpected) Keep the properties and the example as the original text describes them, including clocks as a required property. Assisted-by: LLM Reported-by: Sashiko Link: https://sashiko.dev/#/patchset/20260922084542.104788-1-quchaosheng000= 406@163.com?part=3D2 Reviewed-by: Rob Herring (Arm) Signed-off-by: Quchaosheng --- v8: - Put back the $ref to spi/spi-peripheral-props.yaml. v7 dropped it as redundant, but the HI-3110 is an SPI peripheral and its node carries spi-max-frequency. With unevaluatedProperties: false and no reference, dt_binding_check reports: can@1 (holt,hi3110): Unevaluated properties are not allowed ('spi-max-frequency' was unexpected) A node carrying spi-max-frequency fails without the reference and passes with it, so the reference is required. Reported by sashiko. The schema is identical to the v6 that Rob reviewed, so his Reviewed-by is kept. .../bindings/net/can/holt,hi311x.yaml | 67 +++++++++++++++++++ .../bindings/net/can/holt_hi311x.txt | 23 ------- 2 files changed, 67 insertions(+), 23 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/can/holt,hi311x.y= aml delete mode 100644 Documentation/devicetree/bindings/net/can/holt_hi311x.t= xt diff --git a/Documentation/devicetree/bindings/net/can/holt,hi311x.yaml b/D= ocumentation/devicetree/bindings/net/can/holt,hi311x.yaml new file mode 100644 index 000000000000..9ec6abb1279a --- /dev/null +++ b/Documentation/devicetree/bindings/net/can/holt,hi311x.yaml @@ -0,0 +1,67 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/net/can/holt,hi311x.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Holt HI-311X stand-alone CAN controller + +maintainers: + - Marc Kleine-Budde + +description: + The Holt HI-3110 is a stand-alone CAN controller with an SPI interface. + +allOf: + - $ref: can-controller.yaml# + - $ref: /schemas/spi/spi-peripheral-props.yaml# + +properties: + compatible: + const: holt,hi3110 + + reg: + description: SPI chip select. + maxItems: 1 + + clocks: + description: The clock feeding the CAN controller. + maxItems: 1 + + interrupts: + description: IRQ line for the CAN controller. + maxItems: 1 + + vdd-supply: + description: Regulator that powers the CAN controller. + + xceiver-supply: + description: Regulator that powers the CAN transceiver. + +required: + - compatible + - reg + - clocks + - interrupts + +unevaluatedProperties: false + +examples: + - | + #include + + spi { + #address-cells =3D <1>; + #size-cells =3D <0>; + + can@1 { + compatible =3D "holt,hi3110"; + reg =3D <1>; + clocks =3D <&clk32m>; + interrupt-parent =3D <&gpio4>; + interrupts =3D <13 IRQ_TYPE_LEVEL_HIGH>; + vdd-supply =3D <®5v0>; + xceiver-supply =3D <®5v0>; + }; + }; +... diff --git a/Documentation/devicetree/bindings/net/can/holt_hi311x.txt b/Do= cumentation/devicetree/bindings/net/can/holt_hi311x.txt deleted file mode 100644 index 3a9926f99937..000000000000 --- a/Documentation/devicetree/bindings/net/can/holt_hi311x.txt +++ /dev/null @@ -1,23 +0,0 @@ -* Holt HI-311X stand-alone CAN controller device tree bindings - -Required properties: - - compatible: Should be one of the following: - - "holt,hi3110" for HI-3110 - - reg: SPI chip select. - - clocks: The clock feeding the CAN controller. - - interrupts: Should contain IRQ line for the CAN controller. - -Optional properties: - - vdd-supply: Regulator that powers the CAN controller. - - xceiver-supply: Regulator that powers the CAN transceiver. - -Example: - can0: can@1 { - compatible =3D "holt,hi3110"; - reg =3D <1>; - clocks =3D <&clk32m>; - interrupt-parent =3D <&gpio4>; - interrupts =3D <13 IRQ_TYPE_LEVEL_HIGH>; - vdd-supply =3D <®5v0>; - xceiver-supply =3D <®5v0>; - }; --=20 2.43.0 From nobody Thu Sep 24 16:09:27 2026 Received: from m16.mail.163.com (m16.mail.163.com [220.197.31.4]) (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 5F01F5372C3; Tue, 22 Sep 2026 10:23:29 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=220.197.31.4 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790072616; cv=none; b=eLLqhT844BUu+ZabO9vUVrXLXOyvqXdh5KB9HIcbGYNwfxgw83IsWDxI4lzh0rpgkw9QJfW8ctl3z53Dkjg/UzoU9sAT4ANtaSOsKIvriYyfFdsFZeqVbd0K/8O2rZP6lAj24b6PdeDyUvWxoQZVaGmbLefdMNB177RB3QlzDkA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790072616; c=relaxed/simple; bh=t7uL8YiygASmPb9McXYGzTjHoLA3Of84K9u8AbMrCzw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=rwAaUTn2GZSxSXKeMAkPAUGh7QCiRIF71+vYxNegmkHyX6qjEnuSk40L61dPBTycpntaW846XLE5J/x4YE0X3kAo0Iq+292EQNbLuS/5RDcK58tut4dtvZ6vkR3OEQb/VbcpIHSVMHgaw60Y+mhvIz/dgYgMKkyYlk7R6+RrHMo= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=163.com; spf=pass smtp.mailfrom=163.com; dkim=pass (1024-bit key) header.d=163.com header.i=@163.com header.b=WJ3Ggmvu; arc=none smtp.client-ip=220.197.31.4 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=163.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=163.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=163.com header.i=@163.com header.b="WJ3Ggmvu" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=163.com; s=s110527; h=From:To:Subject:Date:Message-ID:MIME-Version; bh=px 1jv+7mW6mF/w7KAvP8T6sBEltXZpg+ewKEIeGDCro=; b=WJ3GgmvuOF1VRQLHXr ftcuS3BXbCtsRSe9Bk1YaFYdWyx9J/DFPJfOP6KoKyGhu+SH4bQt19tEI1fs6OcA xhRCWzSDjJ5L/7Mka10o+UUhtJCZIETWikoWCbjLuOTP8f3KgG0oEn4P9meLUPlA ZfVT9fk6JXU7i4OFC/PHj0enA= Received: from chaosheng-ASUS-TUF-Gaming-F16-FX607JV-FX607JV.lan (unknown []) by gzga-smtp-mtada-g0-3 (Coremail) with SMTP id _____wD3X+0LV7Jq8o9oAA--.39710S5; Tue, 22 Sep 2026 18:23:11 +0800 (CST) From: Quchaosheng To: Marc Kleine-Budde , Vincent Mailhol , Rob Herring , Krzysztof Kozlowski , Conor Dooley Cc: linux-can@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, quchaosheng000406@163.com Subject: [PATCH v8 3/3] dt-bindings: net: can: fsl,mpc5xxx-mscan: Convert to DT schema Date: Tue, 22 Sep 2026 18:22:58 +0800 Message-ID: <20260922102258.138753-4-quchaosheng000406@163.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260922102258.138753-1-quchaosheng000406@163.com> References: <20260922102258.138753-1-quchaosheng000406@163.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-CM-TRANSID: _____wD3X+0LV7Jq8o9oAA--.39710S5 X-Coremail-Antispam: 1Uf129KBjvJXoWxKr1DAF4xZr4DJF18Kr1fXrb_yoWxJFW3pa y3C3W7JFyqqF15Z3yvqF48Cw1kJanYyF15Grn7Z34xK398CF48tF43KF9YvFW5GryfZa9F g3WSqr18JFnI9w7anT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDUYxBIdaVFxhVjvjDU0xZFpf9x0z_yCJDUUUUU= X-CM-SenderInfo: xtxfxtprvkv0bjqqikiqw6il2tof0z/xtbC-w8glWqyVw94HgAA3j Content-Type: text/plain; charset="utf-8" Convert the Freescale MPC5xxx MSCAN binding from free-form text to DT schema. The original text documents fsl,mpc5200-mscan and fsl,mpc5121-mscan in two separate sections. Keep that split: fsl,mscan-clock-source takes "ip" or "ref" on fsl,mpc5200-mscan, and "ip", "ref" or "sys" on fsl,mpc5121-mscan. Add fsl,mpc5200b-mscan as a fallback of fsl,mpc5200-mscan. mpc5200b.dtsi uses it. Document clocks and clock-names, which the original text does not describe. fsl,mpc5121-mscan requires the "ipg", "ips", "sys", "ref" and "mclk" clocks in that order, as mpc5121.dtsi supplies them. MPC5200 does not use DT clocks; it takes its frequency from the CDM block. fsl,mscan-clock-divider divides the selected clock, so value 0 cannot be used. Keep the note that the MPC5121 Rev. 1 processor is not supported. Assisted-by: LLM Signed-off-by: Quchaosheng Reviewed-by: Rob Herring (Arm) --- v8: - No change. .../bindings/net/can/fsl,mpc5xxx-mscan.yaml | 109 ++++++++++++++++++ .../bindings/net/can/mpc5xxx-mscan.txt | 53 --------- 2 files changed, 109 insertions(+), 53 deletions(-) create mode 100644 Documentation/devicetree/bindings/net/can/fsl,mpc5xxx-m= scan.yaml delete mode 100644 Documentation/devicetree/bindings/net/can/mpc5xxx-mscan= .txt diff --git a/Documentation/devicetree/bindings/net/can/fsl,mpc5xxx-mscan.ya= ml b/Documentation/devicetree/bindings/net/can/fsl,mpc5xxx-mscan.yaml new file mode 100644 index 000000000000..77aa46fd62ac --- /dev/null +++ b/Documentation/devicetree/bindings/net/can/fsl,mpc5xxx-mscan.yaml @@ -0,0 +1,109 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/net/can/fsl,mpc5xxx-mscan.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale MPC5xxx MSCAN controller + +maintainers: + - Marc Kleine-Budde + +description: + The MSCAN controller found on the Freescale MPC5200 and MPC5121 SoCs. The + MPC5121 Rev. 1 processor is not supported. + +properties: + compatible: + oneOf: + - items: + - enum: + - fsl,mpc5200b-mscan + - const: fsl,mpc5200-mscan + - enum: + - fsl,mpc5200-mscan + - fsl,mpc5121-mscan + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + clocks: + description: + Clocks feeding the controller. fsl,mpc5200-mscan takes its frequency + from the CDM block and does not use DT clocks. + minItems: 5 + maxItems: 5 + + clock-names: + items: + - const: ipg + - const: ips + - const: sys + - const: ref + - const: mclk + + fsl,mscan-clock-source: + description: + Clock source used for the controller. When the property is not prese= nt, + fsl,mpc5200-mscan uses the reference clock, while fsl,mpc5121-mscan + selects an optimal clock source and frequency based on the system cl= ock + and uses the reference clock when that is not possible. + enum: [ip, ref, sys] + + fsl,mscan-clock-divider: + description: Additional clock divider for the reference and system clo= cks. + $ref: /schemas/types.yaml#/definitions/uint32 + minimum: 1 + default: 1 + +required: + - compatible + - reg + - interrupts + +allOf: + - $ref: can-controller.yaml# + + - if: + properties: + compatible: + contains: + const: fsl,mpc5200-mscan + then: + properties: + fsl,mscan-clock-source: + enum: [ip, ref] + + - if: + properties: + compatible: + contains: + const: fsl,mpc5121-mscan + then: + required: + - clocks + - clock-names + +unevaluatedProperties: false + +examples: + - | + #include + #include + + can@1300 { + compatible =3D "fsl,mpc5121-mscan"; + reg =3D <0x1300 0x80>; + interrupts =3D <12 IRQ_TYPE_LEVEL_LOW>; + interrupt-parent =3D <&ipic>; + clocks =3D <&clks MPC512x_CLK_BDLC>, <&clks MPC512x_CLK_IPS>, + <&clks MPC512x_CLK_SYS>, <&clks MPC512x_CLK_REF>, + <&clks MPC512x_CLK_MSCAN0_MCLK>; + clock-names =3D "ipg", "ips", "sys", "ref", "mclk"; + fsl,mscan-clock-source =3D "ref"; + fsl,mscan-clock-divider =3D <3>; + }; +... diff --git a/Documentation/devicetree/bindings/net/can/mpc5xxx-mscan.txt b/= Documentation/devicetree/bindings/net/can/mpc5xxx-mscan.txt deleted file mode 100644 index 2fa4fcd38fd6..000000000000 --- a/Documentation/devicetree/bindings/net/can/mpc5xxx-mscan.txt +++ /dev/null @@ -1,53 +0,0 @@ -CAN Device Tree Bindings ------------------------- - -(c) 2006-2009 Secret Lab Technologies Ltd -Grant Likely - -fsl,mpc5200-mscan nodes ------------------------ -In addition to the required compatible-, reg- and interrupt-properties, yo= u can -also specify which clock source shall be used for the controller: - -- fsl,mscan-clock-source : a string describing the clock source. Valid val= ues - are: "ip" for ip bus clock - "ref" for reference clock (XTAL) - "ref" is default in case this property is not - present. - -fsl,mpc5121-mscan nodes ------------------------ -In addition to the required compatible-, reg- and interrupt-properties, yo= u can -also specify which clock source and divider shall be used for the controll= er: - -- fsl,mscan-clock-source : a string describing the clock source. Valid val= ues - are: "ip" for ip bus clock - "ref" for reference clock - "sys" for system clock - If this property is not present, an optimal CAN - clock source and frequency based on the system - clock will be selected. If this is not possible, - the reference clock will be used. - -- fsl,mscan-clock-divider: for the reference and system clock, an addition= al - clock divider can be specified. By default, a - value of 1 is used. - -Note that the MPC5121 Rev. 1 processor is not supported. - -Examples: - can@1300 { - compatible =3D "fsl,mpc5121-mscan"; - interrupts =3D <12 0x8>; - interrupt-parent =3D <&ipic>; - reg =3D <0x1300 0x80>; - }; - - can@1380 { - compatible =3D "fsl,mpc5121-mscan"; - interrupts =3D <13 0x8>; - interrupt-parent =3D <&ipic>; - reg =3D <0x1380 0x80>; - fsl,mscan-clock-source =3D "ref"; - fsl,mscan-clock-divider =3D <3>; - }; --=20 2.43.0