From mboxrd@z Thu Jan 1 00:00:00 1970 From: David Gibson Subject: Re: [PATCH] Describe interrupts-extended property Date: Wed, 4 Jan 2017 10:04:36 +1100 Message-ID: <20170103230436.GS12761@umbus.fritz.box> References: <20170103192423.5838-1-f.fainelli@gmail.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="OtP8TOIcu2/MSuWQ" Return-path: DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gibson.dropbear.id.au; s=201602; t=1483486610; bh=h+AGUh79uEHhB2FN2EnLQOP5gZu6OsmYPiJ7NXlaAN8=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=WWczuTqf8QH8K4XJAURxcYcN0eivokOFDPxctSrSVA/ZQ5JbbHLwxfHxszA1iPGrN K3+RVtaf4BTWvd1r83Uft3NdEiF0/V4AWpiHehmB2hgLv2StN67SXbagznS9vpXcpR zznPjPWxzESJ1pGGdR1C4rJStHA5esDlPn7xVI3s= Content-Disposition: inline In-Reply-To: <20170103192423.5838-1-f.fainelli-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> Sender: devicetree-spec-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org List-ID: To: Florian Fainelli Cc: devicetree-spec-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, robh+dt-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org, grant.likely-QSEj5FYQhm4dnm+yROfE0A@public.gmane.org --OtP8TOIcu2/MSuWQ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jan 03, 2017 at 11:24:23AM -0800, Florian Fainelli 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. >=20 > Signed-off-by: Florian Fainelli Hmm. Is this actually used in the wild already? I'm just wondering if it's really needed, since you can work around the limitations with the ordinary interrupts property by setting interrupt-parent to the node itself putting an interrupt nexus (interrupt-map and interrupt-map-mask properties) in there to redirect those to different interrupt controllers. > --- > source/devicetree-basics.rst | 34 ++++++++++++++++++++++++++++++++++ > 1 file changed, 34 insertions(+) >=20 > 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, i= ts > interrupt parent is assumed to be its devicetree parent. > =20 > +interrupts-extended > +^^^^^^^^^^^^^^^^^^^ > + > +Property: ``interrupts-extended`` > + > +Value type: `` `` > + > +Description: > + > + The *interrupts-extended* property of a device node defines the inter= rupt or > + the interrupts that are generated by the device. In case where an int= errupt > + generating devices has several interrupt lines, some of them having d= istinct > + interrupt parents, the *interrupts-extended* property should be used = to > + fully describe the interrupts of this device, relative to the interru= pt > + controller(s), which is encoded by the phandle part of the property. = The non > + phandle part of the property encodes the interrupt specifiers and obe= ys to > + the *interrupts* property description. > + > + If both *interrupts-extended* and *interrupts* properties are present= , the > + *interrupts-extended* properties takes precedence, and the *interrupt= s* > + property may be provided to a client program for compatibility purpos= es. > + > +Example: > + > + A device with several interrupt lines in distinct interrupt controlle= rs, > + having different interrupt specifiers is illustrated below. In this e= xample > + ``pic`` is an interrupt controller with an *#interrupt-cells* specifi= er > + of 2, while ``gic`` is an interrupt controller with an *#interrupts-c= ells* > + specifier of 1. > + > + > + ``interrupts-extended =3D <&pic 0xA 8>, <&gic 0xda>;`` > + > + > Properties for Interrupt Controllers > ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > =20 --=20 David Gibson | I'll have my music baroque, and my code david AT gibson.dropbear.id.au | minimalist, thank you. NOT _the_ _other_ | _way_ _around_! http://www.ozlabs.org/~dgibson --OtP8TOIcu2/MSuWQ Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCAAGBQJYbC4CAAoJEGw4ysog2bOSY+EP/1YZgOKER1ErRAAdimwG6Lhy KghS13T4oRJDQ4wia/arYxebVZ0o7JwZerS8W34Dp+H5Ub9cs47I6ZUZZU24V+QF h7JgDVMHMpEK8eQUMJyqQ7xmzBI66HhJK36jjETCiaJS2oGn31FDngcJRTWXPb0A 8SL1gCziqWD+4gP+tJy0932dtg3dkrP9ouu+1Qyl1j3eclApq2Fphia7gs+XbRf4 NpMACogXtAp0hyEqNZAHAyF/u+buzO45YRMGthv2u+9TgFvkqQ/jpsOc20peQ6Us VxGwtMT/bHurMc7QPBMtCvJZkC9zCqePfurij23tDn4WFUUOwPgiXzY7KEHPEqcA yJdo9HKW3yJim8wcGctaLyyy4B+sh65OEyeNuQLikfe47yJgP0lshXjikxfD4LW9 F8z81Nb/1f+0ytePNCuA+FOACuYSysrkjtdKN+rB4iMtENFodSjQJ4rK8JeOtkbF W52dJTHsoc1ubX4jRTbTdtZbValTJgCcCnWsWp+9/URbeg7Duz9jicRUrmNr3V3z 7by/lm19fMbBJgm6Noix8dIZruqTxbbRDCPPxONhpJh3YIs0S7/tsu4T31hsmykW //tL6HDyy/9/ZFNGtbO1jXGA46JTts313YqIBJJQuq9rOOgYhJo9amObMII1I5b7 ykyr6tAnShvNk6IgTEIu =S+Bs -----END PGP SIGNATURE----- --OtP8TOIcu2/MSuWQ--