Tool Reference

Measurement Tools

Tool	Description
`info`	Get device info (firmware, serial, frequency range)
`sweep`	Set sweep range (start, stop, points)
`scan`	Run measurement scan, return S-parameter data
`data`	Get current trace data without new measurement
`frequencies`	Get frequency list for current sweep
`marker`	Set/read marker position and values
`cal`	Run calibration step (open, short, load, thru, isoln, done)
`save`	Save calibration to flash slot
`recall`	Recall calibration from flash slot
`pause`	Pause continuous sweep
`resume`	Resume continuous sweep

Configuration Tools

Tool	Description
`power`	Set/get output power level
`bandwidth`	Set/get IF bandwidth
`edelay`	Set/get electrical delay compensation
`s21offset`	Set/get S21 offset correction
`vbat`	Read battery voltage
`capture`	Capture LCD screenshot (PNG)
`measure`	Set measurement mode
`config`	Get full device configuration
`saveconfig`	Save configuration to flash
`clearconfig`	Reset configuration to defaults
`color`	Set/get display colors
`freq`	Set single frequency (CW mode)
`tcxo`	Set/get TCXO calibration
`vbat_offset`	Set/get battery voltage offset
`threshold`	Set/get measurement thresholds

Display Tools

Tool	Description
`trace`	Configure trace display settings
`transform`	Enable/configure time domain transform
`smooth`	Set trace smoothing
`touchcal`	Run touchscreen calibration
`touchtest`	Test touchscreen
`refresh`	Force display refresh
`touch`	Simulate touch press
`release`	Simulate touch release

Device Tools

Tool	Description
`reset`	Reset device
`version`	Get firmware version
`detect`	Detect and connect to VNA
`disconnect`	Close serial connection
`raw_command`	Send raw command to device
`cw`	Set continuous wave output
`sd_list`	List SD card files
`sd_read`	Read file from SD card
`sd_delete`	Delete file from SD card
`time`	Get/set device time

Diagnostics Tools

Tool	Description
`i2c`	I2C bus diagnostics
`si`	Si5351 clock chip status
`lcd`	LCD controller info
`threads`	FreeRTOS thread status
`stat`	System statistics
`sample`	Raw ADC samples
`test`	Run self-test
`gain`	Set/get receiver gain
`dump`	Memory dump
`port`	Port configuration
`offset`	Calibration offsets
`dac`	DAC control
`usart_cfg`	USART configuration
`usart`	USART I/O
`band`	Band settings

Analysis Tools

Tool	Description
`analyze`	Full scan analysis (SWR, Z, return loss)
`export_touchstone`	Export to .s1p/.s2p format
`export_csv`	Export to CSV format
`analyze_filter`	Characterize filter response
`analyze_xtal`	Extract crystal parameters
`analyze_tdr`	Time domain reflectometry
`analyze_component`	Identify unknown L/C/R
`analyze_lc_series`	Measure series LC resonator
`analyze_lc_shunt`	Measure shunt LC resonator
`analyze_lc_match`	Design L-network matching
`analyze_s11_resonance`	Find S11 resonance points

Radiation Pattern Tools

Tool	Description
`radiation_pattern`	Generate 3D pattern from S11 scan
`radiation_pattern_from_data`	Generate pattern from known impedance
`radiation_pattern_multi`	Multi-frequency pattern comparison

Pattern Import Tools

Tool	Description
`import_pattern_csv`	Import from CSV file
`import_pattern_emcar`	Import from EMCAR vna.dat
`import_pattern_nec2`	Import from NEC2 output
`import_pattern_s1p`	Import from Touchstone S1P
`list_pattern_formats`	List supported import formats

Coordination Tools

Manage and synchronize multiple NanoVNA devices simultaneously.

Device Management

Tool	Description
`list_devices`	List all connected VNAs with status and capabilities
`refresh_devices`	Re-scan USB ports for hot-plugged devices
`set_default_device`	Set default VNA for subsequent calls
`clear_default_device`	Clear default, require explicit device_id
`detect_capabilities`	Check hardware trigger and clock support

Tier 1: Software Synchronization

Tool	Description
`sync_sweep`	Software-coordinated parallel sweep (±2-5ms)
`multi_antenna_compare`	Compare S11 across multiple antennas
`differential_s21`	Two-VNA transmission measurement

Tier 2: Hardware Trigger

Requires custom firmware and physical trigger wiring. See VNA Trigger Wiring for hardware setup.

Tool	Description
`set_trigger_mode`	Configure hardware trigger mode
`hardware_sync_sweep`	Hardware-triggered sync sweep (±10-50µs)

Tier 3: Phase Coherent

Requires external 26 MHz clock reference plus Tier 2. See VNA External Clock for hardware modification guide.

Tool	Description
`set_clock_reference`	Set internal/external clock reference
`phase_coherent_sweep`	Phase-coherent sweep with shared clock (±1°)

Smart Coordination

Tool	Description
`coordinated_sweep`	Auto-selects best available sync method

Example Usage

User: Scan my antenna from 144 to 148 MHz with 201 points

Calls: sweep(144000000, 148000000, 201)
Calls: scan(s11=true)
Calls: analyze()

User: Analyze this bandpass filter from 1 to 500 MHz

Calls: sweep(1000000, 500000000, 201)
Calls: analyze_filter()

User: Calibrate for the 2m band

Calls: sweep(144000000, 148000000, 101)
Calls: cal("load")   # user connects load
Calls: cal("open")   # user connects open
Calls: cal("short")  # user connects short
Calls: cal("thru")   # user connects through
Calls: cal("done")
Calls: save(0)

User: Compare my two 2m antennas simultaneously

Calls: list_devices()
# Returns: [{id: "0001234567", ...}, {id: "0007654321", ...}]

Calls: sync_sweep(
  device_ids=["0001234567", "0007654321"],
  start_hz=144000000,
  stop_hz=148000000,
  points=101
)
Calls: multi_antenna_compare()