Click here to Skip to main content
Click here to Skip to main content

Basic serial port listening application

, 9 May 2010 CPOL
Rate this:
Please Sign up or sign in to vote.
Scans for installed serial ports, queries the supported baud rates, and starts listening to the selected serial port.

SerialPortListenerApp

Introduction

This is a basic sample of serial port (COM port) listening in C#. This application is connected to a GPS sending ASCII text for test, but the serial port listening part is all byte-oriented.

CodeProject is missing a simple serial port application. Serial port listening applications usually have this only as a part of a bigger solution, while this application does nothing else than list the available COM-ports, list the available baud rates for the selected COM-port, and starts sending the data. In this solution, a form converts the data to ASCII-text and displays it in a text box.

Using the code

The serial port handling code is placed in a class called SerialPortManager. This class contains methods to start and stop listening for data on the serial port.

Finding the installed serial ports

Rather than just assuming the number of serial ports, or leaving it up to the user to know this beforehand, the code finds the installed serial ports. A string array of serial ports is received through a call made in the constructor of the class SerialPortManager.

public SerialPortManager()
{
    // Finding installed serial ports on hardware
    _currentSerialSettings.PortNameCollection = 
            System.IO.Ports.SerialPort.GetPortNames();
    _currentSerialSettings.PropertyChanged += 
                       new System.ComponentModel.PropertyChangedEventHandler
                       (_currentSerialSettings_PropertyChanged);

    // If serial ports is found, we select the first found
    if (_currentSerialSettings.PortNameCollection.Length > 0)
        _currentSerialSettings.PortName = 
             _currentSerialSettings.PortNameCollection[0];
}

Updating baud rates supported by the selected device

When a serial port is selected by the user, a query for supported baud rates is done. Depending on the hardware, different collections of baud rates may be supported. The field dwSettableBaud from the COMMPROP structure is a join of all supported baud rates.

private void UpdateBaudRateCollection()
{
    _serialPort = new SerialPort(_currentSerialSettings.PortName);
    _serialPort.Open();

    // Getting COMMPROP structure, and its property dwSettableBaud.
    object p = _serialPort.BaseStream.GetType().GetField("commProp", 
       BindingFlags.Instance | BindingFlags.NonPublic).GetValue(_serialPort.BaseStream);
    Int32 dwSettableBaud = (Int32)p.GetType().GetField("dwSettableBaud", 
       BindingFlags.Instance | BindingFlags.NonPublic | BindingFlags.Public).GetValue(p);

    _serialPort.Close();
    _currentSerialSettings.UpdateBaudRateCollection(dwSettableBaud);
}

Serial port settings

The class named SerialSettings contains the currently selected serial port settings, and also includes lists of alternatives for the different setting properties. Everything is data bound to the GUI.

Start listening to a serial port

The serial port is instantiated using the currently selected settings:

// Connects to a serial port defined through the current settings
public void StartListening()
{
    // Closing serial port if it is open
    if (_serialPort != null && _serialPort.IsOpen)
        _serialPort.Close();

    // Setting serial port settings
    _serialPort = new SerialPort(
        _currentSerialSettings.PortName,
        _currentSerialSettings.BaudRate,
        _currentSerialSettings.Parity,
        _currentSerialSettings.DataBits,
        _currentSerialSettings.StopBits);

     // Subscribe to event and open serial port for data
     _serialPort.DataReceived += 
         new SerialDataReceivedEventHandler(_serialPort_DataReceived);
     _serialPort.Open();
}

The actual serial port reading

The actual serial port reading runs in a threadpool. When data is received on the serial port, an event is raised and _serialPort_DataReceived is called.

void _serialPort_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
    int dataLength = _serialPort.BytesToRead;
    byte[] data = new byte[dataLength];
    int nbrDataRead = _serialPort.Read(data, 0, dataLength);
    if (nbrDataRead == 0)
        return;
          
    // Send data to whom ever interested
    if (NewSerialDataRecieved != null)
        NewSerialDataRecieved(this, new SerialDataEventArgs(data));
}

The received byte array is sent to those listening for the event. The class SerialDataEventArgs houses a byte array.

Stop listening

We stop listening by simply closing the serial port. Note that this might deadlock your UI-thread if you are using Invoke in the event handling in your form.

/// Closes the serial port
public void StopListening()
{
     _serialPort.Close();
}

To work around this possible deadlock, a BeginInvoke is needed. And, that is generally good practice as well.

if (this.InvokeRequired)
{
    // Using this.Invoke causes deadlock when closing serial port,
    // and BeginInvoke is good practice anyway.
    this.BeginInvoke(new EventHandler<SerialDataEventArgs>(
       _spManager_NewSerialDataRecieved), new object[] { sender, e });
    return;
}

Summary

A rather simple sample in how to implement serial port listening has been provided.

Updates

  • 27 April 2010 - Code clean-up and getting < > to show in the article.
  • 10 May 2010 - Fixing some misspells in the article.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Amund Gjersøe
Engineer
Norway Norway
No Biography provided

Comments and Discussions

 
QuestionProgram returns (?) question marks. PinmemberMember 110677458-Sep-14 13:52 
AnswerRe: Program returns (?) question marks. PinmemberAmund Gjersøe8-Sep-14 20:27 
QuestionBad zip PinmemberMember 1048922615-May-14 9:16 
AnswerRe: Bad zip PinmemberAmund Gjersøe26-May-14 20:41 
GeneralMy vote of 1 PinmemberMember 106981496-Apr-14 23:59 
GeneralRe: My vote of 1 PinmemberAmund Gjersøe26-May-14 20:43 
QuestionHELP PinmemberLytYrs12-Feb-14 5:36 
AnswerRe: HELP PinmemberAmund Gjersøe26-May-14 20:45 
QuestionHow to parse string to get $GPGGA? PinmemberTaketo Eguchi28-Nov-13 21:26 
AnswerRe: How to parse string to get $GPGGA? PinmemberAmund Gjersøe28-Nov-13 21:35 
GeneralRe: How to parse string to get $GPGGA? PinmemberTaketo Eguchi28-Nov-13 21:59 
GeneralRe: How to parse string to get $GPGGA? PinmemberAmund Gjersøe28-Nov-13 22:12 
QuestionProper way to catch an unavailable COM port? PinmemberJasper van Stijn13-Nov-13 11:41 
AnswerRe: Proper way to catch an unavailable COM port? PinmemberAmund Gjersøe28-Nov-13 22:16 
Questiontime out [modified] PinmemberLycian21-Aug-13 22:25 
AnswerRe: time out PinmemberAmund Gjersøe31-Aug-13 23:41 
QuestionDiscrete values PinmemberCatOfTheCanals2-Jul-13 3:03 
AnswerRe: Discrete values PinmemberAmund Gjersøe2-Jul-13 3:21 
GeneralRe: Discrete values PinmemberCatOfTheCanals2-Jul-13 22:30 
GeneralMy vote of 4 Pinmemberhamid.mousavinasab26-Mar-13 2:21 
GeneralMy vote of 1 PinmemberMember 993964224-Mar-13 22:58 
GeneralRe: My vote of 1 PinmemberAmund Gjersøe24-Mar-13 23:32 
QuestionWriting to the serial port Pinmembervasch2-Jan-13 3:33 
QuestionGood Application: Do you have the MVC 3 application for this? Pinmembermatimu ngobeni18-Nov-12 21:45 
QuestionTesting Serial Listener ? PinmemberZARk_be26-Sep-12 0:16 
AnswerRe: Testing Serial Listener ? PinmemberAmund Gjersøe26-Sep-12 0:24 
QuestionBinary Data Parse PinmemberEmbedded Planet17-Jul-12 11:22 
GeneralRe: Binary Data Parse [modified] PinmemberAmund Gjersøe30-Jul-12 1:47 
Generalis there any other serial port like articles? Pinmemberlyglary9-Jul-12 22:51 
Generalhi...Thank yu for saving my day Pinmemberdombanyasha7-Jun-12 10:09 
QuestionThanx Pinmemberdombanyasha7-Jun-12 10:08 
QuestionThanks , Just what I was searching for , BUT, PinmemberMember 228177127-Nov-10 7:45 
AnswerRe: Thanks , Just what I was searching for , BUT, PinmemberAmund9-Dec-10 1:38 
GeneralProblem to get the Baudrate PinmemberNMehta8317-Nov-10 19:21 
GeneralRe: Problem to get the Baudrate PinmemberAmund18-Nov-10 21:53 
QuestionCan't open port COM1? PinmemberJun Du22-Jul-10 4:26 
AnswerRe: Can't open port COM1? PinmemberAmund2-Aug-10 2:27 
QuestionAnyone knows a tip to reduce serial port latency Pinmembervertex8526-Apr-10 21:38 
AnswerRe: Anyone knows a tip to reduce serial port latency PinmemberAmund26-Apr-10 23:36 
AnswerRe: Anyone knows a tip to reduce serial port latency PinmvpLuc Pattyn27-Apr-10 3:06 
AnswerRe: Anyone knows a tip to reduce serial port latency Pinmembersupercat910-May-10 5:50 
AnswerRe: Anyone knows a tip to reduce serial port latency PinmemberTim Smartcom9-Jun-10 6:40 
GeneralRe: Anyone knows a tip to reduce serial port latency PinmemberH. P. Uffze16-Sep-10 3:38 
GeneralMy vote of 3 PinmvpLuc Pattyn26-Apr-10 3:43 
GeneralRe: My vote of 3 PinmemberAmund26-Apr-10 6:00 
GeneralRe: My vote of 3 PinmvpLuc Pattyn26-Apr-10 6:06 
GeneralRe: My vote of 3 PinmemberAmund26-Apr-10 23:15 
GeneralRe: My vote of 5 PinmvpLuc Pattyn27-Apr-10 3:15 
GeneralGood Pinmemberkird26-Apr-10 2:14 

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

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

| Advertise | Privacy | Mobile
Web04 | 2.8.141015.1 | Last Updated 10 May 2010
Article Copyright 2010 by Amund Gjersøe
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid