参考链接:https://blog.csdn.net/songyi160/article/details/50754705
1、新建项目
建立好的项目界面如下:
接着在解决方案中找到【头文件】然后右击选择【添加】》【新建项】,在弹出的添加新项对话框中进行如下选择:
继续按上面的方法在解决方案中找到【源文件】然后右击选择【添加】》【新建项】,在弹出的添加新项对话框中进行如下选择:
项目准备建好了,现在开始编程了。
2 编程实现串口通信
我们先编写刚才建立好的 “ WzSerialPort.h ” 文件,该文件主要是做一些函数声明:
#pragma once #ifndef _WZSERIALPORT_H #define _WZSERIALPORT_H class WzSerialPort { public: WzSerialPort(); ~WzSerialPort(); // 打开串口,成功返回true,失败返回false // portname(串口名): 在Windows下是"COM1""COM2"等,在Linux下是"/dev/ttyS1"等 // baudrate(波特率): 9600、19200、38400、43000、56000、57600、115200 // parity(校验位): 0为无校验,1为奇校验,2为偶校验,3为标记校验(仅适用于windows) // databit(数据位): 4-8(windows),5-8(linux),通常为8位 // stopbit(停止位): 1为1位停止位,2为2位停止位,3为1.5位停止位 // synchronizeflag(同步、异步,仅适用与windows): 0为异步,1为同步 bool open(const char* portname, int baudrate, char parity, char databit, char stopbit, char synchronizeflag = 1); //关闭串口,参数待定 void close(); //发送数据或写数据,成功返回发送数据长度,失败返回0 int send(const void *buf, int len); //接受数据或读数据,成功返回读取实际数据的长度,失败返回0 int receive(void *buf, int maxlen); private: int pHandle[16]; char synchronizeflag; }; #endif
接着编写 “ WzSerialPort.cpp ” 的文件,该文件主要实现串口打开关闭以及数据传输函数:
#include "WzSerialPort.h" #include <stdio.h> #include <string.h> #include <WinSock2.h> #include <windows.h> WzSerialPort::WzSerialPort() { } WzSerialPort::~WzSerialPort() { } bool WzSerialPort::open(const char* portname, int baudrate, char parity, char databit, char stopbit, char synchronizeflag) { this->synchronizeflag = synchronizeflag; HANDLE hCom = NULL; if (this->synchronizeflag) { //同步方式 hCom = CreateFileA(portname, //串口名 GENERIC_READ | GENERIC_WRITE, //支持读写 0, //独占方式,串口不支持共享 NULL,//安全属性指针,默认值为NULL OPEN_EXISTING, //打开现有的串口文件 0, //0:同步方式,FILE_FLAG_OVERLAPPED:异步方式 NULL);//用于复制文件句柄,默认值为NULL,对串口而言该参数必须置为NULL } else { //异步方式 hCom = CreateFileA(portname, //串口名 GENERIC_READ | GENERIC_WRITE, //支持读写 0, //独占方式,串口不支持共享 NULL,//安全属性指针,默认值为NULL OPEN_EXISTING, //打开现有的串口文件 FILE_FLAG_OVERLAPPED, //0:同步方式,FILE_FLAG_OVERLAPPED:异步方式 NULL);//用于复制文件句柄,默认值为NULL,对串口而言该参数必须置为NULL } if (hCom == (HANDLE)-1) { return false; } //配置缓冲区大小 if (!SetupComm(hCom, 1024, 1024)) { return false; } // 配置参数 DCB p; memset(&p, 0, sizeof(p)); p.DCBlength = sizeof(p); p.BaudRate = baudrate; // 波特率 p.ByteSize = databit; // 数据位 switch (parity) //校验位 { case 0: p.Parity = NOPARITY; //无校验 break; case 1: p.Parity = ODDPARITY; //奇校验 break; case 2: p.Parity = EVENPARITY; //偶校验 break; case 3: p.Parity = MARKPARITY; //标记校验 break; } switch (stopbit) //停止位 { case 1: p.StopBits = ONESTOPBIT; //1位停止位 break; case 2: p.StopBits = TWOSTOPBITS; //2位停止位 break; case 3: p.StopBits = ONE5STOPBITS; //1.5位停止位 break; } if (!SetCommState(hCom, &p)) { // 设置参数失败 return false; } //超时处理,单位:毫秒 //总超时=时间系数×读或写的字符数+时间常量 COMMTIMEOUTS TimeOuts; TimeOuts.ReadIntervalTimeout = 1000; //读间隔超时,该时间为串口每次接收等待的时间间隔,数据不多可以把该时间改小,这里每次等待1000mS间隔 TimeOuts.ReadTotalTimeoutMultiplier = 500; //读时间系数 TimeOuts.ReadTotalTimeoutConstant = 5000; //读时间常量 TimeOuts.WriteTotalTimeoutMultiplier = 500; // 写时间系数 TimeOuts.WriteTotalTimeoutConstant = 2000; //写时间常量 SetCommTimeouts(hCom, &TimeOuts); PurgeComm(hCom, PURGE_TXCLEAR | PURGE_RXCLEAR);//清空串口缓冲区 memcpy(pHandle, &hCom, sizeof(hCom));// 保存句柄 return true; } void WzSerialPort::close() { HANDLE hCom = *(HANDLE*)pHandle; CloseHandle(hCom); } int WzSerialPort::send(const void *buf, int len) { HANDLE hCom = *(HANDLE*)pHandle; if (this->synchronizeflag) { // 同步方式 DWORD dwBytesWrite = len; //成功写入的数据字节数 BOOL bWriteStat = WriteFile(hCom, //串口句柄 buf, //数据首地址 dwBytesWrite, //要发送的数据字节数 &dwBytesWrite, //DWORD*,用来接收返回成功发送的数据字节数 NULL); //NULL为同步发送,OVERLAPPED*为异步发送 if (!bWriteStat) { return 0; } return dwBytesWrite; } else { //异步方式 DWORD dwBytesWrite = len; //成功写入的数据字节数 DWORD dwErrorFlags; //错误标志 COMSTAT comStat; //通讯状态 OVERLAPPED m_osWrite; //异步输入输出结构体 //创建一个用于OVERLAPPED的事件处理,不会真正用到,但系统要求这么做 memset(&m_osWrite, 0, sizeof(m_osWrite)); m_osWrite.hEvent = CreateEvent(NULL, TRUE, FALSE, L"WriteEvent"); ClearCommError(hCom, &dwErrorFlags, &comStat); //清除通讯错误,获得设备当前状态 BOOL bWriteStat = WriteFile(hCom, //串口句柄 buf, //数据首地址 dwBytesWrite, //要发送的数据字节数 &dwBytesWrite, //DWORD*,用来接收返回成功发送的数据字节数 &m_osWrite); //NULL为同步发送,OVERLAPPED*为异步发送 if (!bWriteStat) { if (GetLastError() == ERROR_IO_PENDING) //如果串口正在写入 { WaitForSingleObject(m_osWrite.hEvent, 1000); //等待写入事件1秒钟 } else { ClearCommError(hCom, &dwErrorFlags, &comStat); //清除通讯错误 CloseHandle(m_osWrite.hEvent); //关闭并释放hEvent内存 return 0; } } return dwBytesWrite; } } int WzSerialPort::receive(void *buf, int maxlen) { HANDLE hCom = *(HANDLE*)pHandle; //if (this->synchronizeflag) //{ // //同步方式,这里因为发送用了同步,接收想用异步,又没有重新初始化串口打开,就直接注释掉用串口异步接收了 // DWORD wCount = maxlen; //成功读取的数据字节数 // BOOL bReadStat = ReadFile(hCom, //串口句柄 // buf, //数据首地址 // wCount, //要读取的数据最大字节数 // &wCount, //DWORD*,用来接收返回成功读取的数据字节数 // NULL); //NULL为同步发送,OVERLAPPED*为异步发送 // if (!bReadStat) // { // return 0; // } // return wCount; //} //else { //异步方式,用同步会阻塞 DWORD wCount = maxlen; //成功读取的数据字节数 DWORD dwErrorFlags; //错误标志 COMSTAT comStat; //通讯状态 OVERLAPPED m_osRead; //异步输入输出结构体 //创建一个用于OVERLAPPED的事件处理,不会真正用到,但系统要求这么做 memset(&m_osRead, 0, sizeof(m_osRead)); m_osRead.hEvent = CreateEvent(NULL, TRUE, FALSE, L"ReadEvent"); ClearCommError(hCom, &dwErrorFlags, &comStat); //清除通讯错误,获得设备当前状态 if (!comStat.cbInQue)return 0; //如果输入缓冲区字节数为0,则返回false BOOL bReadStat = ReadFile(hCom, //串口句柄 buf, //数据首地址 wCount, //要读取的数据最大字节数 &wCount, //DWORD*,用来接收返回成功读取的数据字节数 &m_osRead); //NULL为同步发送,OVERLAPPED*为异步发送 if (!bReadStat) { if (GetLastError() == ERROR_IO_PENDING) //如果串口正在读取中 { //GetOverlappedResult函数的最后一个参数设为TRUE //函数会一直等待,直到读操作完成或由于错误而返回 GetOverlappedResult(hCom, &m_osRead, &wCount, TRUE); } else { ClearCommError(hCom, &dwErrorFlags, &comStat); //清除通讯错误 CloseHandle(m_osRead.hEvent); //关闭并释放hEvent的内存 return 0; } } return wCount; } }
再接着,我们编写 “ USER_COM.cpp ” 文件,该文件主要是实现把 “ WzSerialPort.cpp ” 文件里的串口函数进行一次封装,封装声明成可供DLL外部调用的函数:
// USER_COM_DLL.cpp : 定义 DLL 应用程序的导出函数。 // #include "stdafx.h" #include "USER_COM.h" #include <iostream> #include "WzSerialPort.h" #include "Windows.h" using namespace std; /*类重命名*/ WzSerialPort w; /************************************************* 函数名:bool OpenCOM() 功 能:打开串口 传入值:无 返回值:串口打开成功返回true,串口打开失败返回false *************************************************/ bool OpenCOM() { return w.open("COM1", 115200, 0, 8, 1); //这里配置打开串口1,配置波特率为115200,数据位为8位,奇偶校验位为0,停止位为1,最后一位是同步异步选择位(隐藏)
}
/************************************************* 函数名:void COM_Send(unsigned char cmd, unsigned char data1, unsigned char data2) 功 能:发送数据 传入值:num为要发送的数据量大小,Send_buff为发送数据的数组,数组大小要跟num大小一致 返回值:发送成功返回发送数据长度,发送失败返回0 *************************************************/ int COM_Send(int num ,uint8_t* Send_buff) { sen_len = w.send(Send_buff, num); if (sen_len==0) return 0; else return sen_len ; } /************************************************* 函数名:void Close_COM() 功 能:关闭串口 传入值:无 返回值:无 *************************************************/ void Close_COM() { w.close(); } /************************************************* 函数名:void COM_RX(uint8_t* Rx_buff) 功 能:接收数据数据 传入值:uint8_t* Rx_buff 接收的串口数据的缓存BUFF数组指针, 接收到数据后,直接把数据填到该Rx_buff,默认可接收的数据最大长度为255 返回值:int len 返回值为实际接收到的数据长度,返回0则代表没有接收到数据或者数据校验出错 *************************************************/ int COM_RX(uint8_t* Rx_buff) { //该函数编译X86的时候,调用时使用X64编译器无法调用,调用编译时要调用的话就要用X64编译 uint8_t buff[255];int i = 0; memset(buff, 0, 255); int len = w.receive(buff, 255); //参数:接收的数据buff;接收的最大数据长度;返回值为实际接收到的数据长度,其他APP使用该函数时使用新线程调用for (i = 0; i < len; i++) Rx_buff[i] = buff[i];return len; }
最后我们在头文件那里,新建一个 “ USER_COM.h ” 文件实现把 “ USER_COM.cpp ” 文件里的函数声明为DLL的外部接口:
#ifdef USER_COM_EXPORTS #define USER_COM_API __declspec(dllexport) //声明为DLL导出函数的宏定义 #else #define USER_COM_API __declspec(dllimport) #endif #include "stdint.h" extern "C" USER_COM_API bool OpenCOM(); extern "C" USER_COM_API int COM_Send(unsigned char cmd, unsigned char data1, unsigned char data2); extern "C" USER_COM_API int COM_RX(uint8_t* Rx_buff); extern "C" USER_COM_API void Close_COM();
注意:__stdcall定义导出函数入口点调用约定为_stdcall
extern "C" 说明导出函数使用C编译器,则函数名遵循C编译器的函数名修饰规则,不加extern "C"说明使用C++编译器的函数名修饰 规则,两种规则区别如下:
(1)C编译器的函数名修饰规则
对于__stdcall调用约定,编译器和链接器会在输出函数名前加上一个下划线前缀,函数名后面加上一个“@”符号和其参数的字节数。
例如 _functionname@number。__cdecl调用约定仅在输出函数名前加上一个下划线前缀,例如_functionname。__fastcall调用约定在输出函数名前加上一个“@”符号,后面也是一个“@”符号和其参数的字节数,例如@functionname@number
(2)C++编译器的函数名修饰规则
C++的函数名修饰规则有些复杂,但是信息更充分,通过分析修饰名不仅能够知道函数的调用方式,返回值类型,甚至参数个数、参数类 型。不管__cdecl,__fastcall还是__stdcall调用方式,函数修饰都是以一个“?”开始,后面紧跟函数的名字,再后面是参数表的开始标识 和按照参数类型代号拼出的参数表。对于__stdcall方式,参数表的开始标识是“@@YG”,对于__cdecl方式则是“@@YA”,对于__fastcall方式则是“@@YI”。
使用 extern "C" 跟不使用 extern "C" 的形成的DLL函数名差异如下图测试DLL函数名所示:
由图可以看出两者之间最终形成的名字会有差异的,到这里编译就已经可以建成串口通信的 DLL 了,不过形成的的DLL通过函数查看器还会有一些除函数名以外的符号,最后进行函数命名规范就好了。“ .h ” 头文件的作用仅仅能导出动态库、明确编译链接方式及确定入口点约定,还一个重要作用是打包给开发者,使其了解动态库导出的函数及对应的的参数,为了确保导出函数名及入口点函数不变,此时需添加.def文件。
3 添加 def 文件,保持函数名以及入口点函数不变
在解决方案中找到【源文件】右击选择【添加】》【新建项】,在弹出的添加新项对话框中进行如下图所示选择:
然后编写 “ USER_COM.def ” 文件,使用def文件的意义:将编译器生成的函数修饰去掉,用更加自然、更加容易理解、更加容易记忆的名字来命名函数,而不是一串人一看就吓一跳的 修饰名字。
LIBRARY "USER_COM" EXPORTS OpenCOM @ 1 COM_Send @ 2 COM_RX @ 3 Close_COM @ 4
4 编译形成DLL
最后编译就可以形成对应的DLL了,要是要编译32位的DLL就选择X86,要是要选择64位的DLL就选择X64即可。
用函数查看器看,函数名都正常了: