1、API描述
在WIN32 API中,串口使用文件方式進(jìn)行訪問,其操作的API基本上與文件操作的API一致。
打開串口
Win32 中用于打開串口的API 函數(shù)為CreateFile,其原型為:
HANDLE CreateFile ( LPCTSTR lpFileName, //將要打開的串口邏輯名,如COM1 或COM2 DWORD dwAccess, //指定串口訪問的類型,可以是讀取、寫入或兩者并列 DWORD dwShareMode, //指定共享屬性,由于串口不能共享,該參數(shù)必須置為0 LPSECURITY_ATTRIBUTES lpsa, //引用安全性屬性結(jié)構(gòu),缺省值為NULL DWORD dwCreate, //創(chuàng)建標(biāo)志,對(duì)串口操作該參數(shù)必須置為OPEN EXISTING DWORD dwAttrsAndFlags, //屬性描述,用于指定該串口是否可進(jìn)行異步操作, //FILE_FLAG_OVERLAPPED:可使用異步的I/O HANDLE hTemplateFile //指向模板文件的句柄,對(duì)串口而言該參數(shù)必須置為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); } |
對(duì)于dwAttrsAndFlags參數(shù)及FILE_FLAG_OVERLAPPED標(biāo)志的由來(lái),可解釋如下:Windows文件操作分為同步I/O和重疊I/O(Overlapped I/ O)兩種方式,在同步I/O方式中,API會(huì)阻塞直到操作完成以后才能返回(在多線程方式中,雖然不會(huì)阻塞主線程,但是仍然會(huì)阻塞監(jiān)聽線程);而在重疊I/O方式中,API會(huì)立即返回,操作在后臺(tái)進(jìn)行,避免線程的阻塞。重疊I/O非常靈活,它也可以實(shí)現(xiàn)阻塞(例如我們可以設(shè)置一定要讀取到一個(gè)數(shù)據(jù)才能進(jìn)行到下一步操作)。如果進(jìn)行I/O操作的API 在沒有完成操作的情況下返回,我們可以通過調(diào)用GetOverLappedResult()函數(shù)阻塞到I/O操作完成后返回。
配置串口
配置串口是通過改變?cè)O(shè)備控制塊DCB(Device Control Block) 的成員變量值來(lái)實(shí)現(xiàn)的,接收緩沖區(qū)和發(fā)送緩沖區(qū)的大小可通過SetupComm函數(shù)來(lái)設(shè)置。
DCB結(jié)構(gòu)體定義為:
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函數(shù)的原型則為: BOOL SetupComm( HANDLE hFile, // handle to communications device DWORD dwInQueue, // size of input buffer DWORD dwOutQueue // size of output buffer ); |
以下程序?qū)⒋谠O(shè)置為:波特率為9600,數(shù)據(jù)位數(shù)為7位,停止位為2 位,偶校驗(yàn),接收緩沖區(qū)和發(fā)送緩沖區(qū)大小均為1024個(gè)字節(jié),最后用PurgeComm函數(shù)終止所有的后臺(tái)讀寫操作并清空接收緩沖區(qū)和發(fā)送緩沖區(qū):
DCB dcb; dcb.BaudRate = 9600; //波特率為9600 dcb.ByteSize = 7; //數(shù)據(jù)位數(shù)為7位 dcb.Parity = EVENPARITY; //偶校驗(yàn) dcb.StopBits = 2; //兩個(gè)停止位 dcb.fBinary = TRUE; dcb.fParity = TRUE; if (!SetCommState(hCom, &dcb)) { MessageBox("串口設(shè)置出錯(cuò)!"); } SetupComm(hCom, 1024, 1024); PurgeComm(hCom, PURCE_TXABORT | PURGE_RXABORT | PURGE_TXCLEAR | PURGE_RXCLEAR); |
2.例程
在《深入淺出Win32多線程程序設(shè)計(jì)之綜合實(shí)例》中我們已經(jīng)給出一個(gè)利用WIN API進(jìn)行串口通信的例子,這里再給出一個(gè)類似的例子,以進(jìn)一步加深理解。
|
(審核編輯: 智匯小新)
分享