Getting Started with LimeSDR-USB and LimeSuiteGUI

Democratising Wireless Innovation
Jump to navigation Jump to search

Launching LimeSuiteGUI and connecting to the board

First of all, connect LimeSDR-USB board to PC USB3.0 socket. Please go Driver Installation Documentation to see how to install OS drivers so your PC can see LimeSDR-USB board. In the provided USB Flash there is a folder GUI in which you will find LimeSuiteGUI.exe file (or just download the software from here). Open it.

Figure 1. Opening LimeSuiteGUI.exe file


To launch LimeSuiteGUI application go to menu and select: Options -> Connection Settings as shown in Figure 2.

Figure 2. Opening connection settings


Select LimeSDR-USB board as shown in Figure 3 and press Connect.

Figure 3. LimeSuiteGUI select ports


Loading and saving register settings

In order to load settings, click button Open as shown in Figure 4.

Figure 4. Opening LimeSuiteGUI settings file


Select .ini setting file and click Open as shown in Figure 5.

Figure 5. Selecting LimeSuiteGUI settings file


Then click GUI --> Chip button as shown in Figure 6.

Figure 6. Sending LMS7002M settings from GUI to LimeSDR board


If you want load all LMS7002M settings from LimeSDR-USB to GUI, then click button Chip-->GUI as shown in Figure 7.

Figure 7. Sending LMS7002M settings from LimeSDR-USB to GUI


Quick Test

If there is a need to check if the board is fully working you can run very simple and quick board test. All instruction on how to do it you can find it in LimeSDR-USB Quick Test. One you see the graph as it show in Figure 8 of W-CDMA signal on FFT Viewer, you know that the board is working.

Figure 8. Performing Quick Test


Changing TX / RX Frequency

After power up in order to configure LMS7002M Tx or Rx LO to 2140 MHz, do the following:

  1. Select the SXR tab for Receiver or SXT tab for Transmitter
  2. Enable SXR/SXT module
  3. Type the wanted frequency in Frequency, GHz box. In this case, 800 MHz
  4. Press Calculate followed by Tune


See Figure 9 to check related controls in the LimeSuiteGUI.

Figure 9. SXR / SXT register setup procedure


Changing Receiver Gain

Select the RBB tab to configure the PGA gain and baseband filter bandwidths. Follow the configuration steps below:

  1. Select the A CHANNEL to control channel A
  2. Select PGA output to output pads. This selection enables receiver analog outputs
  3. Set PGA gain to -1 dB
  4. Configure filter bandwidth. Type desired bandwidth and click Tune


See Figure 10 below to check related controls in the LimeSuiteGUI.

Figure 10. RBB register setup procedure


Changing Transmitter Output Signal Gain

In the TBB tab the baseband gain and filter bandwidth are controlled. Follow the instructions below to set up TBB:

  1. Select the A CHANNEL to control channel A
  2. Set Frontend gain to your wanted
  3. Configure the base band filter settings. Type desired bandwidth and click Tune and Tune gain


See Figure 11 below to check related controls in the LimeSuiteGUI.

Figure 11. TBB register setup procedure


Load waveform for Tx Path

The programed FPGA is acting as waveform player for LMS7002M transceiver. In order to load the waveform, select Modules from top menu, then FPGA Controls from the drop down menu as shown in Figure 12.

Figure 12. Selecting FPGA Control window


New window will appear in the bottom of the GUI, offering you to load supplied waveforms or custom waveforms. Please select to load CW waveform by clicking on Onetone button, as shown in Figure 13.

Figure 13. Waveform selection


The file loading process to the FPGA is shown by indication bar, see Figure 14.

Figure 14. Loaded waveform indication


Digital Loopback Enable

There is also implemented option to receive data from LMS7002M receiver and stream back on to LMS7002M transmitter. In order to enable this option, click on the ‘Digital Loopback enable’ check box in the ‘FPGA Control’ Module Figure 15.

Figure 15. Select Digital Loopback enable


Run FTT viewer

FFTviewer module is a part of LimeSuiteGUI software. To run FFTviewer, go to top menu, select Modules and choose FFTviewer as shown in Figure 16.

Figure 16. LimeSuiteGUI module menu to select FFTviewer


FFTviewer control window will appear. Before start capturing data, set the Data reading type to “Packets MIMO”, Display channel and press Start, as shown in Figure 17 and Figure 18.

Figure 17. FFTviewer Controls


Figure 18. Setting data type to Packets MIMO


At this point, the FFTviewer start capturing data. Connect the generator to selected LimeSDR receiver path. In the Figure 19 showed the FFTviewer data capture with 1 MHz CW signal offset from LO.

Figure 19. FFTviewer window in operation


Manual Calibration of RX Path

Rx DC offset and Rx Unwanted SSB calibration routines have to be executed to calibrate receiver path. The Rx DC offset calibration split in two parts; Analog DC Offset calibration and digital DC offset removal procedure.

To execute Analog DC Offset calibration, select the RFE tab in the main GUI window. Make sure that you have selected channel A. In the DC box, change Mixer LO signal to 0.621 V and look for the best Offset I/Q values to reach minimum level of DC Offset. See Figure 20 below.

Figure 20. RX DC offset manual calibration


For residual DC offset calibration you need to enable the DC corrector in RxTSP tab. See Figure 21. It should be enabled (check box un-checked) by default.

Figure 21. Enable DC corrector in RxTSP


The unwanted SSB can be seen on FFTviewer window by applying signal to one of the transceiver inputs. See Figure 22.

Figure 22. Receiver spectrum with un-calibrated IQ imbalance


To calibrate RX IQ imbalance, go to RxTSP tab on LimeSuiteGUI GUI. On IQ Correction box adjust Gain ch. I or Gain ch. Q followed by Phase correction to reduce the Unwanted SSB. See Figure 23.

Figure 23. Rx IQ correction block


Calibrated receiver spectrum should look like in the Figure 24.

Figure 24. Calibrated Rx Spectrum


Manual Calibration of TX Path

The LO leakage and IQ imbalance have to be calibrated for the LMS7002M transceiver in order to get optimum performance for Tx EVM measurement. The IQ imbalance calibration is done by generating CW and adjusting IQ phase/gain error for IQ mismatch. Th LO leakage calibration is doem by adjust DC offset registers. The internal test NCO can be enabled for this purpose. To do this, select TxTSP tab in LimeSuiteGUI and select the Test Signal as input for Tx path and NCO as TSGMODE, as showed in figure below.

Figure 25. Enable the test NCO


NOTE: Before configuring TxTSP tab, select the A/RXT channel in top right of the GUI.

On the transmitter output you should see the wanted CW with 3.8MHz offset from LO, unwanted SSB on the other side of spectrum and LO leakage. See Figure 26.

Figure 26. Not calibrated Tx Output


To do the LO leakage calibration, select TxTSP tab in the LimeSuiteGUI GUI and adjust the DC Corrector settings (see Figure 27) for channel I and Q separately to get minimum LO leakage.

Figure 27. DC offset block control


To calibrate Unwanted SSB, use the IQ Corrector controls in the TxTSP tab. Change I ch. gain or Q ch. gain followed by Phase correction to reduce the Unwanted SSB as shown in Figure 28.

Figure 28. IQ Corrector block control


Calibrated Transceiver TX output should look like in the Figure 29.

Figure 29. Calibrated Tx output


Once TX is calibrated the settings can be saved and can be recalled after chip power cycle. After calibration is complete and configure Tx path to accept data from Stream board; go to TxTSP and select LML output under Tx Input Source has to be selected to in TxTSP tab. See Figure 25.

NOTE: The Tx IQ and LO leakage calibration procedure can be done using auto calibration routines. The routines are accessed from Calibration tab in the GUI.