C4M-OS中斷服務常式分享的登錄機制

 參考 圖4.C4M-OS中斷服務常式分享登錄機制圖，C4M-OS在GCC原始ISR之外，另外創建了InternalISR。當使用者未使用特定中斷向量的 ISR時，該中斷向量的Internal ISR會自動啟用。每當Internal ISR被中斷向量觸發執行時，它會查詢其工作登錄表找到其中致能工作的函式指標，並呼叫並執行該函式。

使用

C4M-OS中斷服務常式分享登錄機制，有兩個好處，第一：因為Internal ISR架空了ISR，它吸收了不同C語言編譯器處理中斷向量表的語法不同，因此應用程式可以攜往不同的C編譯器 IDE平台。第二：不同的工作可以分享同一個硬體中斷向量，達到同步輸出入的效果，且可以獨立禁致能各自的輸出入及後續工作串。

圖4. C4M-OS中斷服務常式分享登錄機制圖

C4MLib函式庫提供了

中斷服務分享器可以開放工作方塊登錄來分享各個硬體中斷內部服務常式Internal ISR所提供的執行服務。為了將內部中斷服務分享給軟即時讀寫工作方塊，應用程式首先必須要先完成硬體中斷分享器佈局，然後將想要分享此一中斷的工作方塊登錄進此一硬體中斷分享工作名單並取得分享工作編號。之後C4M-OS便會在中斷事件發生後自動執行分享名單中己致能的工作編號。使用者可以依據需求在適當的時機，呼叫禁致能函式來禁致能硬體中斷分享工作。

硬體中斷分享器佈局巨集 XXXHWINT_LAY()：

本課程所使用的ATMega128有多種類型的週邊硬體中斷源，毎種類型中斷源都可能有複數個。硬體中斷分享器本身即是一個工作方塊。C4M-OS為每一類型的中斷源準備了一份工作表單，足以容納同類型的所有中斷分享器。而且每一個硬體中斷分享器，又有一份工作登錄表單。要管理中斷分享工作，必需要定義出中斷分享管理結構體，表單並將它們鏈結起來。為了方便使用者組織架構中斷分享器，CC4M-OS提供了硬體中斷分享器佈局巨集。

XXXHWINT_LAY(INTSTR,ININUM,TASKNUM)

說明：呼叫本巨集會針對特定類型硬體中斷源XXX，建立一個以型態為HWIntStr_t的硬體中斷分享器結構體以及搭配的空白分享工作表單。 並且將執行本身的工作方塊掛進所屬類型硬體中斷表單XXXIntList_p[n]中等待對應於它的INTERNAL_ISR中斷服務常式執行。其中XXX為特定型態之硬體中斷，例如外部中斷EXT，類比轉數位中斷ADC。 n為此型MCU XXX型硬體中斷源的數目。例如外部中斷EXT共有8個，ADC只有1個。

parameter：                    

                     INTSTR：硬體中斷分享器的結構體。                    

                     ININUM：硬體中斷分享器結構體佔同類型中斷的編序。                    

                     TASKNUM：硬體中斷分享器允許被登錄執行的最高工作數目。

Constrain：                    

                      XXXIntStrList_p[ININUM]: Hardware interrupt service                    

                      structure pointer list is Defined Beforehand.

在呼叫使用硬體中斷分享佈局巨集時，其傳參必需要符合以下硬體中斷分享器佈局巨集參數快查表。

M128硬體中斷分享器佈局巨集參數快查表(1)

M128硬體中斷分享器佈局巨集參數快查表(2)

範例：以本單元的外部中斷為例，假設欲讓硬體外部中斷4分享給最多4個工作方塊，可選用巨集為EXTHWINT_LAY，參數INTSTR為Ext4Int_str。參數ININUM為4，參數TASKNUM為4。因此呼叫佈局巨集如下：

EXTHWINT_LAY(Ext4Int_str,4,4);

硬體中斷分享登錄函式HWInt_reg()：

當一個內部中斷服務常式完成硬體中斷分享器佈局之後就能夠接受使用者將工作方塊登錄進這一個中斷分享器。C4M-OS提供硬體中斷分享登錄函式，可供使用者呼叫完成登錄。

uint8_tHWInt_reg(HWIntStr_t* Str_p, Func_t FbFunc_p, void* FbPara_p)

簡介：提供使用者呼叫以便將工作方塊登錄進入硬體中斷分享器之中。其工作項目包括，把工作方塊函式及結構體指標存入硬體中斷分享結構體，並回傳工作編號TaskId。

傳址參數：

              HWIntStr_t* Str_p：特定硬體中斷分享管理結構體指標。

              Func_t FbFunc_p：工作方塊執行函式指標

              void* FbPara_p：工作方塊參數結構體指標

前置動作：應先呼叫特定中斷服務之佈局巨集XXXHWINT_LAY()完成佈局定義出中斷分享器結構體。

後續動作：將 TaskId 存回工作方塊的結構體之工作編號欄位XXXTaskId。

回傳：TaskId 或 ERROR CODE=255。

範例：以本單元的外部中斷為例，假設外部中斷4服務常式分享給最多4個工作方塊登錄。並且將即時寫入平行埠D暫存器工作方塊登錄進此一外部中斷分享器。

/* Define RealTimePort D Output and initial it */

uint8_tDataSource;

RTREGIO_LAY(RTPDOut_str,1,&PORTD,1,&DataSource);

/* Define Ext4Int_str and initial it */

EXTHWINT_LAY(Ext4Int_str,4,4);

/*Register Port D Output as a task of Ext4 ISR */

uint8_tTaskId=HWInt_reg(&Ext4Int_str,RealTimeRegPut_step,(void*) &RTPDOut_str);

RTPDOut_str.TaskId=TaskId; /* Store the TaskId into FB Str*/

中斷服務分享禁致能函式HWInt_en()：

供使用者呼叫禁致能己登錄進硬體中斷分享器中等待執行的工作方塊，僅有致能者在中斷時會被執行。

uint8_tHWInt_en(HWIntStr_t* Str_p, uint8_t TaskId, uint8_tEnable)

簡介：禁致能己登錄至硬體中斷分享器的工作方塊

傳值參數：

               uint8_t TaskId：登錄進特定硬體中斷時所取得的工作識別編號。

               uint8_t Enable：禁致能參數，1: 致能，0:禁能。

傳址參數：

               HWIntStr_t* Str_p：硬體中斷分享器結構體指標。

回傳：錯誤碼 OK: 0, ERROR:1

前置動作：必需先完成將工作方塊登錄進中斷服務分享器,取得並記存TaskId

後續影響：致能後，每當中斷分享器的中斷事件發生後，中斷分享器會自動執行本工作方塊。

範例：接續前述 HWInt_reg()範例,想致能登錄在 Ext4Int_str所管理的硬體中斷分享器中的工作方塊RTPDOut_str

HWInt_en(&Ext4Int_str,RTPDOut_str.TaskId, 1);