Configuration Commands

Commands for device configuration and persistent settings.

config

Get or set various configuration flags (requires ENABLE_CONFIG_COMMAND). Each option is a boolean toggle controlled by the _vna_mode bitfield in the config structure.

Syntax

config <option> [0|1]

Options

The available options depend on compile-time feature flags:

Option	Compile Flag	Description
`auto`	(always)	Automatic parameter selection (e.g., power, bandwidth)
`avg`	`__USE_SMOOTH__`	Enable trace averaging/smoothing
`connection`	`__USE_SERIAL_CONSOLE__`	Serial console connection mode
`mode`	(always)	Band selection mode
`grid`	(always)	Show grid values on display
`dot`	(always)	Dot-style trace rendering (vs. connected lines)
`bk`	`__USE_BACKUP__`	Backup mode
`flip`	`__FLIP_DISPLAY__`	Flip display 180 degrees
`separator`	`__DIGIT_SEPARATOR__`	Decimal separator style (0=`.` 1=`,`)
`tif`	`__SD_CARD_DUMP_TIFF__`	Save screenshots as TIFF instead of BMP

Examples

ch> config auto 1
ch> config flip 1
ch> config separator 0
ch> config grid 1
ch> config dot 0
ch> config tif 1

Notes

Each option maps to a bit in config._vna_mode via apply_VNA_mode()
The option index is position-dependent — changing compile flags shifts the indices
Use saveconfig to persist changes across power cycles

saveconfig

Save configuration to flash memory.

Syntax

saveconfig

What Gets Saved

The config_t structure containing:

Touch calibration data
VBat offset
Serial port settings
Display orientation
Color palette
UI mode flags
RTC calibration (if enabled)

Example

ch> config flip 1
ch> saveconfig

clearconfig

Reset configuration to defaults.

Syntax

clearconfig

Behavior

Erases configuration area in flash
Resets device

Example

ch> clearconfig
(device resets)

tcxo

Set or get TCXO reference frequency.

Syntax

tcxo [frequency_Hz]

Parameters

Parameter	Description	Default
`frequency_Hz`	Reference oscillator frequency	26000000

Examples

ch> tcxo
26000000

ch> tcxo 26001234

Usage

Adjust if measurements are consistently offset in frequency:

Measure a known-good signal or frequency reference
Calculate correction: new_tcxo = old_tcxo * (actual_freq / displayed_freq)
Set new value and verify

Notes

Typical TCXO accuracy is +/- 2.5 ppm
Small corrections (hundreds of Hz) are normal
Save with saveconfig after adjusting

threshold

Set harmonic frequency threshold.

Syntax

threshold [frequency_Hz]

Parameters

Parameter	Description
`frequency_Hz`	Frequency above which harmonics are used

Default Values

Mixer	Default Threshold
SA612A	290000110 Hz
ZeeTK NE602A	300000110 Hz

Examples

ch> threshold
300000110

ch> threshold 295000000

Usage

Adjust if seeing measurement artifacts near the threshold frequency.

vbat

Read battery voltage.

Syntax

vbat

Output

ch> vbat
3850 mV

Notes

Returns voltage in millivolts
Affected by vbat_offset correction
Typical Li-ion range: 3000-4200 mV

vbat_offset

Set battery voltage reading offset (requires ENABLE_VBAT_OFFSET_COMMAND).

Syntax

vbat_offset [offset_mV]

Parameters

Parameter	Description
`offset_mV`	Correction in millivolts

Examples

ch> vbat_offset
0

ch> vbat_offset -50

Calibration Procedure

Connect known voltage source or measure with multimeter
Read current display: vbat
Calculate offset: offset = actual_mV - displayed_mV
Set offset: vbat_offset <offset>
Save: saveconfig

color

Set display colors (requires ENABLE_COLOR_COMMAND).

Syntax

color [index] [rgb_value]

Color Indices

Index	Name	Default
0	BG_COLOR	0x0000 (Black)
1	FG_COLOR	0xFFFF (White)
2	GRID_COLOR	0x4208
3	MENU_COLOR	0xF7BE
4	MENU_TEXT_COLOR	0x0000
5	MENU_ACTIVE_COLOR	0xFFFF
6	TRACE_1_COLOR	0xFFE0 (Yellow)
7	TRACE_2_COLOR	0x07FF (Cyan)
8	TRACE_3_COLOR	0x07E0 (Green)
9	TRACE_4_COLOR	0xF81F (Magenta)
10	TRACE_5_COLOR	0xF800 (Red)
11	TRACE_6_COLOR	0x001F (Blue)
12	NORMAL_BAT_COLOR	0x07E0 (Green)
13	LOW_BAT_COLOR	0xF800 (Red)

RGB565 Format

Colors are 16-bit RGB565:

Bits 15-11: Red (5 bits)
Bits 10-5: Green (6 bits)
Bits 4-0: Blue (5 bits)

Examples

ch> color 6
65504

ch> color 6 0xF800
ch> color 7 0x07FF

usart / usart_cfg

Serial console configuration (requires ENABLE_USART_COMMAND).

usart - Select Console

usart [usb|serial]

Value	Description
`usb`	USB CDC console
`serial`	USART1 console

usart_cfg - Set Baud Rate

usart_cfg [baudrate]

Baud Rate	Value
9600	9600
19200	19200
38400	38400
57600	57600
115200	115200
230400	230400
460800	460800
921600	921600

Examples

ch> usart_cfg
115200

ch> usart_cfg 921600
ch> usart serial

time

RTC date/time operations (requires __USE_RTC__).

Syntax

time [YYMMDD] [HHMMSS]

Parameters

Parameter	Format	Description
`YYMMDD`	YYMMDD	Date (BCD format)
`HHMMSS`	HHMMSS	Time (BCD format)

Examples

ch> time
2024-01-15 14:30:45

ch> time 240115 143045

RTC Calibration

time cal [ppm]

Adjust RTC drift in parts per million.

touchcal

Calibrate touch screen.

Syntax

touchcal

Procedure

Touch the upper-left calibration point
Touch the lower-right calibration point
Calibration values are stored

Example

ch> touchcal
touch upper left
touch lower right
done
ch> saveconfig

touchtest

Test touch screen response.

Syntax

touchtest

Behavior

Displays touch coordinates continuously. Press push button to exit.

Example

ch> touchtest
100 150
102 148
...
(press push button to exit)

Source Code Reference

Configuration commands in main.c:

Command	Handler	Line	Compile Flag
`config`	`cmd_config`	547	`ENABLE_CONFIG_COMMAND`
`saveconfig`	`cmd_saveconfig`	713	(always)
`clearconfig`	`cmd_clearconfig`	721	(always)
`tcxo`	`cmd_tcxo`	1462	(always)
`threshold`	`cmd_threshold`	701	(always)
`vbat`	`cmd_vbat`	2568	(always)
`vbat_offset`	`cmd_vbat_offset`	2576	`ENABLE_VBAT_OFFSET_COMMAND`
`color`	`cmd_color`	2641	`ENABLE_COLOR_COMMAND`
`usart`	`cmd_usart`	2747	`ENABLE_USART_COMMAND`
`usart_cfg`	`cmd_usart_cfg`	2735	`ENABLE_USART_COMMAND`
`time`	`cmd_time`	653	`__USE_RTC__`
`touchcal`	`cmd_touchcal`	2335	(always)
`touchtest`	`cmd_touchtest`	2347	(always)