转载——wince源码分析中断之map.c

1. 1. //------------------------------------------------------------------------------
   2. //
   3. //  Function:   OALIntrStaticTranslate
   4. //
   5. //  This function sets static translation between IRQ and SYSINTR. In most
   6. //  cases it should not be used. Only exception is mapping for 
   7. //  SYSINTR_RTC_ALARM and obsolete device drivers.
   8. //
   9. VOID OALIntrStaticTranslate(UINT32 sysIntr, UINT32 irq)
   10. {
   11.     OALMSG(OAL_FUNC&&OAL_INTR, (
   12.         L"+OALIntrStaticTranslate(%d, %d)/r/n", sysIntr, irq
   13.     ));
   14.     if (irq < OAL_INTR_IRQ_MAXIMUM && sysIntr < SYSINTR_MAXIMUM) {
   15.         g_oalSysIntr2Irq[sysIntr] = irq;
   16.         g_oalIrq2SysIntr[irq] = sysIntr;
   17.     }        
   18.     OALMSG(OAL_FUNC&&OAL_INTR, (L"-OALIntrStaticTranslate/r/n"));
   19. }
   //------------------------------------------------------------------------------
2. //
3. //  Function:  OALIntrMapInit
4. //
5. //  This function must be called from OALInterruptInit to initialize mapping
6. //  between IRQ and SYSINTR. It simply initialize mapping arrays.
7. //
8. VOID OALIntrMapInit()
9. {
10.     UINT32 i;
11.     
12.     OALMSG(OAL_FUNC&&OAL_INTR, (L"+OALIntrMapInit/r/n"));
14.     // Initialize interrupt maps
15.     for (i = 0; i < SYSINTR_MAXIMUM; i++) {
16.         g_oalSysIntr2Irq[i] = OAL_INTR_IRQ_UNDEFINED;
17.     }
18.     for (i = 0; i < OAL_INTR_IRQ_MAXIMUM; i++) {
19.         g_oalIrq2SysIntr[i] = SYSINTR_UNDEFINED;
20.     }
22.     OALMSG(OAL_FUNC&&OAL_INTR, (L"-OALIntrMapInit/r/n"));
23. }

wince学习手记

1. //------------------------------------------------------------------------------
2. //
3. //  Function:  OALIntrTranslateSysIntr
4. //
5. //  This function maps a SYSINTR to its corresponding IRQ. It is typically used
6. //  in OEMInterruptXXX to obtain IRQs for given SYSINTR.
7. //
8. BOOL OALIntrTranslateSysIntr(
9.     UINT32 sysIntr, UINT32 *pCount, const UINT32 **ppIrqs
10. ) {
11.     BOOL rc;
13.     OALMSG(OAL_INTR&&OAL_VERBOSE, (L"+OALTranslateSysIntr(%d)/r/n", sysIntr));
14.     
15.     // Valid SYSINTR?
16.     if (sysIntr >= SYSINTR_MAXIMUM) {
17.         rc = FALSE;
18.         goto cleanUp;
19.     }
20.     *pCount = 1;
21.     *ppIrqs = &g_oalSysIntr2Irq[sysIntr];
22.     rc = TRUE;
24. cleanUp:
25.     OALMSG(OAL_INTR&&OAL_VERBOSE, (L"-OALTranslateSysIntr(rc = %d)/r/n", rc));
26.     return rc;
27. }

 

 

