From nobody Thu Sep 24 16:09:56 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 E198D52940E; Tue, 22 Sep 2026 08:46:13 +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=1790066777; cv=none; b=W1ku+fDABsgMEzGZ0VDl/tI2pt2IIuLp3Tsl4g2rfNtefyicsjnt7gBcixSZAr0QR2nQ/UtfRxX09/Scc6zBw8A63sLq9IYKzIpza7Ye282uR2DRz6XXw0CdpbVxIUStVFTBcL82zxgLymoPjUL7smH6iBiHA+WO6w1uOSMqVSc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790066777; c=relaxed/simple; bh=OhNrXd95q2AFjkshRT6MKjGAtmK7ODVQCcP6uTvI8uY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=QHbIDrykTZdieSuIXUUCEc6Uxte/SqRnMz1ruh3Sbe+0tZYKXClsPoqp39P04CxV1lO79RzyUqjXXAVA0o2raztvZAxrAQvTgPCMfO6P4Lz25XsxEtzhQB5GF7gW4WNvsOgBXjj5bm9LD6oUV+2ohvV9H/2zHYs/rd+7KXPT3FA= 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=CKmiJu9t; 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="CKmiJu9t" 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=Qt jIcsjxKqFLUwSQXtQubvciZlrWiqtVRuCDQVYP0R8=; b=CKmiJu9t8zDpSCoNiU XIL63teNrcrW6bvpWxianLK7fRlU5IEY6VYZ+NJOWyS0lAwals3vlzt3hzI/2WGF 9kdCUK/ophW1WfrRXKaOzuBAld/hlHtadwT3gbXPifM9BGd22Fsj4JNea5P8wZ4+ D42ZG3FiLR5PDnxiXlVvsKuL0= Received: from chaosheng-ASUS-TUF-Gaming-F16-FX607JV-FX607JV.lan (unknown []) by gzga-smtp-mtada-g0-1 (Coremail) with SMTP id _____wD330E_QLJqT4dWAA--.33181S3; Tue, 22 Sep 2026 16:45:53 +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 v7 1/3] dt-bindings: net: can: ifi,canfd-1.0: Convert to DT schema Date: Tue, 22 Sep 2026 16:45:40 +0800 Message-ID: <20260922084542.104788-2-quchaosheng000406@163.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260922084542.104788-1-quchaosheng000406@163.com> References: <20260922084542.104788-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: _____wD330E_QLJqT4dWAA--.33181S3 X-Coremail-Antispam: 1Uf129KBjvJXoWxXF1kGrWruFyrGr43Zw17trb_yoW5Aw48pa y3CFsrXF4IqF43C397K3W8C3W3XFs5AF15Gr9rXw10yas09Fy5tw4akr95Za4jqrZ2vFWx XFn0ga1Ut3WxXaUanT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDUYxBIdaVFxhVjvjDU0xZFpf9x0pR1GQDUUUUU= X-CM-SenderInfo: xtxfxtprvkv0bjqqikiqw6il2tof0z/xtbC4wJn3GqyQEJADQAA3N 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) Reviewed-by on ifi,canfd-1.0 and holt,hi311x. fsl,mpc5xxx-mscan came back --- v7: - Add Assisted-by and the Reviewed-by tag received on v6. No content chang= e. .../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:56 2026 Received: from m16.mail.163.com (m16.mail.163.com [220.197.31.2]) (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 03C6B437130; Tue, 22 Sep 2026 08:46:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=220.197.31.2 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790066772; cv=none; b=WNojFn0lTQ4NxDRdjvVEC9TOXkfv6LZCcv7DHAzJlbUMecjJeGC54jOtWE9D740l1HUtqLSDBVnaNW7AtI+7HvD4v0sofrxugEi3ISbnzAor/S88xgjIGyhzNCEwSbZz/SLCO2MbM4okdB2x7HlRARiTBiUk2BaHiBtAoa/ab5k= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790066772; c=relaxed/simple; bh=iaLVxDAG5+nB5ptO+TpM0Qf9GhIRqpRVHMLuK4hPsv4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=WSowBIEY7Dx140HsZAe/vj6T4VYXizXKRqLs8scye4jGHTz+cj7c/TDXy7OcCC08uDNq01zFw7d/9f7+Pa+Bpm5T3QErGg/AGVY+Vn6SW5GrT4YQCQuSED0lJxlMJK2Ra7c1f59ROEpdHihx3GLEjV500A5oSsjvTTOuOt39FWA= 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=AGlQu6rq; arc=none smtp.client-ip=220.197.31.2 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="AGlQu6rq" 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=Hx FEgAzEvnh+dUnQWPWaBxX8yBJft8ckZpazV4YOYqE=; b=AGlQu6rq4c223FL3qB HgG6A/r6K8c/6czFvcEPGjEOca7RVm1HozFHEqfwgMctdc6I9VJTZKglILFFrlvW 4UFN8jmCXPXfo0s2wSJwQRiX3/ZYugzX0PtRjrGe6tyyuGDRSVGkSqY0N57xzUls JcwY2faOzTV6ie2dVka3vdy1k= Received: from chaosheng-ASUS-TUF-Gaming-F16-FX607JV-FX607JV.lan (unknown []) by gzga-smtp-mtada-g0-1 (Coremail) with SMTP id _____wD330E_QLJqT4dWAA--.33181S4; Tue, 22 Sep 2026 16:45:55 +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 v7 2/3] dt-bindings: net: can: holt,hi311x: Convert to DT schema Date: Tue, 22 Sep 2026 16:45:41 +0800 Message-ID: <20260922084542.104788-3-quchaosheng000406@163.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260922084542.104788-1-quchaosheng000406@163.com> References: <20260922084542.104788-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: _____wD330E_QLJqT4dWAA--.33181S4 X-Coremail-Antispam: 1Uf129KBjvJXoWxZFyDuryrtr1UCF4UtFW8JFb_yoWrJFW8pa y5G3Z3WFs2qF1xXw40g3W8AF93Xan5ZF47GrZrXw18tF909an5tFWSkr90va4UXrs7ZFy2 vF1093W8J3W5AaUanT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDUYxBIdaVFxhVjvjDU0xZFpf9x0pRU5rxUUUUU= X-CM-SenderInfo: xtxfxtprvkv0bjqqikiqw6il2tof0z/xtbC5ANn3GqyQEMUdgAA3l Content-Type: text/plain; charset="utf-8" Convert the Holt HI-311X binding from free-form text to DT schema. Reference can-controller.yaml. Keep the properties and the example as the original text describes them, including clocks as a required property. Assisted-by: LLM Signed-off-by: Quchaosheng Reviewed-by: Rob Herring (Arm) Reviewed-by on ifi,canfd-1.0 and holt,hi311x. fsl,mpc5xxx-mscan came back --- v7: - Add Assisted-by and the Reviewed-by tag received on v6. - Drop the $ref to spi/spi-peripheral-props.yaml. The example does not use SPI properties, so the reference is redundant (Krzysztof Kozlowski). Rob's Reviewed-by is kept: this is the only change against the v6 he reviewed, and it is the removal Krzysztof had asked for. .../bindings/net/can/holt,hi311x.yaml | 66 +++++++++++++++++++ .../bindings/net/can/holt_hi311x.txt | 23 ------- 2 files changed, 66 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..d9e3584590c6 --- /dev/null +++ b/Documentation/devicetree/bindings/net/can/holt,hi311x.yaml @@ -0,0 +1,66 @@ +# 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# + +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:56 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 77BF035677C; Tue, 22 Sep 2026 08:46:08 +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=1790066772; cv=none; b=TjPOI5MzgUdeV4qH0qKkYSiaP0Mz95Z9sbA1T04g/MMSpsBNb0V27RJn+5BZAUXXhRjIWsqWgWAObqPlL6bpz3aALmFJdykPAVaYrLIY4brAUx7IErpNX4z5TstjWAPS39se3RTbM1T5h01jm6zQCF/yuAhrnDiqC8lqtcLRziU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1790066772; c=relaxed/simple; bh=4UGzpWko3rlOk/RChAypjOhx5GnjXmB4/FiKsjfGvEk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ZMh6mV9VGF+zRPM59sspDTKeRYHWYYSvpcbSV2pbG11/SzaNvEwbPFPnuboC+B4XQ4molk2Wpih3/wREPNeJlKVVHtyD5u++zEZKIEg3qDcjgJFjibupsTZwwWFUpncFjKHb+tiO2y1cAroL5esSpoIMn0ipjjyQnWwEqQ+IG5Y= 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=WVqQJ+7h; 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="WVqQJ+7h" 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=bb XVKLsX91HaTT7y2+Ipa4w7rfsERAqEPBm8yq9WYb0=; b=WVqQJ+7hzxRlsy5UWx YoJQNtDkrGXMirtpMpQTp1mIZMGYNCgCYvz8HtYNtQKBQ3Ar4Hn9Cjc8AKUNyuog X6HOun2AM9YeuRifOld0AXjjZOAabZnjT7I35Iaby5DF/fpaw5lCaiRqUmG/av6G /MXNvy9LLu8LQvJUbQb99gcM0= Received: from chaosheng-ASUS-TUF-Gaming-F16-FX607JV-FX607JV.lan (unknown []) by gzga-smtp-mtada-g0-1 (Coremail) with SMTP id _____wD330E_QLJqT4dWAA--.33181S5; Tue, 22 Sep 2026 16:45:56 +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 v7 3/3] dt-bindings: net: can: fsl,mpc5xxx-mscan: Convert to DT schema Date: Tue, 22 Sep 2026 16:45:42 +0800 Message-ID: <20260922084542.104788-4-quchaosheng000406@163.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260922084542.104788-1-quchaosheng000406@163.com> References: <20260922084542.104788-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: _____wD330E_QLJqT4dWAA--.33181S5 X-Coremail-Antispam: 1Uf129KBjvJXoWxKr1DAF45WF43XFyxtF43Jrb_yoWxAw1Dpa y3Ca17JFyqqF15Z3yvqF48Cw18Ja1vyF15Grn7Z34xK3y5CF18tF43KF9YvFW5JryfZa9F g3WSqr18JFnI9w7anT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDUYxBIdaVFxhVjvjDU0xZFpf9x0z_iSd5UUUUU= X-CM-SenderInfo: xtxfxtprvkv0bjqqikiqw6il2tof0z/xtbC5ARo3WqyQEQUggAA3f 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 on ifi,canfd-1.0 and holt,hi311x. fsl,mpc5xxx-mscan came back --- v7: - clock-names is an ordered list of the five names and clocks is minItems = 5, as the one order used by the device trees is documented. fsl,mpc5121-msc= an now requires both properties. - Drop the if/then for fsl,mpc5121-mscan that only restated the enum of fsl,mscan-clock-source. The description of the two per-compatible defaul= ts moved to the property itself. - fsl,mscan-clock-divider has a minimum of 1; the driver divides by it. - One example, which now shows the required clocks. - Add Assisted-by. .../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