[PATCH 1/2] fsl: Add binding for RCPM

[Wang Dongsheng]

Hi Scott,

Thanks for your review.

> -----Original Message-----
> From: Wood Scott-B07421
> Sent: Thursday, September 10, 2015 3:57 AM
> To: Wang Dongsheng-B40534
> Cc: devicetree at vger.kernel.org; linuxppc-dev at lists.ozlabs.org; Jin Zhengxiong-
> R64188; Zhao Chenhui-B35336; Tang Yuantian-B29983; Wang Huan-B18965;
> robh+dt at kernel.org; linux-arm-kernel at lists.infradead.org
> Subject: Re: [PATCH 1/2] fsl: Add binding for RCPM
> 
> On Wed, 2015-09-09 at 14:42 +0800, Dongsheng Wang wrote:
> > From: Wang Dongsheng <dongsheng.wang at freescale.com>
> >
> > RCPM is the Run Control and Power Management module performs all
> > device-level tasks associated with device run control and power
> > management.
> >
> > Add this for freescale powerpc platform and layerscape platform.
> >
> > Signed-off-by: Chenhui Zhao <chenhui.zhao at freescale.com>
> > Signed-off-by: Tang Yuantian <Yuantian.Tang at freescale.com>
> > Signed-off-by: Wang Dongsheng <dongsheng.wang at freescale.com>
> >
> > diff --git a/Documentation/devicetree/bindings/soc/fsl/rcpm.txt
> > b/Documentation/devicetree/bindings/soc/fsl/rcpm.txt
> > new file mode 100644
> > index 0000000..284070c
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/soc/fsl/rcpm.txt
> > @@ -0,0 +1,64 @@
> > +* Run Control and Power Management
> > +-------------------------------------------
> > +The RCPM performs all device-level tasks associated with device run control
> > +and power management.
> > +
> > +Required properites:
> > +  - reg : Offset and length of the register set of RCPM block.
> > +  - compatible : Sould contain a chip-specific RCPM block compatible string
> > +     and (if applicable) may contain a chassis-version RCPM compatible string.
> > +     Chip-specific strings are of the form "fsl,<chip>-rcpm", such as:
> > +     * "fsl,p2041-rcpm"
> > +     * "fsl,p3041-rcpm"
> > +     * "fsl,p4080-rcpm"
> > +     * "fsl,p5020-rcpm"
> > +     * "fsl,p5040-rcpm"
> > +     * "fsl,t4240-rcpm"
> > +     * "fsl,b4420-rcpm"
> > +     * "fsl,b4860-rcpm"
> > +
> > +     Chassis-version strings are of the form "fsl,qoriq-rcpm-<version>",
> > +     such as:
> > +     * "fsl,qoriq-rcpm-1.0": for chassis 1.0 rcpm
> > +     * "fsl,qoriq-rcpm-2.0": for chassis 2.0 rcpm
> > +     * "fsl,qoriq-rcpm-2.1": for chassis 2.1 rcpm
> > +
> > +All references to "1.0" and "2.0" refer to the QorIQ chassis version to
> > +which the chip complies.
> > +Chassis Version              Example Chips
> > +---------------              -------------------------------
> > +1.0                          p4080, p5020, p5040, p2041, p3041
> > +2.0                          t4240, b4860, b4420
> > +2.1                          t1040, ls1021
> > +
> > +Example:
> > +The RCPM node for T4240:
> > +     rcpm:  global-utilities at e2000{
> > +             compatible = "fsl,t4240-rcpm", "fsl,qoriq-rcpm-2.0";
> > +             reg = <0xe2000 0x1000>;
> > +     };
> > +
> > +The RCPM node for P4080:
> > +     rcpm:  global-utilities at e2000{
> > +             compatible = "fsl,qoriq-rcpm-1.0";
> > +             reg = <0xe2000 0x1000>;
> > +     };
> 
> I would avoid putting the p4080 example in the binding, as we don't want to
> make it look like it's OK to leave out the specific chip compatible.
> 

Fine, I will add the specific chip compatible in this example.
compatible = "fsl,p4080-rcpm", "fsl,qoriq-rcpm-1.0";

> > +* Freescale RCPM Wakeup Source Device Tree Bindings
> > +-------------------------------------------
> > +Required rcpm-wakeup property should be added to a device node if the
> > device
> > +can be used as a wakeup source.
> > +
> > +  - rcpm-wakeup: should contain a pointer to the rcpm node and the
> > +     corresponding bit of device in the register.
> 
> The corresponding bit in *what* register?
> 

RCPM_IPPDEXPCRx register, I will add a explain to this.

Regards,
-Dongsheng