2.1.6. Streaming

The Streaming application enables users to stream data from Red Pitaya to:

  • A file saved on the Red Pitaya SD card

  • A file saved on a remote computer via the ethernet protocol (UDP or TCP).

The user can set:

  • The sampling frequency (rate)

  • Input channel count (Channel 1, Channel 2, or Both (4 Channels for STEMlab 125-14 4-Input))

  • Input channel resolution (8 or 16 bits)

  • Input attenuation (HV/LV mode) (for 125-xx, a switch of the jumper is required)

  • Whether to use the calibration or not (for 125-xx, the filter is also calibrated)

  • RAW / Volts mode

  • The number of samples or unlimited sampling

Streamed data can be stored into:

  • Standard audio WAV file format

  • Technical Data Management Streaming (TDMS) file format

  • Fast and compact binary format (BIN). It can be converted to CSV format.

Max. streaming speeds are limited to:

  • 10 MB/s for streaming to an SD card (SD card class 10 is recommended for optimal streaming performance)

  • 20 MB/s for streaming over 1 Gbit network (A direct connection is recommended to achieve the best streaming performance)

Note

The maximum continuous streaming speeds are limited to the total input data rate, not the network transfer rates. If the maximum data rate is exceeded, the data pipeline inside Red Pitaya starts to clog, which leads to unpredictable behaviour. Here are a few examples of maximum data rates:

  • One channel, 8-bits per sample: Max sampling frequency 20 MHz.

  • One channel, 16-bits per sample: Max sampling frequency 10 MHz.

  • Two channels, 8-bits per sample: Max sampling frequency per channel 10 MHz (assuming same frequencies for both channels)

  • Two channels, 16-bits per sample: Max sampling frequency per channel 5 MHz (assuming same frequencies for both channels)

If acquiring a limited amount of samples in a short duration, it is possible to reach higher sampling frequencies (up to the sampling speed of fast analog inputs).

Note

We plan to expand the functionality by adding the generation to the Streaming application in the future. For now, it is possible for a user to implement it by themselves.

2.1.6.1. Getting started with the Red Pitaya streaming feature

  1. Run the Streaming app from the Red Pitaya Web interface

    ../../../_images/redpitaya_main_page.png
  2. Stream locally to a file

    1. Set the app’s properties & click RUN

      ../../../_images/to_file_settings.png

      Example: streaming on ch1, 8-bit resolution, 5.208 MS/s into TDMS file format

    2. Press STOP to stop streaming

    3. Click Browse to open the file browser and download the streaming data file

      ../../../_images/capture.png
    4. Open the file in a program that supports TDMS file reading, visualisation, and processing, such as DIAdem.

      ../../../_images/diadem_tdms_file_viewer.png
  3. Streaming to a remote computer

    1. Get the streaming client for your computer. Clients are located on the board itself and can be downloaded from there.

      ../../../_images/download_client.png
    2. Set the app’s properties & click RUN

      ../../../_images/tcp_settings.png

      Example: streaming on ch1, 16-bit resolution 5 MS/s, TCP

    3. Run the streaming app on a remote computer (copy the IP address from the web interface and choose the required file format).

    rpsa_client.exe -h 192.168.1.29 -p TCP -f ./ -t wav
    
    ../../../_images/tcp_client.png

    Data streaming can be stopped by pressing Ctrl + C.

    The created wav file can be read or viewed in Audacity:

    ../../../_images/audacity.png

2.1.6.2. Streaming application for the Desktop (Linux, Windows)

You can also use the desktop version of the client for streaming.

  1. Download the client

  2. Unzip and run the client

    Note

    For Linux clients, after unpacking, the files (rpsa_client_qt.sh, bin/rpsa_client_qt) must be made executable.

    ../../../_images/qt1.png

    For Windows clients, you need to grant access to the network.

  3. The running application automatically detects boards on the network if streaming is running on them. The boards and the client must be on the same network.

    ../../../_images/qt2.png