1. //------------------------------------------------------------------------------
2. //
3. //  Function:  OALIntrTranslateIrq
4. //
5. //  This function maps a IRQ to its corresponding SYSINTR.
6. //
7. UINT32 OALIntrTranslateIrq(UINT32 irq)
8. {
9.     UINT32 sysIntr = SYSINTR_UNDEFINED;
10.     
11.     OALMSG(OAL_FUNC&&OAL_VERBOSE, (L"+OALIntrTranslateIrq(%d)/r/n", irq));
13.     if (irq >= OAL_INTR_IRQ_MAXIMUM) goto cleanUp;
14.     sysIntr = g_oalIrq2SysIntr[irq];
16. cleanUp:
17.     OALMSG(OAL_FUNC&&OAL_VERBOSE, (
18.         L"-OEMTranslateIrq(sysIntr = %d)/r/n", sysIntr
19.     ));
20.     return sysIntr;
21. }
24. //------------------------------------------------------------------------------
25. //
26. //  Function:  OALIntrRequestSysIntr
27. //
28. //  This function allocate new SYSINTR for given IRQ and it there isn't
29. //  static mapping for this IRQ it will create it.
30. //
31. UINT32 OALIntrRequestSysIntr(UINT32 count, const UINT32 *pIrqs, UINT32 flags)
32. {
33.     UINT32 irq, sysIntr;
35.     OALMSG(OAL_INTR&&OAL_FUNC, (
36.         L"+OALIntrRequestSysIntr(%d, 0x%08x, 0x%08x)/r/n", count, pIrqs, flags
37.     ));
38.     
39.     // Valid IRQ?
40.     if (count != 1 || pIrqs[0] >= OAL_INTR_IRQ_MAXIMUM) {
41.         sysIntr = SYSINTR_UNDEFINED;            
42.         goto cleanUp;
43.     }
44.     irq = pIrqs[0];
46.     // If there is mapping for given irq check for special cases
47.     if (g_oalIrq2SysIntr[irq] != SYSINTR_UNDEFINED) {
48.         // If static mapping is requested we fail
49.         if ((flags & OAL_INTR_STATIC) != 0) {
50.             OALMSG(OAL_ERROR, (L"ERROR: OALIntrRequestSysIntr: "
51.                L"Static mapping for IRQ %d already assigned/r/n", irq
52.             ));
53.             sysIntr = SYSINTR_UNDEFINED;            
54.             goto cleanUp;
55.         }
56.         // If we should translate, return existing SYSINTR
57.         if ((flags & OAL_INTR_TRANSLATE) != 0) {
58.             sysIntr = g_oalIrq2SysIntr[irq];
59.             goto cleanUp;
60.         }
61.     }
63.     // Find next available SYSINTR value...
64.     for (sysIntr = SYSINTR_FIRMWARE; sysIntr < SYSINTR_MAXIMUM; sysIntr++) {
65.         if (g_oalSysIntr2Irq[sysIntr] == OAL_INTR_IRQ_UNDEFINED) break;
66.     }
67.     
68.     // Any available SYSINTRs left?
69.     if (sysIntr >= SYSINTR_MAXIMUM) {
70.         OALMSG(OAL_ERROR, (L"ERROR: OALIntrRequestSysIntr: "
71.             L"No avaiable SYSINTR found/r/n"
72.         ));            
73.         sysIntr = SYSINTR_UNDEFINED;
74.         goto cleanUp;
75.     }
76.     
77.     // Make SYSINTR -> IRQ association.
78.     g_oalSysIntr2Irq[sysIntr] = irq;
79.     
80.     // Make IRQ -> SYSINTR association if required
81.     if ((flags & OAL_INTR_DYNAMIC) != 0) goto cleanUp;
82.     if (
83.         g_oalIrq2SysIntr[irq] == SYSINTR_UNDEFINED ||
84.         (flags & OAL_INTR_FORCE_STATIC) != 0
85.     ) {
86.         g_oalIrq2SysIntr[irq] = sysIntr;
87.     }
89. cleanUp:
90.     OALMSG(OAL_INTR&&OAL_FUNC, (
91.         L"-OALIntrRequestSysIntr(sysIntr = %d)/r/n", sysIntr
92.     ));
93.     return sysIntr;
94. }
97. //------------------------------------------------------------------------------
98. //
99. //  Function:  OALIntrReleaseSysIntr
100. //
101. //  This function release given SYSINTR and remove static mapping if exists.
102. //
103. BOOL OALIntrReleaseSysIntr(UINT32 sysIntr)
104. {
105.     BOOL rc = FALSE;
106.     UINT32 irq;
108.     OALMSG(OAL_INTR&&OAL_FUNC, (L"+OALIntrReleaseSysIntr(%d)/r/n", sysIntr));
110.     // Is the SYSINTR already released?
111.     if (g_oalSysIntr2Irq[sysIntr] == OAL_INTR_IRQ_UNDEFINED) goto cleanUp;
113.     // Remove the SYSINTR -> IRQ mapping
114.     irq = g_oalSysIntr2Irq[sysIntr];
115.     g_oalSysIntr2Irq[sysIntr] = OAL_INTR_IRQ_UNDEFINED;
117.     // If we're releasing the SYSINTR directly mapped in the IRQ mapping, 
118.     // remove the IRQ mapping also
119.     if (g_oalIrq2SysIntr[irq] == sysIntr) {
120.         g_oalIrq2SysIntr[irq] = SYSINTR_UNDEFINED;
121.     }
123. cleanUp:
124.     OALMSG(OAL_INTR&&OAL_FUNC, (L"-OALIntrReleaseSysIntr(rc = %d)/r/n", rc));
125.     return rc;
126. }
128. //------------------------------------------------------------------------------

