2.1.7. X-Channel Streaming

Note

We have decided to use PRIMARY and SECONDARY device terminology instead of the standard MASTER and SLAVE device.

2.1.7.1. Overview

X-Channel streaming is suitable for applications that require multiple acquisition or generation channels.

Red Pitaya X-Channel streaming software provides the ability to stream analog and digital signals to client PCs from several Red Pitaya devices simultaneously, with synchronised clock and trigger among all Red Pitayas in the system.

Streaming can be done in both directions. Users can stream acquired analog and digital signals from Red Pitaya devices to a client computer or stream analog and digital signals from the client to Red Pitaya device outputs. The X-Channel streaming software also provides the ability to control streaming completely remotely from client PCs.

../../../_images/RPs_to_PC_conn.png

2.1.7.2. Setup

What do I need before I start?

The Red Pitaya STEMlab 125-14 X-Channel System consists of multiple Low-Noise STEMlab 125-14 devices that are modified for clock and trigger synchronization, and also comes with SATA synchronisation cables and software that supports X-Channel RF signal acquisition and generation.

../../../_images/Master_and_slaves.jpg

Notice that the Red Pitaya STEMlab 125-14 X-Channel System includes two types of devices:

  • one STEMlab 125-14 PRIMARY device (Low-Noise STEMlab 125-14 device)

  • one or more Low-Noise STEMlab 125-14 SECONDARY devices denoted by an “S” sticker

In order to achieve synchronization, the PRIMARY device provides a clock and trigger over the SATA S1 connector that is then connected to the S2 of the SECONDARY 1 board. SECONDARY1 then passes the clock forward to SECONDARY 2, SECONDARY2 to SECONDARY 3, and so on (SECONDARY N to SECONDARY N+1). This way, we can achieve synchronisation of all boards in the system.

Note

PRIMARY and SECONDARY boards do use different OS-es!

The PRIMARY runs the standard Red Pitaya device OS, while SECONDARY boards require a special OS that only supports X-channel streaming.

Due to frequent OS updates, it is recommended to always use the latest OS.

2.1.7.3. Connecting together

  1. Connect all Red Pitayas to the same network via ethernet cables (switch or router that is connected to the client PC).

    Note

    Make sure that your network can provide enough throughput for all the data you are about to stream. It is also recommended to use a dedicated network only for the X-channel system.

  2. Connect the SATA cables between the PRIMARY and SECONDARY devices.

    PRIMARY SATA S1 -> SECONDARY 1 SATA S2

    SECONDARY 1 SATA S1 -> SECONDARY 2 SATA S2

    SECONDARY 2 SATA S1 -> SECONDARY 3 SATA S2

    …

  3. Connect the power supply to the Red Pitaya board.

../../../_images/Master_and_slaves_2.jpg

2.1.7.4. Download and install an X-channel streaming client on your computer

  1. Connect to the PRIMARY board by entering the URL from the sticker into a web browser and launching the streaming app.

../../../_images/run_app.png

  1. Click the “Clients” button to get the client app for Linux or Windows and download it to your client computer.

../../../_images/download_client.png

2.1.7.5. Use case examples

Symultanious acquisiton of 6 input signals.

In this example, we will acquire data from all 3 RP units, which gives us 6 RF input channels.

PRIMARY_IP=192.168.2.141, SECONDARY1_IP=192.168.2.60 SECONDARY2_IP=192.168.2.25

  1. Open the streaming app on the PRIMARY and all SECONDARY boards via the WEB interface.

    Note

    The Streaming app can also be started via ssh by running /opt/redpitaya/bin/streaming-server.run.sh on the Red Pitaya.

  2. Configure the streaming parameters and configuration.

Configuration can be set over the WEB interface UI, which is then stored in /root/.streaming_config or /root/.config/redpitaya/apps/streaming/streaming_config.json (for version 2.00) on the Red Pitaya.

In this example, we will show how to set configuration remotely using an already prepared test.conf that will set all PRIMARY and SECONDARY devices to these settings.

../../../_images/settings.png 
rpsa_client.exe -c -h 192.168.2.141,192.168.2.60,192.168.2.25 -s F -f test.conf -v

2022.06.02-15.20.21.173:  Connected: 192.168.2.141
2022.06.02-15.20.21.176:  Connected: 192.168.2.25
2022.06.02-15.20.21.178:  Connected: 192.168.2.60
2022.06.02-15.20.21.278:  Send configuration to: 192.168.2.141
2022.06.02-15.20.21.291:  Send configuration to: 192.168.2.25
2022.06.02-15.20.21.291:  SET: 192.168.2.141 [OK]
2022.06.02-15.20.21.303:  Send configuration to: 192.168.2.60
2022.06.02-15.20.21.309:  Send configuration save command to: 192.168.2.141
2022.06.02-15.20.21.324:  SET: 192.168.2.25 [OK]
2022.06.02-15.20.21.332:  Send configuration save command to: 192.168.2.25
2022.06.02-15.20.21.337:  SET: 192.168.2.60 [OK]
2022.06.02-15.20.21.343:  Send configuration save command to: 192.168.2.60
2022.06.02-15.20.21.350:  SAVE TO FILE: 192.168.2.141 [OK]
2022.06.02-15.20.21.357:  SAVE TO FILE: 192.168.2.25 [OK]
2022.06.02-15.20.21.363:  SAVE TO FILE: 192.168.2.60 [OK]

  1. Start the X-channel streaming of 6 inputs

