Getting Started with LimeSDR-USB and LimeSuiteGUI

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.