简单跨平台串口通信C++类的实现

简单跨平台串口通信C++类的实现

1. 说明：

    在Eclipse和mingw环境下开发串口应用程，目标是实现串口控制的跨平台实现，

    此程序目前只支持windows平台。

2. 源代码：

 此代码为主函数，通过命令行实现对串口发送和接受数据。

//============================================================================ // Name : rs232.cpp // Author : anve // Version : // Copyright : Your copyright notice // Description : Rs232 program in C++, Ansi-style //============================================================================ #include <iostream> #include <stdlib.h> #include <string.h> #include <time.h> #include <assert.h> #include "cross_serial_port.h" #include <tchar.h> using namespace std; static void printUsage(char * programName) { cout << "Usage:" << endl; cout << " " << programName << " portName speed wordSize stopBits parity waitTime inputString" << endl; #if (SERIAL_PORT_TYPE == SERIAL_PORT_WINDOWS) cout << " " << "portName: 'COM1','COM2','COM3',..." << endl; cout << " " << "parity: 'n' = None,'o' = Odd,'e' = Even" << endl; cout << " " << "waitTime: How many seconds will we wait" << endl; cout << "Example: " << programName << " COM1 115200 8 1 n 3" << endl; #else #endif } static void convertString(char *str) { char *index; index = str; str = strstr(str, "//"); do{ index = strstr(index, "//"); if(index == NULL) { return; } switch(index[1]) { case 'r': *str++ = 0x0D; break; case 'n': *str++ = 0x0A; break; case '//': *str++ = '//'; break; default: *str++ = 0x00; break; } index = str; strcpy(str, str+1); }while(1); } typedef struct MyData { int waitTime; CrossPlatformSerial *pSerialPort; } MYDATA, *PMYDATA; DWORD WINAPI ReadStdinToSerial( LPVOID lpParam ) { int waitTime; CrossPlatformSerial *pSerialPort; char writeBuf[256]; HANDLE hStdin; const int bufSize = sizeof(writeBuf)-1; PMYDATA pMyData = (PMYDATA) lpParam; waitTime = pMyData->waitTime; pSerialPort = pMyData->pSerialPort; writeBuf[1] = 0; hStdin = GetStdHandle(STD_INPUT_HANDLE); while(1) { // read stdin DWORD readSize = 0; // readSize = fread(writeBuf, 1, bufSize, stdin); // if(readSize != bufSize) // { // perror("read stdin error:"); // } ReadFile(hStdin, writeBuf,bufSize,&readSize,NULL); writeBuf[readSize] = '/0'; //cout << writeBuf << ":" << readSize << endl; pSerialPort->writeBuf(writeBuf, readSize); if(clock() > (waitTime*CLOCKS_PER_SEC)) { break; } if(feof(stdin)) { break; } } return 0; } int main(int argc, char *argv[]) { //cout << "!!!Hello World!!!" << endl; // prints !!!Hello World!!! clock_t currentTime; int speed, wordSize, stopBits, waitTime; char parity, *portName, *inputString; char readBuf[256]; const int bufSize = sizeof(readBuf); int writeSize, readSize; CrossPlatformSerial serialPort; HANDLE hThread; HANDLE hStdout; DWORD dwThreadId; MYDATA myData; if(argc != 7 && argc != 8) { printUsage(argv[0]); return EXIT_FAILURE; } // parse parameter portName = argv[1]; speed = atoi(argv[2]); assert(speed); wordSize = atoi(argv[3]); assert(wordSize); stopBits = atoi(argv[4]); assert(stopBits); parity = argv[5][0]; waitTime = atoi(argv[6]); // open serial port if(!serialPort.open(portName)) { cout << "open " << portName << " failed" << endl; return EXIT_FAILURE; } // set serial port if(!serialPort.setSettings(speed, wordSize, stopBits, parity)) { cout << "set " << portName << " failed" << endl; return EXIT_FAILURE; } if(!serialPort.setTimeouts(1, 1)) { cout << "set timeout failed" << endl; return EXIT_FAILURE; } // transform inputString to serial port if(argc == 8) { inputString = argv[7]; convertString(inputString); do{ writeSize = serialPort.writeBuf(inputString, strlen(inputString)); inputString += writeSize; }while(strlen(inputString) != 0); } // stdin -> serial port // create thread ReadStdinToSerial myData.waitTime = waitTime; myData.pSerialPort = &serialPort; hThread = CreateThread( NULL, // default security attributes 0, // use default stack size ReadStdinToSerial, // thread function name &myData, // argument to thread function 0, // use default creation flags &dwThreadId); // returns the thread identifier // Check the return value for success. // If CreateThread fails, terminate execution. // This will automatically clean up threads and memory. if (hThread == NULL) { cout << "Create ReadStdinToSerial thread fail" << endl; ExitProcess(3); } // serial port -> stdout hStdout = GetStdHandle(STD_OUTPUT_HANDLE); while(1) { DWORD dwWritenSize; readSize = serialPort.readBuf(readBuf, bufSize); WriteFile(hStdout, readBuf, readSize, &dwWritenSize, NULL); currentTime = clock(); //cout << currentTime << endl; if(currentTime > (waitTime*CLOCKS_PER_SEC)) { break; } } CloseHandle(hThread); currentTime = clock(); // the processor time since the program started //cout << currentTime << endl; assert(currentTime != -1); return EXIT_SUCCESS; }