--streaming --host PRIMARY IP, SECONDARY1 IP, SECONDARY2 IP, --format=wav --dir=NAME
--limit=SAMPLES

rpsa_client.exe -s -h 192.168.2.141,192.168.2.60,192.168.2.25 -f wav -d ./acq -l 10000000 -v

2022.06.02-15.25.00.795:  Connected: 192.168.2.141
2022.06.02-15.25.00.798:  Connected: 192.168.2.25
2022.06.02-15.25.00.804:  Connected: 192.168.2.60
2022.06.02-15.25.00.907:  Send stop command to master board 192.168.2.141
2022.06.02-15.25.00.925:  Streaming stopped: 192.168.2.141 [OK]
2022.06.02-15.25.01.32:  Send stop command to slave board 192.168.2.25
2022.06.02-15.25.01.36:  Send stop command to slave board 192.168.2.60
2022.06.02-15.25.01.37:  Streaming stopped: 192.168.2.25 [OK]
2022.06.02-15.25.01.45:  Streaming stopped: 192.168.2.60 [OK]
2022.06.02-15.25.01.156:  Send start command to slave board: 192.168.2.25
2022.06.02-15.25.01.169:  Send start command to slave board: 192.168.2.60
2022.06.02-15.25.01.286:  Streaming started: 192.168.2.25 TCP mode [OK]
2022.06.02-15.25.01.307:  Streaming started: 192.168.2.60 TCP mode [OK]
2022.06.02-15.25.01.407:  Send start command to master board: 192.168.2.141
2022.06.02-15.25.01.542:  Streaming started: 192.168.2.141 TCP mode [OK]
2022.06.02-15.25.01.639:  Send start ADC command to slave board: 192.168.2.25
Run write to: ./1/data_file_192.168.2.25_2022-06-02_13-25-00.wav
Run write to: ./1/data_file_192.168.2.60_2022-06-02_13-25-00.wav
Run write to: ./1/data_file_192.168.2.141_2022-06-02_13-25-00.wav
2022.06.02-15.25.01.659:  Send start ADC command to slave board: 192.168.2.60
2022.06.02-15.25.01.660:  ADC is run: 192.168.2.25
Available physical memory: 16260 Mb
Used physical memory: 8130 Mb
Available physical memory: 16260 Mb
Used physical memory: 8130 Mb
Available physical memory: 16260 Mb
2022.06.02-15.25.01.741:  Connect 192.168.2.25
2022.06.02-15.25.01.730:  ADC is run: 192.168.2.60
Used physical memory: 8130 Mb
2022.06.02-15.25.01.752:  Connect 192.168.2.141
2022.06.02-15.25.01.764:  Connect 192.168.2.60
2022.06.02-15.25.01.826:  Send start ADC command to master board: 192.168.2.141
2022.06.02-15.25.01.834:  ADC is run: 192.168.2.141
2022.06.02-15.25.04.402:  Error 192.168.2.25
2022.06.02-15.25.04.408:  Error 192.168.2.141
2022.06.02-15.25.04.410:  Error 192.168.2.60
2022.06.02-15.25.04.415:  Send stop command to master board 192.168.2.141
2022.06.02-15.25.04.420:  Streaming stopped: 192.168.2.141 [OK]
2022.06.02-15.25.04.422:  Streaming stopped: 192.168.2.141 [OK]
2022.06.02-15.25.04.526:  Send stop command to slave board 192.168.2.25
2022.06.02-15.25.04.529:  Send stop command to slave board 192.168.2.60
2022.06.02-15.25.04.530:  Streaming stopped: 192.168.2.25 [OK]
2022.06.02-15.25.04.533:  Streaming stopped: 192.168.2.60 [OK]
2022.06.02-15.25.04.536:  Streaming stopped: 192.168.2.25 [OK]
2022.06.02-15.25.04.545:  Streaming stopped: 192.168.2.60 [OK]

2022.06.02-15.25.04.635 Total time: 0:0:2.794
=====================================================================================================================
Host              | Bytes all         | Bandwidth         |    Samples CH1    |    Samples CH2    |      Lost        |
+--------------------------------------------------------------------------------------------------------------------|
192.168.2.141     | 38.188 Mb         | 13.668 MB/s       | 10010624          | 10010624          |                  |
                  +...................+...................+...................+...................+ 0                |
                  |Lost in UDP: 0                         |Lost in file: 0                        |                  |
                  +...................+...................+...................+...................+                  |
192.168.2.25      | 38.188 Mb         | 13.668 MB/s       | 10010624          | 10010624          |                  |
                  +...................+...................+...................+...................+ 0                |
                  |Lost in UDP: 0                         |Lost in file: 0                        |                  |
                  +...................+...................+...................+...................+                  |
192.168.2.60      | 38.188 Mb         | 13.668 MB/s       | 10010624          | 10010624          |                  |
                  +...................+...................+...................+...................+ 0                |
                  |Lost in UDP: 0                         |Lost in file: 0                        |                  |
                  +...................+...................+...................+...................+                  |
=====================================================================================================================

  1. To view acquired data, drag the .wav files from /acq to Audacity.

../../../_images/audacity_2.png

In this example, a 1 kHz sinewave signal was connected to all 6 inputs.