tiny-wb/docs/tinysa-field-guide.md

315 lines
15 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# tinySA and tinySA Ultra field guide
This is the instrument-side reference for tiny-wb maintainers and users. It
summarizes the official documentation needed to identify, protect, configure,
and interpret the supported hardware. It does not replace the safety labels on
the device, and limits are not targets.
## Names and model identification
The product name is **tinySA** (tiny spectrum analyzer). The larger device is
**tinySA Ultra**—not “tinySAultra”—and newer variants are **tinySA Ultra+**.
Firmware and source code often use hardware-family names:
| Product | How to identify it | Firmware/source shorthand |
| --- | --- | --- |
| tinySA Basic | 2.8-inch, 320×240 display; separate `LOW` and `HIGH` SMA ports | tinySA / `TINYSA3` |
| tinySA Ultra ZS405 | Front says `Ultra`; 4-inch, 480×320 display | tinySA4 / `TINYSA4` |
| tinySA Ultra+ ZS406 | Front says `Ultra+`; rear label says ZS406 | tinySA4 / `TINYSA4` |
| tinySA Ultra+ ZS407 | Front says `Ultra+`; rear label says ZS407 | tinySA4 / `TINYSA4` |
“Ultra mode” is also the name of a high-frequency measurement mode on Ultra
hardware. Do not confuse the physical Ultra model with whether Ultra mode is
currently enabled.
Counterfeits exist. Prefer the sellers listed by the official project. The
official first-use guidance recommends authentic firmware and the built-in
self-test as checks; a clone can be electrically unsafe or behave differently
at the console.
## What the instrument is
A tinySA is a swept, scalar spectrum analyzer and a signal generator. In
analyzer mode it steps a local oscillator across a range, passes the selected
mixing product through a resolution filter, measures power, and reports level
at each step. It measures magnitude versus frequency, not phase, and it is not
a real-time analyzer. Signals shorter than the time spent away from their
frequency may be missed.
In generator mode the RF path is reconfigured to produce an output. Never
assume an SMA connector is an input merely because it was one earlier: confirm
the mode before connecting a device under test.
## Model capability summary
Values below summarize the official model comparison and specification pages.
Some limits depend on firmware, mode, frequency, attenuation, LNA state, and
hardware revision.
| Capability | Basic | Ultra ZS405 | Ultra+ ZS406 | Ultra+ ZS407 |
| --- | --- | --- | --- | --- |
| Display | 2.8 in, 320×240 | 4 in, 480×320 | same | same |
| Normal analyzer range | low 100 kHz–350 MHz; high 240–960 MHz | 100 kHz–800 MHz | 100 kHz–900 MHz | 100 kHz–900 MHz |
| Extended analyzer range | none | Ultra mode to about 5.3 GHz; calibrated to 6 GHz | Ultra mode to about 5.4 GHz; calibrated to 6 GHz | Ultra mode and calibrated range to 7.3 GHz |
| Harmonic observation | none | about 10 GHz | about 10 GHz | about 11 GHz |
| RBW selections | roughly 3–600 kHz | 0.2–850 kHz | same | same |
| Maximum displayed points | 290 | 450 | 450 | 450 |
| Step attenuator | 0–31 dB on low path | 0–31 dB when LNA is off | same | same |
| Internal LNA | none on standard low path | nominal 20 dB to 4 GHz | same | 20 dB to 7.3 GHz, about 15 dB to 9 GHz |
| Sine generator | 100 kHz–350 MHz | 100 kHz–800 MHz | 100 kHz–900 MHz | 100 kHz–900 MHz |
| Higher-frequency generator | square 240–960 MHz | square to 4.4 GHz / RF test to 5.3 GHz | square to 4.4 GHz / RF test to 5.4 GHz | square around 6 GHz / RF test to 7.3 GHz |
| Storage/audio | no microSD; audio requires modification | microSD up to 32 GB; headphone output | same | same |
The official Ultra specification lists ±2 dB absolute level accuracy after
level calibration over its main calibrated region, detector resolution of
0.5 dB, more than 1,000 points/s with the widest filters, and selectable
200 Hz, 1, 3, 10, 30, 100, 300, 600, and 850 kHz filters. Those headline values
do not mean every signal at every frequency is measured to ±2 dB: mismatch,
compression, images, correction tables, RBW, battery voltage, and Ultra-mode
limitations still apply.
## RF architecture
### tinySA Basic
The Basic exposes two distinct bidirectional RF ports and four broad modes:
- **Low input:** the higher-quality 100 kHz–350 MHz analyzer path with a
0–31 dB step attenuator and input filtering.
- **High input:** a 240–960 MHz path with frequency-dependent impedance, no
input band filter, no adjustable step attenuator, lower intercept point, and
greater susceptibility to overload, images, and out-of-band signals.
- **Low output:** a filtered sine source over roughly 100 kHz–350 MHz.
- **High output:** a square-wave source over roughly 240–960 MHz.
The 240–350 MHz overlap is useful: compare paths when a result is suspicious.
The low path is generally preferable where it covers the frequency.
### tinySA Ultra and Ultra+
Ultra uses one main RF SMA path and a separate calibration/output connector.
In analyzer mode the signal path is conceptually:
```text
RF SMA
-> select LNA or 0–31 dB attenuator
-> select 800 MHz low-pass filter, bypass, or direct path
-> swept first LO + mixer
-> ~980 MHz high-IF band-pass filter
-> receiver / second mixer
-> ~870 kHz low IF
-> selectable RBW filter
-> power detector
```
The low-pass filter suppresses aliases in the normal range. In Ultra mode it
is bypassed above its useful passband, allowing higher-frequency mixing but
also allowing many more images and spurs. Firmware makes multiple measurements
with shifted conditions to reject candidates that do not behave like a real
input signal.
In generator mode a nominal 980 MHz source, filter/mixer network, switching,
and attenuation are reused to create the requested output. Above the normal
sine range the user trades spectral cleanliness, frequency granularity, level
accuracy, and maximum frequency between “cleanest” square-wave and “highest
accuracy” RF-test modes.
The CAL source derives 30, 15, 10, 4, 3, 2, or 1 MHz from a temperature-
controlled 30 MHz oscillator. It is a useful internal reference, not a general
laboratory-grade calibrated generator across the analyzer's entire range.
## Ultra mode and harmonic mode
Ultra mode bypasses the input low-pass filter when needed and applies a
multi-measurement mirror/spur-removal algorithm. On the ZS405, the filter is
normally retained below roughly 750 MHz. Above that point scans slow down.
It works best for stable, narrowband signals. Important failure modes are:
- short bursts may be absent because repeated observations do not coincide;
- swept or hopping signals may be rejected or placed incorrectly;
- complex or wideband signals (official guidance flags roughly 600 kHz–1 MHz
width, depending on the page/firmware) can create false results;
- sensitivity deteriorates with frequency;
- bypassing the filter increases LO leakage at the RF connector, reported as
high as approximately −10 dBm;
- results beyond the level-calibrated range lack trustworthy
frequency-dependent amplitude correction.
A band-limited antenna or external preselector can reject unwanted mixing
products before they enter the analyzer. This is often better than asking the
algorithm to disambiguate every possible image.
Harmonic mode extends observation beyond the calibrated Ultra range by mixing
on a selected LO harmonic. Treat it as signal discovery, not calibrated level
metrology. The official best-settings guidance says harmonic selection should
normally remain at 3 and key expert settings should remain automatic.
## Safe operation: read before connecting a signal
Absolute maximum ratings prevent immediate damage; they do not guarantee
linearity or accurate measurement. Use the most conservative applicable limit.
### Core rules
- Keep Ultra/Ultra+ below **+6 dBm at 0 dB internal attenuation**. Basic's
published absolute RF limit at 0 dB attenuation is **+10 dBm**. The official
recommendation for automatic attenuation is no more than **0 dBm**, and best
accuracy is generally obtained with signal level below about **−25 dBm** at
the analyzer input stage.
- The latest official safe-operation table says to use a **DC block plus at
least 3 dB external attenuation above 5 V DC offset**. When the DC content is
unknown, use a suitably rated DC block.
- Do not trust the internal attenuator as the sole protection from a powerful
source. Place external attenuation directly at the analyzer so a failed
cable or incorrect mode cannot expose the input.
- Never connect a transmitter directly. The official minimum examples are
40 dB attenuation for 1 W, 50 dB for 10 W, and 60 dB for 100 W. Real setups
must also account for peak/envelope power, attenuator power rating, mismatch,
transients, and harmonics.
- Avoid the supplied telescopic antenna where static discharge or a nearby
transmitter is possible. Do not touch objects with it.
- After Basic self-test/calibration, disconnect the cable between LOW and HIGH
before enabling an output. Driving a connected input can destroy the input
attenuator.
- Confirm whether the RF port is in analyzer or generator mode before every
connection change.
### A practical transmitter setup
Use a rated dummy load or directional/attenuating sampler, followed by
power-rated coarse attenuation, then a sacrificial fixed attenuator (the
official example uses 30 dB) immediately at the tinySA. Calculate the expected
level in dBm and leave margin for modulation peaks. For harmonic measurements,
an external high-pass/low-pass/band-pass filter may be required to prevent the
fundamental from generating analyzer distortion that looks like DUT harmonics.
## Measurement controls and trade-offs
### Frequency span and sample points
Displayed or requested points are not identical to analog resolution. Point
spacing is approximately span divided by the number of intervals. Firmware may
insert hidden measurements so the RBW covers the span without gaps. More
points improve trace sampling but increase time and do not substitute for a
narrower RBW.
### Resolution bandwidth (RBW)
RBW is the bandwidth of the measurement filter:
- narrower RBW separates nearby carriers and lowers displayed noise;
- narrower RBW takes longer, particularly below 30 kHz;
- wider RBW scans quickly and captures more energy from modulated signals, but
merges close signals and raises the displayed noise floor.
Auto RBW is a good default. A wide span with a narrow fixed RBW can take a very
long time because firmware adds steps to maintain coverage.
### Attenuation and overload diagnosis
Internal attenuation trades sensitivity for headroom. Automatic mode aims to
keep the strongest signal at a safe internal level. To test whether a harmonic
or spur is generated inside the analyzer, increase external or internal
attenuation:
- a real input signal, after compensation, should remain near the same
reported level;
- an internally generated intermodulation product often falls or disappears
disproportionately;
- the noise floor rises because attenuation reduces signal before the
receiver.
The Basic high path has no normal adjustable attenuator and is easy to
overload. Strong out-of-band signals also reach it because it lacks an input
band filter.
### LNA
Ultra's LNA improves sensitivity for weak signals but disables the step
attenuator and greatly reduces overload headroom. Do not enable it around
unknown or strong signals. The model comparison reports a roughly −26.5 dBm
1 dB compression level with the LNA on for the ZS405, versus about +0.5 dBm
with it off. If a trace changes unexpectedly when the LNA is toggled, suspect
compression or intermodulation before assuming a real RF change.
### Repeat and averaging
The `repeat` console setting takes multiple measurements at each frequency and
reduces random noise at the cost of proportional scan time. Trace calculations
such as min hold, max hold, and averaging are separate firmware features. For
bursty signals, max hold across repeated sweeps is often more informative than
per-point averaging.
### Spur and image checks
When a line is questionable:
1. change attenuation and see whether its corrected amplitude behaves like the
wanted signal;
2. change span/RBW and repeat the sweep;
3. switch the Basic path in the overlap region or use below/above-IF controls;
4. enable automatic spur removal;
5. add an external preselector or filter;
6. compare against a known source or another analyzer.
Remember that the instrument's own 48 MHz MCU clock and harmonics can be
visible, especially with an antenna or low RBW.
## First use, calibration, and health checks
1. Charge the device. Ultra RF performance can degrade at low supply voltage;
official guidance recommends more than 3.9 V for best performance.
2. Record the hardware label and current `version`/`info` output.
3. If updating firmware, first run the self-test so pre-existing damage is not
confused with an update problem.
4. For the Basic self-test, connect LOW and HIGH with the supplied SMA cable
and run `CONFIG -> SELF TEST`.
5. Perform input level calibration as directed by the on-device menu. Basic low
level calibration uses the two ports connected; high-path calibration is a
separate procedure. Ultra correction/calibration varies by range and model.
6. Disconnect any calibration loop before enabling generator output.
Calibration corrects systematic level error; it cannot remove front-end
overload, RF mismatch, an image, a damaged switch, insufficient shielding, or
an invalid Ultra-mode measurement.
## Firmware update and recovery
Use the firmware file for the exact family:
- Basic: the `tinySA/DFU` tree;
- Ultra/Ultra+: the `tinySA4/DFU` tree.
Do not flash a similarly named file from the other family. Configuration data
may be reset or become structurally incompatible, so record unusual correction
settings and expect to redo calibration when appropriate.
Ultra enters recovery/DFU mode by holding the jog control while powering on;
the screen remains black. The Basic normally enters DFU from its menu, with a
documented PCB BOOT0 recovery procedure if an update is interrupted. The
official guide supports `dfu-util` and vendor tools. After updating, power-cycle
the unit, verify normal USB serial enumeration, check the version, clear stale
configuration when advised, and rerun self-test.
## Settings baseline for Ultra
For general use, leave these expert controls automatic unless a documented
experiment requires otherwise: spur removal, IF frequency, mixer drive, scan
speed, and below-IF choice. Keep harmonic at 3. The official best-settings page
also warns against casual AGC/LNA expert changes and against its then-current
FAST sweep mode. Because firmware evolves, confirm that advice against the
version installed on the instrument.
## How this maps to tiny-wb
tiny-wb detects Basic/Ultra families and applies model-specific input commands
and native encoding offsets. Generic Ultra support covers 0.1–800 MHz; a
detected ZS406 covers normal mode through 900 MHz and explicit opt-in Ultra mode
through 5.4 GHz. Harmonic reception, ZS407 extended mode and other extended
ranges remain unsupported; RF accuracy qualification remains pending. See
[support scope](ultra-support.md) and the [compatibility matrix](tiny-wb-operations.md#compatibility-matrix).
For the wire format and exact command behavior, continue with
[USB console and `scanraw` protocol](usb-protocol.md).