serial_enumerator

A serial port enumeration library written in Rust. It lists available serial ports with vendor, product, and USB VID/PID information.

• Cross-platform: Linux, Windows, macOS
• Filters out non-functional ports so you only see what can actually communicate
• On Linux, distinguishes valid ports from false positives via the valid field — unlike tools that dump every TTY blindly

Quick Start

use serial_enumerator::get_serial_list;

fn main() {
    for port in get_serial_list() {
        println!("{}  valid={}  {:?}", port.name, port.valid, port.usb_info);
    }
}

API

pub fn get_serial_list() -> Vec<SerialInfo>

Returns all available serial ports on the current platform.

SerialInfo

UsbInfo

CLI Tool: lser

This crate also ships a built-in CLI tool for listing serial ports from the terminal:

cargo install serial_enumerator
lser

Or run it directly:

cargo run --bin lser

Example output (Linux):

SerialInfo { name: "/dev/ttyS0", valid: true, vendor: Some("pnp"), product: Some("PNP0501"), driver: Some("serial"), usb_info: None }
SerialInfo { name: "/dev/ttyUSB0", valid: true, vendor: Some("FTDI"), product: Some("Dual RS232-HS:00"), driver: Some("usbserial"), usb_info: Some(UsbInfo { vid: "0403", pid: "6010" }) }

Example output (Windows):

SerialInfo { name: "COM4", valid: true, vendor: Some("wch.cn"), product: Some("USB-SERIAL CH340"), driver: None, usb_info: Some(UsbInfo { vid: "1A86", pid: "7523" }) }

Validity Behavior by Platform

License

MIT