Click here to Skip to main content
15,867,453 members
Articles / Desktop Programming / MFC
Article

CSerialCom - A Simple Class for Implementing Serial Communication in Win-9X/2000

Rate me:
Please Sign up or sign in to vote.
4.62/5 (64 votes)
30 Sep 20029 min read 483.6K   17.5K   127   132
CSerialCom - A simple class for implementing serial communication in Win-9X/2000.

Introduction

Serial Data transmission seems a bit difficult for those who are new to the world of serial communication and VC++. Long ago, I had searched on codeguru.com for some help on serial data transmission and I got some valuable information. It was my dream to develop a simple class for implementing serial data transmission since then.

After getting seven months practical experience in the field of serial communication, I have developed a simple class for implementing serial transmission using WinAPI functions. Before going into the details of this class it is essential to know the basics of serial data transmission.

Serial Data Tranmission Basics

In serial data transmission the data is transmitted in serial format with the LSB of the byte to be transmitted, shifted out first among the data bits. The general format for serial transmission is Start Bit + Data Bits + Parity Bit (Optional) + Stop Bit.

The Parity bit is optional. It is used for error checking in communication. You can enable or disable parity checking by software modifications. Also, you can specify which parity you would like to use, either 'EVEN' or 'ODD' through software.

The various steps to be performed for sending and receiving data through the serial port of a PC are listed below:-

  1. Open the communication port
  2. Configure the communication port by setting the Baud rate, parity, no. of data bits, etc.
  3. Set time-outs for communication.
  4. Write data to the port.
  5. Read data from the port.
  6. Close the port.

Opening The Serial Port

The CreateFile() function opens a communications port. There are two ways to call CreateFile() to open the port - OVERLAPPED and NON-OVERLAPPED. You can open a Communication Port for OVERLAPPED IO operation and NON-OVERLAPPED IO operation. The CSerialCom class is written for NON-OVERLAPPED IO operation. For more details on OVERLAPPED & NON-OVERLAPPED IO, please refer to the MSDN documentation.

Configuring Serial Ports

The most critical phase in serial communication programming is configuring the port settings with the DCB structure. Erroneously initializing the DCB structure is a common problem. When a serial communications function does not produce the expected results, the DCB structure may be in error. A call to the CreateFile() function opens a serial port with default port settings. Usually, the application needs to change the defaults. You must set the Baud rate for communication, Parity functions, no. of Stop Bits, etc. in accordance with the requirements of the external device by calling appropriate WinAPI functions.

Configuring Time-Outs

An application must always set communication time-outs using the COMMTIMEOUTS structure each time it opens a communication port. If this structure is not configured, the port uses default time-outs supplied by the driver, or time-outs from a previous communication application. By assuming specific time-out settings when the settings are actually different, an application can have read/write operations that never complete or complete too often. You must configure the read & write time-outs by calling the appropriate WinAPI functions.

Writing to a Serial Port

The WriteFile() function transfers data through the serial connection to another device. Before calling this function, an application must open and configure a serial port.

Reading from a Serial Port

An application calls the ReadFile() function to receive data from a device at the other end of a serial connection.

Closing a Serial Port

You must close the communications port after serial transmission in order to make this port available for other applications which use this resource. As long as you are working with a port (i.e. the port is in an open state), other threads or applications will not be able to access to this port till you close the handle to that port in NON-OVERLAPPED IO operation. Call the CloseHandle() function to close the serial port. CloseHandle() has one parameter, which is the handle returned by the CreateFile() call that opened the port.

CSerialCom Class

The CSerialCom class uses six member functions to achieve the above mentioned functionality. They are:

BOOL CSerialCom::OpenPort(CString portname)
{
portname= "//./" + portname;

hComm = CreateFile(portname,
                      GENERIC_READ | GENERIC_WRITE,
                      0,
                      0,
                      OPEN_EXISTING,
                      0,
                      0);
if(hComm==INVALID_HANDLE_VALUE){
	return false;}
	else
	return true;

}

The OpenPort() member function opens a communication port for data transmission. The parameter to be passed to this function is a string containing the port name. For example "com1" for COM1, "com2" for COM2 etc. If the function succeeds the return value is true, otherwise it is false.

BOOL CSerialCom::ConfigurePort(DWORD BaudRate, BYTE ByteSize, 
                               DWORD fParity, BYTE Parity, BYTE StopBits)
{
	if((m_bPortReady = GetCommState(hComm, &m_dcb))==0)
	{
		MessageBox("GetCommState Error","Error",MB_OK+MB_ICONERROR);
		CloseHandle(hComm);
	    return false;
	}
    
    m_dcb.BaudRate =BaudRate;
    m_dcb.ByteSize = ByteSize;
    m_dcb.Parity =Parity ;
    m_dcb.StopBits =StopBits;
    m_dcb.fBinary=TRUE;
    m_dcb.fDsrSensitivity=false;
    m_dcb.fParity=fParity;
    m_dcb.fOutX=false;
    m_dcb.fInX=false;
    m_dcb.fNull=false;
    m_dcb.fAbortOnError=TRUE;
    m_dcb.fOutxCtsFlow=FALSE;
    m_dcb.fOutxDsrFlow=false;
    m_dcb.fDtrControl=DTR_CONTROL_DISABLE;
    m_dcb.fDsrSensitivity=false;
    m_dcb.fRtsControl=RTS_CONTROL_DISABLE;
    m_dcb.fOutxCtsFlow=false;
    m_dcb.fOutxCtsFlow=false;

    m_bPortReady = SetCommState(hComm, &m_dcb);
    if(m_bPortReady ==0)
    {
		MessageBox("SetCommState Error","Error",MB_OK+MB_ICONERROR);
		CloseHandle(hComm);
		return false;
	}
    return true;
}

The ConfigurePort() member function configures a communication port for data transmission. The parameters to be passed to this function are given below.

DWORD BaudRate
It represents the Baud rate for communication supported by external device. For example, you can give this parameter as 9600 or CBR_9600 for a BaudRate of 9600. The available Standard Baud rates supported by a PC are CBR_110 ,CBR_300 ,CBR_600 ,CBR_1200,CBR_2400,CBR_4800,CBR_9600,CBR_14400, CBR_19200,CBR_38400,CBR_56000,CBR_57600,CBR_115200,CBR_128000,CBR_256000

BYTE ByteSize
This represents the number of bits in the bytes transmitted and received. Standard values are 8 or 4.

DWORD fParity
Specifies whether parity checking is enabled. If this parameter is TRUE, parity checking is performed and errors are reported. If FALSE, no parity checking is performed.

BYTE Parity
Specifies the parity scheme to be used. This member can be one of the following values:

  • EVENPARITY
  • MARKPARITY
  • NOPARITY
  • ODDPARITY
  • SPACEPARITY

BYTE StopBits
Specifies the number of stop bits to be used. This member can be one of the following values:

  • ONESTOPBIT
  • ONE5STOPBITS
  • TWOSTOPBITS

NOTE
The ConfigurePort() function is written on the assumption that the communication flow control is completely controlled on the basis of the protocol supported by the external device. It transmits and receives data without checking CTS/RTS and Xon/Xoff hardware flow control. You can modify this to your requirements by changing the values of the members of DCB which are responsible for it, in the implementation of ConfigurePort() in SerialCom.cpp.

ConfigurePort(CBR_9600, 8, true, EVENPARITY , ONESTOPBIT )

If the function succeeds the return value is true otherwise false.

BOOL CSerialCom::SetCommunicationTimeouts(DWORD ReadIntervalTimeout, 
                                          DWORD ReadTotalTimeoutMultiplier, 
                                          DWORD ReadTotalTimeoutConstant, 
                                          DWORD WriteTotalTimeoutMultiplier, 
                                          DWORD WriteTotalTimeoutConstant)
{
    if((m_bPortReady = GetCommTimeouts (hComm, &m_CommTimeouts))==0)
        return false;
    m_CommTimeouts.ReadIntervalTimeout =ReadIntervalTimeout;
    m_CommTimeouts.ReadTotalTimeoutConstant =ReadTotalTimeoutConstant;
    m_CommTimeouts.ReadTotalTimeoutMultiplier =ReadTotalTimeoutMultiplier;
    m_CommTimeouts.WriteTotalTimeoutConstant = WriteTotalTimeoutConstant;
    m_CommTimeouts.WriteTotalTimeoutMultiplier =WriteTotalTimeoutMultiplier;
	m_bPortReady = SetCommTimeouts (hComm, &m_CommTimeouts);
	
	if(m_bPortReady ==0)
	{
        MessageBox("StCommTimeouts function failed",
                   "Com Port Error",MB_OK+MB_ICONERROR);
		CloseHandle(hComm);
		return false;
	}
	return true;
}

The SetCommunicationTimeouts() member function sets the write & read timeouts for data transmission. The parameters to be passed to this function are given below.

DWORD ReadIntervalTimeout
Specifies the maximum time, in milliseconds, allowed to elapse between the arrival of two characters on the communications line. During a ReadFile() operation, the time period begins when the first character is received. If the interval between the arrival of any two characters exceeds this amount, the ReadFile operation is completed and any buffered data is returned. A value of zero indicates that interval time-outs are not used. A value of MAXDWORD, combined with zero values for both the ReadTotalTimeout constant and ReadTotalTimeoutMultiplier members, specifies that the read operation is to return immediately with the characters that have already been received, even if no characters have been received.

