yapper 0.4.0

A modern, ergonomic UART serial TUI terminal for embedded workflows
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

#![allow(dead_code)]

mod app;
mod buffer;
mod config;
mod event;
mod filter;
mod hex;
mod highlight;
mod history;
mod input;
mod logging;
mod macros;
mod mouse;
mod search;
mod serial;
mod theme;
mod ui;

use anyhow::Result;
use clap::Parser;
use crossterm::{
    event::{DisableMouseCapture, EnableMouseCapture},
    execute,
    terminal::{disable_raw_mode, enable_raw_mode, EnterAlternateScreen, LeaveAlternateScreen},
};
use ratatui::prelude::*;
use std::io;

use app::App;
use event::EventLoop;

/// yapper — A modern UART serial TUI terminal for embedded workflows
#[derive(Parser, Debug)]
#[command(name = "yapper", version, about)]
struct Cli {
    /// Serial port to connect to (e.g. /dev/ttyUSB0)
    #[arg(value_name = "PORT")]
    port: Option<String>,

    /// Baud rate (defaults to saved config value, or 115200)
    #[arg(value_name = "BAUD")]
    baud: Option<u32>,

    /// Data bits (5, 6, 7, 8)
    #[arg(short, long)]
    data_bits: Option<u8>,

    /// Parity (none, odd, even)
    #[arg(short, long)]
    parity: Option<String>,

    /// Stop bits (1, 2)
    #[arg(short, long)]
    stop_bits: Option<u8>,

    /// Flow control (none, software, hardware)
    #[arg(short, long)]
    flow_control: Option<String>,

    /// Line ending to send (lf, crlf, cr)
    #[arg(long)]
    line_ending: Option<String>,

    /// Skip auto-connecting to the last used port
    #[arg(long)]
    no_auto: bool,
}

fn main() -> Result<()> {
    let cli = Cli::parse();
    let app_config = config::AppConfig::load();

    // Setup terminal
    enable_raw_mode()?;
    let mut stdout = io::stdout();
    execute!(stdout, EnterAlternateScreen, EnableMouseCapture)?;
    let backend = CrosstermBackend::new(stdout);
    let mut terminal = Terminal::with_options(
        backend,
        ratatui::TerminalOptions {
            viewport: ratatui::Viewport::Fullscreen,
        },
    )?;

    // Create app — merge CLI overrides with saved config defaults
    let serial_config = serial::config::SerialConfig {
        baud_rate: cli.baud.unwrap_or(app_config.defaults.baud_rate),
        data_bits: parse_data_bits(cli.data_bits.unwrap_or(app_config.defaults.data_bits)),
        parity: parse_parity(cli.parity.as_deref().unwrap_or(&app_config.defaults.parity)),
        stop_bits: parse_stop_bits(cli.stop_bits.unwrap_or(app_config.defaults.stop_bits)),
        flow_control: parse_flow_control(cli.flow_control.as_deref().unwrap_or(&app_config.defaults.flow_control)),
    };

    let line_ending = match cli.line_ending.as_deref().unwrap_or(&app_config.defaults.line_ending) {
        "lf" => "\n",
        "cr" => "\r",
        _ => "\r\n",
    };

    let mut app = App::new(serial_config, line_ending.to_string(), app_config.clone());

    // Connect: CLI port takes priority, then auto-connect to last port
    if let Some(port) = cli.port {
        app.connect(&port);
    } else if !cli.no_auto && app_config.connection.auto_connect {
        if let Some(last_port) = &app_config.connection.last_port {
            app.connect(last_port);
        }
    }

    // Run event loop
    let mut event_loop = EventLoop::new();
    let result = event_loop.run(&mut terminal, &mut app);

    // Restore terminal
    disable_raw_mode()?;
    execute!(
        terminal.backend_mut(),
        LeaveAlternateScreen,
        DisableMouseCapture
    )?;
    terminal.show_cursor()?;

    result
}

fn parse_data_bits(bits: u8) -> serialport::DataBits {
    match bits {
        5 => serialport::DataBits::Five,
        6 => serialport::DataBits::Six,
        7 => serialport::DataBits::Seven,
        _ => serialport::DataBits::Eight,
    }
}

fn parse_parity(parity: &str) -> serialport::Parity {
    match parity.to_lowercase().as_str() {
        "odd" => serialport::Parity::Odd,
        "even" => serialport::Parity::Even,
        _ => serialport::Parity::None,
    }
}

fn parse_stop_bits(bits: u8) -> serialport::StopBits {
    match bits {
        2 => serialport::StopBits::Two,
        _ => serialport::StopBits::One,
    }
}

fn parse_flow_control(fc: &str) -> serialport::FlowControl {
    match fc.to_lowercase().as_str() {
        "software" | "sw" | "xon" => serialport::FlowControl::Software,
        "hardware" | "hw" | "rts" => serialport::FlowControl::Hardware,
        _ => serialport::FlowControl::None,
    }
}