拿走不谢： WIN32 API 中串口DCB 结构

最新推荐文章于 2024-04-22 10:56:44 发布

十八岁少年想踢球

最新推荐文章于 2024-04-22 10:56:44 发布

阅读量404

点赞数 1

本文链接：https://blog.csdn.net/qq_38370925/article/details/83178533

版权

typedef struct _DCB { 
  DWORD DCBlength; 
  DWORD BaudRate; 
  DWORD fBinary: 1; 
  DWORD fParity: 1; 
  DWORD fOutxCtsFlow:1; 
  DWORD fOutxDsrFlow:1; 
  DWORD fDtrControl:2; 
  DWORD fDsrSensitivity:1; 
  DWORD fTXContinueOnXoff:1; 
  DWORD fOutX: 1; 
  DWORD fInX: 1; 
  DWORD fErrorChar: 1; 
  DWORD fNull: 1; 
  DWORD fRtsControl:2; 
  DWORD fAbortOnError:1; 
  DWORD fDummy2:17; 
  WORD wReserved; 
  WORD XonLim; 
  WORD XoffLim; 
  BYTE ByteSize; 
  BYTE Parity; 
  BYTE StopBits; 
  char XonChar; 
  char XoffChar; 
  char ErrorChar; 
  char EofChar; 
  char EvtChar; 
  WORD wReserved1; 
} DCB;

`DWORD DCBlength;`	sizeof(DCB)
`DWORD BaudRate;`	current baud rate　指定当前的波特率
`DWORD fBinary: 1;`	binary mode, no EOF check　指定是否允许二进制模式WIN95中须为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之后便停止发送 //FALSE时，接收到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
`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
`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 未使用

在这个结构中, 共有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，则不使用间隔超时，只考虑总超时设置。

十八岁少年想踢球

关注

1
点赞
踩
2

收藏

觉得还不错? 一键收藏
0
评论
拿走不谢： WIN32 API 中串口DCB 结构

typedef struct _DCB { DWORD DCBlength; DWORD BaudRate; DWORD fBinary: 1; DWORD fParity: 1; DWORD fOutxCtsFlow:1; DWORD fOutxDsrFlow:1; DWORD fDtrControl:2; DWORD fDsrSensit...
复制链接

扫一扫