WIN32 API串口通讯实例教程

WIN32 API 串口通讯实例教程
第一节 实现串口通讯的函数及串口编程简介
API 函数不仅提供了打开和读写通讯端口的操作方法，还提供了名目繁多的函数以支持对串行通讯的 各种操作。常用函数及作用下： 函数名 CreateFile GetCommState SetCommState BuilderCommDCB GetCommTimeouts SetCommTimeouts SetCommMask WaitCommEvent WaitForMultipleObjects WriteFile ReadFile GetOverlappedResult PurgeComm ClearCommError CloseHandle 作用 打开串口 检测串口设置 设置串口 用字符串中的值来填充设备控制块 检测通信超时设置 设置通信超时参数 设定被监控事件 等待被监控事件发生 等待多个被监测对象的结果 发送数据 接收数据 返回最后重叠（异步）操作结果 清空串口缓冲区,退出所有相关操作 更新串口状态结构体,并清除所有串口硬件错误 关闭串行口
DWORD fParity: 1;//是否进行奇偶校验 DWORD fOutxCtsFlow:1; //CTS 线上的硬件握手 DWORD fOutxDsrFlow:1; DWORD fDtrControl:2; //DSR 线上的硬件握手 //DTR 控制
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 ErrorChar; char EofChar; char EvtChar; WORD wReserved1; } DCB; //设置在 XON 字符发送之前 inbuf 中允许的最少字节数 //在发送 XOFF 字符之前 outbuf 中允许的最多字节数 //数据宽度，一般为 8，有时候为 7 //奇偶校验 //停止位数 //设置表示 XON 字符的字符,一般是采用 0x11 这个数值 //是否使用 XON/XOFF 协议 //是否使用 XON/XOFF 协议 //发送错误协议
用 Windows API 编写串口程序本身是有巨大优点的，因为控制能力会更强，效率也会更 高。 API 编写串口，过程一般是这样的： 1、 2、 创建串口句柄，用 CreateFile； 对串口的参数进行设置，其中比较重要的是波特率（BaudRate），数据宽度（BytesBits），奇
偶校验（Parity），停止位（StopBits），当然，重要的还有端口号（Port）； 3、 4、 然后对串口进行相应的读写操作，这时候用到 ReadFile 和 WriteFile 函数； 读写结束后，要关闭串口句柄，用 CloseFile。
下面依次讲述各个步骤的过程。
第二节 创建串口句柄打开串口
从字面上去理解，大家也可以发现 CreateFile 实际上表明 Windows 是把串口当作一个文件来处理 的，所以它也有文件那样的缓冲区、句柄、读写错误等，不同的是，这个文件名字只有固定的几个（一般 为四个），而且始终存在（EXSITING），而且在调用 CreateFile 的时候请注意它的参数。CreateFile 函 数原型如下：
第三节
设置串口
在打开通信设备句柄后，常常需要对串行口进行一些初始化工作。这需要通过一个 DCB 结构来进行。 DCB 结构包含了诸如波特率、每个字符的数据位数、奇偶校验和停止位数等信息。在查询或配置串口的属 性时，都要用 DCB 结构来作为缓冲区。
第一次打开串口时，串口设置为系统默认值，函数 GetCommState 和 SetCommState 可用于检索和设定 端口设置的 DCB(设备控制块)结构，该结构中 BaudRate、ByteSize、StopBits 和 Parity 字段含有串口波 特率、数据位数、停止位和奇偶校验控制等信息。 程序中用 DCB 进行串口设置时，应先调用 API 函数 GetCommState，来获得串口的设置信息： GetCommState() 用途：取得串口当前状态 原型：BOOL GetCommState(HANDLE hFile, LPDCB lpDCB); 参数说明： -hFile：串口句柄 -lpDCB：设备控制块(Device Control Block)结构地址。此结构中含有和设备相关的参数。此处是与 串口相关的参数。由于参数非常多，当需要设置串口参数时，通常是先取得串口的参数结构，修改部分参 数后再将参数结构写入。 然后在需要设置的地方对 dcb 进行设置。串口有很多的属性，上面也已经介绍了一些最重要的参数。 这里介绍数据结构 DCB： typedef struct _DCB { // dcb DWORD DCBlength; DWORD BaudRate; DWORD fBinary: 1; //DCB 结构体大小 //波特率 //是否是二进制，一般设置为 TRUE
bool openport(char *portname)//打开串口 { HANDLE hComm; hComm = CreateFile(portname, //串口号 GENERIC_READ | GENERIC_WRITE, //允许读写 0, //通讯设备必须以独占方式打开 0, //无安全属性 OPEN_EXISTING, //通讯设备已存在 0, //同步 I/O 0); //通讯设备不能用模板打开 if (hComm == INVALID_HANDLE_VALUE) { CloseHandle(hComm); return FALSE; } else return true; }
0); //通讯设备不能用模板打开 if (hComm == INVALID_HANDLE_VALUE) { CloseHandle(hComm); return FALSE; } else return true; }
void {
main()
bool open; open=openport("com2"); if(open) printf("open comport success"); system("pause") ; } /************************** program end***************************************/ 实例 2： /****************** /* lishaoan /* #include #include #include example2.cpp ******************************************/
2009-06-29
*****************************************************/
******************************************************/ #include #include #include <windows.h> <stdio.h> <stdlib.h>
char XoffChar; //设置表示 XOFF 字符的字符,一般是采用 0x13 这个数值
我们真正在串口编程中用到的数据成员没有几个，在此仅介绍少数的几个常用的参数： DWORD BaudRate：串口波特率 DWORD fParity：为 1 的话激活奇偶校验检查 DWORD Parity：校验方式，值 0~4 分别对应无校验、奇校验、偶校验、校验置位、校验清零 DWORD ByteSize：一个字节的数据位个数，范围是 5~8 DWORD StopBits：停止位个数，0~2 分别对应 1 位、1.5 位、2 位停止位 然后再末尾调用 SetCommState 就可以了，还是比较方便的。这样可不必构造一个完整的 DCB 结构。 SetCommState() 用途：设置串口状态，包括常用的更改串口号、波特率、奇偶校验方式、数据位数等 原型：BOOL SetCommState(HANDLE hFile, LPDCB lpDCB); 参数说明： -hFile:串口句柄 -lpDCB：设备控制块(Device Control Block)结构地址。要更改的串口参数包含在此结构中。 然后调用 SetCommMask,用来指定程序接收特定的串口事件,调用 SetupComm 函数,设置串口缓冲区大 小: SetCommMask（）说明： 用途：设置串口通信事件。 原型：BOOL SetCommMask(HANDLE hFile, DWORD dwEvtMask ); 参数说明： -hFile：串口句柄 -dwEvtMask：准备监视的串口事件掩码 该参数有如下信息掩码位值： EV_BREAK:收到 BREAK 信号 EV_CTS:CTS(clear to send)线路发生变化 EV_DSR:DST(Data Set Ready)线路发生变化 EV_ERR:线路状态错误，包括了 CE_FRAME\CE_OVERRUN\CE_RXPARITY 3 钟错误。 EV_RING:检测到振铃信号。 EV_RLSD:CD(Carrier Detect)线路信号发生变化。 EV_RXCHAR:输入缓冲区中已收到数据。 EV_RXFLAG:使用 SetCommState()函数设置的 DCB 结构中的等待字符已被传入输入缓冲区中。 EV_TXEMPTY:输出缓冲区中的数据已被完全送出。 还有，串口因为是 I/O 操作，可能会产生错误，这时候需要用 SetCommTimeouts（）设置超时限制， 以避免阻塞现象。设置超时设置需要一个结构体 COMMTIMEOUTS。 SetCommTimeouts（） BOOL SetCommTimeouts( hCommDev， lpctmo )； Lpctmo 指向包含新的超时参数的 COMMTIMEOUTS 结构。 COMMTIMEOUTS 结构定义如下： typedef struct _ COMMTIMEOUTS{ DWORD ReadIntervalTimeout; DWORD ReadTotalTimeoutMultiplier; DWORD ReadTotalTimeoutconstant; DWORD WriteTotalTimeoutMultiplier;
HANDLE CreateFile(LPCTSTR lpFileName, DWORD dwDesiredAccess, DWORD dwShareMode, LPSECURITY_ATTRIBUTES lpSecurityAttributes, DWORD dwCreationDisposition, DWORD dwFlagsAndAttributes, HANDLE hTemplateFile ); lpFileName：指向一个以 NULL 结束的字符串，该串指定了要创建、打开或截断的文件、管道、通信 源、磁盘设备或控制台的名字。当用 CreateFile 打开串口时，这个参数可用“COM1”指定串口 1，用 “COM2”指定串口 2，依此类推。 dwDesireAccess： 指定对文件访问的类型，该参数可以为 GENERIC_READ(指定对该文件的读访问权) 或 GENERIC_WRITE（指定该文件的写访问权）两个值之一或同时为为这两个值。用 ENERIC_READ|GENERIC_WRITE 则指定可对串口进行读写; dwShareMode：指定此文件可以怎样被共享。因为串行口不支持任何共享模式，所以 dwShareMode 必 须设为０; lpSecurityAttributes 定义安全属性，一般不用，可设为 NULL。Win 9x 下该参数被忽略； dwCreationDistribution 定义文件创建方式， 对串口必须设为 OPEN_EXISTING，表示打开已经存在 的文件； dwFlagsAndAttributes 为该文件指定定义文件属性和标志，这个程序中设为 FILE_FLAG_OVERLAPPED，表示异步通信方式； hTemplateFile 指向一个模板文件的句柄，串口无模板可言，设为 NULL。在 Windows 9x 下该参 数必须为 NULL。 串口被成功打开时，返回其句柄，否则返回 INVALID_HANDLE_value(0XFFFFFFFF)。 上面说到了异步，那什么是异步呢？异步是相对同步这个概念而言的。异步，就是说， 在进行串口读写操作时，不用等到 I/O 操作完成后函数才返回，也就是说，异步可以更快得 响应用户操作；同步，相反，响应的 I/O 操作必须完成后函数才返回，否则阻塞线程。对于 一些很简单的通讯程序来说，可以选择同步，这样可以省去很多错误检查，但是对于复杂一点的应用程 序，异步是最佳选择。 实例 1： /****************** /* lishaoan /* example1.cpp ******************************************/
2009-06-29 <windows.h> <stdio.h> <stdlib.h>
****************************************Hale Waihona Puke Baidu************/
******************************************************/
bool openport(char *portname)//打开串口 { HANDLE hComm; hComm = CreateFile(portname, //串口号 GENERIC_READ | GENERIC_WRITE, //允许读写 0, //通讯设备必须以独占方式打开 0, //无安全属性 OPEN_EXISTING, //通讯设备已存在 FILE_FLAG_OVERLAPPED, //异步 I/O
void {
main()
bool open; open=openport("com2"); if(open) printf("open comport success"); system("pause") ; } /************************** program end***************************************/