嵌入式開發調試利器：printf() 與 RETAILMSG() 性能對比與最佳實踐

前言：調試輸出的性能隱患

在 Windows CE / Embedded Visual C++ (eVC) 等嵌入式開發環境（如 S3C2410 ARM9 平台）中，調試信息輸出是開發日常。常用的 printf() 與系統宏 RETAILMSG() 雖功能相似，但在實時性要求嚴苛的系統中，兩者性能差異巨大，直接影響系統響應與穩定性。

核心性能對比：數據說話

結論： 實時系統中，調試輸出點優先使用 RETAILMSG()，嚴禁在中斷服務程序 (ISR)、高優先級任務中調用 printf()。

工程化最佳實踐：條件編譯隔離調試代碼

Release 版本必須完全剔除調試輸出，避免性能拖累與信息洩露。標準做法：

// 方式一：標準條件編譯
#ifdef DEBUG
    printf("\n broadcast Hello");
#endif

// 方式二：RETAILMSG 宏（需 Unicode 字符串）
#ifdef DEBUG
    RETAILMSG(1, (TEXT("Receive a packet\t\n")));
#endif

RETAILMSG 使用關鍵細節：Unicode 字符串處理

RETAILMSG 要求寬字符 (Unicode) 格式字符串，正確寫法：

// 錯誤：窄字符串直接傳遞
// RETAILMSG(1, ("%s\n", "Your str")); 

// 正確：所有字符串字面量用 TEXT() 或 L 前綴包裹
RETAILMSG(1, (TEXT("%s\n"), TEXT("Your str")));

// 變量字符串需轉換為 wchar_t* 或使用 CString
WCHAR buf[128];
swprintf(buf, L"Value: %d", val);
RETAILMSG(1, (buf));

原理提示： TEXT() 宏在 Unicode 構建下展開為 L""，確保字符串類型匹配 RETAILMSG 內部 wprintf 類函數參數要求。

// 定義調試等級
#define DBG_ERROR   1
#define DBG_WARN    2
#define DBG_INFO    3
#define DBG_VERBOSE 4

// 全局調試等級控制（可通過註冊表/配置文件動態調整）
extern DWORD g_dwDebugLevel;

// 封裝宏
#define MY_RETAILMSG(level, fmt, ...) \
    do { \
        if ((level) <= g_dwDebugLevel) { \
            RETAILMSG(1, (TEXT(fmt), __VA_ARGS__)); \
        } \
    } while(0)

// 使用示例
MY_RETAILMSG(DBG_INFO, "Sensor init ok, id=%d", sensor_id);
MY_RETAILMSG(DBG_ERROR, "I2C read failed, err=0x%X", hr);