by Lime Microsystems

Flexible, next-generation, open source software-defined radio

View all updates Jul 01, 2019

Field Report: A bit pattern generator aligned with the SDR data stream

by Andrin D

Submitted by Andrin Doll, a researcher at the interface between magnetic resonance and technology who discovered the LimeSDR during his postdoc at CEA Saclay in France.

The LimeSDR devices provide a versatile transceiver that suits a number of applications that require reception and transmission at radio frequency. Of particular interest is the use of this low-cost SDR in scientific research and academia, as the frequency range is adapted to a number of experimental techniques. However, in order to incorporate an SDR into such experiments, synchronization with external devices is often crucial. In my case, the technique of interest is magnetic resonance with either nuclear spins or electron spins. I am pursuing these techniques within my postdoc fellowship at the CEA Saclay in France funded by the Swiss National Science Foundation (grant #177732).

In its basic version, the LimeSDR can synchronize its reference frequency to an external reference and synchronization between the TX and RX streams is facilitated by timestamps. Eight GPIO pins are available that can be controlled by the software. However, it is not possible to tie the GPIO state to the data stream, which would be required for basic synchronization with external devices. To achieve this, an augmented firmware has been developed by Prof. C. Michal, also in the context of magnetic resonance spectroscopy. In his firmware, the timestamp in the SDR is reset when a specific GPIO pin gets set to high. The LimeSDR can thus be triggered by an external device using this modified firmware.

In my application, the situation is reversed: It is the LimeSDR that triggers up to four external devices. In essence, I modified the FPGA firmware such that four GPIO outputs represent four bits of the TX stream. A TX data packet thus consists of 16 bits in total: 12 bits for the DACs and 4 bits for the GPIO. Importantly, the LimeSuite API already implements streams with 16-bit data, which is natural given the bus width of the USB interface. Accordingly, there was no need for me to make any changes in the API. One only needs to select the 16-bit data format in the API to avoid packaging three 12 bit samples into two 16 bit samples. Moreover, when I studied the FPGA firmware, I realized that the data actually remain 16 bits for quite a while. There are only a few instances before the data is sent from the FPGA to the LimeSDR where the four bits are normally discarded (look for ‘inst2_fifo_q’ in tx_path_top.vhd). In the modified firmware, these four bits remain together with the DAC data up to the double data rate (DDR) bus at the output and are then routed to the GPIO pins.

Schematic showing the four GPIO bits (red) embedded into the TX stream & routed to the output pins

A notable detail is that the stream data for the DACs are complex I/Q pairs. As a result, the sampling rate of the GPIO outputs will be twice the sampling rate of the SDR, unless you interpolate your TX data downstream in the TSP to a faster rate. I tested this both on a LimeSDR mini, where I implemented it first, and on a LimeSDR USB. With the LimeSDR USB, one needs to take care of all the MUX positions in txiq.vhd, so that the alignment is preserved across the different MIMO modes. In order to ease the distribution of the GPIO signals, I made a companion board that buffers the signals to 5 V TTL level with low-impedance line buffers. Indeed, the principal challenge at this point was to acquire the details on what’s going on in the API/firmware. At the same time, this is also the main advantage of the MyriadRF project’s open source nature. I was able to learn a lot from going through the API and FPGA code.

I then went to the lab with the augmented LimeSDR USB and successfully set up two experiments. The details of these experiments are beyond the scope of this field report and will be detailed in a scientific publication, together with the underlying source code and firmware. Here, I will just give a rough sketch.

Both experiments are built around an RF coil that is tuned to the desired frequency and contains the sample. The RX and TX channel are both connected to this coil (via external amplifiers) and isolated from each other by passive means. The first experiment is a basic pulsed nuclear magnetic resonance (NMR) experiment. In this experiment, a strong and short RF pulse is required, namely a few tens of volts for few microseconds. After this pulse, a rather weak nuclear induction signal can be captured by the RX. The frequency of the experiment is determined by the magnetic field applied to the spins. In my case, the field was 0.7 T, which prescribes a frequency of 30 MHz. The GPIO was used here to activate the high power amplifier during the pulse duration – otherwise, the output noise from the power amplifier would swamp the RX during reception. In other words, passive isolation is often insufficient for this type of experiment and the GPIO provides the time-critical trigger for active isolation.

Hardware setup for pulsed NMR

The second experiment is a basic continuous-wave (CW) electron spin resonance (ESR) experiment. Here, I applied a field of 5 mT to the sample, which sets the experiment’s frequency to 150 MHz. However, the magnetic field in CW ESR is not static, it wobbles slightly with a modulation frequency in the kHz range. Thanks to this wobbling, the spin signal appears on sidebands around the 150 MHz carrier that is incidental on the sample. Traditionally, excitation and detection of this wobbling involve a lock-in amplifier at the modulation frequency. When using the LimeSDR for this, the missing part is the modulation frequency in the kHz range. One can easily add a sine-wave generator that shares the reference clock with the LimeSDR. However, this only works to a limited extent, since the phase between the external sinewave and the SDR data stream will be different for each time the experiment is run.

Sample spectra

Accordingly, I use a GPIO pin to generate a square wave of 105 kHz, which always has the same phase as the SDR data stream (up to a phase shift of 180 degree that can arise due to the clock management within the LimeSDR). Using opamps and extensive low-pass filtering, the square wave is transformed into a sine with the proper characteristics for the experiment. As a result, I can extract the spin signal on the modulation sideband. Overall, the GPIO was here used to synthesize a kHz oscillator with its phase tied to the SDR stream. It is actually not yet working perfectly, as I always see a small sideband around the carrier. This is most likely due to unwanted coupling between the kHz square wave and the RF. For the moment, this adds a constant offset to my spectra, which is acceptable (and actually allows the determination of the phase of 180 degrees mentioned just above). In the longer run, one could elaborate on this further. A more versatile, better performing design could be achieved with an external DDS that runs on the LimeSDR reference clock. By resetting the DDS phase with a GPIO output, a reproducible phase relation could be established.

Did you do something cool with a Crowd Supply project? Let the world know by submitting your own Field Report!

About the Author

Andrin D

 Paris, France

$3,458,343 raised

of $500,000 goal

691% Funded! Order Below

Product Choices


LimeSDR USB Type-A

The LimeSDR is based on Lime Microsystem’s latest generation of field programmable RF transceiver technology, combined with FPGA and microcontroller chipsets. These connect to a computer via USB 3 with a Type-A connector. LimeSDR then delivers the wireless data and the CPU provides the computing power required to process the incoming signals, and to generate the data to be transmitted by the LimeSDR to all other devices.


Acrylic Case

A layered acrylic case to protect your LimeSDR. Antenna not included - separate purchase available.


Lime AC Tetra Case

From the Lime AC Case project.

An aluminum case for LimeSDR USB Type-A, with one fan and 12 U.FL-to-SMA cables. This case allows for all on-board RF and CLK lines to be externally available.


LimeSDR with Aluminum Kit

Start developing apps based on Lime Microsystem’s latest generation of field programmable RF transceiver technology. This board comes with fancy aluminum casing. The board will be delivered with turnkey support for a diverse range of SDR ecosystem software, a powerful API and rapid prototyping environment. All the boards in this category will come with a fancy Aluminum casing coated with high quality material, cables, and antennas for a quick set up.


Ultimate LimeSDR With PCIe Interface

Start developing apps based on Lime Microsystem’s latest generation of field programmable RF transceiver technology. The board will be delivered with turnkey support for a diverse range of SDR ecosystem software, a powerful API and rapid prototyping environment. All the boards in this category will come with a PCIe interface, cables and Antennas for a quick set up.


Multi-band 4G/3G/2G Monopole Antenna

From the Crowd Supply Basics project.

Use one antenna for each of LimeSDR's four channels. Connect each antenna to the LimeSDR using a U.FL-to-SMA cable.

A TG.09 4G/3G/2G cellular hinged SMA(M) mount monopole antenna.


U.FL-to-SMA Cable

From the Crowd Supply Basics project.

Use one cable for each of LimeSDR's four channels. The 100 mm version works well with the Acrylic Case.

A Hirose U.FL to SMA (jack) bulkhead straight connector with a 1.32 mm diameter cable. Less than -2 dB cable insertion loss up to 6 GHz. Both connectors are gold-plated brass and the cable conductor is silver-coated copper.


GPIO Board

This stackable expansion board for the LimeSDR provides individually settable, bi-directional level-shifted I/O for FPGA GPIO 0-7. Each I/O has a high-voltage and power Darlington drive stage suitable for inductive loads, such as coaxial relays. LimeSDR not included.


Lime Microsystems

Working toward the democratization of wireless communication through an open source ideology.

Jessica Gillingham

Christy Chuang

Ebrahim Bushehri

Andrew Back

Zack Tamosevicius

Richard Jonaitis

Josh Blum

Lexi Hatziharalambous

Karolis Kiela

Andy Chang

ASE Group

IC manufacturer

See Also

Subscribe to the Crowd Supply newsletter, highlighting the latest creators and projects: