Changes between Version 20 and Version 21 of kernel_interrupts

Timestamp:

Mar 27, 2015, 10:59:18 AM (9 years ago)

Author:

alain

Comment:

--

kernel_interrupts

@@ -36 +36 @@
 || EXT_IRQ_TER  || 3*NB_PROCS_MAX + lpid ||
 
+ == __Global variables used for external IRQs routing__ ==
+
+ * unsigned char '''_ext_irq_index'''[GIET_ISR_TYPE_MAX][GIET_ISR_CHANNEL_MAX];
+This array contains the external IRQ indexes (IOPIC input index) for each (isr/channel) couple.
+This is an hardware feature defined in the mapping.
+
+ * unsigned char '''_wti_alloc_one'''[X_SIZE][Y_SIZE][NB_PROCS_MAX];
+ * unsigned char '''_wti_alloc_two'''[X_SIZE][Y_SIZE][NB_PROCS_MAX];
+ * unsigned char '''_wti_alloc_ter'''[X_SIZE][Y_SIZE][NB_PROCS_MAX];
+These three arrays define the WTI allocators for each processor: non zero value when the entry has been allocated to a given external IRQ. This allocation is dynamically done by the kernel.
+
+
+ == __Functions used for dynamic allocation of external IRQs__ ==
+
+ === void '''_ext_irq_init'''() ===
+This function is only used when the architecture contains an external IOPIC component. It initializes the ''_ext_irq_index[isr][channel]'' kernel array. This array defines the IRQ index (i.e. the IOPIC input index) associated to an (isr_type / isr_channel) couple, as specified in the mapping. It is used by the kernel for dynamic routing of external IRQs.
+
+ === void '''_ext_irq_alloc( unsigned int isr_type , unsigned int isr_channel , unsigned int* wti_index ) ===
+This function is used when the architecture contains an external IOPIC component. It dynamically allocates an external IRQ signaling completion of an I/O operation to the processor P[x,y,p] running the calling task. The two (isr_type / isr_channel) arguments define actually the external IRQ to be routed.
+ * '''isr_type''' : type of ISR 
+ * '''isr_channel''' : ISR channel (for multi-channels peripherals)
+ * '''wti_index''' : return value defining the index of the WTI mailbox allocated to P[x,y,p]
+This function does three things: 
+ 1. it allocates a WTI mailbox in the XCU of cluster[x,y] to the requesting processor ( index is in [4*p+1, 4*p+2, 4*p+3] ) ; 
+ 2. it initialises the IOPIC entry associated to the (isr_type/isr_channel) IRQ.
+ 3. it initializes the proper entry in the WTI interrupt vector associated to processor P[x,y,p].
+
+ === void '''_ext_irq_release( unsigned int isr_type , unsigned int isr_channel , unsigned int wti_index ) ===
+This function is used when the architecture contains an external IOPIC component. It desallocates the ressources allocated by the  previous _ext_irq_alloc() function to the calling processor. The two (isr_type, isr_channel) arguments define actually the external IRQ to be released.
+ * '''isr_type''' : type of ISR 
+ * '''isr_channel''' : ISR channel (for multi-channels peripherals)
+ * '''wti_index''' :  index of the WTI mailbox allocated to P[x,y,p] to be released.
+This function does only two things: 
+ 1.  it desactivates the PIC entry associated to the (isr_type/isr_channel) IRQ.
+ 2. it releases the WTI mailbox allocated to P[x,y,p].
+ 3. The WTI interrupt vector is NOT modified
+
+
  == __Functions used for all HWI / PTI / WTI interrupts__ ==
 
@@ -62 +100 @@
  === void '''_isr_default'''() ===
 This default ISR is called  when the interrupt handler is called, and there is no active IRQ. It simply displays a warning message on the kernel TTY[0].
-
- == __Functions used for dynamic allocation of external IRQs__ ==
-
- === void '''_ext_irq_init'''() ===
-This function is only used when the architecture contains an external IOPIC component. It initializes the ''_ext_irq_index[isr][channel]'' kernel array. This array defines the IRQ index (i.e. the IOPIC input index) associated to an (isr_type / isr_channel) couple, as specified in the mapping. It is used by the kernel for dynamic routing of external IRQs.
-
- === void '''_ext_irq_alloc( unsigned int isr_type , unsigned int isr_channel , unsigned int* wti_index ) ===
-This function is used when the architecture contains an external IOPIC component. It dynamically allocates an external IRQ signaling completion of an I/O operation to the processor P[x,y,p] running the calling task. The two (isr_type / isr_channel) arguments define actually the external IRQ to be routed.
- * '''isr_type''' : type of ISR 
- * '''isr_channel''' : ISR channel (for multi-channels peripherals)
- * '''wti_index''' : return value defining the index of the WTI mailbox allocated to P[x,y,p]
-This function does three things: 
- 1. it allocates a WTI mailbox in the XCU of cluster[x,y] to the requesting processor ( index is in [4*p+1, 4*p+2, 4*p+3] ) ; 
- 2. it initialises the IOPIC entry associated to the (isr_type/isr_channel) IRQ.
- 3. it initializes the proper entry in the WTI interrupt vector associated to processor P[x,y,p].
-
- === void '''_ext_irq_release( unsigned int isr_type , unsigned int isr_channel , unsigned int wti_index ) ===
-This function is used when the architecture contains an external IOPIC component. It desallocates the ressources allocated by the  previous _ext_irq_alloc() function to the calling processor. The two (isr_type, isr_channel) arguments define actually the external IRQ to be released.
- * '''isr_type''' : type of ISR 
- * '''isr_channel''' : ISR channel (for multi-channels peripherals)
- * '''wti_index''' :  index of the WTI mailbox allocated to P[x,y,p] to be released.
-This function does only two things: 
- 1.  it desactivates the PIC entry associated to the (isr_type/isr_channel) IRQ.
- 2. it releases the WTI mailbox allocated to P[x,y,p].
- 3. The WTI interrupt vector is NOT modified
-