Serial communication with NodeJS


Mar 2015

How can you talk to hardware peripherals, lights or robots from your laptop?

For many cases, the answer is: Serial communication. With serial communication, you can send bits and bytes “in series” over a wire. This often looks as in the figure below.

While you will always find a wire for data, the clock is optional in some communication schemes. The clock can be included for accurate timing of data signals. But in other communication schemes, the clock is left out. From operating system perspective, a nice overview is here. This is possible when timing is defined on the sending and receiving ends, for example when data transmission should happen on 57600 bits per second.

Besides timing, serial communication is about configuration of wires. Data travels in one or multiple directions, usually on wires. But serial communication concepts often apply to wire-less communication too.

There are different forms of serial communication such as RS-232 or USB. In both cases, the core building block in a micro chip is an UART (or “universal asynchronous receiver and transmitter”). This digital logic can be configured to different data formats and transmission speeds.

On your computer, an operating system connects to the UART with a driver. The driver takes care of inputs and outputs, and configuration of the signals (or ioctl in computing language). This means, if you want to talk to your Arduino from your laptop with NodeJS, your JavaScript actually talks to the driver for the serial port.

Sounds complicated? Maybe some code examples clear things up.

The serialport library

JavaScript and hardware - why would you combine both? There are some good arguments about using JavaScript with hardware.

The physical world is accessible for JavaScript projects thanks to the serialport module by Chris Williams.

Let’s create a fresh JavaScript project and add this module to it:

$ npm install --save-dev serialport

After the module has been downloaded, you are ready to start some serial communication fun.

Opening a port

Before any communication can happen, you must open the serial port. This is the start of every program. In the file “dump_usb.js”, you write:

var serialport = require("serialport"); 
var SerialPort = serialport.SerialPort; 

var serialPort = new SerialPort("/dev/cu.usbmodem14131", {
  baudrate: 9600,
  parser: serialport.parsers.readline("\n")

You must pass the port name, something like “COM1” on Windows or “/dev/ttyS0” on POSIX platforms. In case of my Arduino, it is “/dev/cu.usbmodem14131”.

Next, you must configure the port, mainly the transmission speed for sending and receiving bits. (Serial port configuration can also include things as flow control type, parity, stop bits and character size - this is out of scope for most Arduino projects).

For Arduino projects, a good choice for transmission speed is 9600 baud, because you can still watch incoming bits “live”. If there is a speed mismatch between your computer and your Arduino, you’ll see weird output.

As last argument for opening the port, you better set a parser for the incoming data. The default readline parser is nice to get line breaks out of the way.

Prepare the Arduino

Once the serial port is open, we have access to its data stream. The easiest thing to do is dumping data from the stream to the terminal.

Let’s have the Arduino send some data over with the Serial library. The following Arduino sketch “counter.ino” increases a counter, and sends the value over:

setup() {

int i=0;
void loop() {
  delay(100); // poll every 100ms

The last “delay” gives the laptop some time to process the data. Providing a delay is a good idea when you want to watch a data stream with human eyes instead of a CPU’s.

Reading from the port

To read bits from the port, you must add some more lines to the “dump_usb.js” script:

var serialport = require("serialport");
var SerialPort = serialport.SerialPort;

var serialPort = new SerialPort("/dev/cu.usbmodem14131", {
  baudrate: 9600,
  parser: serialport.parsers.readline("\n")

serialPort.on("open", function () {
  serialPort.on('data', function(data) {

The last part is important: We listen to the open event from the driver. Then, we subscribe to its data events. The received bits are displayed to the screen with console.log(data).

Let’s run this script:

$ node dump_usb.js

If everything works out, you’ll see some numbers from the Arduino scrolling down on the screen. With a bit more advanced Arduino breadboard setup (see the screenshot), you can easily measure the room temperature or the position of a potentiometer.

arduino serial


This post gave you some basic concepts for communication with an embedded device with NodeJS. Not too much happened at this stage. Just numbers scrolling down the screen. Things will get more fun in a future blog post, where we’ll connect the serial port to the browser by using a simple “polling” mechansism. This will enable us to write some simple web interfaces for hardware.

Note: This post is the first post of a new series about JavaScript for embedded devices. This will be the topic of my new book. You can track its progress on the book website. Any feedback, suggestions and criticism is highly appreciated.

Leave me feedback

Follow me on Twitter here.

comments powered by Disqus