1、API描述
在WIN32 API中，串口使用文件方式進行訪問，其操作的API基本上與文件操作的API一致。
打開串口
Win32 中用于打開串口的API 函數為CreateFile，其原型為：
| HANDLE CreateFile ( LPCTSTR lpFileName, //將要打開的串口邏輯名，如COM1 或COM2 DWORD dwAccess, //指定串口訪問的類型，可以是讀取、寫入或兩者并列 DWORD dwShareMode, //指定共享屬性，由于串口不能共享,該參數必須置為0 LPSECURITY_ATTRIBUTES lpsa, //引用安全性屬性結構，缺省值為NULL DWORD dwCreate, //創建標志，對串口操作該參數必須置為OPEN EXISTING DWORD dwAttrsAndFlags, //屬性描述，用于指定該串口是否可進行異步操作， //FILE_FLAG_OVERLAPPED：可使用異步的I/O HANDLE hTemplateFile //指向模板文件的句柄，對串口而言該參數必須置為NULL ); |
例如，以下程序用于以同步讀寫方式打開串口COM1：
| HANDLE hCom; DWORD dwError; hCon = CreateFile("COM1", GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING, 0, NULL); if (hCom == (HANDLE)0xFFFFFFFF) { dwError = GetLastError(); MessageBox(dwError); } |
對于dwAttrsAndFlags參數及FILE_FLAG_OVERLAPPED標志的由來，可解釋如下：Windows文件操作分為同步I/O和重疊I/O(Overlapped I/ O)兩種方式，在同步I/O方式中，API會阻塞直到操作完成以后才能返回（在多線程方式中，雖然不會阻塞主線程，但是仍然會阻塞監聽線程）；而在重疊I/O方式中，API會立即返回，操作在后臺進行，避免線程的阻塞。重疊I/O非常靈活，它也可以實現阻塞（例如我們可以設置一定要讀取到一個數據才能進行到下一步操作)。如果進行I/O操作的API 在沒有完成操作的情況下返回，我們可以通過調用GetOverLappedResult()函數阻塞到I/O操作完成后返回。
配置串口
配置串口是通過改變設備控制塊DCB(Device Control Block) 的成員變量值來實現的，接收緩沖區和發送緩沖區的大小可通過SetupComm函數來設置。
DCB結構體定義為：
| typedef struct _DCB { // dcb DWORD DCBlength; // sizeof(DCB) DWORD BaudRate; // current baud rate DWORD fBinary: 1; // binary mode, no EOF check DWORD fParity: 1; // enable parity checking DWORD fOutxCtsFlow:1; // CTS output flow control DWORD fOutxDsrFlow:1; // DSR output flow control DWORD fDtrControl:2; // DTR flow control type DWORD fDsrSensitivity:1; // DSR sensitivity DWORD fTXContinueOnXoff:1; // XOFF continues Tx DWORD fOutX: 1; // XON/XOFF out flow control DWORD fInX: 1; // XON/XOFF in flow control DWORD fErrorChar: 1; // enable error replacement DWORD fNull: 1; // enable null stripping DWORD fRtsControl:2; // RTS flow control DWORD fAbortOnError:1; // abort reads/writes on error DWORD fDummy2:17; // reserved WORD wReserved; // not currently used WORD XonLim; // transmit XON threshold WORD XoffLim; // transmit XOFF threshold BYTE ByteSize; // number of bits/byte, 4-8 BYTE Parity; // 0-4=no,odd,even,mark,space BYTE StopBits; // 0,1,2 = 1, 1.5, 2 char XonChar; // Tx and Rx XON character char XoffChar; // Tx and Rx XOFF character char ErrorChar; // error replacement character char EofChar; // end of input character char EvtChar; // received event character WORD wReserved1; // reserved; do not use } DCB; 而SetupComm函數的原型則為： BOOL SetupComm( HANDLE hFile, // handle to communications device DWORD dwInQueue, // size of input buffer DWORD dwOutQueue // size of output buffer ); |
以下程序將串口設置為：波特率為9600，數據位數為7位，停止位為2 位，偶校驗，接收緩沖區和發送緩沖區大小均為1024個字節，最后用PurgeComm函數終止所有的后臺讀寫操作并清空接收緩沖區和發送緩沖區：
| DCB dcb; dcb.BaudRate = 9600; //波特率為9600 dcb.ByteSize = 7; //數據位數為7位 dcb.Parity = EVENPARITY; //偶校驗 dcb.StopBits = 2; //兩個停止位 dcb.fBinary = TRUE; dcb.fParity = TRUE; if (!SetCommState(hCom, &dcb)) { MessageBox("串口設置出錯!"); } SetupComm(hCom, 1024, 1024); PurgeComm(hCom, PURCE_TXABORT | PURGE_RXABORT | PURGE_TXCLEAR | PURGE_RXCLEAR); |
2.例程
在《深入淺出Win32多線程程序設計之綜合實例》中我們已經給出一個利用WIN API進行串口通信的例子，這里再給出一個類似的例子，以進一步加深理解。
|
(審核編輯: 智匯小新)
分享