ReadTotalTimeoutConstant
Specifies the constant, in milliseconds, used to calculate the total time-out period for read operations. For each read operation, this value is added to the product of the ReadTotalTimeoutMultiplier member and the requested number of bytes. A value of zero for both the ReadTotalTimeoutMultiplier and ReadTotalTimeoutConstant members indicates that total time-outs are not used for read operations.

ReadTotalTimeoutMultiplier
Specifies the multiplier, in milliseconds, used to calculate the total time-out period for read operations. For each read operation, this value is multiplied by the requested number of bytes to be read.

WriteTotalTimeoutConstant
Specifies the constant, in milliseconds, used to calculate the total time-out period for write operations. For each write operation, this value is added to the product of the WriteTotalTimeoutMultiplier member and the number of bytes to be written.

WriteTotalTimeoutMultiplier
Specifies the multiplier, in milliseconds, used to calculate the total time-out period for write operations. For each write operation, this value is multiplied by the number of bytes to be written.

A value of zero for both the WriteTotalTimeoutMultiplier and WriteTotalTimeoutConstant members indicates that total time-outs are not used for write operations.

For example, if your device transmits a block of characters with a max. timeout value of 500 ms between each characters, you can set the time-out function as SetCommunicationTimeouts(0,500,0,0,0);. If the function succeeds the return value is true otherwise false.

BOOL CSerialCom::WriteByte(BYTE bybyte)
{
    iBytesWritten=0;
    if(WriteFile(hComm,&bybyte,1,&iBytesWritten,NULL)==0)
        return false;
    else 
        return true;
}

The WriteByte() member function writes the data byte to the communication port. The parameter to be passed to this function is the byte to be transmitted. You can call this function repeatedly in a loop with your data to be written placed in an array. Each time you send characters, increment the index of the array and call WriteByte() till all data bytes are transmitted.

If the function succeeds the return value is true otherwise false.

BOOL CSerialCom::ReadByte(BYTE &resp)
{
    BYTE rx;
    resp=0;

    DWORD dwBytesTransferred=0;

    if (ReadFile (hComm, &rx, 1, &dwBytesTransferred, 0))
    {
        if (dwBytesTransferred == 1)
        {
            resp=rx;
	        return true;
	     }
	}
	return false;
}

The ReadByte() member function reads data bytes from the communication port. The parameter to be passed to this function is the address of the variable in which the received data byte is to be stored. You can call this function repeatedly in a loop with your received data moved to an array. Each time you receive characters, increment the index of the array and call ReadByte() till all data bytes are received. If you know exactly the no. of response bytes from the external device you can call the ReadByte() function in a loop till all characters are received or a time out occurs. Sometimes you may not be able to predict the no. of response bytes from the external device. In that case call ReadByte file repeatedly till you get a time out and if the character received previously is a character representing end of transmission in your protocol format, the communication process is successfully completed. For example, for a device following 3964 the end of transmission is 'ETX' character. So use the ReadByte() function properly in accordance with the protocol supported by your external device.

If ReadByte() succeeds the return value is true and the received Byte will be stored in the location pointed by the address of ReadByte( )'s parameter. If a timeout occurs the return value will be false.

void CSerialCom::ClosePort()
{
CloseHandle(hComm);
return;
}
The ClosePort() member function closes a communication port which is already in an Open state.

How To Use 'CSerialCom' Class

Take the following steps to use the CSerialCom class

  1. Copy the SerialCom.h & SerialCom.cpp files and paste into your project directory.
  2. In your VC++ IDE, add the files to your project
  3. Add the line #include "SerialCom.h" in your dialog's header file
  4. Create an instance of the CSerialCom class in your dialog's header file.

You can now call the member functions of CSerialCom when you want to communicate with external device as shown below.

In your dialog's .cpp file:

// Open Communication Port. Please check functions return value to ensure whether
// Port opened successfully.
port.OpenPort( );

// Configure Port for Communication. Please check functions return value to
// ensure whether Port is configured  successfully.
port.ConfigurePort( );

// Set communication time outs. Please check functions return
// value to ensure whether communication time outs configured
// successfully.
port.SetCommunicationTimeouts( );

// call this function in a loop till all bytes are written. Please check
// functions return value to ensure whether Write operation completed
// successfully.
port.WriteByte();

// call this function in a loop till all bytes are received. Please check
// functions return value to ensure whether Read operation completed
// successfully or a time out occurred.
port.ReadByte( );

