WIN32:API串口通讯实例教程

WIN32 API串口通讯实例教程

 

 

第一节   实现串口通讯的函数及串口编程简介

 

API函数不仅提供了打开和读写通讯端口的操作方法，还提供了名目繁多的函数以支持对串行通讯的各种操作。常用函数及作用下：

函数名                     作用

CreateFile                 打开串口

GetCommState               检测串口设置

SetCommState               设置串口

BuilderCommDCB             用字符串中的值来填充设备控制块

GetCommTimeouts            检测通信超时设置

SetCommTimeouts            设置通信超时参数

SetCommMask                设定被监控事件

WaitCommEvent              等待被监控事件发生

WaitForMultipleObjects     等待多个被监测对象的结果

WriteFile                  发送数据

ReadFile                   接收数据

GetOverlappedResult        返回最后重叠（异步）操作结果

PurgeComm                  清空串口缓冲区,退出所有相关操作

ClearCommError             更新串口状态结构体,并清除所有串口硬件错误

CloseHandle                关闭串行口

用Windows API 编写串口程序本身是有巨大优点的，因为控制能力会更强，效率也会更

高。

    API编写串口，过程一般是这样的：

    1、  创建串口句柄，用CreateFile；

    2、  对串口的参数进行设置，其中比较重要的是波特率（BaudRate），数据宽度（BytesBits），奇偶校验（Parity），停止位（StopBits），当然，重要的还有端口号（Port）；

    3、  然后对串口进行相应的读写操作，这时候用到ReadFile和WriteFile函数；

4、       读写结束后，要关闭串口句柄，用CloseFile。

下面依次讲述各个步骤的过程。

 

 

  

 

 

 

 

 

 

 

 

 

 

第二节   创建串口句柄打开串口

 

从字面上去理解，大家也可以发现CreateFile实际上表明Windows是把串口当作一个文件来处理的，所以它也有文件那样的缓冲区、句柄、读写错误等，不同的是，这个文件名字只有固定的几个（一般为四个），而且始终存在（EXSITING），而且在调用CreateFile的时候请注意它的参数。CreateFile函数原型如下：

    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：

/******************   example1.cpp   ******************************************/

/* lishaoan  2009-06-29  *****************************************************/

/*   ******************************************************/

#include  <windows.h>

#include   <stdio.h>

#include   <stdlib.h>

 

bool openport(char *portname)//打开串口

{

HANDLE hComm;

hComm = CreateFile(portname, //串口号

                   GENERIC_READ | GENERIC_WRITE, //允许读写

                   0, //通讯设备必须以独占方式打开

                   0, //无安全属性

                   OPEN_EXISTING, //通讯设备已存在

                   FILE_FLAG_OVERLAPPED, //异步I/O

                   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：

/******************   example2.cpp   ******************************************/

/* lishaoan  2009-06-29  *****************************************************/

/*   ******************************************************/

#include  <windows.h>

#include   <stdio.h>

#include   <stdlib.h>

 

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;

}

   

void   main()

{

bool open;

open=openport("com2");

if(open)

printf("open comport success");

system("pause") ;

}

/************************** program end***************************************/