OAL是位于WindowsCE内核与目标设备硬件之间的一个代码层，用于实现windowCE与目标设备硬件之间的通信。为了实现内核与硬件之间最基本的通信功能，OEM必须实现一些必要的功能，同时为了适合不同的硬件配置与操作系统功能，OEM有必要的选择实现一些其他的功能。
在OAL开发过程中，OEM需要实现下列主要功能或函数：
.Startup函数；
.调试串口；
.OEMInit函数；
.系统计时器；
.中断处理；
.内核的输入/输出（ioctl）；
.KITL。
下面给出微软公司提供的各个功能的函数。
/***************************中断处理****************************/
./platform/Common/src/common/intr/base/map.c
The file implement simple table/array based mapping between IRQ and SYSINTR
which is suitable for most OAL implementations.
这个文件主要是用来定义IRQ和SYSIRQ的映射关系。
主要函数如下：
OALIntrMapInit()；//此函数由OALInterruptInit调用来初始化IRQ和SYSIRQ的映射，只是简单的映射数组的初始化；初始化为未定义类型。
VOID OALIntrStaticTranslate(UINT32 sysIntr, UINT32 irq)； //此函数建立IRQ和SYSINTR的静态映射，大多数情况下都不可能用到，只有在SYSINTR_RTC_ALARM和过时的设备驱动的时候会用到。
BOOL OALIntrTranslateSysIntr(UINT32 sysIntr, UINT32 *pCount, const UINT32 **ppIrqs)；//此函数将SYSINTR映射为它相应的IRQ，主要用在OEMInterruptXXX中对于给定SYSINTR得到其IRQs。
UINT32 OALIntrTranslateIrq(UINT32 irq)；//此函数将IRQ映射为相应的SYSINTR。
UINT32 OALIntrRequestSysIntr(UINT32 count, const UINT32 *pIrqs, UINT32 flags)；//此函数为给定的IRQ分配一个新的SYSINTR,如果此IRQ没有静态映射，就创建一个。
BOOL OALIntrReleaseSysIntr(UINT32 sysIntr)；//此函数释放一个SYSINTR，并且消除存在的静态映射。
问题：
SYSINTR于IRQ的映射关系是不是一对一？BOOL OALIntrTranslateSysIntr(UINT32 sysIntr, UINT32 *pCount, const UINT32 **ppIrqs)使用的是地址来进行映射，而UINT32 OALIntrTranslateIrq(UINT32 irq)使用值来进行映射，目前我认为应该是一对一的关系来映射的。
感想：
微软的程序写的很缜密，设计的很合理，能让我学到不少编程的方法。映射关系的编程可以参考微软的中断映射表。

 

1. //------------------------------------------------------------------------------
3. static UINT32 g_oalSysIntr2Irq[SYSINTR_MAXIMUM];
4. static UINT32 g_oalIrq2SysIntr[OAL_INTR_IRQ_MAXIMUM];