retrogram~soapysdr

	  _                                      /\/|____                         _________________ 
	 | |                                    |/\/  ___|                       /  ___|  _  \ ___ \
 _ __ ___| |_ _ __ ___   __ _ _ __ __ _ _ __ ___   \ `--.  ___   __ _ _ __  _   _\ `--.| | | | |_/ /
| '__/ _ \ __| '__/ _ \ / _` | '__/ _` | '_ ` _ \   `--. \/ _ \ / _` | '_ \| | | |`--. \ | | |    / 
| | |  __/ |_| | | (_) | (_| | | | (_| | | | | | | /\__/ / (_) | (_| | |_) | |_| /\__/ / |/ /| |\ \ 
|_|  \___|\__|_|  \___/ \__, |_|  \__,_|_| |_| |_| \____/ \___/ \__,_| .__/ \__, \____/|___/ \_| \_|
			 __/ |                                       | |     __/ |                  
			|___/                                        |_|    |___/                   

Wideband Spectrum analyzer on your terminal/ssh console with ASCII art. Hacked from Ettus UHD RX ASCII Art DFT code for SoapySDR. Adapted from retrogram~plutosdr / retrogram-rtlsdr.

[Tuning on VHF band while transmitting on 145.500 MHz with Handheld Radio]

[Spotting FCCH (Freq. Correction) burst in the local GSM BCCH (Broadcast Control Channel) @ 938.2 MHz]

Pan & Zoom spectrum using keyboard controls [decrement-Increment]. [Full feature demo based on retrogram-plutosdr]

• Center Frequency using keys [f-F]
• Sampling rate using keys [r-R]
• Bandwidth using keys [b-B]
• Reference level using keys [l-L]
• Dynamic Range using keys [d-D]
• Frame rate using keys [s-S]
• Peak Hold using keys [h-H]
• Tuning step using keys [t-T]
• Hide/Show controls using keys [c-C]
• Quit program using keys [q-Q]

Tuning step applies for decrementing / Incrementing Center Frequency and Sampling Rate.

---

retrogram~soapysdr - ASCII Art Spectrum Analysis for SoapySDR

Allowed options:
  --help                   help message
  --dev arg (=0)           soapysdr device index
  --rate arg (=1000000)    rate of incoming samples (sps) [r-R]
  --freq arg (=100000000)  RF center frequency in Hz [f-F]
  --frame-rate arg (=15)   frame rate of the display (fps) [s-S]
  --peak-hold (=false)  enable peak hold [h-H]
  --ref-lvl arg (=0)       reference level for the display (dB) [l-L]
  --dyn-rng arg (=80)      dynamic range for the display (dB) [d-D]
  --step arg (=100000)     tuning step for rate/bw/freq [t-T]
  --show-controls arg (=1) show the keyboard controls

---

Requires: libsoapysdr, libcurses, libboost-program-options

sudo apt install libsoapysdr-dev libncurses5-dev libboost-program-options-dev

Build:

For running on a Linux host:

make

Run:

./retrogram-soapysdr --dev 0 --rate 1.8e6 --freq 100e6 --step 1e5

TODO:

• Handle Gain adjustments
• Fix format conversions / normalization
• Direct Freq Entry / parameter change
• Mouse tuning
• Modularize / Optimize with std::vector transform
• Waterfall (!) / Markers / Demodulators (!!) :)
• HTML output / Web(sockets)-server