[转载]VC串口上位机编程学习笔记_Detective_ALong_新浪博客

原文地址：VC串口上位机编程学习笔记 作者：fromzero

此文转载于中国电子开发网

http://www.ourdev.cn/bbs/bbs_content.jsp?bbs_sn=4698293&bbs_page_no=1&bbs_id=1036

谢谢作者的辛勤劳动!

 

我发现目前网上搜到的中文VC串口编程资料，要么把相关的API函数罗列一遍，要么就是以管窥豹肢离破碎，更有甚者完全是误人子弟（包括一些流传相当广的所谓教程），靠这些乱七八糟的资料来学习，估计最后会只会练得走火入魔。
这些搜索给我唯一的帮助就是知道了MSDN里的绝世好文：
Serial Communications in Win32 http://msdn.microsoft.com/en-us/library/ms810467.aspx
这个SAMPLE把串口通讯的方方面面都涉及到了，里面还有例程源码，把它的CODE研究清楚，串口通讯的一切脉落自然了然于心。当然里面没有具体说打开、设置串口之类的基础操作，碰到不认识的就MSDN吧。另外讲解虽然是连续的，但SAMPLE CODE里的函数是分散的，需要灵活使用IDE的查看代码功能快速地在不同代码间跳跃。
下面就结合自己的理解，分析MTTY的SAMPLE CODE，就当读书笔记吧。希望对打算用API进行串口编程的朋友有所帮助，能尽快读懂MTTY的源码，建立起串口编程的思想框架，高手请飘过。阅读这篇文章需要你有阅读MSDN的英文能力，对串口概念有基本的认识。
开讲之前再啰嗦一把，按我找的资料来看，有几个普遍观点：1 WINNT串口不能用同步模式工作 2 简单地应用用同步模式、开单线程，实时性高地用异步单线程或多线程，因为异步＋多线程比同步异步＋单线程要复杂得多。先说第二点，首先异步多线程确实要复杂得多，但也不至于有登天那么难，以我现在的水平就能基本搞明白，我从6月1日儿童节头脑发热决心研究编程，要知道那时候我还以为VC是一种语言，而且最开始的几天都花在纠结该学哪种语言上，半路出家，完全没有基础。其次出于学习考虑，找最难的整，学到的东西才多，至少学完串口能对多线程的使用有一定地直观了解。再次，从性能上说，异步多线程是最好的，而且使用非常灵活，能应付一切需求。所以初学串口，就咬紧牙搞异步多线程吧,CreatFile时用上OVERLAPPED，哈哈，那就一发不可收拾了。差点忘了说第一点，我从来不打算用同步模式，我也不知道行不行。
以下 xxx()表示一个函数，没有特别说明的话指SAMPLE CODE里的自定义函数。
第一：串口工作环境地建立
点击FILE里的CONNECT后，调用 INIT.C里的SetupCommPort（）进行串口初始化：
1打开串口
用API函数CreateFile
2设置串口
调用UpdateConnection（），先建立一个dcb结构体（记得一定要初始化后再使用），然后用API函数GetCommState把现在的串口配置存入新建的dcb中，因为一般对串口参数的设置就是波特率之类，其他用默认即可，获取现在串口配置保存到我们建立的 dcb中，再根据需要进行修改会方便得多。根据需要对dcb内的成员赋值后，再用API函数SetCommState使设置好的 dcb生效，下一步就是用API函数SetCommTimeouts进行超时设置。
最后用用API函数SetupComm设置输入输出缓存。
至此，串口已经准备好，可以供我们使用了。
无论什么时候需要开始使用串口，按上面的步骤进行初始化操作都是必须而且有效的。
这里有另外两个API函数顺便说一下，1CommConfigDialog，2PurgeComm。
第一个是调用WINDOWS自带的串口设置对话框设置串口参数，这需要新建立一个COMMCONFIG 结构体来接收设置，COMMCONFIG里也有一个dcb结构，通话框里的设置自然就是保存到这里边来了，这个结构体在使用前记得要初始化。在调用CommConfigDialog前把现在的dcb 结构存到COMMCONFIG里是个好办法，不然对话框里的参数都是系统默认的，还得一个一个改。另外COMMCONFIG 在使用前要对成员wVersion和dwSize 赋值，否则执行会有异常，具体设置在MSDN里有详细说明。有人说其中的dwSize 不能填 sizeof COMMCONFIG，但MSDN里用的就是SIZEOF，我也用得很好，没有任何问题。
第二个函数在MSDN的说明是：Discards all characters from the output or input buffer of a specified communications resource. It can also terminate pending read or write operations on the resource.简单说就是立即中断串口的一切操作，当用CommConfigDialog设置好串口参数后，当然是希望串口按新的状态工作，所以应该接着调用PurgeComm。如果你想等所有的读写（包括未决的）操作都完成再生效，就需要使用事件“event”，在后面会说到它。
最后用StartThreads(void)建立读、写线程，MTTY里的监视和读是同一个线程。
至此这里串口的工作环境建立完成。
第二 让串口按我们的要求进行读写
串口工作环境地建立比较程式化，一步一步做完即可。那怎么按我们的要求让串口工作起来呢？下面说说怎么具体地实现利用多线程进行异步串口操作。我也只是有了初步概念，以下叙述若有错误，日后再更正。