// Call this function to close the handle to the port.
// Process the received Data
port.ClosePort();

Note

This code has been tested with an RS-232 Connector, whose TXD pin & RXD pin were shorted, connected to 'com1' (E.g. for case1: where the no. of databytes to be read is predefined or constant (in this case 1) and with a Smart Card Reader with baud rate 9600 supporting 3964 Protocol for communication (Eg. for case2: where the no. of databytes to be read from the external device is unknown and the end of data transmission is detected by a timeout with the last character received being the End of transmission character in that Protocol ('ETX' Character for 3964 Protocol) in win-98/2000 and it is found working properly.

Some of the explanations given in this article are taken from the MSDN library.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Architect Infosys Technologies
India India
Currently working with the Embedded Systems & DSP Lab of Infosys Technologies, Thiruvananthapuram Development unit (www.infosys.com)

Comments and Discussions

 
PraiseCSerial Class is elegantly coded and it works flawlessly, Thanks Pin
Member 848955114-Sep-16 16:46
Member 848955114-Sep-16 16:46 
QuestionPlease Help! Send and Receiving Data over RS232/422 Pin
alpinanc0427-Mar-14 2:32
alpinanc0427-Mar-14 2:32 
QuestionTimeout on getting Response.Please ensure that\nyou have connected the loop back plug to com1 Pin
jeffy66516-Aug-12 21:41
jeffy66516-Aug-12 21:41 
Questionwhy is it derived from CWnd ? Pin
xiedong10-Jul-12 3:13
xiedong10-Jul-12 3:13 
Questionneed some help Pin
Usama.tariq15-May-11 3:44
Usama.tariq15-May-11 3:44 
AnswerRe: need some help Pin
Shibu K V21-May-11 8:22
Shibu K V21-May-11 8:22 
GeneralRe: need some help Pin
Usama.tariq21-May-11 21:37
Usama.tariq21-May-11 21:37 
GeneralRe: need some help Pin
Shibu K V22-May-11 18:15
Shibu K V22-May-11 18:15 
GeneralMy vote of 3 Pin
Atukuri Srinivasa Rao20-Apr-11 3:05
Atukuri Srinivasa Rao20-Apr-11 3:05 
Generalthe SerialCom.cpp compile with errors Pin
Member 46267787-Feb-11 21:26
Member 46267787-Feb-11 21:26 
GeneralRe: the SerialCom.cpp compile with errors Pin
Shibu K V8-Feb-11 7:48
Shibu K V8-Feb-11 7:48 
GeneralRe: the SerialCom.cpp compile with errors Pin
Member 46267788-Feb-11 15:59
Member 46267788-Feb-11 15:59 
GeneralRe: the SerialCom.cpp compile with errors Pin
Shibu K V8-Feb-11 20:55
Shibu K V8-Feb-11 20:55 
Generalsuggestion for handling Comm Error Pin
Brian_m_a5-Jan-10 3:14
Brian_m_a5-Jan-10 3:14 
GeneralRe: suggestion for handling Comm Error Pin
Shibu K V6-Jan-10 1:50
Shibu K V6-Jan-10 1:50 
GeneralRS485 Pin
wanbeng18-Oct-09 18:06
wanbeng18-Oct-09 18:06 
GeneralRe: RS485 Pin
Shibu K V18-Oct-09 20:34
Shibu K V18-Oct-09 20:34 
Generalafxdisp.h Pin
Redosl11-Jul-09 8:29
Redosl11-Jul-09 8:29 
GeneralRe: afxdisp.h Pin
Shibu K V11-Jul-09 12:10
Shibu K V11-Jul-09 12:10 
QuestionCan i use CSerialCom class for "RS-232 communication by generating interrupts"? Pin
dsreenath27-May-09 1:37
dsreenath27-May-09 1:37 
GeneralMy vote of 1 Pin
Syed J Hashmi13-Dec-08 18:06
Syed J Hashmi13-Dec-08 18:06 
GeneralRe: My vote of 1 [modified] Pin
Sigurd Johansen29-Dec-08 16:41
Sigurd Johansen29-Dec-08 16:41 
Generalrunning the application in non loopback mode Pin
Divya Lalwani10-Dec-08 22:25
Divya Lalwani10-Dec-08 22:25 
Generalwill demo application on CSerialCom run on Vista. Pin
Divya Lalwani8-Dec-08 3:15
Divya Lalwani8-Dec-08 3:15 
GeneralRe: will demo application on CSerialCom run on Vista. Pin
Shibu K V8-Dec-08 4:51
Shibu K V8-Dec-08 4:51 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.