[POWERPC] Document the global utilities node define and example
authorRoy Zang <tie-fei.zang@freescale.com>
Tue, 19 Jun 2007 07:19:18 +0000 (15:19 +0800)
committerKumar Gala <galak@kernel.crashing.org>
Tue, 3 Jul 2007 07:01:49 +0000 (02:01 -0500)
Document the global utilities node define and example.

Signed-off-by: Roy Zang <tie-fei.zang@freescale.com>
Signed-off-by: Kumar Gala <galak@kernel.crashing.org>
Documentation/powerpc/booting-without-of.txt

index c169299716b1bb148aa3d3c537bc1ea4cf637a51..06141cb200fa0734df549ebed4f6536aeba4409f 100644 (file)
@@ -51,6 +51,7 @@ Table of Contents
       h) Board Control and Status (BCSR)
       i) Freescale QUICC Engine module (QE)
       g) Flash chip nodes
+      k) Global Utilities Block
 
   VII - Specifying interrupt information for devices
     1) interrupts property
@@ -1790,6 +1791,33 @@ platforms are moved over to use the flattened-device-tree model.
                partition-names = "fs\0firmware";
        };
 
+   k) Global Utilities Block
+
+   The global utilities block controls power management, I/O device
+   enabling, power-on-reset configuration monitoring, general-purpose
+   I/O signal configuration, alternate function selection for multiplexed
+   signals, and clock control.
+
+   Required properties:
+
+    - compatible : Should define the compatible device type for
+      global-utilities.
+    - reg : Offset and length of the register set for the device.
+
+  Recommended properties:
+
+    - fsl,has-rstcr : Indicates that the global utilities register set
+      contains a functioning "reset control register" (i.e. the board
+      is wired to reset upon setting the HRESET_REQ bit in this register).
+
+    Example:
+
+       global-utilities@e0000 {        /* global utilities block */
+               compatible = "fsl,mpc8548-guts";
+               reg = <e0000 1000>;
+               fsl,has-rstcr;
+       };
+
    More devices will be defined as this spec matures.
 
 VII - Specifying interrupt information for devices