API串口通信实例nhh.docx

《API串口通信实例nhh.docx》由会员分享，可在线阅读，更多相关《API串口通信实例nhh.docx（70页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、第一节 实现现串口通通讯的函函数及串串口编程程简介API函函数不仅仅提供了了打开和和读写通通讯端口口的操作作方法，还还提供了了名目繁繁多的函函数以支支持对串串行通讯讯的各种种操作。常常用函数数及作用用下：函数名 作用用 CreaateFFilee 打开开串口 GetCCommmStaate 检测测串口设设置 SetCCommmStaate 设置置串口 BuillderrCommmDCCB 用字字符串中中的值来来填充设设备控制制块 GetCCommmTimmeouuts 检测测通信超超时设置置 SetCCommmTimmeouuts 设置置通信超超时参数数 SetCCommmMassk 设定定被

2、监控控事件 WaittCommmEvventt 等待待被监控控事件发发生 WaittForrMulltippleOObjeectss 等待待多个被被监测对对象的结结果 WritteFiile 发送送数据 ReaddFille 接收收数据 GetOOverrlapppeddRessultt 返回回最后重重叠（异异步）操操作结果果 PurggeCoomm 清空空串口缓缓冲区,退出所所有相关关操作 CleaarCoommEErroor 更新新串口状状态结构构体,并并清除所所有串口口硬件错错误 ClosseHaandlle 关闭闭串行口口用Winndowws AAPI编编写串口口程序本本身是有有巨大优

3、优点的，因因为控制制能力会会更强，效效率也会会更高。 AAPI编编写串口口，过程程一般是是这样的的： 11、 创创建串口口句柄，用用CreeateeFille； 22、 对对串口的的参数进进行设置置，其中中比较重重要的是是波特率率（BaaudRRatee），数数据宽度度（ByytessBitts），奇奇偶校验验（Paaritty），停停止位（SStoppBitts），当当然，重重要的还还有端口口号（PPortt）； 33、 然然后对串串口进行行相应的的读写操操作，这这时候用用到ReeadFFilee和WrriteeFille函数数；4、 读写写结束后后，要关关闭串口口句柄，用用ClooseFF

4、ilee。下面依次次讲述各各个步骤骤的过程程。 第二节 创建建串口句句柄打开开串口从字面上上去理解解，大家家也可以以发现CCreaateFFilee实际上上表明WWinddowss是把串串口当作作一个文文件来处处理的，所所以它也也有文件件那样的的缓冲区区、句柄柄、读写写错误等等，不同同的是，这这个文件件名字只只有固定定的几个个（一般般为四个个），而而且始终终存在（EEXSIITINNG），而而且在调调用CrreatteFiile的的时候请请注意它它的参数数。CrreatteFiile函函数原型型如下： HHANDDLE CreeateeFille(LLPCTTSTRR lppFilleNaam

5、e, DDWORRD ddwDeesirredAAcceess, DDWORRD ddwShhareeModde, LLPSEECURRITYY_ATTTRIIBUTTES lpSSecuurittyAtttriibuttes, DDWORRD ddwCrreattionnDisspossitiion, DDWORRD ddwFllagssAnddAtttribbutees, HHANDDLE hTeempllateeFille );lpFiileNNamee：指向向一个以以NULLL结束束的字符符串，该该串指定定了要创创建、打打开或截截断的文文件、管管道、通通信源、磁磁盘设备备或控制制台的名

6、名字。当当用CrreatteFiile打打开串口口时，这这个参数数可用“CCOM11”指定定串口11，用“CCOM22”指定定串口22，依此此类推。dwDeesirreAcccesss： 指定对对文件访访问的类类型，该该参数可可以为GGENEERICC_REEAD(指定对对该文件件的读访访问权)或GEENERRIC_WRIITE（指指定该文文件的写写访问权权）两个个值之一一或同时时为为这这两个值值。用EENERRIC_REAAD|GGENEERICC_WRRITEE则指定定可对串串口进行行读写;dwShhareeModde：指指定此文文件可以以怎样被被共享。因因为串行行口不支支持任何何共享模模

7、式，所所以dwwShaareMModee必须设设为;lpSeecurrityyAtttribbutees定义义安全属属性，一一般不用用，可设设为NUULL。WWin 9x下下该参数数被忽略略；dwCrreattionnDisstriibuttionn定义文文件创建建方式， 对串口口必须设设为OPPEN_EXIISTIING，表表示打开开已经存存在的文文件；dwFllagssAnddAtttribbutees为该该文件指指定定义义文件属属性和标标志，这这个程序序中设为为FILLE_FFLAGG_OVVERLLAPPPED，表表示异步步通信方方式； hhTemmplaateFFilee指向一一个模

8、板板文件的的句柄，串串口无模模板可言言，设为为NULLL。在在 Wiindoows 9x下下该参数数必须为为NULLL。串口被成成功打开开时，返返回其句句柄，否否则返回回INVVALIID_HHANDDLE_vallue(0XFFFFFFFFFFF)。上面说到到了异步步，那什什么是异异步呢？异步是是相对同同步这个个概念而而言的。异异步，就就是说，在进行串串口读写写操作时时，不用用等到II/O操操作完成成后函数数才返回回，也就就是说，异异步可以以更快得得响应用户户操作；同步，相相反，响响应的II/O操操作必须须完成后后函数才才返回，否否则阻塞塞线程。对对于一些很简简单的通通讯程序序来说，可可以选

9、择择同步，这这样可以以省去很很多错误误检查，但但是对于于复杂一一点的应应用程序序，异步步是最佳佳选择。实例1：/* eexammplee1.ccpp */* llishhaoaan 220099-066-299 */* */#inccludde #inccludde #inccludde booll oppenpportt(chhar *poortnnamee)/打开串串口HANDDLE hCoomm;hCommm = CrreatteFiile(porrtnaame, /串口号号 GGENEERICC_REEAD | GGENEERICC_WRRITEE, /允许许读写 00, /通讯讯设备

10、必必须以独独占方式式打开 00, /无安安全属性性 OOPENN_EXXISTTINGG, /通讯讯设备已已存在 FFILEE_FLLAG_OVEERLAAPPEED, /异异步I/O 00); /通通讯设备备不能用用模板打打开if (hCoomm = INVVALIID_HHANDDLE_VALLUE)ClosseHaandlle(hhCommm);retuurn FALLSE;elseeretuurn truue; voidd mmainn()booll oppen;openn=oppenpportt(ccom22);if(oopenn)prinntf(oppen commporrt ss

11、ucccesss);systtem(paausee) ;/* proograam eend*/实例2：/* eexammplee2.ccpp */* llishhaoaan 220099-066-299 */* */#inccludde #inccludde #inccludde booll oppenpportt(chhar *poortnnamee)/打开串串口HANDDLE hCoomm;hCommm = CrreatteFiile(porrtnaame, /串口号号 GGENEERICC_REEAD | GGENEERICC_WRRITEE, /允许许读写 00, /通讯讯设备必必须以

12、独独占方式式打开 00, /无安安全属性性 OOPENN_EXXISTTINGG, /通讯讯设备已已存在 00, /同步步I/OO 00); /通通讯设备备不能用用模板打打开if (hCoomm = INVVALIID_HHANDDLE_VALLUE)ClosseHaandlle(hhCommm);retuurn FALLSE;elseeretuurn truue; voidd mmainn()booll oppen;openn=oppenpportt(ccom22);if(oopenn)prinntf(oppen commporrt ssucccesss);systtem(paausee)

13、;/* proograam eend*/第三节 设置串串口在打开通通信设备备句柄后后，常常常需要对对串行口口进行一一些初始始化工作作。这需需要通过过一个DDCB结结构来进进行。DDCB结结构包含含了诸如如波特率率、每个个字符的的数据位位数、奇奇偶校验验和停止止位数等等信息。在在查询或或配置串串口的属属性时，都都要用DDCB结结构来作作为缓冲冲区。第一次打打开串口口时，串串口设置置为系统统默认值值，函数数GettCommmSttatee和SeetCoommSStatte可用用于检索索和设定定端口设设置的DDCB(设备控控制块)结构，该该结构中中BauudRaate、BByteeSizze、SSt

14、oppBitts和PPariity字字段含有有串口波波特率、数数据位数数、停止止位和奇奇偶校验验控制等等信息。程序中用用DCBB进行串串口设置置时，应应先调用用APII函数GGetCCommmStaate，来来获得串串口的设设置信息息： GetCCommmStaate()用途：取取得串口口当前状状态 原型：BBOOLL GeetCoommSStatte(HHANDDLE hFiile, LPPDCBB lppDCBB);参数说明明： -hFiile：串口句句柄 -lpDDCB：设备控控制块(Devvicee Coontrrol Bloock)结构地地址。此此结构中中含有和和设备相相关的参参数。

