Practical tricks and tips

Transcription

1 Gqrx SDR Open source software de ned radio by Alexandru Csete OZ9AEC Practical tricks and tips Written by Robert Lainé (robert.laine at sailcut.com), this document provides a practical introduction to getting started with gqrx. Table of contents 1. Installation 2. Starting gqrx 3. Using gqrx 4. Re ned settings 5. Applications Gqrx is a software de ned radio (SDR) receiver written by Alexandru Csete to control and use a variety of SDR hardware. The following describes the procedure to install gqrx and use it with a FunCube Dongle Pro+ receiver on an Asus Eeepc NoteBook setup with Linux Debian 8 and KDE. Earlier versions of Debian come with an older version of gqrx that may not have all the features described here. Installation In order to use gqrx you will need to install gnuradio and gqrx packages with the following command for Linux Debian: 1/20

2 $ sudo apt-get install gnuradio gqrx Once gnuradio and gqrx are installed (above procedure depends on which OS you are using): Connect the FunCube Dongle Pro+ receiver to the PC USB-2 port (do not use a USB-3 port as it may not work reliably on all PC). Use an USB extension cable for the connection to the PC to distance the receiver from the PC (hefty source of noise) and minimise the mechanical loads applied to the dongle connectors. Connect the antenna to the female SMA connector of the FunCube dongle. For HF and VHF, I found it convenient to use 1m of RG-174 coax terminated at one end with a male SMA and a male BNC at the other end such that I can reuse my HF antenna tuning box. Starting gqrx Having the device connected to the PC and the appropriate antenna, open a terminal and launch gqrx with the line command: $ gqrx The rst window to appear is for con guring the Input/Output of the device: 2/20

3 I/O device con guration dialog Make sure that the Device line shows the FunCube Dongle or the device you are using. Leave the other elds as they are then click OK. The main window of gqrx looks as below. 3/20

4 Gqrx main window. Activate gqrx by clicking on the grey start/stop button just below the File menu (see the red arrow pointing at the start/stop button). The central window should show something like below, and noise should be heard from your speaker or headphones, if not, check your audio volume control. 4/20

5 Gqrx main window while the application is running Using gqrx The upper part of the gqrx window proposes various roll-down menus: 1. File 2. Tools 3. View 4. Help Below these menus you nd a number of short-cut buttons: Start/stop (already used) Con gure I/O devices Load previously stored con guration 5/20

6 Save current con guration Record and Play I/Q data Con gure remote control settings Toggle full screen In the left part of the main window starting from the top you nd: The current frequency of the receiver (here MHz). Below the frequency is the RF spectrum frame around that frequency. Below the spectrum frame is the waterfall frame displaying the spectrum history. On the upper right side of the main window you will nd frames with tabs for the input and options of the Receiver, and lower right side frames with tabs for RF signal processing (FFT Settings) and Audio output control. The color of the spectrum display can be changed by the color line of the FFT setting tab. Tuning the receiver To tune the received frequency move the mouse pointer on any of the frequency digits and use the mouse wheel to change it. Alternatively you can move the pointer and click on the upper or lower part of any digit or use the Up/Down key to change it. Gqrx toolbar and main frequency control widget 6/20

7 Note that there is a second frequency displayed on the right frame of Receiver Options tab. It display the o set of the actual frequency from the central line of the main display frequency. Keep it to until you are familiar with all the functionalities of gqrx. Receiver options In the Upper right window appears either the Receiver Options or the Input controls depending on which tab you clicked on, as shown below: Gqrx receiver options The frequency windows allows you to o set the receiver actual frequency from the main frequency entered in the left window. It can be useful for e.g. weather fax reception as the frequency to be used is normally 1.9 khz below the nominal frequency of the station. Personally, I prefer to keep that o set frequency to 0.00 and set the main frequency. Filter and mode go together. Here it is shown for receiving weather fax, in USB and a Normal lter. 7/20

8 Mode setting is for the modulation mode of the signal received, it can be: CW-U or CW-L for Morse code On-O modulation (use Upper or Lower side band depending on possible interference from another carrier close by) USB or LSB for single side band amplitude modulation, Upper or Lower Side Band, WFM (stereo or mono) for Wide Frequency Modulation used by broad casting stations, Narrow FM for e.g. marine VHF, AM for old style Amplitude Modulation used by broadcasting stations, Raw I/Q is intended to pass raw I/Q data through without any demodulation; however, this mode has not been implemented yet, Demod O essentially turns o all signal processing. Gqrx can then stil be used to view the real time spectrum. Filter can be Normal, Narrow, Wide or user set. Narrow lters are useful against interference from stations on nearby frequencies but they also require more CPU power. The same applies for the lter shape: A lter with sharp edges will be better against interference but requires more computing. AGC can be set to O, User, Slow, Medium, Fast. Choose whichever best t the current propagation fading. I tend to use the Fast AGC mode. Squelch control is mainly used when you want to monitor a xed frequency, for example channel 16 ( MHz) of marine VHF or the local airport frequency. You can change the squelch level by entering the appropriate value in the line to the right of Squelch or you wait for a period when nobody is talking and click on the button A to right of the squelch level and it will automatically adjust the squelch level to that of the current background noise. Do not forget to lower again the squelch level when you change frequency or mode. NB1 and NB2 activate noise blankers for attenuating static and pulse type noise. Input controls frames 8/20

9 Gqrx input controls At the top there is a frame LNB LO for entering a Local Oscillator frequency in case to use an up or down converter in front of your SDR dongle. In all other cases keep it to MHz. Hardware AGC: Some hardware has built-in automatic gain control in either the RF front end of the IF stages. It saves ddling with the various manual gain settings. In some cases where you have serious interference from a local jammer you may have to switch o the AGC and tweak the various gains. Start by lowering the LNA and Mixer gain and look at the e ect on the RF spectrum. Swap I/Q: Swaps I and Q channels, normally you want to to leave it o. No limits: Leave it o recommended frequency domain., it is only if you want to use the sdr beyond its DC rem.: Tick it, it removes the DC bias often seen in direct conversion receivers. IQ bal.: leave it o unless you have ghost images in the spectrum. 9/20

10 Freq. Correction: a very useful feature to correct the error or drift in the dongle internal oscillator. To do that you need to tune to the nominal frequency of a the carrier of very well known station or even better to the frequency of a reference generator, then you adjust Freq.correction until the displayed frequency of the main window correspond to that of the reference signal. Remember that 10ppm is 10Hz of a 1MHz signal, 1.44kHz of a 144MHz signal, etc.) Once you have corrected the frequency, save the settings with the File Save settings menu (in Debian KDE these are save to ~/.conf/gqrx/default.conf) and write down the number of ppm entered in you preferred logbook together with the SDR device model/serial number such that you can monitor future drift or use it next time to use the SDR dongle on a di erent PC. Antenna: keep it to Rx, anyway there is no other option for the FunCube Dongle. Audio and FFT signal processing options frames Audio frame In the lower right window appears either the spectrum and controls of the Audio signal received or the FFT Settings depending on which tab you clicked on. 10/20

11 Gqrx audio options The Audio spectrum frame shows the spectrum of the demodulated signal. You can change the scale of the spectrum by click and drag the mouse pointer of the frequency scale, and move it right-left with the mouse wheel. The slider below the audio spectrum control the output level to the speaker/headphone. The Tool button (lower right) opens a window with a tab Recording in which you can change the directory in which gqrx will save audio signal received in a.wav le. Gqrx audio recording options The audio le name format will be: gqrx_yyyymmdd_hhmmss_frequency.wav yyyy is the year mm is the month dd is the day hhmmss the start hour, minutes,seconds frequency is the hardware in Hz The Network tab allows you to change the network port number to which the audio is sent. FFT Settings frame 11/20

12 Gqrx FFT settings The FFT Size is the number of points used in the FFT calculations. It determines the resolution of the plot. For example, if the bandwidth is 192 khz and FFT size is 4096, then the FFT resolution is / 4096 = Hz / FFT bin. An additional scaling takes place to convert from FFT bins to screen pixels. FFT Averaging is used to reduce the noise level. Gqrx uses adaptive averaging where the averaging factor depends on the signal level. This results in the noise oor being averaged more than strong signals enahncing the visual experience. The averaging only a ects the FFT plot / pandapter and not the waterfall. The Pandapter WF slider allows to modify the portion of the main display allocated to the spectrum and to the waterfall. The Peak D button will attach little circles to the peaks of the RF spectrum display. The Peak H buttons will display faintly the envelope RF spectrum. The Zoom R, C, D buttons are respectively for: 12/20

13 R = resetting the RF spectrum display to its 100% default value, C = centering the RF spectrum display around the original frequency D = centering the RF spectrum display around the demodulator frequency The Color selector changes the color of the RF spectrum display. The F button will ll / clear the space below the spectrum line with a color gradient. Re ned settings Changing the RF spectrum display You can change the frequency scale by placing the mouse pointer on the frequency scale at the bottom of the spectrum window and then click+drag right or left or using the mouse whell to stretch the display. You can reset the display with the Zoom R button in the FFT Settings frame. Changing the Receiver lter (user de ned) In the spectrum window, the grey band represent the width of the receiver lter. Its width depend on the Receiver Option chosen for the lter, here it is shown set as normal. You can also adjust the lter as you like by the following procedure: Make sure you have the Audio spectrum displayed such that you can see what you are doing. Move the mouse pointer over the grey band representing the current lter. Press and hold CTRL key + mouse wheel: change lter width 13/20

14 Press and hold SHIFT key + mouse wheel: change lter o set (to eliminate a spurious signal close to the carrier). The e ect will be seen in the Audio spectrum as a dip starting at the low frequencies) Gqrx lter adjustment Alternatively you can move the mouse pointer over the right edge of the grey band until it changes to an inclined double arrow, click and drag it. Same procedure to click and drag the lower frequency edge of the lter but much more di cult as the mouse pointer tend to grab the center frequency of the receiver rather than the lower edge of the lter. It sometime help to o set the receiver frequency from the central line by adding a few khz in the Receiver Options frequency window. Con gure I/O devices With the FunCube Dongle Pro/Pro+ there is nothing to change. TODO: explain the various settings for the RTL-SDR dongle. Applications Receiving weather faxes I use the FunCube Dongle Pro+ to receive weather faxes from Northwood UK. These are transmitted starting after the hour, simultaneously on the following frequencies: Nominal frequency Set gqrx to (+USB) Notes khz khz UTC khz khz UTC khz khz UTC 14/20

15 khz khz UTC The transmission is AM Upper Side Band and the weather picture modulation is using 2 tones at 1500 Hz (black) and 2300 Hz (white). It is necessary to set the receiver 1.9 khz below the nominal frequency of the transmitter and set the Receiver options Mode to USB with a Filter to Normal. Also make sure that you have set the Audio recording destination to a directory which is easily accessible. Once you get the start tone of the transmitter, immediately press on the Audio REC button to start record the demodulated signal, and wait for 11 minutes until the end of transmission. Meanwhile you can listen to the music of the image and very quickly you will recognise its various phases, in particular the end of image multi-tones. At this point in time you can press again on the Audio red button to stop the audio recording. Be ready for the next transmission which may starts about 45s after the end of a previous image. Once you have recorded an image you can visualise it with another sotware named hamfax written by Christof Schmitt, DH1CS, which is part of Debian distribution. You can install it using: $ sudo apt-get install hamfax Launch hamfax and click on the Receive / Recevoir tab at the top and make sure the receive from audio peripheral option is selected. Note that my installation of hamfax is in french, english text should be easily understood. 15/20

16 Hamfax main screen Open the audio le recorded with for exemple VLC and start playing it back. Monitor the audio level received by hamfax in the horizontal sub-window, and adjust the audio mixer such that the level is as high as possible but below continuous saturation. It can happen that your audio mixer is set to a low level for the gqrx output. Adjust it before you start recording. If for any reason hamfax did not start decoding the picture, it is most likely that you started to late recording the audio signal from gqrx and missed the syncronisation phase. The image is not all lost, it may just be truncated at the beginning! Just restart playing it back and use the Skip/Annuler button to launch the decoding without waiting the APT and Synchronisation phase. Once the image is complete (it takes about 12 minutes) use the Hamfax start/stop Skip/Annuler button to stop hamfax. The screen will most likely look like below: 16/20

17 Hamfax decoded image To correct the image slant use the Image menu and its correct slant option. After that you may still have to correct the position of the beginning of the lines, again with the appropriate option of the Image menu. The result should look like below: 17/20

18 Hamfax slant corrected image The horizontal grey lines are due to noise from poor reception of the signal. Some image processing can be use to remove that noise, if necessary. Finally save the decoded image for further processing. Note that by default hamfax save the image as yyyy-mm-dd-hh-mm-ss.png.png and it is easy to nd them in the directory from which you launched hamfax. I nd that the stored images are too stretched in the vertical dimension for reading them on the screen. I correct the vertical size with imagemagick tool convert as follow: First nd the size of the image: $ file png.png 18/20

19 it will return something like: png.png: PNG image data, 904 x 1259, 8-bit/color RGB, non-interlaced The PNG image is 904 pixel wide by 1259 high. Given the format of the fax transmitted should be about , use the following command to resize the image and remove one of the png extension such that it does not overwrite the original: $ convert png.png -resize 904x638\! png Notes on weather faxes reception problems encountered with a laptop: Both gqrx and image decoder process signals in real time. Some laptops have a somewhat slow processor and if you try to use gqrx simultanously with a fax decoder like hamfax ( digi is another fax decoder and it shows similar issues) then the image received may have lines which are o set from their normal position. This is due to time delays in the signal processing when the processor become overloaded. I found that having gqrx working alone and recording the image and then processing it with hamfax after I have nished receiving all images gives much better images quality. Laptops have a built in microphone and loudspeaker and when paying back the audio it can happen that the output of the loudspeaker is heard by the microphone and mixed with the audio stream picked up by hamfax or other fax reader. Obviously that degrades the quality of the image and it shows up as shadow to the right of the image! On my Asus EeePC, the only solution to get rid of this issue is to disconnect the internal microphone by plugging a dummy mic into the microphone jack. One could also use a headphone plugged into the 19/20

20 corresponding jack to disconnect the internal loudspeaker but that still leaves the internal microphone on and it will pick up ambien noise, furthermore you will then not hear the music of the image! Listening to HF radio To be written Listening to VHF marine stations To be written Author: Alexandru Csete All-round nerd and space hacker. Known as OZ9AEC on the air. View all posts by Alexandru Csete Alexandru Csete / April 22, 2015 / Documents / beginner, gqrx, hamfax, HF, linux, sdr, tutorial Ghostery blocked comments powered by Disqus. Gqrx SDR / Proudly powered by WordPress 20/20