Recent Changes - Search:

PmWiki

pmwiki.org

edit SideBar

USB Interface

After connecting the tinySA to a PC using the a USB cable a serial interface will become available on the PC. Drivers for the serial interface over USB will be automatically installed on Windows and are already builtin in most Linux kernels The serial interface supports a large set of commands. You can always use the help command to get a list of the available commands

There is limited error checking against incorrect parameters of incorrect mode

  • Frequencies can be specified using an integer optionally postfixed with a the letter 'k' for kilo 'M' for Mega or 'G' for Giga. E.g. 0.1M (100kHz), 500k (0.5MHz) or 12000000 (12MHz)
  • Levels are specified in dB(m) and can be specified using a floating point notation. E.g. 10 or 2.5
  • Time is specified in seconds optionally postfixed with the letters 'm' for mili or 'u' for micro. E.g. 1 (1 second), 2.5 (2.5 seconds), 120m (120 milliseconds)

Commands:

attenuate
sets the internal attenuation to automatic or a specific value
usage: attenuate [auto|0-31]
bulk
send by tinySA when in auto refresh mode
format: "bulk\r\n{X}{Y}{Width}{Height}{Pixeldata}\r\n"
where all numbers are binary coded 2 bytes little endian. The Pixeldata is encoded as 2 bytes per pixel
calc
sets or cancels one of the measurement modes
usage: calc off|minh|maxh|maxd|aver4|aver16|quasip
the commands are the same as those listed in the MEASURE menu
caloutput
disables or sets the caloutput to a specified frequency in MHz
usage: caloutput off|30|15|10|4|3|2|1
capture
requests a screen dump to be send in binary format of 320x240 pixels of each 2 bytes
clearconfig
resets the configuration data to factory defaults
usage: clearconfig 1234
color
sets or dumps the colors used
usage: color [{id} {rgb24}]
correction
sets or dumps the frequency level correction table
usage: correction [0..9 {frequency} {level}]
dac
sets or dumps the dac value
usage: dac [0..4095]
data
dumps the trace data
usage: data 0..2
0=temp value, 1=stored trace, 2=measurement
deviceid
sets of dumps a user settable number that can be use to identify a specific tinySA
usage: deviceid [{number}]
fill
send by tinySA when in auto refresh mode
format: "fill\r\n{X}{Y}{Width}{Height}{Color}\r\n"
where all numbers are binary coded 2 bytes little endian.
freq
pauses the sweep and sets the measurement frequency
usage: freq {frequency}
frequencies
dumps the frequencies used by the last sweep
usage: frequencies
if
sets the IF to automatic or a specific value
usage: if ( 0 | 433M..435M )
where 0 means automatic
info
displays various SW and HW information
help
dumps a list of the available commands
usage: help
hop (Ultra only)
measures the input level at each of the requested frequencies
usage: hop {start(Hz)} {stop(Hz)} {step(Hz) | points} [outmask]
If the 3rd parameter is below 450 it is assumed to be points, otherwise as step frequency
Outmask selects if the frequency (1) or level (2) is output.
level
sets the output level
usage: level -76..13
Not all values in the range are available
levelchange
sets the output level delta for low output mode level sweep
usage: levelchange -70..+70
leveloffset
sets or dumps the level calibration data
usage: leveloffset low|high|switch [output] {error}
For the output corrections first ensure correct output levels at maximum output level. For the low output set the output to -50dBm and measure and correct the level with "leveloffset switch error" where
For all output leveloffset commands measure the level with the leveloffset to zero and calculate
error = measured level - specified level
load
loads a previously stored preset
usage: load 0..4
where 0 is the startup preset
marker
sets or dumps marker info
usage: marker {id} on|off|peak|{freq}|{index}
where id=1..4 index=0..num_points-1
Merker levels will use the selected unit
Marker peak will activate the marker (if not done already), position the marker on the strongest signal and display the marker info
The frequency must be within the selected sweep range
menu
The menu command can be used to activate any menu item.
usage: menu {#} [{#} [{#} [{#}]]]
where # is the menu entry number starting with 1 at the top.
Example: menu 6 2 will toggle the waterfall option
mode
sets the mode of the tinySA
usage: mode low|high input|output
modulation
sets the modulation in output mode
usage: modulation off|AM_1kHz|AM_10Hz|NFM|WFM|extern
ext_gain
sets the external attenuation/amplification
usage: ext_gain -100..100
Works in both input and output mode
output
sets the output on or off
usage: output on|off
pause
pauses the sweeping in either input or output mode
usage: pause
rbw
sets the rbw to either automatic or a specific value
usage: rbw auto|3..600
the number specifies the target rbw in kHz
recall
same as load
refresh
enables/disables the auto refresh mode
Usage refresh on|off
release
signals a removal of the touch
usage: release
remark
does nothing
usage: remark use any text
reset
resets the tinySA
usage: reset
resume
resumes the sweeping in either input or output mode
usage: resume
save
saves the current setting to a preset
usage: save 0..4
where 0 is the startup preset
saveconfig
saves the device configuration data
usage: saveconfig
scan
performs a scan and optionally outputs the measured data
usage: scan {start(Hz)} {stop(Hz)} [points] [outmask]
where the outmask is a binary OR of 1=frequencies, 2=measured data, 4=stored data and points is maximum 290
scanraw
performs a scan of unlimited amount of points and send the data in binary form
usage: scanraw {start(Hz)} {stop(Hz)} [points]
The measured data is the level in dBm and is send as '{' ('x' MSB LSB)*points '}'. To get the dBm level from the 16 bit data, divide by 32 and subtract 128.
selftest
performs one or all selftests
usage: selftest 0 0..9
spur
enables or disables spur reduction
usage: spur on|off
sweep
set sweep boundaries or execute a sweep
usage: sweep [ ( start|stop|center|span|cw {frequency} ) | ( {start(Hz)} {stop(Hz)} [0..290] ) ]
sweep without arguments lists the current sweep settings, the frequencies specified should be within the permissible range. The sweep commands apply both to input and output modes
sweeptime
sets the sweeptime
usage: sweep {time(Seconds)}the time specified may end in a letter where m=mili and u=micro
text
specifies the text entry for the active keypad
usage: text keypadtext
where keypadtext is the text used
Example: text 12M
threads
lists information of the threads in the tinySA
touch
sends the coordinates of a touchusage: touch {X coordinate} {Y coordinate}
The upper left corner of the screen is "0 0"
touchcal
starts the touch calibration
touchtest
starts the touch test
trace
displays all or one trace information or sets trace related information
usage: trace [ {0..2} | dBm|dBmV|dBuV|V|W |store|clear|subtract | (scale|reflevel) auto|{level}
trigger
sets the trigger type or level
usage: trigger auto|normal|single|{level(dBm)}
the trigger level is always set in dBm
vbat
displays the battery voltage
vbat_offset
displays or sets the battery offset value
usage: vbat_offset [{0..4095}]
version
displays the version text
Edit - History - Print - Recent Changes - Search
Page last modified on July 21, 2023, at 12:10 PM