15、此此处是与与串口相相关的参参数。由由于参数数非常多多，当需需要设置置串口参参数时，通通常是先先取得串串口的参参数结构构，修改改部分参参数后再再将参数数结构写写入。然后在需需要设置置的地方方对dccb进行行设置。串串口有很很多的属属性，上上面也已已经介绍绍了一些些最重要要的参数数。这里里介绍数数据结构构DCBB：typeedeff sttrucct _DCBB / dcbb DDWORRD DDCBllenggth; /DCBB结构体体大小 DDWORRD BBauddRatte; /波波特率 DDWORRD ffBinnaryy: 11; /是否是是二进制制，一般般设置为为TRUUE DDWO

16、RRD ffParrityy: 11;/是否进进行奇偶偶校验 DDWORRD ffOuttxCttsFllow:1; /CCTS线线上的硬硬件握手手 DDWORRD ffOuttxDssrFllow:1; /DDSR线线上的硬硬件握手手 DDWORRD ffDtrrConntrool:22; /DTTR控制制 DDWORRD ffDsrrSennsittiviity:1; DDWORRD ffTXCConttinuueOnnXofff:11; DDWORRD ffOuttX: 1; /是否使使用XOON/XXOFFF协议 DDWORRD ffInXX: 11; /是否否使用XXON/XOFFF

17、协议议 DDWORRD ffErrrorCCharr: 11; /发发送错误误协议 DDWORRD ffNulll: 1; DDWORRD ffRtssConntrool:22; DDWORRD ffAboortOOnErrrorr:1; DDWORRD ffDummmy22:177; WWORDD wRReseerveed; WWORDD XoonLiim; /设置置在XOON字符符发送之之前innbuff中允许许的最少少字节数数 WWORDD XooffLLim; /在发发送XOOFF字字符之前前outtbuff中允许许的最多多字节数数 BBYTEE ByyteSSizee; /数据据宽度

18、，一一般为88，有时时候为77 BBYTEE Paaritty; /奇偶偶校验 BBYTEE SttopBBitss; /停停止位数数 ccharr XoonChhar; /设置置表示XXON字字符的字字符,一一般是采采用0xx11这这个数值值 ccharr XooffCCharr; /设置置表示XXOFFF字符的的字符,一般是是采用00x133这个数数值 ccharr ErrrorrChaar; ccharr EoofChhar; ccharr EvvtChhar; WWORDD wRReseerveed1; DCCB; 我我们真正正在串口口编程中中用到的的数据成成员没有有几个，在在此仅介介

19、绍少数数的几个个常用的的参数： DWORRD BBauddRatte：串串口波特特率 DWORRD ffParrityy：为11的话激激活奇偶偶校验检检查 DWORRD PPariity：校验方方式，值值044分别对对应无校校验、奇奇校验、偶偶校验、校校验置位位、校验验清零 DWORRD BByteeSizze：一一个字节节的数据据位个数数，范围围是58DWORRD SStoppBitts：停停止位个个数，002分分别对应应1位、11.5位位、2位位停止位位 然后再末末尾调用用SettCommmSttatee就可以以了，还还是比较较方便的的。这样样可不必必构造一一个完整整的DCCB结构构。Se

20、tCCommmStaate()用途：设设置串口口状态，包包括常用用的更改改串口号号、波特特率、奇奇偶校验验方式、数数据位数数等 原型：BBOOLL SeetCoommSStatte(HHANDDLE hFiile, LPPDCBB lppDCBB);参数说明明： -hFiile:串口句句柄 -lpDDCB：设备控控制块(Devvicee Coontrrol Bloock)结构地地址。要要更改的的串口参参数包含含在此结结构中。然后调用用SettCommmMaask,用来指指定程序序接收特特定的串串口事件件,调用用SettupCCommm函数,设置串串口缓冲冲区大小小: SetCCommmMass

21、k（）说说明：用途：设设置串口口通信事事件。 原型：BBOOLL SeetCoommMMaskk(HAANDLLE hhFille,DWORRD ddwEvvtMaask);参数说明明： -hFiile：串口句句柄 -dwEEvtMMaskk：准备备监视的的串口事事件掩码码 该参数有有如下信信息掩码码位值： EV_BBREAAK:收收到BRREAKK信号 EV_CCTS:CTSS(cllearr too seend)线路发发生变化化 EV_DDSR:DSTT(Daata Sett Reeadyy)线路路发生变变化 EV_EERR:线路状状态错误误，包括括了CEE_FRRAMEECEE_OVVE

