README on the Vectored Interrupt Controller of the LH7A404==========================================================The 404 revision of the LH7A40X series comes with two vectoredinterrupts controllers.  While the kernel does use some of thefeatures of these devices, it is far from the purpose for which theywere designed.When this README was written, the implementation of the VICs was influx.  It is possible that some details, especially with priorities,will change.The VIC support code is inspired by routines written by Sharp.Priority Control----------------The significant reason for using the VIC's vectoring is to controlinterrupt priorities.  There are two tables inarch/arm/mach-lh7a40x/irq-lh7a404.c that look something like this.  static unsigned char irq_pri_vic1[] = { IRQ_GPIO3INTR, };  static unsigned char irq_pri_vic2[] = {	IRQ_T3UI, IRQ_GPIO7INTR,	IRQ_UART1INTR, IRQ_UART2INTR, IRQ_UART3INTR, };The initialization code reads these tables and inserts a vectoraddress and enable for each indicated IRQ.  Vectored interrupts havehigher priority than non-vectored interrupts.  So, on VIC1,IRQ_GPIO3INTR will be served before any other non-FIQ interrupt.  Dueto the way that the vectoring works, IRQ_T3UI is the next highestpriority followed by the other vectored interrupts on VIC2.  Afterthat, the non-vectored interrupts are scanned in VIC1 then in VIC2.ISR---The interrupt service routine macro get_irqnr() inarch/arm/kernel/entry-armv.S scans the VICs for the next activeinterrupt.  The vectoring makes this code somewhat larger than it wasbefore using vectoring (refer to the LH7A400 implementation).  In thecase where an interrupt is vectored, the implementation will tend tobe faster than the non-vectored version.  However, the worst-case pathis longer.It is worth noting that at present, there is no need to readVIC2_VECTADDR because the register appears to be shared between thecontrollers.  The code is written such that if this changes, it oughtto still work properly.Vector Addresses----------------The proper use of the vectoring hardware would jump to the ISRspecified by the vectoring address.  Linux isn't structured to takeadvantage of this feature, though it might be possible to changethings to support it.In this implementation, the vectoring address is used to speed thesearch for the active IRQ.  The address is coded such that the lowest6 bits store the IRQ number for vectored interrupts.  These numberscorrespond to the bits in the interrupt status registers.  IRQ zero isthe lowest interrupt bit in VIC1.  IRQ 32 is the lowest interrupt bitin VIC2.  Because zero is a valid IRQ number and because we cannotdetect whether or not there is a valid vectoring address if thataddress is zero, the eigth bit (0x100) is set for vectored interrupts.The address for IRQ 0x18 (VIC2) is 0x118.  Only the ninth bit is setfor the default handler on VIC1 and only the tenth bit is set for thedefault handler on VIC2.In other words.  0x000		- no active interrupt  0x1ii		- vectored interrupt 0xii  0x2xx		- unvectored interrupt on VIC1 (xx is don't care)  0x4xx		- unvectored interrupt on VIC2 (xx is don't care)