lkml.org 
[lkml]   [2012]   [Sep]   [19]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    /
    Date
    From
    SubjectRe: [PATCH 1/2] dt: Document general interrupt controller bindings
    On 09/19/2012 02:57 AM, Thierry Reding wrote:
    > In order to use a device as interrupt controller, it needs to be marked
    > with the DT interrupt-controller property. This commit adds rudimentary
    > documentation about the required standard properties and describes the
    > most commonly used interrupt specifiers.

    > +++ b/Documentation/devicetree/bindings/interrupt-controller/interrupts.txt
    > @@ -0,0 +1,94 @@
    > +Specifying interrupt information for devices
    > +============================================
    > +
    > +1) Interrupt user nodes
    > +-----------------------

    s/user/client/? Bike-shedding a little I suppose.

    > +
    > +A device that generates interrupts can specify the interrupt controller to
    > +which the interrupts are routed by passing the controller's phandle in the
    > +"interrupt-parent" property.
    > +
    > +The "interrupts" property is a list of specifiers that describe each of the
    > +interrupts. See section 2 below for details.

    This should probably mention that interrupt-parent cascades from parent
    nodes. How about the following instead:

    Nodes that describe devices which generate interrupts must contain an
    "interrupts" property. This property must contain a list of interrupt
    specifiers, one per output interrupt. The format of the interrupt
    specifier is determined by the interrupt controller to which the
    interrupts are routed; see section 2 below for details.

    The interrupt-parent property is used to define the controller to which
    interrupts are routed; it contains a single phandle referring to the
    interrupt controller node. This property may be specified in any
    interrupt client node, or in any parent node of the device.


    \
     
     \ /
      Last update: 2012-09-19 18:01    [W:4.139 / U:0.316 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site