摘要:WIN95界面下的VC++串口通讯程序在WIN32下是不建议对端口进行操作的,在WIN32中所有的设备都被看成是文件,串行口也不例外也是作为文件来进行处理的。 关键词 串行口,DWORD,缓冲区
WIN95界面下的VC++串口通讯程序在WIN32下是不建议对端口进行操作的,在WIN32中所有的设备都被看成是文件,串行口也不例外也是作为文件来进行处理的。这是我的一份关于串口编程的读书笔记,对于使 用VC进行编程的同行应该有一定的帮助。
1.打开串口:
在Window 95下串行口作为文件处理,使用文件操作对串行口进行处理。使用CreateFile()打开串口,CreateFile()将返回串口的句柄。 HANDLE CreateFile( LPCTSTR lpFileName, // pointer to name of the file DWORD dwDesiredAccess, // access (read-write) mode DWORD dwShareMode, // share mode LPSECURITY_ATTRIBUTES lpSecurityAttributes, // pointer to security attributes DWORD dwCreationDistribution, // how to create DWORD dwFlagsAndAttributes, // file attributes HANDLE hTemplateFile // handle to file with attributes to copy ); lpFileName: 指明串口制备,例:COM1,COM2 dwDesiredAccess: 指明串口存取方式,例:GENERIC_READ|GENERIC_WRITE dwShareMode: 指明串口共享方式 lpSecurityAttributes: 指明串口的安全属性结构,NULL为缺省安全属性 dwCreateionDistribution: 必须为OPEN_EXISTIN dwFlagAndAttributes: 对串口唯一有意义的是FILE_FLAG_OVERLAPPED hTemplateFile: 必须为NULL
2.关闭串口:
CloseHandle(hCommDev);
3.设置缓冲区长度:
BOOL SetupComm( HANDLE hFile, // handle of communications device DWORD dwInQueue, // size of input buffer DWORD dwOutQueue // size of output buffer );
4.COMMPROP结构:
可使用GetCommProperties()取得COMMPROP结构,COMMPROP结构中记载了系统支持的各项设置。 typedef struct _COMMPROP { // cmmp WORD wPacketLength; // packet size, in bytes WORD wPacketVersion; // packet version DWORD dwServiceMask; // services implemented DWORD dwReserved1; // reserved DWORD dwMaxTxQueue; // max Tx bufsize, in bytes DWORD dwMaxRxQueue; // max Rx bufsize, in bytes DWORD dwMaxBaud; // max baud rate, in bps DWORD dwProvSubType; // specific provider type DWORD dwProvCapabilities; // capabilities supported DWORD dwSettableParams; // changeable parameters DWORD dwSettableBaud; // allowable baud rates WORD wSettableData; // allowable byte sizes WORD wSettableStopParity; // stop bits/parity allowed DWORD dwCurrentTxQueue; // Tx buffer size, in bytes DWORD dwCurrentRxQueue; // Rx buffer size, in bytes DWORD dwProvSpec1; // provider-specific data DWORD dwProvSpec2; // provider-specific data WCHAR wcProvChar[1]; // provider-specific data } COMMPROP; dwMaxBaud: BAUD_075 75 bps BAUD_110 110 bps BAUD_134_5 134.5 bps BAUD_150 150 bps BAUD_300 300 bps BAUD_600 600 bps BAUD_1200 1200 bps BAUD_1800 1800 bps BAUD_2400 2400 bps BAUD_4800 4800 bps BAUD_7200 7200 bps BAUD_9600 9600 bps BAUD_14400 14400 bps BAUD_19200 19200 bps BAUD_38400 38400 bps BAUD_56K 56K bps BAUD_57600 57600 bps BAUD_115200 115200 bps BAUD_128K 128K bps BAUD_USER Programmable baud rates available dwProvSubType: PST_FAX 传真设备 PST_LAT LAT协议 PST_MODEM 调制解调器设备 PST_NETWORK_BRIDGE 未指定的网桥 PST_PARALLELPORT 并口 PST_RS232 RS-232口 PST_RS422 RS-422口 PST_RS423 RS-432口 PST_RS449 RS-449口 PST_SCANNER 扫描仪设备 PST_TCPIP_TELNET TCP/IP Telnet协议 PST_UNSPECIFIED 未指定 PST_X25 X.25标准 dwProvCapabilities PCF_16BITMODE 支持特殊的16位模式 PCF_DTRDSR 支持DTR(数据终端就绪)/DSR(数据设备就绪) PCF_INTTIMEOUTS 支持区间超时 PCF_PARITY_CHECK 支持奇偶校验 PCF_RLSD 支持RLSD(接收线信号检测) PCF_RTSCTS 支持RTS(请求发送)/CTS(清除发送) PCF_SETXCHAR 支持可设置的XON/XOFF PCF_SPECIALCHARS 支持特殊字符 PCF_TOTALTIMEOUTS 支持总(占用时间)超时 PCF_XONXOFF 支持XON/XOFF流控制 标准RS-232和WINDOW支持除PCF_16BITMODE和PCF_SPECIALCHAR外的所有功能 dwSettableParams SP_BAUD 可配置波特率 SP_DATABITS 可配置数据位个数 SP_HANDSHAKING 可配置握手(流控制) SP_PARITY 可配置奇偶校验模式 SP_PARITY_CHECK 可配置奇偶校验允许/禁止 SP_RLSD 可配置RLSD(接收信号检测) SP_STOPBITS 可配置停止位个数 标准RS-232和WINDOW支持以上所有功能 wSettableData DATABITS_5 5个数据位 DATABITS_6 6个数据位 DATABITS_7 7个数据位 DATABITS_8 8个数据位 DATABITS_16 16个数据位 DATABITS_16X 通过串行硬件线路的特殊宽度路径 WINDOWS 95支持16的所有设置
5.DCB结构:
typedef struct _DCB {// dcb DWORD DCBlength; // sizeof(DCB) DWORD BaudRate; // current baud rate 指定当前的波特率 DWORD fBinary: 1; // binary mode, no EOF check 指定是否允许二进制模式, WINDOWS 95中必须为TRUE DWORD fParity: 1; // enable parity checking 指定奇偶校验是否允许 DWORD fOutxCtsFlow:1; // CTS output flow control 指定CTS是否用于检测发送控制。 当为TRUE是CTS为OFF,发送将被挂起。 DWORD fOutxDsrFlow:1; // DSR output flow control 指定CTS是否用于检测发送控制。 当为TRUE是CTS为OFF,发送将被挂起。 DWORD fDtrControl:2; // DTR flow control type DTR_CONTROL_DISABLE值将DTR置为OFF, DTR_CONTROL_ENABLE值将DTR置为ON, DTR_CONTROL_HANDSHAKE允许DTR"握手",DWORD fDsrSensitivity:1; // DSR sensitivity 当该值为TRUE时DSR为OFF时接收的字节被忽略 DWORD fTXContinueOnXoff:1; // XOFF continues Tx 指定当接收缓冲区已满,并且驱动程序已经发 送出XoffChar字符时发送是否停止。 TRUE时,在接收缓冲区接收到缓冲区已满的字节XoffLim且驱动程序已经发送出XoffChar字符中止接收字节之后,发送继续进行。 FALSE时,在接收缓冲区接收到代表缓冲区已空的字节XonChar且驱动程序已经发送出恢复发送的XonChar之后,发送继续进行。 DWORD fOutX: 1; // XON/XOFF out flow control TRUE时,接收到XoffChar之后便停止发送 接收到XonChar之后将重新开始 DWORD fInX: 1; // XON/XOFF in flow control TRUE时,接收缓冲区接收到代表缓冲区满的XoffLim之后,XoffChar发送出去 接收缓冲区接收到代表缓冲区空的XonLim之后,XonChar发送出去 DWORD fErrorChar: 1; // enable error replacement 该值为TRUE且fParity为TRUE时,用ErrorChar 成员指定的字符代替奇偶校验错误的接收字符 DWORD fNull: 1; // enable null stripping TRUE时,接收时去掉空(0值)字节 DWORD fRtsControl:2; // RTS flow control RTS_CONTROL_DISABLE时,RTS置为OFF RTS_CONTROL_ENABLE时, RTS置为ON RTS_CONTROL_HANDSHAKE时, 当接收缓冲区小于半满时RTS为ON 当接收缓冲区超过四分之三满时RTS为OFF RTS_CONTROL_TOGGLE时, 当接收缓冲区仍有剩余字节时RTS为ON ,否则缺省为OFF DWORD fAbortOnError:1; // abort reads/writes on error TRUE时,有错误发生时中止读和写操作 DWORD fDummy2:17; // reserved 未使用 WORD wReserved; // not currently used 未使用,必须为0 WORD XonLim; // transmit XON threshold 指定在XON字符发送这前接收缓冲区中可允许的最小字节数 WORD XoffLim; // transmit XOFF threshold 指定在XOFF字符发送这前接收缓冲区中可允许的最小字节数 BYTE ByteSize; // number of bits/byte, 4-8 指定端口当前使用的数据位 BYTE Parity; // 0-4=no,odd,even,mark,space 指定端口当前使用的奇偶校验方法,可能为: EVENPARITY,MARKPARITY,NOPARITY,ODDPARITY BYTE StopBits; // 0,1,2 = 1, 1.5, 2 指定端口当前使用的停止位数,可能为: ONESTOPBIT,ONE5STOPBITS,TWOSTOPBITS char XonChar; // Tx and Rx XON character 指定用于发送和接收字符XON的值 char XoffChar; // Tx and Rx XOFF character 指定用于发送和接收字符XOFF值 char ErrorChar; // error replacement character 本字符用来代替接收到的奇偶校验发生错误时的值 char EofChar; // end of input character 当没有使用二进制模式时,本字符可用来指示数据的结束 char EvtChar; // received event character 当接收到此字符时,会产生一个事件 WORD wReserved1; // reserved; do not use 未使用 } DCB;
6.改变端口设置
使用如下的两个方法 BOOL GetCommState(hComm,&dcb); BOOL SetCommState(hComm,&dcb);
7.改变普通设置
BuildCommDCB(szSettings,&DCB); szSettings的格式:baud parity data stop 例: "baud=96 parity=n data=8 stop=1" 简写:"96,N,8,1" szSettings 的有效值 baud: 11 or 110 = 110 bps 15 or 150 = 150 bps 30 or 300 = 300 bps 60 or 600 = 600 bps 12 or 1200 = 1200 bps 24 or 2400 = 2400 bps 48 or 4800 = 4800 bps 96 or 9600 = 9600 bps 19 or 19200= 19200bps parity: n=none e=even o=odd m=mark s=space data: 5,6,7,8 StopBit 1,1.5,2
8.COMMCONFIG结构:
typedef struct _COMM_CONFIG { DWORD dwSize; WORD wVersion; WORD wReserved; DCB dcb; DWORD dwProviderSubType; DWORD dwProviderOffset; DWORD dwProviderSize; WCHAR wcProviderData[1]; } COMMCONFIG, *LPCOMMCONFIG; 可方便的使用BOOL CommConfigDialog( LPTSTR lpszName, HWND hWnd, LPCOMMCONFIG lpCC); 来设置串行口。
9.超时设置:
可通过COMMTIMEOUTS结构设置超时, typedef struct _COMMTIMEOUTS { DWORD ReadIntervalTimeout; DWORD ReadTotalTimeoutMultiplier; DWORD ReadTotalTimeoutConstant; DWORD WriteTotalTimeoutMultiplier; DWORD WriteTotalTimeoutConstant; } COMMTIMEOUTS,*LPCOMMTIMEOUTS; 区间超时:(仅对从端口中读取数据有用)它指定在读取两个字符之间要经历的时间 总超时: 当读或写特定的字节数需要的总时间超过某一阈值时,超时触发. 超时公式: ReadTotalTimeout = (ReadTotalTimeoutMultiplier * bytes_to_read) + ReadToTaltimeoutConstant WriteTotalTimeout = (WriteTotalTimeoutMuliplier * bytes_to_write) + WritetoTotalTimeoutConstant NOTE:在设置超时时参数0为无限等待,既无超时 参数MAXDWORD为立即返回 超时设置: GetCommTimeouts(hComm,&timeouts); SetCommTimeouts(hComm,&timeouts);
10.查询方式读写数据
例程: COMMTIMEOUTS to; DWORD ReadThread(LPDWORD lpdwParam) { BYTE inbuff[100]; DWORD nBytesRead; if(!(cp.dwProvCapabilities&PCF_INTTIMEOUTS)) return 1L; memset(&to,0,sizeof(to)); to.ReadIntervalTimeout = MAXDWORD; SetCommTimeouts(hComm,&to); while(bReading) { if(!ReadFile(hComm,inbuff,100,&nBytesRead,NULL)) locProcessCommError(GetLastError()); else if(nBytesRead) locProcessBytes(inbuff,nBytesRead); } PurgeComm(hComm,PURGE_RXCLEAR); return 0L; } NOTE: PurgeComm()是一个清除函数,它可以中止任何未决的后台读或写,并且可以冲掉I/O缓冲区. BOOL PurgeComm(HANDLE hFile,DWORD dwFlags); dwFlages的有效值: PURGE_TXABORT: 中止后台写操作 PRUGE_RXABORT: 中止后台读操作 PRUGE_TXCLEAR: 清除发送缓冲区 PRUGE_RXCLEAR: 清除接收缓冲区 技巧: 可通过ClearCommError()来确定接收缓区中处于等待的字节数。 BOOL ClearCommError( HANDLE hFile, // handle to communications device LPDWORD lpErrors, // pointer to variable to receive error codes LPCOMSTAT lpStat // pointer to buffer for communications status ); ClearCommError()将返回一个COMSTAT结构: typedef struct _COMSTAT { // cst DWORD fCtsHold : 1; // Tx waiting for CTS signal DWORD fDsrHold : 1; // Tx waiting for DSR signal DWORD fRlsdHold : 1; // Tx waiting for RLSD signal DWORD fXoffHold : 1; // Tx waiting, XOFF char rec`d DWORD fXoffSent : 1; // Tx waiting, XOFF char sent DWORD fEof : 1; // EOF character sent DWORD fTxim : 1; // character waiting for Tx DWORD fReserved : 25; // reserved DWORD cbInQue; // bytes in input buffer DWORD cbOutQue; // bytes in output buffer } COMSTAT, *LPCOMSTAT; 其中的cbInQue和cbOutQue中即为缓冲区字节。
11.同步I/O读写数据
COMMTIOMOUTS to; DWORD ReadThread(LPDWORD lpdwParam) { BYTE inbuff[100]; DWORD nByteRead,dwErrorMask,nToRead; COMSTAT comstat; if(!cp.dwProvCapabilities&PCF_TOTALTIMEOUTS) return 1L; memset(&to,0,sizeof(to)); to.ReadTotalTimeoutMultiplier = 5; to.ReadTotalTimeoutConstant = 50; SetCommTimeouts(hComm,&to); while(bReading) { ClearCommError(hComm,&dwErrorMask,&comstat); if(dwErrorMask) locProcessCommError(dwErrorMask); if(comstat.cbInQue >100) nToRead = 100; else nToRead = comstat.cbInQue; if(nToRead == 0) continue; if(!ReadFile(hComm,inbuff,nToRead,&nBytesRead,NULL)) locProcessCommError(GetLastError()); else if(nBytesRead) locProcessBytes(inbuff,nBytesRead); } return 0L; }
12.异步I/O读写数据
当CreateFile()中的fdwAttrsAndFlags参数为FILE_FLAG_OVERLAPPEN时, 端口是为异步I/O打开的,此时可以在ReadFile的最后一个参数中指定一个OVERLAPPED结构,使数据的读操作在后台进行。WINDOWS 95包括了异步I/O的许多变种。 typedef struct _OVERLAPPED { DWORD Internal; DWORD InternalHigh; DWORD Offset; DWORD OffsetHigh; HANDLE hEvent; } OVERLAPPED; 对于串行口仅hEvent成员有效,其于成员必须为0。 例程: COMMTIMEOUTS to; ... DWORD ReadThread((LPDWORD lpdwParam) { BYTE inbuff[100]; DWORD nRytesRead,endtime,lrc; static OVERLAPPED o; if(!cp.dwProvCapabilities & PCF_TOTALTIMEOUTS) return 1L; memset(&to,0,sizeof(to)); to.ReadTotalTimeoutMultiplier = 5; to.ReadTotalTimeoutConstant = 1000; SetCommTimeouts(hComm,&to); o.hEvent = CreateEvent(NULL,TRUE,FALSE,NULL); while(bReading) { if(!ReadFile(hComm,inbuff,10,&nBytesRead,&o)) { nBytesRead = 0; if(lrc=GetLastError() == ERROR_IO_PENDING) { endtime = GetTickCount() + 1000; while(!GetOverlappedResult(hComm,&o,&nBytesRead,FALSE)) if(GetTickCount() > endtime) break; } if(nBytesRead) locProcessBytes(inbuff,nBytesRead); } else { if(nBytesRead) locProcessBytes(inbuff,nBytesRead); ResetEvent(o.hEvent); } } PurgeComm(hComm,PURGE_RXCLEAR); return 0L; } 这一例程是对一开始读缓冲区就读到所需的字节时的处理: while(bReading) { if(!ReadFile(hComm,inbuff,10,&nBytesRead,&o)) { if((lrc=GetLastError()) ==ERROR_IO_PENDING) { if(GetOverlappedResult(hComm,&o,&nBytesRead,TRUE)) { if(nBytesRead) locProcessBytesa(inbuff,nBytesRead); } else locProcessCommError(GetLastError()); } else locProcessCommError(GetLastError)); } else if(nBytesRead) locProcessBytes(inbuff,nBytesRead); ResetEvent(o.hEvent); }
13.事件驱I/O读写:
GetCommMask(hComm,&dwMask) Windows 95报告给应用程序的事件由此方法返回。 SetCommMasl(hComm,&dwMask) 添加或修改Windows 95所报告的事件列表。 事件掩码如下: EV_BREAK 检测到输入为止 EV_CTS CTS(清除发送)信号改变状态 EV_DSR DSR(数据设置就绪)信号改变状态 EV_ERR 发生了线路状态错误. 线路状态错误为: CE_FRAME(帧错误) CE_OVERRUN(接收缓冲区超限) CE_RXPARITY(奇偶校验错误) EV_RING 检测到振铃 EV_RLSD RLSD(接收线路信号检测)信号改变状态 EV_EXCHAR 接收到一个字符,并放入输入缓冲区 EV_RXFLAG 接收到事件字符(DCB成员的EvtChar成员),度放入输入缓冲区 EV_TXEMPTY 输出缓冲区中最后一个字符发送出去 在用SetCommMask指定了有用的事件后,应用程序可调用WaitCommEvent()来等待事件发生. BOOL WaitCommEvent( HANDLE hFile, // handle of communications device LPDWORD lpEvtMask, // address of variable for event that occurred LPOVERLAPPED lpOverlapped, // address of overlapped structure ); 此方法可以以同步或异步方式操作 例程: COMMTIMEOUTS to; ... DWORD ReadTherad(LPDWORD lpdwParam) { BYTE binbuff[100]; DWORD nBytesRead,dwEvent,dwError; COMSTAT cs; SetCommMask(hComm,EV_RXHAR); while(bReading) { if(WaitCommEvent(hComm,&dwEvent,NULL)) { ClearCommError(hComm,&dwError,&cs); if((dwEvent&EV_RXCHAR)&&cs.cbInQue) { if(!ReadFile(hComm,inbuff,cs.cbInQue,&nBytesRead,NULL) locProcessCommError(GetLastError()); } else { if(nByteRead) locProcessBytes(inbuff,nBytesRead); } else locProcessCommError(GetLastError()); } PurgeComm(hComm,PURGE_RXCLEAR); return 0L; } NOTE: SetCommMask(hComm,0)可使WaitCommEvent()中止. 可使用GetCommmodemStatus()方法,例程: if(cp.dwProvCapabilities&PCF_RTSCTS) { SetCommMask(hComm,EV_CTS); WaitCommEvent(hComm,&dwMask,NULL); if(dwMask&EV_CTS) { GetCommModemStatus(hComm,&dwStatus) if(dwStatus&MS_CTS_ON) /* CTS stransition OFF-ON */ else /* CTS stransition ON-OFF */ } } MS_CTS_ON CTS为ON MS_DSR_ON DSR为ON MS_RING_ON RING为ON MS_ELSD_ON RLSD为ON
14.错误
当发生错误时应用方法ClearCommError(hComm,&dwErrorMask,&constat)得到错误掩码。 CE_BREAK 中止条件 CE_FRAME 帧错误 CW_IOE 一般I/O错误,常伴有更为详细的错误标志 CE_MODE 不支持请求的模式 CE_OVERRUN 缓冲区超限下一个字符将丢失 CE_RXOVER 接收缓冲区超限 CE_RXPARITY 奇偶校验错误 CE_TXFULL 发送缓冲区满 CE_DNS 没有选择并行设备 CE_PTO 并行设备发生超时 CE_OOP 并行设备缺纸
15.控制命令
EscapeCommFunction()可将硬件信号置ON或OFF,模拟XON或XOFF
BOOL EscapeCommFunction( HANDLE hFile, // handle to communications device DWORD dwFunc // extended function to perform ); dwFunc的有效值(可用'|'同时使用多个值) CLRDTR DTR置OFF CLRRTS RTS置OFF SETDTR STR置ON SETRTS TRS置ON SETXOFF 模拟XOFF字符的接收 SETXON 模拟XON字符的接收 SETBREAK 在发送中产生一个中止 CLRBREAK 在发送中清除中止
|