On 04/19/2011 12:52 PM, Scott Wood wrote:
> On Tue, 19 Apr 2011 11:59:34 -0500
> Meador Inge <meador_i...@mentor.com> wrote:
> 
>> +    - interrupt-parent: Specifies the interrupt parent of the message 
>> register
>> +      block.  The type shall be a <phandle> and the value of that <phandle>
>> +      shall point to the interrupt parent.
> 
> interrupt-parent is not required; it can be inherited from an ancestor.  In
> any case, this description doesn't say anything specifically about MPIC
> message nodes.

Removed.

>>  The default value shall be
>> +      all a string of consecutive ones where the length of the run is equal
>> +      to the number of registers in the block.  For example, a block with
>> +      four registers shall default to 0xF.
> 
> Could be more simply worded as, "If not present, all message registers in
> the group are available."

That is much better.

>> +Required alias:
>> +
>> +    In order for a message register block to be discovered it *must* define
>> +    an alias in the 'aliases' node.
> 
> I think the "in order to be discovered" statement is specific to your use
> case.
> 
>>  Aliases are of the form 'msgr-block<n>',
>> +    where <n> is an integer specifying the block's number.  Numbers shall 
>> start
>> +    at 0.
> 
> The hw docs refer to "group A" and "group B", not "block 0" and "block 1".
> 
> Plus, I'd put "mpic-" in the alias name.

Are you suggesting that the alias should be called: 'mpic-groupA',
'mpic-groupB', 'mpic-groupC', etc... ?  Or just that I should use the 
terminology
group instead of block where discussing things in the binding?


>> +Example:
>> +
>> +    /* The aliases needed to define an order on the message register blocks.
>> +     */
>> +    aliases {
>> +            msgr-block0 = &msgr_block0;
>> +            msgr-block1 = &msgr_block1;
>> +    };
>> +
>> +    msgr_block0: msgr-block@41400 {
>> +            compatible = "fsl,mpic-v3.1-msgr";
>> +            reg = <0x41400 0x200>;
>> +            // Message registers 0 and 3 in this block can receive 
>> interrupts on
>> +            // sources 0xb0 and 0xb2, respectively.
>> +            interrupts = <0xb0 2 0xb2 2>;
>> +            msg-receive-mask = <0x5>;
>> +            interrupt-parent = <&mpic>;
>> +    };
> 
> A mask of 0x5 specifies message registers 0 and 2 (as do interrupts 0xb0
> and 0xb2), not 0 and 3.
> 

Fixed.  Thanks.

-- 
Meador Inge     | meador_inge AT mentor.com
Mentor Embedded | http://www.mentor.com/embedded-software
_______________________________________________
Linuxppc-dev mailing list
Linuxppc-dev@lists.ozlabs.org
https://lists.ozlabs.org/listinfo/linuxppc-dev

Reply via email to