2.0.2 • Public • Published


Node-RED nodes to talk to hardware serial ports.


To install the stable version use the Menu - Manage palette - Install option and search for node-red-node-serialport, or run the following command in your Node-RED user directory, typically ~/.node-red

    npm i node-red-node-serialport

During install there may be multiple messages about optional compilation. These may look like failures... as they report as failure to compile errors - but often are warnings and the node will continue to install and, assuming nothing else failed, you should be able to use it. Occasionally some platforms will require you to install the full set of tools in order to compile the underlying package.


Provides four nodes - one to receive messages, and one to send, a request node which can send then wait for a response, and a control node that allows dynamic control of the ports in use.


Reads data from a local serial port.

Clicking on the search icon will attempt to autodetect serial ports attached to the device, however you many need to manually specify it. COM1, /dev/ttyUSB0, etc

It can either

  • wait for a "split" character (default \n). Also accepts hex notation (0x0a).
  • wait for a timeout in milliseconds from the first character received
  • wait to fill a fixed sized buffer

It then outputs msg.payload as either a UTF8 ascii string or a binary Buffer object.

If no split character is specified, or a timeout or buffer size of 0, then a stream of single characters is sent - again either as ascii chars or size 1 binary buffers.


Provides a connection to an outbound serial port.

Only the msg.payload is sent.

Optionally the character used to split the input can be appended to every message sent out to the serial port.


Provides a connection to a request/response serial port.

This node behaves as a tightly coupled combination of serial in and serial out nodes, with which it shares the configuration.

Send the request message in msg.payload as you would do with a serial out node. The message will be forwarded to the serial port following a strict FIFO (First In, First Out) queue, waiting for a single response before transmitting the next request. Once a response is received (with the same logic of a serial in node), or after a timeout occurs, a message is produced on the output, with msg.payload containing the received response (or missing in case if timeout), msg.status containing relevant info, and all other fields preserved.

For consistency with the serial in node, msg.port is also set to the name of the port selected.


When the node-red starts, the flow(program) picks up the pre-programmed serial port, open it, and starts the communication. But there are some cases the port needs to switch to a different port, stop, and start again. For example, in order to upload a new binary for Arduino, the serial port needs to be stopped relased from the nodered, and start it again after uploading. Or when the FTDI device re-connects after disconnecting for any reason, it may be possible that the port number changes, and the end user of the flow can't change the port.

This node provides the ability to:

  1. change the serial port and its configuration on the run time programatically.
  2. stop the communication and release the serial port.
  3. reopen the port and restart the communications.

In order to control the communication, send a msg.payload to the control node.

    "serialport": "/dev/ttyUSB0",
    "serialbaud": 115200,
    "databits": 8,
    "parity": "none",
    "stopbits": 1,
    "enabled": true

changes the serial port and the configuration on the fly.

The following optional parameters will change the configuration only if they are present. Any combination of them can be passed to change/control the serial communication

  • serialport
  • serialbaud
  • databits
  • parity
  • stopbits
  • dtr
  • rts
  • cts
  • dsr
  • enabled

If the enabled property is not present, it will default to true.

{"enabled":true} or {"enabled":false} will start or stop the communication.

If enabled is passed along with other parameters, the configuration will be changed and the port will be either started or remain stopped, ready to be started later depending on its value.

Any input message will cause the node to output the current port configuration.



Package Sidebar


npm i node-red-node-serialport

Weekly Downloads






Unpacked Size

81 kB

Total Files


Last publish


  • knolleary
  • dceejay