22、RRRUNCE_RXPPARIITY 3钟错错误。 EV_RRINGG:检测测到振铃铃信号。 EV_RRLSDD:CDD(Caarriier Dettectt)线路路信号发发生变化化。 EV_RRXCHHAR:输入缓缓冲区中中已收到到数据。 EV_RRXFLLAG:使用SSetCCommmStaate()函数数设置的的DCBB结构中中的等待待字符已已被传入入输入缓缓冲区中中。 EV_TTXEMMPTYY:输出出缓冲区区中的数数据已被被完全送送出。还有，串串口因为为是I/O操作作，可能能会产生生错误，这这时候需需要用SSetCCommmTimmeouuts（）设设置超时时限制，以以避免阻阻塞现象

23、象。设置置超时设设置需要要一个结结构体CCOMMMTIMMEOUUTS。SetCCommmTimmeouuts（）BOOLL SeetCoommTTimeeoutts( hCoommDDev， lpcctmoo )；Lpcttmo指指向包含含新的超超时参数数的COOMMTTIMEEOUTTS结构构。COMMMTIMMEOUUTS结结构定义义如下：typeedeff sttrucct _ COOMMTTIMEEOUTTSDWORRD RReaddInttervvalTTimeeoutt;DWORRD RReaddTottalTTimeeouttMulltipplieer;DWORRD RRead

24、dTottalTTimeeouttconnstaant;DWORRD WWritteTootallTimmeouutMuultiipliier;DWORRD WWritteTootallTimmeouutcoonsttantt;COMMMTIIMEOOUTSS， LLPCOOMMTTIMEEOUTTS;ReaddInttervvalTTimeeoutt： 以以毫秒为为单位指指定通信信线上两两个字符符到达之之间的最最大时间间。在ReaddFille操作作其间，收收到第一一个字符符时开始始计算时时间。若若任意两两个字符符到达之之间的间间隔超过过这个最大大值，RReaddFille操作作完成，返返回

25、缓冲冲数据。00值表示示不用间间隔限时时。若该该成员为为MAXDDWORRD，且且ReaadTootallTimmeouutcoonsttantt和ReeadTTotaalTiimeooutMMulttipllierr成员为为零，则则指出读操作作要立即即返回已已接收到到的字符符，即使使未收到到字符，读读操作也也要返回回。ReaddTottalTTimeeouttMulltipplieer：以以毫秒为为单位指指定一个个乘数，该该乘数用用来计算算读操作作的总限限时时间间。每个个读操作作的总限限时时间间等于读读操作所所需的字字节数与与该值的的乘积。ReaddTottalTTimeeouttConns

26、taant：以毫秒秒为单位位指定一一个常数数，用于于计算读读操作的的总限时时时间。每每个操作作的总限限时时间间等于RReaddTottalTTimeeouttMulltipplieer成员员乘以读读操作所所需字节节数再加加上该值值的和。RReaddTottalTTimeeouttMulltipplieer和RReaddTottalTTimeeouttConnstaant成成员的值值为0表表示读操操作不使使用限时时时间。WritteTootallTimmeouutMuultiipliier和和WriiteTTotaalTiimeooutcconsstannt的意意义和作作用分别别与ReaddTo

27、ttalTTimeeouttMulltipplieer和RReaddTottalTTimeeouttConnstaant相相似，不不再重复复。举例：COMMMTIMMEOUUTS timmeouuts; ttimeeoutts.RReaddInttervvalTTimeeoutt=MAAXDWWORDD; ttimeeoutts.RReaddTottalTTimeeouttConnstaant=0; ttimeeoutts.RReaddTottalTTimeeouttMulltipplieer=00; ttimeeoutts.WWritteTootallTimmeouutCoonsttantt

28、=500; ttimeeoutts.WWritteTootallTimmeouutMuultiipliier=20000; SSetCCommmTimmeouuts(m_hhComm, &timmeouuts); 这这里将RReaddInttervvalTTimeeoutt设置为为最大字字节数，.ReaadTootallTimmeouutCoonsttantt和ReaddTottalTTimeeouttMulltipplieer都设设置为00，表示示不设置置读操作作超时，也也就是说说读操作作瞬间完完成，不进进行等待待。 调调用PuurgeeCommm函数数可以终终止正在在进行的的读写操操作，该

29、该函数还还会清除除输入或或输出缓缓冲区中中的内容容。PurggeCoomm（）说说明：功能：终终止目前前正在进进行的读读或写的的动作函数原型型：BOOOL PurrgeCCommm（HANDDLE hFiile, / haandlle oof ccommmuniicattionns rresoourcceDWORRD ddwFllagss / acctioon tto pperfformm）;参数说明明：HANDDLE hFiile,/串串口名称称字符串串dwFllagss共有四四种 fflaggs:PUURGEE_TXXABOORT:终止目目前正在在进行的的（背景景）写入入动作PUURGEE

