序号
字段
释义
1
DWORD DCBlength.:
sizeof(DCB)
2
DWORD BaudRate;
current baud rale指定当前的波特率
3
DWORD fBinary: 1
binary mode, no EOF check指定是否允许二进制模式 WIN95中须为TRUE
4
DWORD fParity: 1
enable parity checking指定奇偶校验是否允许
5
DWORD fOutxCtsFlow:l;
CTS output flow control指定CTS是否用于检测发送控 制C当为TRUE时CTS为 // OFF.发送将被挂起° (发送清楚)
6
DWORD fOutxDsrFlow:1;
DSR output flow control指定CTS是否用于检测发送控 制。(数据装备好)当为TRUE是CTS为OFF.发送 将被挂起。
7
DWORD fDtrControl:2;
DTR flow control type //DTR_CONTROL_DISABLE 值将 DTR 置为 OFF, //DTR_CONTROL_ENABLE 值将 DTR 置为 ON, //DTR CONTROL HANDSHAKE 允许 DTR"握手
8
DWORD fDsrSensitivity:l;
DSR sensitivity当该值为TRUE时DSR为OFF时接 收的字节被忽略
9
DWORD fTXContinueOnXoff: 1;
XOFF continues Tx 指定当接收缓冲区已满,并且驱动程序已经发送出 XoffChar字符时发送是否停止。 TRUE时,在接收缓冲区接收到缓冲区已満的字竹 XoffLim且驱动程序已经发送出XoffChar字符中止接 收字节之后,发送继续进行。 FALSE时,在接收缓冲区接收到代表缓冲区己空的字节 XonChar且驱动程序已经发送岀恢复发送的XonChar 之后,发送继续进行。
10
DWORD fOutX: 1.:
XON/XOFF out flow control //TRUE时,接收到XoffChar之后便停止发送 //FALSE时,接收到XonChar之后将重新开始
11
DWORD flnX: 1;
// XON/XOFF in flow control TRUE时,接收缓冲区接收到代表缓冲区满的XoffLim 之后,XoffChar发送出去 接收缓冲区接收到代表缓冲区空的XonLim之后, XonChar发送出去
12
DWORD fErrorChar: 1:
// enable error replacement 该值为 TRUE 且 fParity 为 TRUE 时,用 ErrorChar 成 员指定的字符代替奇偶校验错误的接收字符
13
DWORD fNull: 1;
//enable null stripping TRUE 时,接收时去掉空(0 值)字节
14
DWORD fRtsControl:2;
RTS flow control
15
DWORD fAbortOnError: 1.:
abort reads/writes on error TRUE 时,有错误发生时 中止读和写操作RTS_CONTROL_DISABLE 时,RTS 置为 OFF RTS_CONTROL_ENABLE 时,RTS 置为 ON RTS_CONTROL_HANDSHAKE 时, 当接收缓冲区小于半满时RTS为ON 当接收缓冲区超过四分之三满时RTS为OFF RTS_CONTROL_TOGGLE 时, 当接态缓冲区仍苔剰余字节时RTS为ON,否则缺省为 OFF
16
DWORD fDummy2:17;
reserved 未使用
17
WORD wReserved;
not currently used 未使用,必须为0
18
WORD XonLim;
//transmit XON threshold 指定在XON字符发送这前接收缓冲区中可允许的最小 字节数
19
WORD XoffLim;
// transmit XOFF threshold 指定在XOFF字符发送这前接收缓冲区中可允许的最小 字节数
20
BYTE ByteSize;
number of bits^yte, 4-8 指定端口当前使用的数据 位
21
BYTE Parity;
// 0-4=no,odd,even,mark,space 指定端口当前使用的 奇偶校验方法,可能为: EVENPARITY,MARKPARITY,NOPARITY,ODDPARITY
22
BYTE StopBits;
0,1,2 = 1, 1.5,2 指定端口当前使用的停止位数,可 能为: ONESTOPBIT,ONE5STOPBITS,TWOSTOPBITS
23
char XonChar:
// Tx and Rx XON character 指定用于发送和接收 字符XON的值
24
char XoffChar;
Tx and Rx XOFF character 指定用于发送和接收字 符XOFF值
25
char ErrorChar;
// error replacement character本字符用来代替接收到 的奇偶校验发生错误时的值
26
char EofChar;
// end of input character当没有使用二进制模式时,本 字符可用来指示数据的结束
27
char EvtChar;
// received event character当接收到此字符时,会产 生一个事件
28
WORD wReservedl;
// reserved; do not use 未使用
在这个结构中, 共有28个变量, 我把这些成员归类为几种.
1. 串口的基本设置
1) DWORD BaudRate; 波特率设置。
2) BYTE ByteSize; 数据位设置。
3) DWORD fParity: 1; TRUE时,支持奇偶检验。
4) BYTE Parity; 奇偶检验位的设置
5) BYTE StopBits; 停止位的设置
2. 流控制(Flow Control) 的设置
流控制分为硬件流控制和软件流控制。而硬件流控制又分为RTS/CTS和DTR/DSR两种。而软件流控制,则是Xon/Xoff。
DTR/DSR 硬件流控制:
1) DWORD fOutxDsrFlow:1; TRUE时,支持DSR流控制。当DSR为OFF时,停止发送。
2) DWORD fDtrControl:2; DTR设置。(置高/置低...)
3) DWORD fDsrSensitivity:1; TRUE时,当DSR为OFF,则接收端忽略所有字符。
RTS/CTS 硬件流控制:
4) DWORD fOutxCtsFlow:1; TRUE时,支持CTS流控制。当CTS为OFF时,停止发送。
5) DWORD fRtsControl:2; RTS设置。(置高/置低...)
Xon/Xoff 软件流控制:
6) DWORD fOutX: 1; 发送端支持Xon/Xoff。
7) DWORD fInX: 1; 接收端支持Xon/Xoff。
8) WORD XonLim; 当接收Buffer中的字符减少小XonLim规定的字符数,就发送Xon 字符,让对方继续发送。
9) WORD XoffLim; 接收Buffer达到XoffLim规定的字符数,就发送Xoff字符,让对方停止发送。
10)char XonChar; Xon 字符。
11)char XoffChar; Xoff 字符。
12)DWORD fTXContinueOnXoff:1; TRUE时,不管接收端是否Xoff,本方发送端持续发送。(也就是本方的发送端,与本方接收端Xon/Xoff是相互独立的)。若为False 时,则当接收端buffer 达到XoffLim 时,发送端发送完Xoff字符后,就停止发送。
3. Error 情况处理
1) DWORD fErrorChar: 1; TRUE时,若fParity为TRUE,则用ErrorChar替换Parity Check 错误的字符。
2) DWORD fAbortOnError:1; TRUE时,发生错误时停止读写操作。
3) char ErrorChar; Parity Check 错误时,替换的字符。
4. 其他参数
1) DWORD DCBlength; DCB结构的长度(以字节为单位)
2) DWORD fBinary: 1; 二进制模式。(必须为1 )
3) DWORD fNull: 1; TRUE时,接收时去掉空字节(0x0)
4) char EofChar; EOF替代字符
5) char EvtChar; 事件触发字符
6) DWORD fDummy2:17; 保留
7) WORD wReserved; 保留
8) WORD wReserved1; 保留
在WIN32 API编程中,除了DCB结构之外,还需要了解COMMTIMEOUTS结构.这个结构是为了读写串口的超时而设置的.
COMMTIMEOUTS结构如下:
typedef struct _COMMTIMEOUTS {
DWORD ReadIntervalTimeout; //任意相邻连个字符之间的超时设置DWORD ReadTotalTimeoutMultiplier; //读操作总的超时时间的系数
DWORD ReadTotalTimeoutConstant; //读操作总的超时时间的修正常量
DWORD WriteTotalTimeoutMultiplier; //写操作总的超时时间的系数
DWORD WriteTotalTimeoutConstant; //写操作总的超时时间的修正常量
} COMMTIMEOUTS,*LPCOMMTIMEOUTS;
ReadIntervalTimeout:两相邻字符之间最大的延时。当读串口数据时,一旦两个字符传输的时间间隔超过该时间,读函数将返回现有的数据。设置为0表示该参数不起作用。
ReadTotalTimeoutMultiplier:读操作总的超时事件的系数。这个变量是不能单独使用的。必须和ReadTotalTimeoutConstant 一起使用才有效果。
ReadTotalTimeoutConstant:读操作总的超时时间的修正常量。这个变量也是不能单独使用的。必须和ReadTotalTimeoutMultiplier一起使用才有效果。
WriteTotalTimeoutMultiplier:写操作总的超时事件的系数。这个变量是不能单独使用的。必须和WriteTotalTimeoutConstant 一起使用才有效果。
WriteTotalTimeoutConstant:写操作总的超时时间的修正常量。这个变量也是不能单独使用的。必须和WriteTotalTimeoutMultiplier一起使用才有效果。
在整个串口的读写操作中,存在着两种超时设置。一种是间隔超时,一种是总超时。这两种超时是独立存在,互不影响的。
间隔超时,只在读操作中存在。就是ReadIntervalTimeout。当读操作中,前后两个字符之间的时间间隔超过时,读操作就结束了。举例来说,你一次读取8个字符,但是在你读取了第一个字符之后,在读取第二个字符时,间隔超时了,那么读操作就结束了,这样整个操作就只读取了1个字节。即使,你的总时间没有超时。
另一种超时,就是总超时。这里有一个公式。
总的读/写超时时间= Read(Write)TotalTimeoutMultiplier x 要读/写的字节数+
Read(Write)TotalTimeoutConstant.
这里要说明的一点,要读/写的字节数是从哪里来的。这个是从ReadFile 或者WriteFile 函数中定义的。
在读操作时,若当前所花读取时间已经超过了总的超时设置,则读操作就结束了。即使,每两个字符之间的间隔没有超时。举例来说,若总共读取8个字节。间隔设置
为8ms,总超时系数为3ms,总超时常数为3ms。则总的超时时间为3*8+3=27ms。若每个字符读取的间隔为7ms,则这次操作总共能读取4个字符。就结束了。因为读取第5个字符时,已经需要35ms,超过总超时时间了。
下面来讨论一下这几个参数的设定:
将ReadIntervalTimeout设置为MAXDWORD,将ReadTotalTimeoutMultiplier 和ReadTotalTimeoutConstant设置为0,表示读操作将立即返回存放在输入缓冲区的字符。
将ReadIntervalTimeout设置为MAXDWORD,将ReadTotalTimeoutMultiplier 和ReadTotalTimeoutConstant设置为MAXDWORD,表示读操作会一直等待直到所需要读取的字节数全部接收到为止。(大家可以把MAXDWORD 认为是永远)
将ReadIntervalTimeout设置为0,则不使用间隔超时,只考虑总超时设置。