2017-11-27 21:42 GMT+08:00 Mark Rutland [off-list ref]:

Him

On Mon, Nov 27, 2017 at 08:28:16PM +0800, Greentime Hu wrote:

quoted

From: Greentime Hu <greentime-MUIXKm3Oiri1Z/+hSey0Gg@public.gmane.org>

This patch adds nds32 CPU binding documents.

Signed-off-by: Vincent Chen <vincentc-MUIXKm3Oiri1Z/+hSey0Gg@public.gmane.org>
Signed-off-by: Rick Chen <rick-MUIXKm3Oiri1Z/+hSey0Gg@public.gmane.org>
Signed-off-by: Zong Li <zong-MUIXKm3Oiri1Z/+hSey0Gg@public.gmane.org>
Signed-off-by: Greentime Hu <greentime-MUIXKm3Oiri1Z/+hSey0Gg@public.gmane.org>
---
 Documentation/devicetree/bindings/nds32/cpus.txt |   32 ++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/nds32/cpus.txt

diff --git a/Documentation/devicetree/bindings/nds32/cpus.txt b/Documentation/devicetree/bindings/nds32/cpus.txt
new file mode 100644
index 0000000..c302c89
--- /dev/null
+++ b/Documentation/devicetree/bindings/nds32/cpus.txt

@@ -0,0 +1,32 @@
+* Andestech Processor Binding
+
+This binding specifies what properties must be available in the device tree
+representation of a Andestech Processor Core, which is the root node in the
+tree.
+
+Required properties:
+
+     - compatible:
+             Usage: required
+             Value type: <string>
+             Definition: should be one of:
+                     "andestech,n13"
+                     "andestech,n15"
+                     "andestech,d15"
+                     "andestech,n10"
+                     "andestech,d10"
+                     "andestech,nds32v3"

Are these specific parts, or architecture versions?

I guess "andestech,nds32v3" is an architecture version, and the rest are
specific parts?

Yes, nds32v3 is an architecture version and the rest are nds32v3
compatible processor's name.

quoted

+     - device_type
+             Usage: required
+             Value type: <string>
+             Definition: must be "cpu"
+     - clock-frequency: Contains the clock frequency for CPU, in Hz.
+
+* Examples
+
+/ {
+     cpu {
+             device_type = "cpu";
+             compatible = "andestech,n13", "andestech,nds32v3";
+     };

This is missing the required clock-frequency property.

There should be a /cpus node, with each CPU listed under that, to align
with the devicetree spec. Even if you never support SMP, there's no
reason to be different from other architectures.

You should have something like:

/ {
        cpus {
                cpu {
                        device_type = "cpu";
                        compatible = "andestech,n13";
                        clock-frequency = <...>;
                };
        };
};

Thanks,
Mark.

Thanks.
I will modify it in the next version patch.
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html