串口编程DCB结构体参数配置详细说明

序号	字段	释义
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，则不使用间隔超时，只考虑总超时设置。