[PATCH] [POWERPC] Add docs for Freescale DMA & DMA channel device tree nodes

[Kumar Gala]

On Jan 22, 2008, at 3:30 PM, Timur Tabi wrote:

> Kumar Gala wrote:
>> Signed-off-by: Zhang Wei <wei.zhang at freescale.com>
>> Signed-off-by: Ebony Zhu <ebony.zhu at freescale.com>
>> Signed-off-by: Kumar Gala <galak at kernel.crashing.org>
>> ---
>> Guys please review and make sure I got all your previous comments  
>> fixed
>> up.  I've added cell-index. and the examples should represent real  
>> HW.
>> Documentation/powerpc/booting-without-of.txt |  128 ++++++++++++++++ 
>> ++++++++++
>> 1 files changed, 128 insertions(+), 0 deletions(-)
>> diff --git a/Documentation/powerpc/booting-without-of.txt b/ 
>> Documentation/powerpc/booting-without-of.txt
>> index da98154..3584c33 100644
>> --- a/Documentation/powerpc/booting-without-of.txt
>> +++ b/Documentation/powerpc/booting-without-of.txt
>> @@ -2615,6 +2615,134 @@ platforms are moved over to use the  
>> flattened-device-tree model.
>>        - clock-frequency  : The frequency of the input clock, which  
>> typically
>>                             comes from an on-board dedicated  
>> oscillator.
>> +    * Freescale 83xx DMA Controller
>> +
>> +    Freescale PowerPC 83xx have on chip general purpose DMA  
>> controllers.
>> +
>> +    Required properties:
>> +
>> +    - compatible        : compatible list, contains 2 entries,  
>> first is
>> +			 "fsl,CHIP-dma", where CHIP is the processor
>> +			 (mpc8349, mpc8360, etc.) and the second is
>> +			 "fsl,elo-dma"
>> +    - reg               : <registers mapping for DMA general  
>> status reg>
>> +    - ranges 		: Should be defined as specified in 1) to describe  
>> the
>> +			  DMA controller channels.
>
> What does "Should be defined as specified in 1)" mean?

Its referring to section 1 of the doc on ranges.  Other nodes use this  
description for ranges. (soc, muram)

>> +    - cell-index        : controller index.  0 for controller @  
>> 0x8100
>
> This should be more generic.  I believe for each of our SoCs, we  
> designation one DMA controller to be "DMA Controller 1", and that  
> one should have a cell-index of "0".

Ok, on 83xx that controller is always at offset 0x8100.

- k