WinCE中的Debug Zone調試

 

在WinCE的開發環境中支援Debug Zones功能，通常也被稱為調試域，通過它可以控制列印資訊。當某個調試域被開啟以後，在這個域中的列印資訊就會被列印出來，如果某個調試域被關閉了，那麼這個域中的列印資訊就會被關閉。調試域是基於模組的，也就是說一個模組，可能是在一個驅動或者一個應用中都可以定義一個調試域，用來調試該模組。一個調試域最多可以包括16個域，一般在每一個模組中都會有一個全域變數dpCurSettings，該變數用於描述調試域的相關資訊，它由一個模組名字，16個域的名字和一個掩碼組成。下面具個例子：

DBGPARAM dpCurSettings =

{
    TEXT("PCIBUS"), {
    TEXT("Errors"),TEXT("Warnings"),TEXT("Functions"),TEXT("Initialization"),
    TEXT("Enumeration"),TEXT("Load Order"),TEXT("Resource"),TEXT("Undefined"),
    TEXT("Undefined"),TEXT("Undefined"),TEXT("Undefined"),TEXT("Undefined"),
    TEXT("Undefined"),TEXT("Undefined"),TEXT("Undefined"),TEXT("Undefined") },
    0x20

};

先來解釋一下DBGPARAM結構，該結構在Dbgapi.h中定義，所以在定義dpCurSettings的時候還需要包含這個標頭檔，該結構定義如下：

typedef struct _DBGPARAM {

    WCHAR  lpszName[32];                    //模組的名字

    WCHAR  rglpszZones[16][32];            //調試域的名字

    ULONG  ulZoneMask;                        //調試域的掩碼

}DBGPARAM, *LPDBGPARAM;

 

在上面的例子中可以看到，第一個是模組的名字，叫PCIBUS。而後定義了16個域的名字，其中只用到了7個域，剩下的都定義為Undefined了。最後一個數字為域的掩碼，表示當前哪個域是被啟用的，0x20表示只有第6個域是被啟用的。從上面的例子還可以看出，前7個域是有意義的，而且按照順序分別對應1到7。下面針對這些域需要定義相應Debug調試的宏定義：

#define DBGZONE_ERROR                           1

#define DBGZONE_WARNING                     2

#define DBGZONE_FUNCTION                    3

#define DBGZONE_INIT                                4

#define DBGZONE_ENUM                            5

#define DBGZONE_LOADORDER                6

#define DBGZONE_RESOURCE                    7

 

上述宏定義對應在dpCurSettings中的7個域，然後就可以在列印資訊的時候，通過這些宏定義來對應相應的調試域了。例如：

1. while(1)
2. {
3.     if (dwFlag)
4.     {
5.          DEBUGMSG(DBGZONE_ERROR, (L"Error found: %d\r\n", NumDevKeys));
6.          break;
7.      }
8.      else
9.      {
10.          DEBUGMSG(DBGZONE_WARNING, (L"Warning found\r\n"));
11.      }
13.      DEBUGMSG(DBGZONE_LOADORDER, (L"load in a while loop\r\n"));
14.      Sleep(100);
15. }
16.  

從這段代碼可以看出，如果dpCurSettings中的掩碼定義為0x20，那麼在DEBUGMSG的列印中，只有條件為DBGZONE_LOADORDER才會被列印，迴圈中的前兩個列印資訊是不會被列印的。如果想讓上面的代碼中的所有DEBUGMSG都能列印必須設定掩碼如下：

dpCurSettings.ulZoneMask = DBGZONE_ERROR | DBGZONE_WARNING | DBGZONE_LOADORDER;

 

在一個模組中定義了調試域，如果想在系統中去使用還必須註冊該調試域，需要用到的函數叫DEBUGREGISTER(..)，其中要把該調試模組的控制代碼作為參數傳給它。例如：

DllMain(..)

{

    switch(op)

    {

        case DLL_PROCESS_ATTACH:

            DEBUGREGISTER(hPCIBUS);

            break;

        ….

    }

}

 

完成了上述工作以後，就可以重新編譯調試的模組，然後運行系統來調試了。調試域的一個好處就是在Debug的過程中，不需要終止系統可以動態改變調試域，方便我們分析問題。首先，我們可以基於Platform. Builder中的CE Debug Zones來調試，在VS2005的菜單中選擇Target，然後選擇CE Debug Zones，

 

然後會出現一個Debug Zones的視窗，在視窗彈出以後，它可能會花一點時間來收集當前支援Debug Zone的模組，如：

 

該圖只是一個例子，左邊顯示了可調試的模組，選擇serial_SMDK2410.dll這個模組，就是S3C2410的串口驅動模組。在右側可以看到各個調試域及名字，使用者可以根據需要來選擇開啟和關閉相應的調試域，最後點擊Apply和OK就可以了。

 

當然，還有其他的方法來修改調試域，一種方法是使用Target Control中的zo命令來修改，Target Control將在以後介紹。還有一種方法就是通過SetDbgZone(..)函數來修改。定義如下：

BOOL SetDbgZone(DWORDdwProcid, LPVOIDlpvMod, LPVOIDbaseptr, DWORDzone, LPDBGPARAMlpdbgTgt)

    dwProcid：    進程的控制代碼

    lpvMod：        調試模組的控制代碼

    baseptr：        設定為NULL

    zone：            新的調試域掩碼

    lpdbgTgt：      返回新的DBGPARAM結構

 

上面對Debug Zone的定義，使用以及調試作了大致的介紹，按照上面的步驟可以給一個模組添加調試域，註冊調試域並在系統運行以後隨時更改調試域，其根本目的無非是協助我們來調試模組和分析問題。一般情況下，調試域只在Debug模式下使用，但是也可以在Release模式下使用。但是有些地方需要修改，首先前面已經介紹過Debug模式下的列印用DEBUGMSG，而Release模式下的列印應該使用RETAILMSG函數。所以在Release模式下，列印函數應該改為RETAILMSG函數。還有在註冊調試域的時候，不能再使用DEBUGREGISTER(..)函數，而是應該改用RETAILREGISTERZONES(..)函數。