跨平台串口操作的接口

/* * cross_serial_port.h * * Created on: 2010-3-26 * Author: Administrator */ #ifndef CROSS_SERIAL_PORT_H_ #define CROSS_SERIAL_PORT_H_ #define SERIAL_PORT_WINDOWS 1 #define SERIAL_PORT_LINUX 2 #define SERIAL_PORT_TYPE SERIAL_PORT_WINDOWS #if (SERIAL_PORT_TYPE == SERIAL_PORT_WINDOWS) #include "windows_serial_port.h" #else #endif /************************************************************************** This header defines a cross-platform serial interface class that was developed over the course of the ECE capstone class. It is intended for demonstration purposes only and, while useful, is not sufficient for most large applications. While we use these functions in our project, they most likely do not apply to all applications,and as always, Your Mileage May Vary(YMMV) With that in mind, I hope that at the very least, you find this useful. ***************************************************************************/ class CrossPlatformSerial { public: /************************************************************** * Default constructor: create an instance of our serial interface * object. * Parameters: None, though it could be convenient to have default * settings specified here as well as possibly a default port name. * Returns: Nothing(it is a constructor) */ CrossPlatformSerial(); /* * Default deconstructor: delete an instance of out serial interface */ ~CrossPlatformSerial(); /* * open: opens the serial port using port-name provided. * Parameters: * portName: an array of chars containing a NULL terminated string * that is the port name that we want to open. * eg. COM1, COM2, COM4 * Returns: a boolean indicating success or failure */ bool open(char* portName); /* * close: closes the serial port * Parameters: None. * Returns: a boolean indicating success or failure */ bool close(); /* * setSettings: Set the settings of the serial port interface. Should * be called after the port is opened because otherwise settings * could be lost. * Parameters: * speed: the desired speed of the serial port * wordSize: the size of the data word in bits * stopBits: the number of stop bits * parity: parity to be used. One of * 'n' = None * 'e' = Even * 'o' = Odd * Returns: boolean indicating success or failure */ bool setSettings(int speed, int wordSize, int stopBits, char parity); /* * setTimeouts: set the read and write timeouts of the serial port * Parameters: * readTimeout: The amount of time to wait for a single word read to timeout (ms) * writeTimeout: The amount of time to wait for a single word write to timeout (ms) * Returns: boolean indicating success or failure */ bool setTimeouts(int readTimeout, int writeTimeout); /* * readBuf: read in a buffer of words * Parameters: * buf: The buffer to read words into * bufSize: the number of words to read. This should be less than * or equal to the size of buf * Returns: the number of words actually read */ int readBuf(char * buf, int bufSize); /* * writeBuf: write out a buffer of words * Parameters: * buf: The buffer to write words from * bufSize: the number of words to write. This should be less than * or equal to the size of buf * Returns: the number of words actually written */ int writeBuf(char * buf, int bufSize); private: #if (SERIAL_PORT_TYPE == SERIAL_PORT_WINDOWS) WindowsSerialPort serialPort; #else #endif }; #endif /* CROSS_SERIAL_PORT_H_ */

/* * cross_serial_port.cpp * * Created on: 2010-3-27 * Author: Administrator */ #include "cross_serial_port.h" CrossPlatformSerial::CrossPlatformSerial(){} CrossPlatformSerial::~CrossPlatformSerial(){} bool CrossPlatformSerial::open(char* portName) { return this->serialPort.open(portName); } bool CrossPlatformSerial::close() { return this->serialPort.close(); } bool CrossPlatformSerial::setSettings(int speed, int wordSize, int stopBits, char parity) { return this->serialPort.setSettings(speed, wordSize, stopBits, parity); } bool CrossPlatformSerial::setTimeouts(int readTimeout, int writeTimeout) { return this->serialPort.setTimeouts(readTimeout, writeTimeout); } int CrossPlatformSerial::readBuf(char * buf, int bufSize) { return this->serialPort.readBuf(buf, bufSize); } int CrossPlatformSerial::writeBuf(char * buf, int bufSize) { return this->serialPort.writeBuf(buf, bufSize); }

windows下串口的实现代码

