simple-scpi

A lightweight SCPI (Standard Commands for Programmable Instruments) command parser for Rust.

Define your instrument's command set as a table of pattern strings and handler functions, and the library takes care of parsing input lines — including short/long keyword forms, numeric suffixes, optional nodes, and compound commands.

Usage

use simple_scpi::{CommandSet, Command, Handler, Param};

let set = CommandSet::from_table(&[
    ("*IDN?",                       handle_idn  as Handler),
    ("SOURce#:FREQuency num",       handle_freq as Handler),
    ("SOURce#:VOLTage[:LEVel] num", handle_volt as Handler),
    ("OUTPut#:STATe bool",          handle_outp as Handler),
]).unwrap();

for cmd in set.parse("SOUR2:FREQ 1e6;OUTP1:STAT ON").unwrap() {
    set.dispatch(&cmd);
}

Each handler receives a &Command with parsed params and numeric suffixes:

fn handle_freq(cmd: &Command) {
    let Param::Numeric(f) = cmd.params[0] else { return };
    println!("ch{} freq = {f}", cmd.suffixes[0]);
}

See examples/demo.rs for a complete working example.

Pattern syntax

Multiple commands on one line are separated by ;.