40 releases

new 0.2.26 Jun 21, 2024
0.2.24 Apr 23, 2024
0.2.20 Mar 4, 2024
0.2.15 Dec 27, 2023
0.1.5 Nov 20, 2021

#46 in Hardware support

Download history 838/week @ 2024-02-29 1191/week @ 2024-03-07 1105/week @ 2024-03-14 897/week @ 2024-03-21 703/week @ 2024-03-28 392/week @ 2024-04-04 600/week @ 2024-04-11 660/week @ 2024-04-18 380/week @ 2024-04-25 505/week @ 2024-05-02 467/week @ 2024-05-09 167/week @ 2024-05-16 184/week @ 2024-05-23 163/week @ 2024-05-30 189/week @ 2024-06-06 458/week @ 2024-06-13

1,012 downloads per month
Used in 9 crates (8 directly)

BSD-2-Clause OR Apache-2.0

120KB
2.5K SLoC

serial2

Serial port communication for Rust.

The serial2 crate provides a cross-platform interface to serial ports. It aims to provide a simpler interface than other alternatives.

Currently supported features:

  • Simple interface: one SerialPort struct for all supported platforms.
  • List available ports.
  • Custom baud rates on all supported platforms except Solaris and Illumos.
  • Concurrent reads and writes from multiple threads, even on Windows.
  • Purge the OS buffers (useful to discard read noise when the line should have been silent, for example).
  • Read and control individual modem status lines to use them as general purpose I/O.
  • Cross platform configuration of serial port settings:
    • Baud rate
    • Character size
    • Stop bits
    • Parity checks
    • Flow control
    • Read/write timeouts
  • Full access to platform specific serial port settings using target specific feature flags ("unix" or "windows").

You can open and configure a serial port in one go with SerialPort::open(). The second argument to open() must be a type that implements IntoSettings. In the simplest case, it is enough to pass a u32 for the baud rate. Doing that will also configure a character size of 8 bits with 1 stop bit and disables parity checks and flow control. For full control over the applied settings, pass a closure that receives the the current Settings and return the desired settings. If you do, you will almost always want to call Settings::set_raw() before changing any other settings.

The standard std::io::Read and std::io::Write traits are implemented for SerialPort and &SerialPort. This allows you to use the serial port concurrently from multiple threads through a non-mutable reference.

There are also non-trait read() and write() functions, so you can use the serial port without importing any traits. These take &self, so they can also be used from multiple threads concurrently.

The SerialPort::available_ports() function can be used to get a list of available serial ports on supported platforms.

Example

This example opens a serial port and echoes back everything that is read.

use serial2::SerialPort;

// On Windows, use something like "COM1" or "COM15".
let port = SerialPort::open("/dev/ttyUSB0", 115200)?;
let mut buffer = [0; 256];
loop {
    let read = port.read(&mut buffer)?;
    port.write(&buffer[..read])?;
}

Dependencies

~2–395KB