[PATCH 1/2]: Document the global utilities node define and example

[PATCH 1/2]: Document the global utilities node define and example

[Zang Roy-r61911]

From: Roy Zang <tie-fei.zang@freescale.com>

Document the global utilities node define and example.
Signed-off-by: Roy Zang <tie-fei.zang@freescale.com>
---
Based on current paul's tree!

 Documentation/powerpc/booting-without-of.txt |   28 ++++++++++++++++++++++++++
 1 files changed, 28 insertions(+), 0 deletions(-)

diff --git a/Documentation/powerpc/booting-without-of.txt b/Documentation/powerpc/booting-without-of.txt
index d42d981..bdae4fc 100644
--- a/Documentation/powerpc/booting-without-of.txt
+++ b/Documentation/powerpc/booting-without-of.txt
@@ -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
@@ -1782,6 +1783,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 reg */
+		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
-- 
1.5.1

Re: [PATCH 1/2]: Document the global utilities node define and example

[Segher Boessenkool]

> Document the global utilities node define and example.
> Signed-off-by: Roy Zang <tie-fei.zang@freescale.com>

Acked-by: Segher Boessenkool <segher@kernel.crashing.org>

Thanks for documenting this stuff.  One nit though...

> +	global-utilities@e0000 {	/* global utilities reg */

s/reg/block/ .  It's not a single 32768 bit register I'm
sure (how would you access it?!)  :-)


Segher

Re: [PATCH 1/2]: Document the global utilities node define and example

[Zang Roy-r61911]

On Tue, 2007-06-19 at 16:49, Segher Boessenkool wrote:
> > Document the global utilities node define and example.
> > Signed-off-by: Roy Zang <tie-fei.zang@freescale.com>
> 
> Acked-by: Segher Boessenkool <segher@kernel.crashing.org>
> 
> Thanks for documenting this stuff.  One nit though...
> 
> > +     global-utilities@e0000 {        /* global utilities reg */
> 
> s/reg/block/ .  It's not a single 32768 bit register I'm
> sure (how would you access it?!)  :-)
I access it by a 32768 bit wide bus -:)!
Roy