Re: [PATCHv2 4/6] dt-bindings: arm: add Freescale LS1021A SoC device tree binding

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




On 08/04/2014 12:39 PM, Jingchang Lu wrote:
Signed-off-by: Jingchang Lu <jingchang.lu@xxxxxxxxxxxxx>
---
  Documentation/devicetree/bindings/arm/fsl.txt | 37 +++++++++++++++++++++++++++
  1 file changed, 37 insertions(+)

diff --git a/Documentation/devicetree/bindings/arm/fsl.txt b/Documentation/devicetree/bindings/arm/fsl.txt
index e935d7d..c962124 100644
--- a/Documentation/devicetree/bindings/arm/fsl.txt
+++ b/Documentation/devicetree/bindings/arm/fsl.txt
@@ -74,3 +74,40 @@ Required root node properties:
  i.MX6q generic board
  Required root node properties:
      - compatible = "fsl,imx6q";
+
+
+Freescale LS1021A Platform Device Tree Bindings
+------------------------------------------------
+
+Required root node compatible properties:
+  - compatible = "fsl,ls1021a";
+
+SoC-specific device tree bindings for system configuration
+-------------------------------------------
+
+Required device node compatible properties:
+
+  - compatible = "fsl,ls1021a-scfg":
+	scfg is the supplemental configuration unit, provides SoC specific
+	configuration and status registers for the chip. There is no dedicate
+	driver for it, but for device whose configuration and status register
+	locates in this space should operate on it. Such as getting PEX port
+	status.
+
+  - compatible = "fsl,ls1021a-dcfg":
+	dcfg is the device configuration unit that provides general purpose
+	configuration and status for the device, there is no dedicate driver
+	for it, but for device whose configuration and status register locates
+	in this space should operate on it. Such as setting the secondary core
+	start address and release the secondary core from holdoff and startup.

Is it that important to be mentioned in the binding that there is no driver for it? It seems to be just an implementation detail, the device tree describes the hardware not any particular implementation.

+
+Example:
+	scfg: scfg@1570000 {
+		compatible = "fsl,ls1021a-scfg";
+		reg = <0x0 0x1570000 0x0 0x10000>;

The reg is not part of the description above. I think that each of these nodes should be described separate, maybe something like this:

Freescale SCFG

scfg is the supplemental configuration unit, provides SoC specific configuration and status registers for the chip. There is no dedicate driver for it, but for device whose configuration and status register locates in this space should operate on it. Such as getting PEX port status.

Required properties:
- compatible: Should be "fsl,ls1021a-scfg"
- reg: should contain.....

+	};
+
+	dcfg: dcfg@1ee0000 {
+		compatible = "fsl,ls1021a-dcfg";
+		reg = <0x0 0x1ee0000 0x0 0x10000>;
+	};

Diana
--
To unsubscribe from this list: send the line "unsubscribe devicetree" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]
  Powered by Linux