串口编程的一般步骤及相关函数讲解

用Windows API进行串口编程的一般步骤及相关函数讲解

------分隔线----------------------------

虽然使用诸如 CSerialPort VC串口类，MSComm VC 串口控件等非常方便，但有时这些控件并不适合自己的特殊需求，所以有必要了解一下基于Windows API的串口编程方法，下面介绍一下API串口编程的一般步骤及相关串口API函数。

串口操作一般有四步，分别是：

1) 打开串口

2) 配置串口

3) 读写串口

4) 关闭串口

１、打开串口

在《VC 打开串口》一文中我们已经单独介绍过如果利用API打开串口的方法，打开串口是用API函数CreateFile来打开或创建的。该函数的原型为：

1 HANDLE CreateFile( LPCTSTR lpFileName,

2 DWORD dwDesiredAccess,

3 DWORD dwShareMode,

4 LPSECURITY_ATTRIBUTES lpSecurityAttributes,

5 DWORD dwCreationDistribution,

6 DWORD dwFlagsAndAttributes,

7 HANDLE hTemplateFile);

参数详解：

lpFileName：将要打开的串口逻辑名，如COM1；

dwDesiredAccess：指定串口访问的类型，可以是读取、写入或二者并列；

dwShareMode：指定共享属性，由于串口不能共享，该参数必须置为0；

lpSecurityAttributes：引用安全性属性结构，缺省值为NULL；

dwCreationDistribution：创建标志，对串口操作该参数必须置为OPEN_EXISTING；

dwFlagsAndAttributes：属性描述，用于指定该串口是否进行异步操作，该值为FILE_FLAG_OVERLAPPED，表示使用异步的I/O；该值为0，表示同步I/O操作；

hTemplateFile：对串口而言该参数必须置为NULL；

串口的操作可以有两种操作方式：同步操作方式和重叠操作方式（也称为异步操作方式）。同步操作时，API函数会阻塞直到操作完成以后才能返回（在多线程方式中，虽然不会阻塞主线程，但是仍然会阻塞监听线程）；而重叠操作方式，API函数会立即返回，操作在后台进行，避免线程的阻塞。

同步I/O方式打开串口的示例：

8 HANDLE hCom; //全局变量，串口句柄

9 hCom=CreateFile(COM1,//COM1口

10 GENERIC_READ|GENERIC_WRITE, //允许读和写

11 0, //独占方式

12 NULL,

13 OPEN_EXISTING, //打开而不是创建

14 0, //同步方式

15 NULL);

16 if(hCom==(HANDLE)-1)

17 {

18 AfxMessageBox(打开COM失败!);

19 return FALSE;

20 }

21 return TRUE;

重叠I/O打开串口的示例：

22 HANDLE hCom; //全局变量，串口句柄

23 hCom =CreateFile(COM1, //COM1口

24 GENERIC_READ|GENERIC_WRITE, //允许读和写

25 0, //独占方式

26 NULL,

27 OPEN_EXISTING, //打开而不是创建

28 FILE_ATTRIBUTE_NORMAL|FILE_FLAG_OVERLAPPED, //重叠方式

29 NULL);

30 if(hCom ==INVALID_HANDLE_VALUE)

31 {

32 AfxMessageBox(打开COM失败!);

33 return FALSE;

34 }

35 return TRUE;

2、配置串口

在打开通讯设备句柄后，常常需要对串口进行一些初始化配置工作。这需要通过一个DCB结构来进行。DCB结构包含了诸如波特率、数据位数、奇偶校验和停止位数等信息。在查询或配置串口的属性时，都要用DCB结构来作为缓冲区。

一般用CreateFile打开串口后，可以调用GetCommState函数来获取串口的初始配置。要修改串口的配置，应该先修改DCB结构，然后再调用SetCommState函数设置串口。

DCB结构包含了串口的各项参数设置，下面仅介绍几个该结构常用的变量：

36 typedef struct _DCB{

37 &&&

38 //波特率，指定通信设备的传输速率。这个成员可以是实际波特率值或者下面的常量值之一：

39 DWORD BaudRate;

40 CBR_110，CBR_300，CBR_600，CBR_1200，CBR_2400，CBR_4800，CBR_9600，CBR_19200， CBR_38400，

41 CBR_56000， CBR_57600， CBR_115200， CBR_128000， CBR_256000，

CBR_14400

42

43 DWORD fParity; // 指定奇偶校验使能。若此成员为1，允许奇偶校验检查

44 &

45 BYTE ByteSize; // 通信字节位数，48

46 BYTE Parity; //指定奇偶校验方法。此成员可以有下列值：

47 EVENPARITY 偶校验 NOPARITY 无校验

48 MARKPARITY 标记校验 ODDPARITY 奇校验

49 BYTE StopBits; //指定停止位的位数。此成员可以有下列值：

50 ONESTOPBIT 1位停止位 TWOSTOPBITS 2位停止位

51 ONE5STOPBITS 1.5位停止位

52 &&&

53 } DCB;

54 winbase.h文件中定义了以上用到的常量。如下：

55 #define NOPARITY 0

56 #define ODDPARITY 1

57 #define EVENPARITY 2

58 #define ONESTOPBIT 0

59 #define ONE5STOPBITS 1

60 #define TWOSTOPBITS 2

61 #define CBR_110 110

62 #define CBR_300 300

63 #define CBR_600 600

64 #define CBR_1200 1200

65 #define CBR_2400 2400

66 #define CBR_4800 4800

67 #define CBR_9600 9600

68 #define CBR_14400 14400

69 #define CBR_19200 19200

70 #define CBR_38400 38400

71 #define CBR_56000 56000

72 #define CBR_57600 57600

73 #define CBR_115200 115200

74 #define CBR_128000 128000

75 #define CBR_256000 256000

GetCommState函数可以获得COM口的设备控制块，从而获得相关参数：

76 BOOL GetCommState(

77 HANDLE hFile, //标识通讯端口的句柄

78 LPDCB lpDCB //指向一个设备控制块（DCB结构）的指针

79 );

80 SetCommState函数设置COM口的设备控制块：

81 BOOL SetCommState(

82 HANDLE hFile,