在CB6下基于api函数编写串口通信措施简介

副标题#e#

1-在C++ Builder 6.0下基于api函数编写串口通信措施简介：

在dos/win95/win98的年月，操纵系统对串口是不掩护的，也就是说将串口的的资源完全开放给用户，用户可以用直接操纵硬件的函数(好比说TC2.0下的inport()和outport()函数) 跟串口直接打交道，这时候用户利用直接操纵串口的函数奈何"熬煎"串口都是没有问题的，操纵系统基础就不管不问，对串口操纵所造成的一切效果都是用户一小我私家包袱的，这时候用户对串口具有高度自由的支配权；可是，这种环境好景不长，从win2000操纵系统开始，微软为了"照顾好"计较机上的硬件，开始实施了对硬件的掩护计策，也就是说任何用户在他的操纵系统下诡计哄骗串口时必需颠末他的同意方可举办，其实也就是变相的将用户往必需利用他的通信api函数才气操纵串口这条"羊肠小路"上赶(虽然也有此外要领操纵串口，但那些并非我等普通用户能研究大白的)，形象一点说就仿佛你想奈何操纵串口的意图必需颠末win2000的翻译(其实是win2000的设备驱动措施)才气传达给串口一样，基于这一点我们说(其实是许多资料上说的)win2000下通过api函数操纵串口是具有"设备无关性的"，什么意思呢？就是说你想奈何操纵串口就用相应的api函数汇报操纵系统你想对串口干什么，然后操纵系统就把你的意思转告给串口让其做出相应的行动，相对付dos/win95/win98下来说，据我领略也就相当于你本来写的直接操纵串口的函数在win2000下他替你完成了，可是你必需用win2000通信api函数清楚地向操纵系统表达清楚你到底想干什么，所以说在这种环境下要想写好串口驱动措施你就必需至少弄大白win2000下的通信api函数都是干什么的方可，啰里啰唆絮聒了这么多… …sorry,还没完呢，至少尚有一件事我想说，本来在dos/win95/win98系统下有许多几何好手用c/c++对串口举办直接操纵长短常纯熟的，尤其是dos时代的turbo 2.0操纵串口的好手他们写的串口驱动措施直到win98的时候还用的很是洋洋自得，可是到了win2000的时候，他们的措施溘然欠好使了，而他们有的大概还会因为常识布局上的滞后始终弄不大白怎么回事儿，兄弟们，你们该大白了吧？闲话少叙，下面先容笔者写串口通信函数时用到的各个api函数———

#p#副标题#e#

2-CreateFile()

用途：打开串口

原型：HANDLE CreateFile(LPCTSTR lpFileName,

DWORD dwDesiredAccess,

DWORD dwShareMode,

LPSECURITY_ATTRIBUTES lpSecurityAttributes,

DWORD dwCreationDistribution,

DWORD dwFlagsAndAttributes,

HANDLE hTemplateFile);

参数说明：

-lpFileName：要打开的文件名称。对串口通信来说就是COM1或COM2。

-dwDesiredAccess:读写模式配置。此处应该用GENERIC_READ及GENERIC_WRITE。

-dwShareMode：串口共享模式。此处不答允其他应用措施共享，应为0。

-lpSecurityAttributes：串口的安详属性，应为0，暗示该串口不行被子措施担任。

-dwCreationDistribution：建设文件的性质，此处为OPEN_EXISTING.

-dwFlagsAndAttributes：属性及相关符号，这里利用异步方法应该用FILE_FLAG_OVERLAPPED。

-hTemplateFile:此处为0。

操纵说明：若文件打开乐成，串口即可利用了，该函数返回串口的句柄，今后对串口操纵时即可利用该句柄。

举例：HANDLE hComm;