30、_RXXABOORT:终正目目前正在在进行的的（背景景）读取取动作PUURGEE_TXXCLEEAR: fllushh写入的的 buuffeerPUURGEE_TXXCLEEAR: fllushh读取的的 buuffeer实例3：/* eexammplee3.ccpp */* llishhaoaan 220099-066-299 */* */#inccludde #inccludde #inccludde booll oppenpportt(chhar *poortnnamee)/打开串串口HANDDLE hCoomm;hCommm = CrreatteFiile(porrtnaame, /串

31、口号号 GGENEERICC_REEAD | GGENEERICC_WRRITEE, /允许许读写 00, /通讯讯设备必必须以独独占方式式打开 00, /无安安全属性性 OOPENN_EXXISTTINGG, /通讯讯设备已已存在 00, /同步步I/OO 00); /通通讯设备备不能用用模板打打开if (hCoomm = INVVALIID_HHANDDLE_VALLUE)ClosseHaandlle(hhCommm);retuurn FALLSE;elseeretuurn truue;booll seetuppdcbb(innt rratee_arrg)/设置置DCBBDCBB dccb

32、;intt raate= raate_argg;memmsett(&ddcb,0,ssizeeof(dcbb);if(!GeetCoommSStatte(hhCommm,&dcbb)/获取取当前DDCB配配置retturnn FAALSEE;/ sset DCBB too coonfiigurre tthe serriall poortdcb.DCBBlenngthh = ssizeeof(dcbb);/* - SeeriaalPoort Connfigg - */ dcbb.BaaudRRatee = ratte; dcbb.Paaritty = NNOPAARITTY; dcbb.fPPa

33、riity = 00; dcbb.SttopBBitss = ONEESTOOPBIIT; dcbb.ByyteSSizee = 8; dcbb.fOOutxxCtssFloow = 0; dcbb.fOOutxxDsrrFloow = 0; dcbb.fDDtrCConttroll = DTRR_COONTRROL_DISSABLLE; dcbb.fDDsrSSenssitiivitty = 0; dcbb.fRRtsCConttroll = RTSS_COONTRROL_DISSABLLE; dcbb.fOOutXX = 0; dcbb.fIInX = 0;/* - mmiscc paar

34、ammeteers - */ dcbb.fEErroorChhar = 0; dcbb.fBBinaary = 1; dcbb.fNNulll = 0; dcbb.fAAborrtOnnErrror = 0; dcbb.wRReseerveed = 0; dcbb.XoonLiim = 2; dcbb.XooffLLim = 4; dcbb.XoonChhar = 0x113; dcbb.XooffCCharr = 0x119; dcbb.EvvtChhar = 0; / sett DCCB if(!SeetCoommSStatte(hhCommm,&dcbb) retturnn faalse

35、e; elsse retturnn trrue;booll seetupptimmeouut(DDWORRD RReaddInttervval,DWOORD ReaadTootallMulltipplieer,DDWORRD RReaddTottalcconsstannt,DDWORRD WWritteTootallMulltipplieer,DDWORRD WWritteTootallconnstaant) CCOMMMTIMMEOUUTS timmeouuts; ttimeeoutts.RReaddInttervvalTTimeeoutt=ReeadIInteervaal; ttimeeo

36、utts.RReaddTottalTTimeeouttConnstaant=ReaadTootallconnstaant; ttimeeoutts.RReaddTottalTTimeeouttMulltipplieer=RReaddTottalMMulttipllierr; ttimeeoutts.WWritteTootallTimmeouutCoonsttantt=WrriteeTottalcconsstannt; ttimeeoutts.WWritteTootallTimmeouutMuultiipliier=WriiteTTotaalMuultiipliier; iif(!SettCom

37、mmTiimeooutss(hCCommm, &timmeouuts) rretuurn fallse; eelsee rretuurn truue;voidd mmainn()booll oppen;openn=oppenpportt(ccom22);if(oopenn)prinntf(oppen commporrt ssucccesss);if(ssetuupdccb(996000)prinntf(seetuppDCBB suucceessn);if(ssetuuptiimeoout(0,00,0,0,00)prinntf(seetupptimmeouut ssucccesssn);SetCCommmMassk(hhCommm, EV_RXCCHARR); /当当有字符符在innbuff中时产产生这个个事件/清除除串口的的所有操操作PurggeCoomm(hCoomm,PURRGE_RXCCLEAAR|PPURGGE_TTXCLLEARR|PUURGEE_RXXABOORT|PURRGE_TXAABORRT);systtem(paausee) ;/*