MSComm 控制項完整指南：C++Builder 串口通訊的事件驅動與輪詢兩種模式

MSComm (Microsoft Communications Control) 是 ActiveX 控制項，封裝 Windows 串口 API，提供 Visual Basic 風格的事件驅動介面，在 C++Builder、Delphi、VB 中廣泛使用。本文系統整理屬性、事件、錯誤碼、常數，並對比**事件驅動**與**輪詢**兩種程式設計模式，給出完整設定流程與代碼範例。

核心屬性速查

OnComm 事件常數 (CommEvent 屬性)

錯誤碼常數 (CommEvent 為錯誤時)

兩種程式設計模式

1. 事件驅動模式 (推薦)

void __fastcall TForm1::MSComm1OnComm(TObject *Sender) {
    switch (MSComm1->CommEvent) {
        case 2: // comEvReceive
            AnsiString data = MSComm1->Input; // 讀取文字
            Memo1->Lines->Add(data);
            break;
        case 1008: // comEventRxOver
            // 處理緩衝區溢位
            break;
        // ... 其他事件
    }
}

優點：即時響應、CPU 佔用低、適合高頻資料流。
缺點：需處理重入、執行緒安全（VCL 非執行緒安全，事件在主執行緒）。

2. 輪詢模式

void __fastcall TForm1::Timer1Timer(TObject *Sender) {
    if (MSComm1->CommEvent == 2) { // 檢查是否有資料
        AnsiString data = MSComm1->Input;
        Memo1->Lines->Add(data);
    }
    // 定期檢查錯誤碼
    if (MSComm1->CommEvent >= 1000) HandleError(MSComm1->CommEvent);
}

優點：邏輯線性、易除錯、適合簡單查詢-回應協定 (如 AT 指令)。
缺點：輪詢間隔權衡延遲與 CPU、易漏讀高速資料。

完整初始化流程

void __fastcall TForm1::FormCreate(TObject *Sender) {
    MSComm1->CommPort = 1;
    MSComm1->Settings = "9600,N,8,1";
    MSComm1->RThreshold = 1;       // 逐字元觸發
    MSComm1->InputLen = 0;         // 讀全部
    MSComm1->InputMode = 0;        // 文字模式
    MSComm1->Handshaking = 0;      // 無握手
    MSComm1->PortOpen = true;      // 開啟埠
}

void __fastcall TForm1::FormDestroy(TObject *Sender) {
    if (MSComm1->PortOpen) MSComm1->PortOpen = false;
}

常見問題排查

• 埠被佔用：檢查裝置管理員、其他程式 (HyperTerminal, PuTTY) 是否佔用。
• 收到亂碼：確認雙方 Settings 完全一致 (鮑率、奇偶、資料位、停止位)。
• 緩衝區溢位：提高 RThreshold、改用二進制模式批次讀取、或啟用硬體流控 (RTS/CTS)。
• 64 位元專案無法使用：MSComm 是 32 位元 ActiveX，C++Builder 64-bit 專案需改用 Win32 API (CreateFile, ReadFile, SetCommMask + WaitCommEvent) 或第三方元件 (如 TComPort)。

「MSComm 適合快速原型、低速裝置、32 位元應用；高可靠、高速、64 位元、跨平台專案請直接使用 Win32 Serial API 或成熟開源元件。」