Crate serial_enumerator

serial_enumerator

A serial port enumreator library writen in rust, which can help you to get serial ports and informations of you devices.

• Support Linux, Windows
• Support arm and x86 devices of linux

Simple usage

• print all serial port with table
• binary cli-tool to list serial port lser

use cli_table::{format::Justify, print_stdout, Table, WithTitle};
use serial_enumerator::{get_serial_list, SerialInfo};

#[derive(Table)]
struct SerialItem {
    #[table(title = "Name")]
    name: String,
    #[table(title = "Vendor", justify = "Justify::Center")]
    vendor: String,
    #[table(title = "Product", justify = "Justify::Center")]
    product: String,
    #[table(title = "USB", justify = "Justify::Center")]
    usb: String,
}

impl SerialItem {
    pub fn from_serial_info(serial_info: SerialInfo) -> SerialItem {
        let field_or_else = || Some(String::from("--"));
        return SerialItem {
            name: serial_info.name,
            vendor: serial_info.vendor.or_else(field_or_else).unwrap(),
            product: serial_info.product.or_else(field_or_else).unwrap(),
            usb: serial_info
                .usb_info
                .and_then(|usbinfo| Some(format!("{}:{}", usbinfo.vid, usbinfo.pid)))
                .or_else(field_or_else)
                .unwrap(),
        };
    }
}

fn main() {
    let serials_info = get_serial_list();
    let mut serials_table = Vec::new();
    for serial_info in serials_info {
        serials_table.push(SerialItem::from_serial_info(serial_info));
    }
    print_stdout(serials_table.with_title()).unwrap();
}

• Output

+------+--------+------------------+-----------+
| Name | Vendor | Product          | USB       |
+------+--------+------------------+-----------+
| COM4 | wch.cn | USB-SERIAL CH340 | 1A86:7523 |
+------+--------+------------------+-----------+

Structs

SerialInfo

serial port informations

UsbInfo

usb information of serial port

Functions

get_serial_list

enumerate all avaliable serial port