From mboxrd@z Thu Jan 1 00:00:00 1970 From: Florian Fainelli Subject: [PATCH] Describe interrupts-extended property Date: Tue, 3 Jan 2017 11:24:23 -0800 Message-ID: <20170103192423.5838-1-f.fainelli@gmail.com> Return-path: DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id; bh=wm/LF4UufcLP9MBLqBZWnrSTkd4J4yNSMhH1QXknt8U=; b=DGWt5oFJGfeBMrE/GNTuNw7YU+elB+NvIbqyPim6uwsT5mqYBeTtxhBQWluvQGLdPE sar4Np41+dWP+puo8rV06zVy76VNZvxEct4qcl5ng7fmGIpNmbuYejyssvgbHfOV4g+v ZVX/o8RmaakErYgCjCS3RZuLaL4i3BIKI28sSmj5d2/OpYd4L/M2NtiWSx1ohgcZGkGs YZ6b4/ugQCk8e2GF76D/7R9NvaNM5yIdOdoiYT0P0ffmHh0/4g5BjFi0npJ1gRasFJwS nXtpqVI3FofGEbeZYBW+nImtUvUv/lpFS811GqKUwK0mC7/0fAXYFSK9e81c7CFZ9kla PJxA== Sender: devicetree-spec-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org List-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: devicetree-spec-u79uwXL29TY76Z2rM5mHXA@public.gmane.org Cc: robh+dt-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org, grant.likely-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org, Florian Fainelli 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 --- 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: `` `` + +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 + generating devices has several interrupt lines, some of them having distinct + 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