Correcting Grant's email. On Tue, Jan 3, 2017 at 1:24 PM, Florian Fainelli <f.fainelli@xxxxxxxxx> wrote: > The interrupts-extended property is a common property used when > interrupt generating devices having interrupt lines in several interrupt > controllers with possibly distinct interrupt specifiers. > > Signed-off-by: Florian Fainelli <f.fainelli@xxxxxxxxx> I assume this is mostly copied from the kernel documentation. This needs Grant's ack as the kernel documentation license is ambiguous (default GPL) and the spec is Apache. > --- > source/devicetree-basics.rst | 34 ++++++++++++++++++++++++++++++++++ > 1 file changed, 34 insertions(+) > > diff --git a/source/devicetree-basics.rst b/source/devicetree-basics.rst > index be80af3d825b..1bda0fa54e7a 100644 > --- a/source/devicetree-basics.rst > +++ b/source/devicetree-basics.rst > @@ -955,6 +955,40 @@ Description: > to the interrupt parent. If this property is missing from a device, its > interrupt parent is assumed to be its devicetree parent. > > +interrupts-extended > +^^^^^^^^^^^^^^^^^^^ > + > +Property: ``interrupts-extended`` > + > +Value type: ``<phandle> <prop-encoded-array>`` > + > +Description: > + > + The *interrupts-extended* property of a device node defines the interrupt or > + the interrupts that are generated by the device. In case where an interrupt In the case... > + generating devices has several interrupt lines, some of them having distinct s/devices/device/ > + interrupt parents, the *interrupts-extended* property should be used to > + fully describe the interrupts of this device, relative to the interrupt > + controller(s), which is encoded by the phandle part of the property. The non > + phandle part of the property encodes the interrupt specifiers and obeys to > + the *interrupts* property description. > + > + If both *interrupts-extended* and *interrupts* properties are present, the > + *interrupts-extended* properties takes precedence, and the *interrupts* > + property may be provided to a client program for compatibility purposes. > + > +Example: > + > + A device with several interrupt lines in distinct interrupt controllers, > + having different interrupt specifiers is illustrated below. In this example > + ``pic`` is an interrupt controller with an *#interrupt-cells* specifier > + of 2, while ``gic`` is an interrupt controller with an *#interrupts-cells* > + specifier of 1. > + > + > + ``interrupts-extended = <&pic 0xA 8>, <&gic 0xda>;`` > + > + > Properties for Interrupt Controllers > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > > -- > 2.9.3 > -- To unsubscribe from this list: send the line "unsubscribe devicetree-spec" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
