1、API描述

  在WIN32 API中,串口使用文件方式进行访问,其操作的API基本上与文件操作的API一致。

  打开串口

  Win32 中用于打开串口的API 函数为CreateFile,其原型为:

HANDLE CreateFile (
 LPCTSTR lpFileName, //将要打开的串口逻辑名,如COM1 或COM2
 DWORD dwAccess, //指定串口访问的类型,可以是读取、写入或两者并列
 DWORD dwShareMode, //指定共享属性,由于串口不能共享,该参数必须置为0
 LPSECURITY_ATTRIBUTES lpsa, //引用安全性属性结构,缺省值为NULL
 DWORD dwCreate, //创建标志,对串口操作该参数必须置为OPEN EXISTING
 DWORD dwAttrsAndFlags, //属性描述,用于指定该串口是否可进行异步操作,
 //FILE_FLAG_OVERLAPPED:可使用异步的I/O
 HANDLE hTemplateFile //指向模板文件的句柄,对串口而言该参数必须置为NULL
);

  例如,以下程序用于以同步读写方式打开串口COM1:

HANDLE hCom;
DWORD dwError;
hCon = CreateFile("COM1", GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING, 0, NULL);
if (hCom == (HANDLE)0xFFFFFFFF)
{
 dwError = GetLastError();
 MessageBox(dwError);
}

  对于dwAttrsAndFlags参数及FILE_FLAG_OVERLAPPED标志的由来,可解释如下:Windows文件操作分为同步I/O和重叠I/O(Overlapped I/ O)两种方式,在同步I/O方式中,API会阻塞直到操作完成以后才能返回(在多线程方式中,虽然不会阻塞主线程,但是仍然会阻塞监听线程);而在重叠I/O方式中,API会立即返回,操作在后台进行,避免线程的阻塞。重叠I/O非常灵活,它也可以实现阻塞(例如我们可以设置一定要读取到一个数据才能进行到下一步操作)。如果进行I/O操作的API 在没有完成操作的情况下返回,我们可以通过调用GetOverLappedResult()函数阻塞到I/O操作完成后返回。

  配置串口

  配置串口是通过改变设备控制块DCB(Device Control Block) 的成员变量值来实现的,接收缓冲区和发送缓冲区的大小可通过SetupComm函数来设置。

  DCB结构体定义为:

typedef struct _DCB { // dcb 
 DWORD DCBlength; // sizeof(DCB) 
 DWORD BaudRate; // current baud rate 
 DWORD fBinary: 1; // binary mode, no EOF check 
 DWORD fParity: 1; // enable parity checking 
 DWORD fOutxCtsFlow:1; // CTS output flow control 
 DWORD fOutxDsrFlow:1; // DSR output flow control 
 DWORD fDtrControl:2; // DTR flow control type 
 DWORD fDsrSensitivity:1; // DSR sensitivity 
 DWORD fTXContinueOnXoff:1; // XOFF continues Tx 
 DWORD fOutX: 1; // XON/XOFF out flow control 
 DWORD fInX: 1; // XON/XOFF in flow control 
 DWORD fErrorChar: 1; // enable error replacement 
 DWORD fNull: 1; // enable null stripping 
 DWORD fRtsControl:2; // RTS flow control 
 DWORD fAbortOnError:1; // abort reads/writes on error 
 DWORD fDummy2:17; // reserved 
 WORD wReserved; // not currently used 
 WORD XonLim; // transmit XON threshold 
 WORD XoffLim; // transmit XOFF threshold 
 BYTE ByteSize; // number of bits/byte, 4-8 
 BYTE Parity; // 0-4=no,odd,even,mark,space 
 BYTE StopBits; // 0,1,2 = 1, 1.5, 2 
 char XonChar; // Tx and Rx XON character 
 char XoffChar; // Tx and Rx XOFF character 
 char ErrorChar; // error replacement character 
 char EofChar; // end of input character 
 char EvtChar; // received event character 
 WORD wReserved1; // reserved; do not use 
} DCB; 
而SetupComm函数的原型则为:
BOOL SetupComm(
 HANDLE hFile, // handle to communications device
 DWORD dwInQueue, // size of input buffer
 DWORD dwOutQueue // size of output buffer
);

  以下程序将串口设置为:波特率为9600,数据位数为7位,停止位为2 位,偶校验,接收缓冲区和发送缓冲区大小均为1024个字节,最后用PurgeComm函数终止所有的后台读写操作并清空接收缓冲区和发送缓冲区:

DCB dcb;
dcb.BaudRate = 9600; //波特率为9600
dcb.ByteSize = 7; //数据位数为7位
dcb.Parity = EVENPARITY; //偶校验
dcb.StopBits = 2; //两个停止位
dcb.fBinary = TRUE;
dcb.fParity = TRUE;
if (!SetCommState(hCom, &dcb))
{
 MessageBox("串口设置出错!");

SetupComm(hCom, 1024, 1024);
PurgeComm(hCom, PURCE_TXABORT | PURGE_RXABORT | PURGE_TXCLEAR | PURGE_RXCLEAR);

  超时设置

  超时设置是通过改变COMMTIMEOUTS结构体的成员变量值来实现的,COMMTIMEOUTS的原型为:

typedef struct _COMMTIMEOUTS
{
 DWORD ReadIntervalTimeout; //定义两个字符到达的最大时间间隔,单位:毫秒
 //当读取完一个字符后,超过了ReadIntervalTimeout,仍未读取到下一个字符,就会
 //发生超时
 DWORD ReadTotalTimeoutMultiplier; 
 DWORD ReadTotalTimeoutConstant;
 //其中各时间所满足的关系如下:
 //ReadTotalTimeout = ReadTotalTimeOutMultiplier* BytesToRead + ReadTotalTimeoutConstant
 DWORD WriteTotalTimeoutMultiplier;
 DWORD WriteTotalTimeoutConstant;
} COMMTIMEOUTS, *LPCOMMTIMEOUTS;

  设置超时的函数为SetCommTimeouts,其原型中接收COMMTIMEOUTS的指针为参数:

BOOL SetCommTimeouts(
 HANDLE hFile, // handle to communications device
 LPCOMMTIMEOUTS lpCommTimeouts // pointer to comm time-out structure
);

  以下程序将串口读操作的超时设定为10 毫秒:

COMMTIMEOUTS to;
memset(&to, 0, sizeof(to));
to.ReadIntervalTimeout = 10;
SetCommTimeouts(hCom, &to);

  与SetCommTimeouts对应的GetCommTimeouts()函数的原型为:

BOOL GetCommTimeouts(
 HANDLE hFile, // handle of communications device
 LPCOMMTIMEOUTS lpCommTimeouts // pointer to comm time-out structure
);

  事件设置

  在读写串口之前,需要用SetCommMask ()函数设置事件掩模来监视指定通信端口上的事件,其原型为:

BOOL SetCommMask(
 HANDLE hFile, //标识通信端口的句柄
 DWORD dwEvtMask //能够使能的通信事件
);

  有了Set当然还会有Get,与SetCommMask对应的GetCommMask()函数的原型为:

BOOL GetCommMask(
 HANDLE hFile, //标识通信端口的句柄
 LPDWORD lpEvtMask // address of variable to get event mask
);

  串口上可以发生的事件可以是如下事件列表中的一个或任意组合:EV_BREAK、EV_CTS、EV_DSR、EV_ERR、EV_RING、EV_RLSD、EV_RXCHAR、EV_RXFLAG、EV_TXEMPTY。

  我们可以用WaitCommEvent()函数来等待串口上我们利用SetCommMask ()函数设置的事件:

BOOL WaitCommEvent(
 HANDLE hFile, //标识通信端口的句柄
 LPDWORD lpEvtMask, // address of variable for event that occurred
 LPOVERLAPPED lpOverlapped, // address of overlapped structure
);

  WaitCommEvent()函数一直阻塞,直到串口上发生我们用所SetCommMask ()函数设置的通信事件为止。一般而言,当WaitCommEvent()返回时,程序员可以由分析*lpEvtMask而获得发生事件的类别,再进行相应的处理。

  读串口

  对串口进行读取所用的函数和对文件进行读取所用的函数相同,读函数原型如下:

BOOL ReadFile(
 HANDLE hFile, // handle of file to read
 LPVOID lpBuffer, // pointer to buffer that receives data
 DWORD nNumberOfBytesToRead, // number of bytes to read
 LPDWORD lpNumberOfBytesRead, // pointer to number of bytes read
 LPOVERLAPPED lpOverlapped // pointer to structure for overlapped I/O
);

  写串口

  对串口进行写入所用的函数和对文件进行写入所用的函数相同,写函数原型如下:

BOOL WriteFile(
 HANDLE hFile, // handle to file to write to
 LPCVOID lpBuffer, // pointer to data to write to file
 DWORD nNumberOfBytesToWrite, // number of bytes to write
 LPDWORD lpNumberOfBytesWritten, // pointer to number of bytes written
 LPOVERLAPPED lpOverlapped // pointer to structure for overlapped I/O
);

  关闭串口

  利用API 函数实现串口通信时关闭串口非常简单,只需使用CreateFile 函数返回的句柄作为参数调用CloseHandle 即可:

BOOL CloseHandle(
 HANDLE hObject // handle to object to close
);

深入浅出VC++串口编程之基于Win32 API相关推荐

  1. 深入浅出VC++串口编程--基于控件

    深入浅出VC++串口编程之基于控件源代码下载 MSComm控件 Visual C++为我们提供了一种好用的ActiveX控件Microsoft Communications Control(即MSCo ...

  2. 深入浅出VC++串口编程--第三方类

    串口类 从本系列文章连载三.四可以看出,与通过WIN32 API进行串口访问相比,通过MScomm这个Activex控件进行串口访问要来的方便许多,它基本上可以向用户屏蔽多线程的细节,以事件(发出On ...

  3. 深入浅出VC++串口编程--短信应用开发

    前面数次连载我们以较长的篇幅讲解了串口通信的硬件原理.DOS平台控制以及基于WIN32 API.控件和第三方类的串口编程.作为本系列文章的最后一次连载,本章将给出一个典型的应用实例:西门子短信服务模块 ...

  4. 深入浅出VC++串口编程之短信应用开发

    前面数次连载我们以较长的篇幅讲解了串口通信的硬件原理.DOS平台控制以及基于WIN32 API.控件和第三方类的串口编程.作为本系列文章的最后一次连载,本章将给出一个典型的应用实例:西门子短信服务模块 ...

  5. 深入浅出VC++串口编程--基于Win32 API

    1.API描述 在WIN32 API中,串口使用文件方式进行访问,其操作的API基本上与文件操作的API一致. 打开串口 Win32 中用于打开串口的API 函数为CreateFile,其原型为: H ...

  6. 深入浅出VC++串口编程--基本概念

    引言 在PC机的主板上,有一种类型的接口可能为我们所忽视,那就是RS-232C串行接口,在微软的Windows系统中称其为COM.我们可以通过设备管理器来查看COM的硬件参数设置,如图1. 图1 在W ...

  7. 深入浅出Visual C++串口编程--深入浅出VC++串口编程之DOS的串口编程

    在DOS平台下,操作串口主要有下列方式:通过BIOS调用.通过串口的硬件中断或通过对串口硬件进行轮询,本章将对以上三种方式进行具体的介绍并给出例子. 1.BIOS中断 在DOS操作系统下,IBM PC ...

  8. 基于WIN32 API界面编程实现的贪吃蛇游戏

    1 设计目的和任务 本次期末大作业采用课程设计的形式进行,作为<Windows编程>课程的期末考核.要求综合运用Windows编程的相关知识,完成大作业的相关内容,并撰写设计报告.其目的和 ...

  9. [源码和文档分享]基于WIN32 API界面编程实现的华容道小游戏

    1 游戏简介 华容道是古老的中国智力游戏,由"曹操败走华容道,正与关公狭路逢.只为当初恩义重,放开金锁走蛟龙"这一故事情节引申而来.华容道有一个4*5的二十个方块构成的棋盘,下方边 ...

最新文章

  1. JavaScript 函数创建思想
  2. IntelliJ IDEA for Mac 项目窗口详解(Project Windows)
  3. 使用协同过滤推荐电影
  4. Detected both log4j-over-slf4j.jar AND bound slf4j-log4j12.jar on the class
  5. JMeter基础之组件的作用域与执行顺序
  6. maven install 没反应
  7. 零基础学python知乎-35岁了零基础自学Python可行吗?
  8. absolute 必须 relative_想搞BLDC电机控制,就必须要懂的角度传感器
  9. C语言之最简单回调demo(五)
  10. netapp 相关常识
  11. 持久层框架有哪些?区别是什么?Mybatis框架的优点和缺点
  12. hbase 二级索引方案
  13. 聚合支付的清算风险有哪些?
  14. 关于中医把脉的一点想法
  15. 触发器(Trigger)
  16. 一文读懂AI圣经,凡研究《深度学习》都知道的一本书!
  17. 用查表的方法将一位十六进制数转换成与它相应的ASCII码
  18. 西门子触摸屏脚本程序_西门子触摸屏的组态和编程
  19. 系统平台如何制订店铺运营计划部署?
  20. 补充番外14:cmake笔记

热门文章

  1. python社区版可以用库么_应用Python,你不但能够得到出色的小区适用和普遍的库集...
  2. 关于go指针在方法or函数中这件事
  3. 1061. 判断题(15)
  4. 计算机汇编语言运用哪个进制,运用汇编语言怎样以2进制、8进制、10进制、16进制方式输出10进制的数的计算结果。...
  5. win10安装mudbox失败,怎么强力卸载删除注册表并重新安装
  6. 爬虫入门-3.初识BeautifulSoup
  7. 十五、导航,头部,CSS基础
  8. 什么是CouchDB?
  9. ASP.NET MVC + ADO.NET EF 项目实战(二):设计过程与设计工具
  10. 图谱问答-句子向量模型部署项目总结(未完)