第二 让串口按我们的要求进行读写
串口工作环境地建立比较程式化，一步一步做完即可。那怎么按我们的要求让串口工作起来呢？下面说说怎么具体地实现利用多线程进行异步串口操作。我也只是有了初步概念，以下叙述若有错误，日后再更正。
先回忆一下上一节的内容，如何建立串口的工作环境：
1.打开串口，用CreateFile
2.DCB xxx ,xxx就是我们要用的串口配置结构体。可以选择用GetCommState获取当前串口配置，存入xxx。
3.按需求填写串口配置块xxx。这时可以用用CommConfigDialog。
4.SetCommState让串口配置块xxx生效
5.设置超时，用SetCommTimeouts
6.设置缓存，用SetupComm
7.创建读、写、监视线程
还是以写串口为例子，我的程序里需要定时更新仪表面板数据，那段程序执行时间最多能达到150ms,它是在主进程里执行的，更新面板数据后还要把数据写到串口，又是一段不短的时间，这样接口程序运行起来让人感觉老是慢半拍，更严重的是如果这个时候下位机发了数据上来，是完全不会得到响应的。所以非常有必要把读、写、监视串口用单独的线程来执行。
我的接口程序最开始写串口时对CPU的点用是近100％，后来把写单独做一个线程，CPU占用率降到25％，再用简单的处理办法：在更新面板数据时让写线程挂起，更新完成后再唤醒写线程，CPU占用率降到可以乎略不计。
平时常用的串口调试助手，同时打开两个，其中一个向另一个循环发字符，CPU（单核闪龙3400＋）占用率立即会飙到100％，但做同样的事情，MS的MTTY工作得就非常好，CPU占用率在5％以内，足见多线程的威力。
创建了线程，当然就有对应线程的函数，MTTY里对应写线程的是
DWORD WINAPI WriterProc(LPVOID lpV)，LPVOID lpV是传递给线程函数的参数，在MTTY里这个值是NULL。
写串口是主动的，我们需要在需要写串口的时候让写串口线程函数里的程序工作起来，平时碰到类似的任务一般是用设flag实现，但是我们写串口的时候需要知道上一次的写操作是否已经结束，这又需要一个flag，其他还有很多需要设flag的地方，flag这么多，怎么安排得过来。还好，WINDOWS有办法解决这个问题,那就是用event （事件）。
跟事件相关的API函数有
CreatEvent, 创建一个事件，需要用到事件时就创建它
SetEvent, 置事件为有信号的
ResetEvent, 重置事件为无信号
WaitForSingleObjects, 等待一个事件
WaitForMultipleObjects，等待多个事件
来打个比方说说这些函数的作用：
一个个的事件就像是一个个的信号灯，我们想知道谁的状态，那就用CreatEvent做几盏灯给他戴到头上，一个状态对应一盏灯。状态发生了就用SetEvent让灯亮（让事情有信号）代表对应的状态发生了，状态结束了就用ResetEvent（重置事件没无信号）让灯灭掉代表嘛事都没有了。然后谁想偷_窥别人了，就用WaitForMultipleObjects或者WaitForSingleObjects这两个马仔来监视，当然得先告诉马仔你想监视谁的哪个状态，马仔就会不间断地把人家的头顶都瞅一遍，要是你想要的状态代表的灯亮了，它立马会告诉你，碰到其他情况它也会给你相应的信息，你再根据不同的信息做不同的处理。
还有一种情况，就是你想让别人控制你，那你就自己建信号灯然后自己盯着头顶，别人调用SetEvent和ResetEvent来控制你的灯，你自己再根据灯的亮灭做相应的操作。MTTY里的写线程函数就是这么干的。
下面开始分析MTTY里神奇的SENDREPEATEDLY：
从这开始case ID_TRANSFER_SENDREPEATEDLY:，这个case里最后的操作是调用TransferRepeatCreate，我们来看看这个函数干了什么，看这个函数的代码，它干了不少事情，怎么没有在里边没看到操作串口？前边我们已经说了，为写串口单独建立了一个线程，所以操作操口的勾当绝对是在线程函数里干的。
我们只关心重点，既然是repeatedly，定时的话，那肯定是用定时器了，果然有
mmTimer = timeSetEvent((UINT) dwFrequency, 10, TransferRepeatDo, dwRead, TIME_PERIODIC);
TransferRepeatDo就是定时器的回调函数，我们再看看它干了什么，只是调用了WriterAddNewNodeTimeout，看意思是新增加一个节点，这个写串口还跟节点扯什么关系？再看这个函数干了什么：Adds a new write request packet, timesout if can't allocate packet.里边的第一句就是 PWRITEREQUEST pWrite;
这个PWRITEREQUESTtypedef struct WRITEREQUEST
{
DWORD      dwWriteType;        // char, file start, file abort, file packet
DWORD      dwSize;             // size of buffer
char       ch;                 // ch to send
char *     lpBuf;              // address of buffer to send
HANDLE     hHeap;              // heap containing buffer
HWND       hWndProgress;       // status bar window handle
struct WRITEREQUEST *pNext;    // next node in the list
struct WRITEREQUEST *pPrev;    // prev node in the list
} WRITEREQUEST, *PWRITEREQUEST;
明白了前面为啥是addnewnode了，这里用到了链表lined list ,因为要写的数据可能很多，串口只能一个一个写，要写的数据先放到链表里，然后串口再依次地写。把建立要写的数据和写数据地操作分开来，那两者就互不影响了。
建完新的数据节点，下一步当然就是把节点放到链表里，倒数第二句AddToLinkedList(pWrite);
这个函数里就是典型的链表增加节点地操作，重点在后面SetEvent(ghWriterEvent)，增加完节点，让ghWriterEvent这个信号灯亮起来，直觉告诉我们，这就是亮给写线程看的，看一下都有谁使用它，真相揭晓，传说中的写线程函数终于闪亮登场：
DWORD WINAPI WriterProc(LPVOID lpV)
这里边的细枝末节比较多，照例只关心重点，里面建立了两个事件
ghWriterEvent = CreateEvent(NULL, FALSE, FALSE, NULL);
    if (ghWriterEvent == NULL)
        ErrorInComm("CreateEvent(writ request event)");
    ghTransferCompleteEvent = CreateEvent(NULL, FALSE, FALSE, NULL);
    if (ghTransferCompleteEvent == NULL)
        ErrorInComm("CreateEvent(transfer