aha/Documentation/fujitsu/frv
David Howells 28baebae73 [PATCH] FRV: Use virtual interrupt disablement
Make the FRV arch use virtual interrupt disablement because accesses to the
processor status register (PSR) are relatively slow and because we will
soon have the need to deal with multiple interrupt controls at the same
time (separate h/w and inter-core interrupts).

The way this is done is to dedicate one of the four integer condition code
registers (ICC2) to maintaining a virtual interrupt disablement state
whilst inside the kernel.  This uses the ICC2.Z flag (Zero) to indicate
whether the interrupts are virtually disabled and the ICC2.C flag (Carry)
to indicate whether the interrupts are physically disabled.

ICC2.Z is set to indicate interrupts are virtually disabled.  ICC2.C is set
to indicate interrupts are physically enabled.  Under normal running
conditions Z==0 and C==1.

Disabling interrupts with local_irq_disable() doesn't then actually
physically disable interrupts - it merely sets ICC2.Z to 1.  Should an
interrupt then happen, the exception prologue will note ICC2.Z is set and
branch out of line using one instruction (an unlikely BEQ).  Here it will
physically disable interrupts and clear ICC2.C.

When it comes time to enable interrupts (local_irq_enable()), this simply
clears the ICC2.Z flag and invokes a trap #2 if both Z and C flags are
clear (the HI integer condition).  This can be done with the TIHI
conditional trap instruction.

The trap then physically reenables interrupts and sets ICC2.C again.  Upon
returning the interrupt will be taken as interrupts will then be enabled.
Note that whilst processing the trap, the whole exceptions system is
disabled, and so an interrupt can't happen till it returns.

If no pending interrupt had happened, ICC2.C would still be set, the HI
condition would not be fulfilled, and no trap will happen.

Saving interrupts (local_irq_save) is simply a matter of pulling the ICC2.Z
flag out of the CCR register, shifting it down and masking it off.  This
gives a result of 0 if interrupts were enabled and 1 if they weren't.

Restoring interrupts (local_irq_restore) is then a matter of taking the
saved value mentioned previously and XOR'ing it against 1.  If it was one,
the result will be zero, and if it was zero the result will be non-zero.
This result is then used to affect the ICC2.Z flag directly (it is a
condition code flag after all).  An XOR instruction does not affect the
Carry flag, and so that bit of state is unchanged.  The two flags can then
be sampled to see if they're both zero using the trap (TIHI) as for the
unconditional reenablement (local_irq_enable).

This patch also:

 (1) Modifies the debugging stub (break.S) to handle single-stepping crossing
     into the trap #2 handler and into virtually disabled interrupts.

 (2) Removes superseded fixup pointers from the second instructions in the trap
     tables (there's no a separate fixup table for this).

 (3) Declares the trap #3 vector for use in .org directives in the trap table.

 (4) Moves irq_enter() and irq_exit() in do_IRQ() to avoid problems with
     virtual interrupt handling, and removes the duplicate code that has now
     been folded into irq_exit() (softirq and preemption handling).

 (5) Tells the compiler in the arch Makefile that ICC2 is now reserved.

 (6) Documents the in-kernel ABI, including the virtual interrupts.

 (7) Renames the old irq management functions to different names.

Signed-off-by: David Howells <dhowells@redhat.com>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
2006-02-14 16:09:35 -08:00
..
atomic-ops.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
booting.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
clock.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
configuring.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
features.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
gdbinit Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
gdbstub.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
kernel-ABI.txt [PATCH] FRV: Use virtual interrupt disablement 2006-02-14 16:09:35 -08:00
mmu-layout.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00
README.txt Linux-2.6.12-rc2 2005-04-16 15:20:36 -07:00

		       ================================
		       Fujitsu FR-V LINUX DOCUMENTATION
		       ================================

This directory contains documentation for the Fujitsu FR-V CPU architecture
port of Linux.

The following documents are available:

 (*) features.txt

     A description of the basic features inherent in this architecture port.


 (*) configuring.txt

     A summary of the configuration options particular to this architecture.


 (*) booting.txt

     A description of how to boot the kernel image and a summary of the kernel
     command line options.


 (*) gdbstub.txt

     A description of how to debug the kernel using GDB attached by serial
     port, and a summary of the services available.


 (*) mmu-layout.txt

     A description of the virtual and physical memory layout used in the
     MMU linux kernel, and the registers used to support it.


 (*) gdbinit

     An example .gdbinit file for use with GDB. It includes macros for viewing
     MMU state on the FR451. See mmu-layout.txt for more information.


 (*) clock.txt

     A description of the CPU clock scaling interface.


 (*) atomic-ops.txt

     A description of how the FR-V kernel's atomic operations work.