Linux Serial Ports Using C/C++


Unluckily, using serial ports in Linux is not the easiest thing in the world. When dealing with the termios.h header, there are many finicky settings buried within multiple bytes worth of bitfields.

Everything Is A File

In typical UNIX style, serial ports are represented by files within the operating system. These files usually pop-up in /dev, and begin with the name tty*.

Common names are:

  • ttyACM0 – ACM stands for the ACM modem on the USB bus. Arduino UNOs (and similar) will appear using this name.
  • ttyPS0 – Xilinx Zynq FPGAs running a Yocto-based Linux build will use this name for the default serial port that Getty connects to.
  • ttyS0 – Standard COM ports will have this name. These are less common these days with newer desktops and laptops not having actual COM ports.
  • ttyUSB0 – Most USB-to-serial cables will show up using a file named like this.

To write to a serial port, you write to the file. To read from a serial port, you read from the file. Of course, this allows you to send/receive data, but how do you set the serial port parameters such as baud rate, parity, e.t.c? This is set by a special tty configuration struct.

VMIN and VTIME Explained

VMIN and VTIME are a source of confusion for many programmers when trying to configure a serial port in Linux.

An important point to note is that VTIME means slightly different things depending on what VMIN is. When VMIN is 0, VTIME specifies a time-out from the start of the read() call. But when VMIN is > 0,  VTIME specifies the time-out from the start of the first received character.

VMIN = 0 , VTIME = 0 : No blocking, return immediately with what is available
VMIN > 0 , VTIME > 0 : Block until either VMIN characters have been received, or VTIME after first character has elapsed. Note that the timeout for VTIME does not begin until the first character is received.

Issues With Getty

Getty can cause issues with serial communication if it is trying to manage the same tty device that you are attempting to perform serial communications with.

To Stop Getty:

Getty can be hard to stop, as by default, if you try and kill the process, and new process will start up immediately.

These instructions apply to older versions of Linux, and/or embedded Linux.

  1. Load /etc/inittab in your favourite text editor.
  2. Comment out any lines involving getty and your tty device.
  3. Save and close the file.
  4. Run the command ~$ init q to reload the /etc/inittab file.
  5. Kill any running getty processes attached to your tty device.

Exclusive Access

It can be prudent to try and prevent other processes from reading/writing to the serial port at the same time you are.

One way to accomplish this is with the flock() system call:




Posted: June 24th, 2017 at 12:49 pm
Last Updated on: October 26th, 2017 at 10:24 am