On Tue, Nov 01, 2016 at 07:52:00PM +0800, Youlin Pei wrote: > This commit adds the device tree binding document for > the mediatek cirq. > > Signed-off-by: Youlin Pei <youlin.pei@xxxxxxxxxxxx> > --- > .../interrupt-controller/mediatek,cirq.txt | 30 ++++++++++++++++++++ > 1 file changed, 30 insertions(+) > create mode 100644 Documentation/devicetree/bindings/interrupt-controller/mediatek,cirq.txt > > diff --git a/Documentation/devicetree/bindings/interrupt-controller/mediatek,cirq.txt b/Documentation/devicetree/bindings/interrupt-controller/mediatek,cirq.txt > new file mode 100644 > index 0000000..84e8123 > --- /dev/null > +++ b/Documentation/devicetree/bindings/interrupt-controller/mediatek,cirq.txt > @@ -0,0 +1,30 @@ > +* Mediatek 27xx cirq > + > +In Mediatek SOCs, the CIRQ is a low power interrupt controller designed to > +works outside MCUSYS which comprises with Cortex-Ax cores,CCI and GIC. s/works/work/ > +The external interrupts (outside MCUSYS) will feed through CIRQ and connect > +to GIC in MCUSYS. When CIRQ is enabled, it will record the edge-sensitive > +interrupts and generated a pulse signal to parent interrupt controller when s/generated/generate/ > +flush command is executed. With CIRQ, MCUSYS can be completely turned off > +to improve the system power consumption without losing interrupts. > + > +Required properties: > +- compatible: should be: "mediatek,mtk-cirq". This should be SoC specific. This is fine as a fallback if the same block is in many SoCs, but mediatek and mtk is a bit redundant. > +- interrupt-controller : Identifies the node as an interrupt controller. > +- #interrupt-cells : Use the same format as specified by GIC in arm,gic.txt. > +- interrupt-parent: phandle of irq parent for cirq. The parent must > + use the same interrupt-cells format as GIC. > +- reg: Physical base address of the cirq registers and length of memory > + mapped region. > +- mediatek,ext-irq-start: Identifies external irq start number in different > + SOCs. Wouldn't this always be 32 if the GIC is the parent? If 32 is the common case, then use the SoC compatible to determine this value. > + > +Example: > + cirq: interrupt-controller@10204000 { > + compatible = "mediatek,mtk-cirq"; > + interrupt-controller; > + #interrupt-cells = <3>; > + interrupt-parent = <&sysirq>; > + reg = <0 0x10204000 0 0x4000>; > + mediatek,ext-irq-start = <32>; > + }; > -- > 1.7.9.5 > -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html