/* * windows_serial_port.h * * Created on: 2010-3-26 * Author: Administrator */ #ifndef WINDOWS_SERIAL_PORT_H_ #define WINDOWS_SERIAL_PORT_H_ #include <windows.h> class WindowsSerialPort { public: WindowsSerialPort(); ~WindowsSerialPort(); /* * open: opens the serial port using port-name provided. * Parameters: * portName: an array of chars containing a NULL terminated string * that is the port name that we want to open. * eg. COM1, COM2, COM4 * Returns: a boolean indicating success or failure */ bool open(char * portName); /* * close: closes the serial port * Parameters: None. * Returns: a boolean indicating success or failure */ bool close(); /* * setSettings: Set the settings of the serial port interface. Should * be called after the port is opened because otherwise settings * could be lost. * Parameters: * speed: the desired speed of the serial port * wordSize: the size of the data word in bits * stopBits: the number of stop bits * parity: parity to be used. One of * 'n' = None * 'e' = Even * 'o' = Odd * Returns: boolean indicating success or failure */ bool setSettings(int speed, int wordSize, int stopBits, char parity); /* * setTimeouts: set the read and write timeouts of the serial port * Parameters: * readTimeout: The amount of time to wait for a single word read to timeout * writeTimeout: The amount of time to wait for a single word write to timeout * Returns: boolean indicating success or failure */ bool setTimeouts(int readTimeout, int writeTimeout); /* * readBuf: read in a buffer of words * Parameters: * buf: The buffer to read words into * bufSize: the number of words to read. This should be less than * or equal to the size of buf * Returns: the number of words actually read */ int readBuf(char * buf, int bufSize); /* * writeBuf: write out a buffer of words * Parameters: * buf: The buffer to write words from * bufSize: the number of words to write. This should be less than * or equal to the size of buf * Returns: the number of words actually written */ int writeBuf(char * buf, int bufSize); private: HANDLE fileHandle; int readTimeout; int writeTimeout; }; #endif /* WINDOWS_SERIAL_PORT_H_ */

/* * windows_serial_port.cpp * * Created on: 2010-3-26 * Author: Administrator */ #include "windows_serial_port.h" #include <stdio.h> WindowsSerialPort::WindowsSerialPort():fileHandle(NULL) { this->readTimeout = 1; this->writeTimeout = 1; } WindowsSerialPort::~WindowsSerialPort() { if(this->fileHandle != NULL) { CloseHandle(this->fileHandle); } } bool WindowsSerialPort::open(char * portName) { HANDLE fileHandle; fileHandle = CreateFile( // the name of the port (as a string) // eg. COM1, COM2, COM4 portName, // must have read AND write access to port GENERIC_READ | GENERIC_WRITE, // sharing mode // ports CANNOT be shared // (hence the 0) 0, // security attributes // 0 here means that this file handle cannot be inherited 0, // The port MUST exist before-hand // we cannot create serial ports OPEN_EXISTING, // Overlapped/Non-Overlapped Mode. // To use overlapped communication replace 0 with FILE_FLAG_OVERLAPPED 0, // HANDLE of a template file // which will supply attributes and permissions. // Not used with port access 0); if(fileHandle == INVALID_HANDLE_VALUE) { // error handling code here return false; } else { this->fileHandle = fileHandle; return true; } } bool WindowsSerialPort::close() { if(!CloseHandle(this->fileHandle)) { return false; } this->fileHandle = NULL; return true; } bool WindowsSerialPort::setSettings(int speed, int wordSize, int stopBits, char parity) { char comSetStr[30]; sprintf(comSetStr, "%d,%c,%d,%d", speed, parity, wordSize, stopBits); DCB dcb; // create the dcb // first, set every field of the DCB to 0 to make sure there are no invalid values FillMemory(&dcb, sizeof(dcb), 0); // set the length of the DCB dcb.DCBlength = sizeof(dcb); // try to build the DCB if(!BuildCommDCB(comSetStr, &dcb)) { return false; } // set the state of fileHandle to be dcb if(!SetCommState(this->fileHandle, &dcb)) { return false; } // set the buffers to be size 1024 of fileHandle if(!SetupComm(this->fileHandle, // in queue 1024, // out queue 1024)) { return false; } if(!this->setTimeouts(this->readTimeout, this->writeTimeout)) { return false; } return true; } bool WindowsSerialPort::setTimeouts(int readTimeout, int writeTimeout) { COMMTIMEOUTS cmt; // create the object this->readTimeout = readTimeout; this->writeTimeout = writeTimeout; cmt.ReadIntervalTimeout = readTimeout; cmt.ReadTotalTimeoutMultiplier = readTimeout; cmt.ReadTotalTimeoutConstant = readTimeout; cmt.WriteTotalTimeoutConstant = writeTimeout; cmt.WriteTotalTimeoutMultiplier = writeTimeout; if(!SetCommTimeouts(this->fileHandle, &cmt)) { return false; } return true; } int WindowsSerialPort::readBuf(char * buf, int bufSize) { // the amount of the data actually read will be returned in this variable DWORD read = 0; ReadFile( // the HANDLE that we are reading from this->fileHandle, // a pointer to an array of words that we want to read buf, // the size of the array of value to be read bufSize, // the address of a DWORD that the number of words // actually read will be stored in &read, // a pointer to an overlapped_reader struct // that is used in overlapped reading. NULL is out case NULL); return read; } int WindowsSerialPort::writeBuf(char * buf, int bufSize) { // the amount of the data actually written will be returned // in this variable DWORD write = 0; WriteFile( // the HANDLE that we are writting to this->fileHandle, // a pointer to an array of words that we want to write buf, // the size of the array of values to be written bufSize, // the address of a DWORD that the number of words // actuall written will be stored in &write, // a pointer to an overlapped_writer struct // that is used in overlapped writting. // NULL in out case NULL); return write; }