中断使能、禁止程序——之oem.c程序分析

作者：wogoyixikexie@gliet

刚才看了何宗健老师的书，在5.0BSP中，在系统启动阶段，除了时钟中断以外，其他中断都是关闭的。在加载驱动的时候，驱动程序负责加载自己所用到的驱动，方法是调用InterruptInitialize。真正工作的是OEMInterruptEnable而这个函数又调用OALIntrEnableIrqs函数。

 

现在让我们一步一步来看代码分析。

首先看InterruptInitialize----------奇怪了，在4.2中的驱动中能找到这个函数被调用，5.0下的却不行。哎怎么回事？

 

然后OEMInterruptEnable

这个函数在C:/WINCE500/PLATFORM/COMMON/SRC/COMMON/INTR/COMMON/oem.c

1. //------------------------------------------------------------------------------
2. //
3. //  File: oem.c
4. //
5. //  This file implements a standard implementation of OEMInterrupt functions
6. //  relating to enabling, disabling and finishing interrupts.
7. //
8. #include <windows.h>
9. #include <nkintr.h>
10. #include <oal.h>
13. //------------------------------------------------------------------------------
14. //
15. //  Function:  OEMInterruptEnable
16. //
17. //  This function enables the IRQ given its corresponding SysIntr value.
18. //  Function returns true if SysIntr is valid, else false.
19. //
20. BOOL OEMInterruptEnable(DWORD sysIntr, LPVOID pvData, DWORD cbData)
21. {
22.     BOOL rc = FALSE;
23.     const UINT32 *pIrqs;//注意这个是个常量指针，以前我总想找他的老家，汗！
24.     UINT32 count;
26.     OALMSG(OAL_INTR&&OAL_VERBOSE, 
27.         (L"+OEMInterruptEnable(%d, 0x%x, %d)/r/n", sysIntr, pvData, cbData
28.     ));
30.     // SYSINTR_VMINI & SYSINTR_TIMING are special cases
31.     if (sysIntr == SYSINTR_VMINI || sysIntr == SYSINTR_TIMING) {
32.         rc = TRUE;
33.         goto cleanUp;
34.     }
36.     // Obtain the SYSINTR's underlying IRQ number
37.     //下面使用的函数很有用，等下会分析。是个关键函数
38.     if (!OALIntrTranslateSysIntr(sysIntr, &count, &pIrqs)) {
39.         // Indicate invalid SysIntr
40.         OALMSG(OAL_ERROR, (
41.             L"ERROR: OEMInterruptEnable: IRQs are undefined for SysIntr %d/r/n", 
42.             sysIntr 
43.         ));
44.         goto cleanUp;
45.     }
47.     // Enable the interrupt
48.     rc = OALIntrEnableIrqs(count, pIrqs);//这个也是关键函数
50. cleanUp:    
51.     OALMSG(OAL_INTR&&OAL_VERBOSE, (L"-OEMInterruptEnable(rc = 1)/r/n"));
52.     return rc;
53. }

再看OALIntrEnableIrqs这个函数

C:/WINCE500/PLATFORM/SMDK2440A/Src/Common/Intr/intr.c

 

2. //------------------------------------------------------------------------------
3. //
4. //  Function:  OALIntrEnableIrqs
5. //
6. BOOL OALIntrEnableIrqs(UINT32 count, const UINT32 *pIrqs)
7. {
8.     BOOL rc = TRUE;
9.     UINT32 i, mask, irq;
11.     OALMSG(OAL_INTR&&OAL_FUNC, (
12.         L"+OALIntrEnableIrqs(%d, 0x%08x)/r/n", count, pIrqs
13.     ));
15.     for (i = 0; i < count; i++) {
16. #ifndef OAL_BSP_CALLBACKS
17.         irq = pIrqs[i];
18. #else
19.         // Give BSP chance to enable irq on subordinate interrupt controller
20.         irq = BSPIntrEnableIrq(pIrqs[i]);
21. #endif
22.         if (irq == OAL_INTR_IRQ_UNDEFINED) continue;
23.         // Depending on IRQ number use internal or external mask register
24.         if (irq <= IRQ_ADC) {
25.             // Use interrupt mask register
26.             CLRREG32(&g_pIntrRegs->INTMSK, 1 << irq);
27.         } else if (irq <= IRQ_EINT7) {
28.             // Use external mask register
29.             CLRREG32(&g_pIntrRegs->INTMSK, 1 << IRQ_EINT4_7);
30.             CLRREG32(&g_pPortRegs->EINTMASK, 1 << (irq - IRQ_EINT4 + 4));
31.         } else if (irq <= IRQ_EINT23) {
32.             // Use external mask register
33.             mask = 1 << (irq - IRQ_EINT4 + 4);
34.             OUTREG32(&g_pPortRegs->EINTPEND, mask);
35.             CLRREG32(&g_pPortRegs->EINTMASK, mask);
36.             mask = 1 << IRQ_EINT8_23;
37.             if ((INREG32(&g_pIntrRegs->INTPND) & mask) != 0) {
38.                 OUTREG32(&g_pIntrRegs->INTPND, mask);
39.             }
40.             CLRREG32( &g_pIntrRegs->INTMSK, 1 << IRQ_EINT8_23);
41.         } else {
42.             rc = FALSE;
43.         }
44.     }        
46.     OALMSG(OAL_INTR&&OAL_FUNC, (L"-OALIntrEnableIrqs(rc = %d)/r/n", rc));
47.     return rc;    
48. }

------------OALIntrEnableIrqs函数的确是使能了一些中断，不过在OAL中根本没有调用这些函数（甚至这这个oem.c大部分函数都没有用到，这里只是分析一下5.0静态中断的一个方法）

中断禁止函数OEMInterruptDisable，中断完成函数OEMInterruptDone都是同样的道理（他们都在oem.c）在这里不再赘述。

下面来看OALIntrTranslateSysIntr这个关键函数

C:/WINCE500/PLATFORM/SMDK2440A/Src/Inc/oal_intr.h有这个函数的声明，但是没有具体实现（貌似这里限定了2440最大中断数目）。我觉得这是三星想自己做，但是后来没有做完——哎！这些BSP都是三星的实验版本。我们要小心使用。N多函数名相同，但是却没有使用，并且没有文档的

这下看PB下的OALIntrTranslateSysIntr

1. //------------------------------------------------------------------------------
2. //
3. //  File:  C:/WINCE500/PLATFORM/COMMON/SRC/COMMON/INTR/BASE/map.c
4. //
5. //  The file implement simple table/array based mapping between IRQ and SYSINTR
6. //  which is suitable for most OAL implementations.
7. //
8. #include <windows.h>
9. #include <nkintr.h>
10. #include <oal_intr.h>
11. #include <oal_log.h>
13. //------------------------------------------------------------------------------
15. static UINT32 g_oalSysIntr2Irq[SYSINTR_MAXIMUM];
16. static UINT32 g_oalIrq2SysIntr[OAL_INTR_IRQ_MAXIMUM];
18. //------------------------------------------------------------------------------
19. //
20. //  Function:  OALIntrTranslateSysIntr
21. //
22. //  This function maps a SYSINTR to its corresponding IRQ. It is typically used
23. //  in OEMInterruptXXX to obtain IRQs for given SYSINTR.
24. //
25. BOOL OALIntrTranslateSysIntr(
26.     UINT32 sysIntr, UINT32 *pCount, const UINT32 **ppIrqs
27. ) {
28.     BOOL rc;
30.     OALMSG(OAL_INTR&&OAL_VERBOSE, (L"+OALTranslateSysIntr(%d)/r/n", sysIntr));
31.     
32.     // Valid SYSINTR?
33.     if (sysIntr >= SYSINTR_MAXIMUM) {
34.         rc = FALSE;
35.         goto cleanUp;
36.     }
37.     *pCount = 1;
38.     //从下一句可以看出，这里只是取出相应的中断而已，不过g_oalIrq2SysIntr这个存储
39.     //中断向量的数组是static类型，并没有得到初始化，所以我据此推测我这个三星
40.    //BSP并没有使用这个OEM函数中断使能、禁止的中断方法而是使用的是KernelIoControl
41.     *ppIrqs = &g_oalSysIntr2Irq[sysIntr];
42.     rc = TRUE;
44. cleanUp:
45.     OALMSG(OAL_INTR&&OAL_VERBOSE, (L"-OALTranslateSysIntr(rc = %d)/r/n", rc));
46.     return rc;
47. }

不过C:/WINCE500/PLATFORM/COMMON/SRC/COMMON/INTR/BASE/map.c(32)://  Function:  OALIntrMapInit这个函数在我的BSP中使用到了，他的作用是初始化中断为未定义类型

 

1. //------------------------------------------------------------------------------
3. static UINT32 g_oalSysIntr2Irq[SYSINTR_MAXIMUM];
4. static UINT32 g_oalIrq2SysIntr[OAL_INTR_IRQ_MAXIMUM];
7. //------------------------------------------------------------------------------
8. //
9. //  Function:  OALIntrMapInit
10. //
11. //  This function must be called from OALInterruptInit to initialize mapping
12. //  between IRQ and SYSINTR. It simply initialize mapping arrays.
13. //
14. VOID OALIntrMapInit()
15. {
16.     UINT32 i;
17.     
18.     OALMSG(OAL_FUNC&&OAL_INTR, (L"+OALIntrMapInit/r/n"));
20.     // Initialize interrupt maps
21.     for (i = 0; i < SYSINTR_MAXIMUM; i++) {
22.         g_oalSysIntr2Irq[i] = OAL_INTR_IRQ_UNDEFINED;
23.     }
24.     for (i = 0; i < OAL_INTR_IRQ_MAXIMUM; i++) {
25.         g_oalIrq2SysIntr[i] = SYSINTR_UNDEFINED;
26.     }
28.     OALMSG(OAL_FUNC&&OAL_INTR, (L"-OALIntrMapInit/r/n"));
29. }

它是在哪里被使用的呢？来看看，我至今不明白它是怎么被调用的。

 

其他关于使用OEM函数禁止中断的函数也在这个map.c里面，

 

注意：这个笔记还没有完成，可能我的认识有极大错误，请大家看了不要太深信，如果发现有误，请在博客留言给我。谢谢。

转载请表明wogoyixikexie@gliet桂林电子科技大学一系科协，如有错误，希望能够指出。