RE: [PATCH 2/2] serial: sh-sci: Document r7s9210 bindings

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi Geert,

I have one last clarification about your idea regarding documenting the 
interrupts separately for RZ/A2.

On Thursday, July 19, 2018, Geert Uytterhoeven wrote:
> For DT backwards compatibility, we have to keep support for the following
> 2 schemes:
>   1. Single "interrupts" value, no "interrupt-names", for fully
> multiplexed
>      interrupts (SH/R-Mobile, R-Car).
>   2. Four "interrupts" values, no "interrupt-names", for ERI/RXI/TXI/TEI
>      (RZ/A1, H8/300).
> 
> For RZ/A2, I suggest extending the bindings with interrupt-names,
> documenting all 6 interrupt sources, and let the driver handle that.
> That means there should be 6, not 5, "interrupts" values.
> Whether the driver implements all possible combinations, or only what you
> need for RZ/A2, is up to you. I agree the interrupt handling in the driver
> is already sufficiently complex.
> Ideally, you would document support for RZ/A1 with interrupt-names too,
> and handle that as well.

So for backward compatibility, no existing DT or setup-xxx.c (SH) file 
should change and the driver needs to assume the order of interrupts.

However, if "interrupt-names" is specified in DT, then the driver 
determines what the interrupt are based on their names, not the order in which
they are listed.

Correct?

So for example, RZ/A1 DT will stay the same and since "interrupt-names" 
was never used and the interrupt order will be assumed as 
ERI/RXI/TXI/BRI.

RZ/A1 [ r7s72100.dtsi ]
scif0: serial@e8007000 {
	compatible = "renesas,scif-r7s72100", "renesas,scif";
	reg = <0xe8007000 64>;
	interrupts = <GIC_SPI 190 IRQ_TYPE_LEVEL_HIGH>,
	             <GIC_SPI 191 IRQ_TYPE_LEVEL_HIGH>,
	             <GIC_SPI 192 IRQ_TYPE_LEVEL_HIGH>,
	             <GIC_SPI 189 IRQ_TYPE_LEVEL_HIGH>;
	clocks = <&mstp4_clks R7S72100_CLK_SCIF0>;
	clock-names = "fck";
	power-domains = <&cpg_clocks>;
	status = "disabled";
};


However, for RZ/A2, "interrupt-names" will be used and then the driver 
will sort things out however it needs to (figuring out what signals
are muxed together an such).

RZ/A2 [ r7s9210.dtsi ]
scif0: serial@e8007000 {
	compatible = "renesas,scif-r7s9210", "renesas,scif";
	reg = <0xe8007000 18>;
	interrupts = <GIC_SPI 265 IRQ_TYPE_LEVEL_HIGH>, /* ERI/BRI */
	             <GIC_SPI 266 IRQ_TYPE_LEVEL_HIGH>, /* RXI */
	             <GIC_SPI 267 IRQ_TYPE_LEVEL_HIGH>, /* TXI */
	             <GIC_SPI 265 IRQ_TYPE_LEVEL_HIGH>, /* ERI/BRI */
	             <GIC_SPI 268 IRQ_TYPE_LEVEL_HIGH>, /* TEI/DRI */
	             <GIC_SPI 268 IRQ_TYPE_LEVEL_HIGH>; /* TEI/DRI */
	interrupt-names = "eri", "rxi", "txi", "bri", "tei", "dri";

	clocks = <&mstp4_clks R7S9210_CLK_SCIF0>;
	clock-names = "fck";
	power-domains = <&cpg_clocks>;
	status = "disabled";
};


Are we on the same page?

Thanks!

Chris

��.n��������+%������w��{.n����z�{��ܨ}���Ơz�j:+v�����w����ޙ��&�)ߡ�a����z�ޗ���ݢj��w�f




[Index of Archives]     [Device Tree Compilter]     [Device Tree Spec]     [Linux Driver Backports]     [Video for Linux]     [Linux USB Devel]     [Linux PCI Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [XFree86]     [Yosemite Backpacking]


  Powered by Linux