hComm=CreateFile("COM1", //串标语

GENERIC_READ|GENERIC_WRITE, //答允读写0, //通讯设备必需以独有方法打开

NULL, //无安详属性

OPEN_EXISTING, //通讯设备已存在FILE_FLAG_OVERLAPPED, //异步I/O 0); //通讯设备不能用模板打开hComm即为函数返回的串口1的句柄。

3-CloseHandle()

用途：封锁串口

原型：BOOL CloseHandle(HANDLE hObjedt)

参数说明：

-hObjedt：串口句柄

操纵说明：乐成封锁串口时返回true,不然返回false

举例：CloseHandle(hComm);

#p#副标题#e#

4-GetCommState()

用途：取得串口当前状态

原型：BOOL GetCommState(HANDLE hFile,

LPDCB lpDCB);

参数说明：

-hFile：串口句柄

-lpDCB：设备节制块(Device Control Block)布局地点。此布局中含有和设备相关的参数。此处是与串口相关的参数。由于参数很是多，当需要配置串口参数时，凡是是先取得串口的参数布局，修改部门参数后再将参数布局写入。

在此仅先容少数的几个常用的参数：

DWORD BaudRate：串口波特率

DWORD fParity：为1的话激活奇偶校验查抄

DWORD Parity：校验方法，值0~4别离对应无校验、奇校验、偶校验、校验置位、校验清零

DWORD ByteSize：一个字节的数据位个数，范畴是5~8

DWORD StopBits：遏制位个数，0~2别离对应1位、1.5位、2位遏制位操纵举例：DCB ComDCB; //串口设备节制块

GetCommState(hComm,&ComDCB);

5-SetCommState()

用途：配置串口状态，包罗常用的变动串标语、波特率、奇偶校验方法、数据位数等原型：BOOL SetCommState(HANDLE hFile,

LPDCB lpDCB);

参数说明：

-hFile:串口句柄

-lpDCB：设备节制块(Device Control Block)布局地点。要变动的串口参数包括在此布局中。

操纵举例：DCB ComDCB;

GetCommState(hComm,&ComDCB);//取恰当前串口状态ComDCB.BaudRate=9600;//变动为9600bps,该值即为你要修改后的波特率

SetCommState(hComm,&ComDCB;//将变动后的参数写入串口6-WriteFile()

用途：向串口写数据

原型：BOOL WriteFile(HANDLE hFile,

LPCVOID lpBuffer,

DWORD nNumberOfBytesToWrite,

#p#副标题#e#

LPDWORD lpNumberOfBytesWritten,

LPOVERLAPPED lpOverlapped);

参数说明：

-hFile：串口句柄

-lpBuffer：待写入数据的首地点

-nNumberOfBytesToWrite：待写入数据的字节数长度

-lpNumberOfBytesWritten：函数返回的实际写入串口的数据个数的地点，操作此变量可判定实际写入的字节数和筹备写入的字节数是否沟通。

-lpOverlapped:重叠I/O布局的指针

操纵举例：DWORD BytesSent=0;

unsigned char SendBytes[5]={1,2,3,4,5};

OVERLAPPED ov_Write;

ov_Write.Offset=0;

ov_Write.OffsetHigh=0;

WriteFile(hComm, //挪用乐成返回非零，失败返回零

SendBytes, //输出缓冲区

5, //筹备发送的字符长度

&BytesSent, //实际发出的字符数

&ov_Write); //重叠布局

#p#分页标题#e#

假如函数执行乐成的话查抄BytesSent的值应该为5，此函数是WriteFile函数执行完毕后自行填充的，操作此变量的填充值可以用来查抄该函数是否将所有的数据乐成写入串口

7-ReadFile()

用途：读串口数据

原型：BOOL ReadFile(HANDLE hFile,

LPVOID lpBuffer,

DWORD nNumberOfBytesToRead,

lpNumberOfBytesRead,

lpOverlapped);

参数说明：

-hFile：串口句柄

-lpBuffer：存储被读出数据的首地点

-nNumberOfBytesToRead：筹备读出的字节个数

-NumberOfBytesRead：实际读出的字节个数

-lpOverlapped：异步I/O布局，

操纵举例：unsigned char ucRxBuff[20];

COMSTAT ComStat;

DWORD dwError=0;

DWORD BytesRead=0;

OVERLAPPED ov_Read;

#p#副标题#e#

ov_Read.hEvent=CreateEvent(NULL, true, false, NULL);//必需建设有效事件

ClearCommError(hComm,&dwError,&ComStat);//查抄串口吸收缓冲区中的数据个数

bResult=ReadFile(hComm, //串口句柄

ucRxBuff, //输入缓冲区地点

ComStat.cbInQue, //想读入的字符数

&BytesRead, //实际读出的字节数的变量指针

&ov_Read); //重叠布局指针

如果当前串口中有5个字节数据的话，那么执行完ClearCommError()函数后，ComStat

布局中的ComStat.cbInQue将被填充为5，此值在ReadFile函数中可被直接操作。

8-ClearCommError()

用途：排除串口错误可能读取串口此刻的状态

原型：BOOL ClearCommError(HANDLE hFile,

LPDWORD lpErrors,

LPCOMATAT lpStat

);

参数说明:

-hFile:串口句柄

-lpErrors：返回错误数值，错误常数如下：

1-CE_BREAK:检测到间断信号。意思是说检测到某个字节数据缺少正当的遏制位。

2-CE_FRAME:硬件检测到帧错误。

3-CE_IOE:通信设备产生输入/输堕落误。

4-CE_MODE:配置模式错误，或是hFile值错误。

5-CE_OVERRUN:溢堕落误，缓冲区容量不敷，数据将丢失。

6-CE_RXOVER:溢堕落误。

7-CE_RXPARITY:硬件查抄到校验位错误。

8-CE_TXFULL:发送缓冲区已满。

-lpStat:指向通信端口状态的布局变量，原型如下：

typedef struct _COMSTAT{

…

DWORD cbInQue; //输入缓冲区中的字节数

DWORD cbOutQue;//输出缓冲区中的字节数

}COMSTAT,*LPCOMSTAT;

该布局中对我们很重要的只有上面两个参数，其他的我们可以不消管。

#p#副标题#e#

操纵举例：COMSTAT ComStat;

DWORD dwError=0;

ClearCommError(hComm,&dwError,&ComStat);

上式执行完后，ComStat.cbInQue就是串口中当前含有的数据字节个数，我们操作此

数值就可以用ReadFile()函数去读串口中的数据了。

9-PurgeComm()

用途：排除串口缓冲区

原型：BOOL PurgeComm(HANDLE hFile,

DWORD dwFlags

);

参数说明：

-hFile:串口句柄

-dwFlags：指定串口执行的行动，由以下参数构成：

-PURGE_TXABORT:遏制今朝所有的传输事情当即返回不管是否完成传输行动。

-PURGE_RXABORT:遏制今朝所有的读取事情当即返回不管是否完成读取行动。

-PURGE_TXCLEAR:排除发送缓冲区的所有数据。

-PURGE_RXCLEAR:排除吸收缓冲区的所有数据。

操纵举例：PurgeComm(hComm, PURGE_RXCLEAR|PURGE_TXCLEAR|PURGE_RXABORT|PURGE_TXABORT);

排除串口的所有操纵。

10-SetCommMask()

用途：配置串口通信事件。

原型：BOOL SetCommMask(HANDLE hFile,

DWORD dwEvtMask

);

参数说明：

-hFile：串口句柄

-dwEvtMask：筹备监督的串口事件掩码

注：在用api函数撰写串口通信函数时概略上有两种要领，一种是查寻法，别的一种是事件通知法。

#p#分页标题#e#

这两种要领的区别在于收串口数据时，前一种要领是主动的周期性的查询串口中当前有没有数据；后一种要领是事先配置好需要监督的串口通信事件，然后依靠单独开设的帮助线程举办监督该事件是否已产生，假如没有产生的话该线程就一直不断的期待直到该事件产生后，将该串口事件以动静的方法通知主窗体，然后主窗体收到该动静后依据差异的事件性质举办处理惩罚。

#p#副标题#e#

好比说当主窗体收到监督线程发来的RX_CHAR(串口中有数据)的动静后，就可以用ReadFile()

函数去读串口。该参数有如下信息掩码位值：

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:输出缓冲区中的数据已被完全送出。

操纵举例：SetCommMask(hComm,EV_RXCHAR|EV_TXEMPTY);

上面函数执行完毕后将监督串口中有无数据和发送缓冲区中的数据是否全部发送完毕。

11-WaitCommEvent()

用途：用来判定用SetCommMask()函数配置的串口通信事件是否已产生。

原型：BOOL WaitCommEvent(HANDLE hFile,

LPDWORD lpEvtMask,

LPOVERLAPPED lpOverlapped

);

参数说明：

-hFile：串口句柄

-lpEvtMask:函数执行完后假如检测到串口通信事件的话就将其写入该参数中。

-lpOverlapped：异步布局，用来生存异步操纵功效。

操纵举例：OVERLAPPED os; DWORD dwMask,dwTrans,dwError=0,err; memset(&os,0,sizeof(OVERLAPPED)); os.hEvent=CreateEvent(NULL,TRUE,FALSE,NULL); if(!WaitCommEvent(hComm,&dwMask,&os)){ //假如异步操纵不能当即完成的话,函数返回FALSE,而且挪用GetLastError()函 //数阐明错误原因后返回ERROR_IO_PENDING,指示异步操纵正在靠山举办.这种情 //况下,在函数返回之前系统配置OVERLAPPED布局中的事件为无信号状态,该函数 //期待用SetCommMask()函数配置的串口事件产生，共有9种事件可被监督： //EV_BREAK，EV_CTS，EV_DSR，EV_ERR，EV_RING，EV_RLSD，EV_RXCHAR， //EV_RXFLAG，EV_TXEMPTY；当个中一个事件产生或错误产生时，函数将 //OVERLAPPED布局中的事件置为有信号状态，并将事件掩码填充到dwMask参数中 if(GetLastError()==ERROR_IO_PENDING){ /**************************************************************/ /*在此期待异步操纵功效,直到异步操纵竣事时才返回.实际上此时 */ /*WaitCommEvent()函数一直在期待串口监控的事件之一产生,当事件发*/ /*生时该函数将OVERLAPPED布局中的事件句柄置为有信号状态,此时 */ /*GetOverlappedResult()函数发明此事件有信号后顿时返回,然后下面*/ /*的措施顿时阐明WaitCommEvent()函数比及的事件是被监督的串口事 */ /*件中的哪一个,然后执行相应的行动并发出相应动静. */ /**************************************************************/ GetOverlappedResult(hComm,&os,&dwTrans,true); switch(dwMask){ case EV_RXCHAR: PostMessage(Parent,WM_COMM_RXCHAR,0,0); break; case EV_TXEMPTY: PostMessage(Parent,WM_COMM_TXEMPTY,0,0); break; case EV_ERR: switch(dwError){ case CE_FRAME: err=0; break; case CE_OVERRUN: err=1; break; case CE_RXPARITY: err=2; break; default:break; } PostMessage(Parent,WM_COMM_ERR,(WPARAM)0,(LPARAM)err); break; case EV_BREAK: PostMessage(Parent,WM_COMM_BREAK,0,0); break; case ...://其他用SetCommMask()函数配置的被监督的串口通信事件。 ... ... break; default:break; } }

#p#副标题#e#

12-以上扼要先容了大部门的串口通信api函数，笔者所写的串口通信软件用的是事件通知方法，该方法是windows2000下效率较高的一种方法。并且只熟悉这些api函数也照旧不足的，该机制下还要牵涉到多线程和动静机制，个中读写串口的行动是由主线程来完成的，好比说操纵者按下发送数据的按钮之后，相应函数马大将某特定区域内里的数据发送出去，所以说用api函数写串口发送数据的成果是相对较简朴的。收数据的时候就要贫苦一点，在打开串口后首先主线程要配置要监督的串口通信事件，然后将监督线程打开，用来监督主线程配置的这些串口通信事件是否已产生，当个中的某个事件产生后，监督线程马大将该动静发送给主线程，个中监督线程在发送动静之前要确保主线程在收到动静后必定的知道串口毕竟产生了什么样的事件，然后按照差异的事件范例举办处理惩罚。下面给出大抵的主线程和监督线程的大抵事情流程：

主线程打开(其实就是主窗体打开之后)

打开串口(配置波特率、校验方法、数据位数、遏制位数)

配置监督线程需要监督的串口通信事件

打开监督线程

期待各类事件的产生(好比发送数据单击事件，变动通信参数事件，监督线程发来的动静等)

——————————————————————————–

监督线程被打开

串口事件产生否(WaitCommEvent())(无论产生否均进入下面的代码)

异步操纵是否正在靠山举办？(if(GetLastError()==ERROR_IO_PENDING))

在此期待异步操纵功效(GetOverlappedResult(hComm,&os,&dwTrans,true))

处理惩罚通信事件，按照事件范例的差异给主窗体发送差异的动静

当前位置：以往代写 > C/C++ 教程 >在CB6下基于api函数编写串口通信措施简介