Red Pitaya Quick Start

Table of content:
Welcome to the comprehensive guide designed to help you seamlessly integrate Red Pitaya into your projects. Whether you're a beginner or an experienced user, this guide serves as your roadmap through the initial setup, connectivity options, SD card preparation, and troubleshooting with an extensive FAQ section. Each segment of the guide is meticulously crafted to provide you with detailed instructions, tips, and solutions to common issues you might encounter along the way.

What do I need before I start?

💡
This segment of the quick start documentation outlines the essential items and preliminary steps necessary for setting up your Red Pitaya board. It lists the components included with each Red Pitaya kit, additional items needed, and critical advice on using an appropriate power supply to ensure the device functions correctly without issues.
The following essential items needed to start are already included in each of the RedPitaya kits available on our WEB store:
125-10, 125-14, 122-16, 125-14 4-Input
  • 5 V / 2 A micro USB power supply,
  • 4 GB (up to 32 GB) Class 10 micro SD card with pre-loaded Red Pitaya OS,
  • Ethernet cable.
Additional required items which are not provided with the Red Pitaya kits:
  • A computer with an internet browser (Google Chrome is recommended),
  • router with DHCP server enabled and access to the internet.
Note
Red Pitaya boards should not be powered by a power supply that provides less power than specified or has very thin power wires, since this will result in abnormal behaviour of the device, causing reboots and network disconnections. The same problem might appear if the Red Pitaya board is powered directly from USB on a PC or HUB that cannot provide enough power or when using a bad power cable.

Connect to Red Pitaya

💡
This section breaks down the process into manageable steps, starting from connecting the board to a router, powering the device, and finally accessing Red Pitaya's applications through a web browser by navigating to a URL unique to the board's MAC address. Detailed instructions, supplemented with visual aids, ensure a straightforward setup process for users of all technical levels.
This is the most common and recommended way of connecting and using your Red Pitaya boards. Your LAN network must have DHCP settings enabled which is true with most local networks. With this, a simple plug and play approach is enabled. Having a Red Pitaya board connected to the local network will enable quick access to all Red Pitaya applications using only your web browser.
Follow these three simple steps to start using your Red Pitaya:
125-10, 125-14, 122-16, 125-14 4-Input
1. Connect your Red Pitaya board to the router
2. Connect the power supply to the Red Pitaya board
3. Open your web browser and type rp-xxxxxx.local/ into the address bar
notion image
💡
Note
xxxxxx are the last six characters of the MAC address of your Red Pitaya board. The MAC address is written on the Ethernet connector.
After the third step, you will get a Red Pitaya main page, as shown below.
notion image
Red Pitaya’s main page user interface.
Note
For any issues during setup, check troubleshooting or look on the forum for a solution. If you cannot find a solution, please post your problem, providing as much detail as possible.

Connection types

For detailed instructions on connection types, please check out the sections below:
💡
Note
Windows 7/8
 users should install Bonjour Print Services, otherwise access to *.local addresses will not work.
Windows 10 or higher already supports mDNS and DNS-SD, so there is no need to install additional software.
💡
Note
Access to the internet is only required when:
  • using the OS update application,
  • installing applications from the marketplace.
💡
Click on arrow to expand Wired or Wireless section

Wired

Local Area Network (LAN)

This is the most common and recommended way of connecting and using your Red Pitaya boards. Your LAN network needs to have DHCP settings enabled, which is the case in the majority of the local networks. With this, a simple plug and play approach is enabled. Having the Red Pitaya board connected to the local network will enable quick access to all Red Pitaya applications using only your web browser. Simply follow these 3 simple steps:
  1. Connect the power supply to the Red Pitaya board,
  1. Connect the Red Pitaya board to the router or directly to the PC Ethernet socket,
  1. Open your web browser and type: rp-xxxxxx.local/ into the URL field.
Note
xxxxxx are the last 6 characters from the MAC address of your Red Pitaya board. The MAC address is written on the Ethernet connector.
notion image
Figure 1: Connecting your Red Pitaya board to the LAN network.
After the third step you will get a Red Pitaya main page as shown below.
notion image
Figure 2: Red Pitaya main page user interface.

Direct Ethernet cable connection

Plug the ethernet cable from your PC to the Red Pitaya board.
notion image
Here is the procedure for a direct Ethernet connection:
Windows (the Bonjour service must be installed for Win 7/8)
  1. Connect the Ethernet cable and wait approx. 30 sec
  1. Open the web browser and type rp-xxxxxx.local/ in the URL field
Linux / Ubuntu
  1. Open Network settings, Edit Connection, and for the LAN network, select Method Share to other computers under IPv4 Settings.
  1. Connect the Ethernet cable and wait approx. 30 sec
  1. Open the web browser and type rp-xxxxxx.local/ in the URL field
MAC
  1. Connect the Ethernet cable and wait approx. 30 sec
  1. Open the web browser and type rp-xxxxxx.local/ in the URL field
Note
xxxxxx are the last 6 characters from the MAC address (on the Ethernet connector)
Warning
If you experience some problems when using the Direct Ethernet Connection described above, try to disable the WiFi connection on your PC (if it has been enabled) and reset the Red Pitaya board (power off/on). If the problem persists, you can try the STATIC IP configuration described below.

Static IP configuration

This type of connection requires additional settings on your PC and Red Pitaya board.
Note
This connection is also arranged via the Network Manager application, so users should first have access to the LAN (DHCP) network in order to arrange a static IP on the Red Pitaya board.
The first step is connecting the Red Pitaya board directly to the LAN network and setting a static IP on it.
  1. Establish a direct Ethernet cable connection.
  1. Connect to your Red Pitaya main web page.
  1. Go to System and start the Network Manager application.
  1. Choose the Static option. Then, input the static IP and click Apply.
    1. notion image
  1. The next step is to set a network setting on the PC. Here is an example on Ubuntu 14.04, but it is very similar on other operating systems as well. To set up a direct connection with your PC, follow these next steps:
    1. Launch Network Manager on your computer.
    2. Add a new Ethernet connection. (There is no need to create a new network since you can set static IP settings on the existing network and skip all steps up to step 8.)
    3. notion image
  1. Select Ethernet connection and press Create button.
    1. notion image
  1. Select the name of the new Ethernet connection.
    1. notion image
  1. Select Method – Manual, press the Add button, and insert:
      • The static IP address of your PC (must be different from the IP address of the Red Pitaya board),
      • Netmask (input: 255.255.255.0)
      • Gateway (can be left empty)
      • DNS servers (can be left empty) and click the Save button.
      notion image
Note
Once you have these settings arranged, connect the Ethernet cable between your Red Pitaya board and PC, open a web browser, in the web browser URL field, input the chosen Red Pitaya board static IP (in our example, 192.168.0.15) and press enter.
notion image
 

Wireless

Wireless Network Connection

To establish a WiFi interface with your Red Pitaya, first, establish a direct ethernet connection. Open the Red Pitaya main webpage and start the Network Manager application. The Network Manager provides access to all network settings of the Red Pitaya board. Select the desired WiFi network, input the password, click “Connect”, and wait for Red Pitaya to configure the settings. Disconnect the ethernet cable from the board and restart it. Red Pitaya should automatically connect to the WiFi.
💡
Note
A WiFi dongle is required to connect the Red Pitaya to a WiFi network (Red Pitaya WiFi dongle). Please note that not all are compatible.
 
notion image
How to connect your Red Pitaya board over a WiFi network:
  1. Start your Red Pitaya web user interface (Use the connection described in LAN connection)
  1. Open Network Manager application
  1. Insert the WiFi dongle into the USB port on the Red Pitaya board. The recommended WiFi USB dongle is the Edimax EW7811Un V2. In general, all WiFi USB dongles that use the RTL8188CUS chipset should work.
  1. When the USB WiFi dongle is plugged in, the system will recognise it and enable additional settings.
  1. Select Client Mode, the desired WiFi network, enter your password and press the Connect button.
    1. notion image
  1. When your Red Pitaya board is connected, the IP address will be shown in the user interface. This IP address is only for the WiFi connection. You can check the connection by inputting a WiFi IP address in the web browser URL field (press enter after inputting).
    1. notion image
Now you have a WiFi connection established. If you restart the Red Pitaya board, it will connect to the selected network automatically (if it is available). Also, you can disconnect the LAN connection, and your board will still be available over the WiFi network, i.e., over the WiFi IP address.
💡
Note
WiFi networks are generally not robust, and the full performance of the Red Pitaya application can be affected.
 
💡
Note
When using the Raspberry Pi WiFi dongle, an issue of the dongle not being detected can arise. To mitigate this, detach the power cable from the Red Pitaya and wait for about a minute before powering up the Red Pitaya again.
 

Access Point Mode (Currently not supported)

Red Pitaya can act as an access point when there are no LAN or WiFi networks available. This will allow you to connect your PC, laptop, tablet, or smartphone directly to the Red Pitaya over Wi-fi.
notion image
Follow the steps below to enable the access point and connect to it.
  1. Start your Red Pitaya web user interface (Use the connection described in LAN connection)
  1. Open the Network Manager application
  1. Input the name and password of the access point network to be created. The password name should be at least eight characters long. Do not use special signs.
  1. Connect your PC, laptop, tablet, or phone to the network created by the Red Pitaya board.
  1. Input the Access Point network IP address into the web browser URL field and press enter.
💡
Note
When Access Point is enabled on Red Pitaya, it will continue to boot in Access Point configuration until it is disabled in the Network Manager.
 
💡
Note
The IP address in Access Point mode is always the same: 192.168.128.1
 
notion image

Prepare SD card

OS Versions

This Section provides a thorough guide on preparing the SD card for Red Pitaya users, detailing the steps to download and install the appropriate operating system (OS) versions onto an SD card. It covers the selection of OS versions, emphasizing the unified OS image introduced with version 2.00, and offers detailed instructions for writing the image to an SD card using tools for Windows, Linux, and macOS. Additionally, it explains the SD card's structure, including the ecosystem and OS partitions, and presents methods for manual ecosystem upgrades and resizing the file system to utilize the full capacity of larger SD cards. This section is essential for users to correctly set up their Red Pitaya, ensuring it operates with the latest features and updates.
The OS versions are listed from newest to oldest. For development OS (Nightly Builds), please check the Nightly Builds chapter located at the end of the OS section.

2.00 OS

With the 2.00 OS versions we moved to a unified OS image for all boards (One OS to rule them all).
RedPitaya OS 2.0:
Latest Beta (2.00-30) - CHANGELOG (MD5 (zipped): ec890319d64ffe059cd0d747cf36eab7)Latest Stable (2.00-23) - CHANGELOG (MD5 (zipped): 45281311c10c2131af9a09005b9b2b32)
New C libraries were added with the Unified (2.00) OS ecosystem, which causes the C program compilation to fail on older OS. To run the C applications, please use one of the following combinations of OS and ecosystem:
UNIFIED OS and 2023.1 or newer release (branch) of the GitHub ecosystemAny other OS version and the 2022.2 or older release (branch) of the GitHub ecosystem
Note
When updating the OS to 2.00 version from 1.04 or older (or downgrading from 2.00 to 1.04 or older), a factory reset of calibration parameters must be performed. Please open the Red Pitaya’s web interface and head to System => Calibration => Manual DC calibration. Click on Reset, select Factory, and confirm the reset. For more details on calibration, please see the Calibration application.
Note
If you have problems running the 2.00 version of the OS and you updated from the 1.04 or older OS image, please check this GitHub solution. For all other problems please contact the support team.

1.04 OS

The 1.04 OS versions are board specific. Please download only versions compatible with your board type.
STEMlab 125-14 & STEMlab 125-10:
1.04-28 - CHANGELOG (MD5 (zipped): 92e14e68d27e63568fb87954239e9fb0)1.04-18 - CHANGELOG (MD5 (zipped): f6cde9b3264a12372873d039535e58d5)
STEMlab 125-14 (SECONDARY/SLAVE board):
1.04-06 - CHANGELOG (MD5 (zipped): ef928d3014d806539e4360e59b7f6a99)
STEMlab 125-14-Z7020:
1.04-14 - CHANGELOG (MD5 (zipped): c740aab5d7b374924f19171e1edd3161)1.04-10 - CHANGELOG (MD5 (zipped): 3770f34e954674b0423db33ed8a3471d)
STEMlab 125-14 4-Input:
1.04-03 - CHANGELOG (MD5 (zipped): 414c1e7572ec116657a356f3ee2000ac)
SDRlab 122-16:
1.04-15 - CHANGELOG (MD5 (zipped): ba9f8be2f19630b42ee7b56bdd1d4392)1.04-11 - CHANGELOG (MD5 (zipped): 634cf27555d4ae8900c92833afc1ddb9)
SIGNALlab 250-12:
1.04-30 - CHANGELOG (MD5 (zipped): 2acb0579dbf67a40828a9b60a59be9e8)1.04-27 - CHANGELOG (MD5 (zipped): 40601a42fb06cf23f43aefe15d042a01)
Note
To run the C applications with 1.04 or older OS, please use the 2022.2 or older release/branch of the GitHub ecosystem

Older OS versions

All older OS versions that are in our database are available in our archive:
Red Pitaya archive link
For manual ecosystem upgrades please refer to Manual upgrade.

Nightly Builds

The nightly builds are snapshots of the development activity for upcoming Red Pitaya OS releases and include the newest features and bug fixes scheduled for the official releases. These builds are made available to make it easier for users to test their setup for potential issues with an upcoming release or to test new features and provide feedback on improving them before they are released as a Beta OS or Stable version.
We have decided to release the nightly builds to ensure that our codebase stays healthy and to shorten the time to fix some of the reported issues or implement some new features reported as suggestions for improvement.
As these builds are snapshots of the latest code, odds are you will encounter more issues compared to stable releases. Please report any issues to support@redpitaya.com so that our developers can review them and make any needed fixes.
Nightly Builds ecosystem:
Red Pitaya downloads - NIGHTLY CHANGELOG
Ecosystem builds run every Saturday night.
Note
These OS versions may be unstable and may cause misconfigurations or measurement data loss. We recommend that you use them solely for testing purposes, or you have reported a bug or requested a feature and our technical staff has instructed you to proceed.
Note
When updating from an OS version older than 2.00 to a Nightly Build version, a factory reset of calibration parameters must be performed. Please open the Red Pitaya’s web interface and head to System => Calibration => Manual DC calibration. Click on Reset, select Factory, and confirm the reset. For more details on calibration, please see the Calibration application.

Download and install the SD card image

The next procedure will create a clean SD card image.
  1. Select an appropriate OS version from above and download it.
    1. notion image
  1. Unzip the SD card image.
  1. Write the image onto an SD card. Instructions are available for various operating systems:
  1. Insert the SD card into the Red Pitaya.
    1. notion image
Note
This video shows how to identify your Red Pitaya model and write a memory card.

Windows

1. Insert the SD card into your PC or SD card reader.
2. Download Balena Ethcer and install it.
3. Open the newly installed Balena Etcher application.
4. Under Flash from file select an unzipped Red Pitaya image file.
5. Under Select target choose the drive letter of the SD card. Balena Etcher will only show you external drives.
Note
Balena Etcher will only show you external drives, but please be careful to select the correct drive if you have multiple cards or USBs plugged into your computer. If you choose the wrong one, you risk erasing data from the selected drive. You can easily see the drive letter (for example, E:) by looking in the left column of Windows Explorer.
6. When you click Flash the computer will prompt you to allow the operation. Click yes and wait for the flashing and validation to be completed.
7. Close Balena Etcher.
notion image
notion image
notion image
notion image
notion image
notion image
notion image

Linux

Note
You can also use Balena Ethcer on Linux and macOS. Instructions are under Windows section.
1.3.2.2.1. Ubuntu using Image Writer
1. Right-click on the extracted SD card image and select Open With > Disk Image Writer.
Context menu
Select tool dialog
1. In the Restore Disk Image window, select your SD card in the Destination pull-down menu. Be careful to select the correct device; use the size for orientation (for example, a 16 GB SD card).
Select drive dialog
2. You will be asked to confirm your choice and enter a password. Additional dialog windows will again show the selected destination drive. Take the opportunity to reconsider whether you chose the right device.
notion image
notion image
notion image

Command line

Note
Please note that the use of the dd tool can overwrite any partition of your machine. If you specify the wrong device in the instructions below, you could delete your primary Linux partition. Please be careful.
  1. Insert the SD card into your PC or SD card reader.
    1. notion image
  1. Open the terminal and check the available disks with df -h. Our SD card is 16 GB. It is named /dev/sdx and divided into two partitions, /dev/sdx1 and /dev/sdx2. The drive mounted at / is your main drive. Be careful not to use it.
    1. $ df -h
      Filesystem Size Used Avail Use% Mounted on
      /dev/sdx1 118M 27M 92M 23% /media/somebody/CAD5-1E3D
      /dev/sdx2 15.9G 1013M 15.8G 33% /media/somebody/7b2d3ba8-95ed-4bf4-bd67-eb52fe65df55
  1. Unmount all SD card partitions with umount /dev/sdxN (make sure you replace N with the right numbers).
    1. $ sudo umount /dev/sdx1 /dev/sdx2
  1. Write the image onto the SD card with the following command. Replace the red_pitaya_image_file.img with the name of the unzipped Red Pitaya SD Card Image and replace /dev/device_name with the path to the SD card.
    1. $ sudo dd bs=1M if=red_pitaya_image_file.img of=/dev/device_name
  1. Wait until the process has finished.

macOS

Note
You can also use Balena Ethcer on Linux and macOS. Instructions are under Windows section.
1.3.2.3.1. Using ApplePi-Baker
1. Insert the SD card into your PC or SD card reader.
2. Download ApplePi-Baker. Direct link:
ApplePi-Baker-v2.2.3.dmg
ApplePi-Baker-1.9.9.dmg
3. Click on ApplePi-Baker icon, then click Open in order to run it.
4. Drag and drop ApplePi-Baker for installation.
5. Enter your admin password and click OK.
6. Select the SD card drive. This can be recognised by the size of the card, which is 16 GB.
7. Select the Red Pitaya OS image file.
8. It’s coffee time. The application will show you the estimated time for accomplishment.
9. When the operation is finished, the status will change to idle.
notion image
notion image
notion image
notion image
notion image
notion image
notion image
notion image
1.3.2.3.2. Command line
1. Insert the SD card into your PC or SD card reader.
2. Click cmd + space, type Disk Utility into the search box and press enter. From the menu, select your SD card and click on the Erase button (be careful not to delete your disk!).
3. Click cmd + space, then enter cd into the Terminal. Then type cd Desktop and press enter once more.
4. Unmount the partition so that you will be able to overwrite the disk. Type diskutil list into the Terminal and press enter. This will show you the list of all memory devices.
Unmount with: diskutil UnmountDisk /dev/diskn (insert the number n of your disk correctly!)
5. Type: sudo dd bs=1m if=path_of_your_image.img of=/dev/rdiskn (Remember to replace n with the number that you noted before!) (notice that there is a letter r in front of the disk name, use that as well!)
6. Type in your password and wait a few minutes for the image to be written.
7. When the image is written, type: diskutil eject /dev/diskn and press enter.
8. Safely eject the SD card.
notion image
notion image
notion image
notion image
notion image

Background

A Red Pitaya SD card contains two partitions:
  1. 128 MB FAT contains the ecosystem:
      • boot files: FSBL, FPGA images, U-Boot, Linux kernel
      • Red Pitaya API libraries and header files
      • Red Pitaya web applications, scripts, tools
      • customized Nginx web server
  1. ~4 GB Ext4 contains the OS:
      • Ubuntu/Debian OS
      • various libraries
      • network setup customization
      • systemd services customization
Most of Red Pitaya’s source code translates into the ecosystem. Therefore, it is updated more often. The OS is changed less frequently.
Note
You can find older and developed Red Pitaya OS images and Ecosystem zip files on our download server.
Note
A list of new features, bug fixes, and known bugs for each Red Pitaya release can be found in our CHANGELOG.

Manual upgrade

Instead of writing the whole SD card image, it is possible to upgrade only the ecosystem.
A manual upgrade allows you to fix a corrupted SD card image (if only the FAT partition is corrupted) or to install older, newer, or custom ecosystem zip files.
  1. Download a zip file from our download server.
  1. Insert the SD card into the card reader.
  1. Delete all files from the FAT partition. Use Shift + Delete to avoid placing files into the trash bin on the same partition.
  1. Extract the ecosystem zip file contents onto the now empty partition.
If you wish to keep wireless settings, skip deleting the next files:
  • wpa_supplicant.conf
  • hostapd.conf

Resize file system

When recording an image to a flash card of any size, we get sections of the file system of 4 GB in size. In order to increase the available free space, you need to execute the following script:
root@rp-f03dee:~# /opt/redpitaya/sbin/resize.sh
After the script is completed, the system will ask you to restart your Red Pitaya. If everything is done correctly, the system will start with an increased space size. This can be checked with the following command:
root@rp-f03dee:~# df -h
Note
If the file system size has not changed, try to manually run the command:
root@rp-f03dee:~# sudo resize2fs /dev/mmcblk0p2

FAQ

The FAQ section in the documentation provides comprehensive answers to common questions and issues related to the setup, connectivity, OS updates, application usage, and hardware specifications of Red Pitaya devices. It addresses how to get started, connect to networks, troubleshoot booting problems, and enhance WIFI connections. Additionally, it guides on updating the OS, dealing with non-booting devices post-update, and ensuring internet connectivity for accessing the marketplace and OS updates. This FAQ section is a vital resource for users seeking quick solutions and deeper understanding of their Red Pitaya's capabilities and troubleshooting methods.
Note
Not found what you are looking for? Please contact us or report a bug. Please include all the relevant information regarding the problem. For easier debugging on OS versions 2.00 and above, please also include the Downloaded system report in the bottom left corner of your Red Pitaya main webpage.

Connectivity

How to get started with Red Pitaya?

How to connect to Red Pitaya in a few simple steps?

Red Pitaya not booting anymore?

  • A possible cause could be a corrupted card, and the recommendation is a manual OS re-write: Prepare SD card

How to connect the external clock to RP?

How can I make sure that my Red Pitaya has access to the internet?
1. Connect to your Red Pitaya over SSH.
2. Make sure that you can ping google.com website:

root@rp-f03dee:~# ping -c 4 google.com
PING google.com (216.58.212.142) 56(84) bytes of data.
64 bytes from ams15s21-in-f142.1e100.net (216.58.212.142): icmp_seq=1 ttl=57 time=27.3 ms
64 bytes from ams15s21-in-f142.1e100.net (216.58.212.142): icmp_seq=2 ttl=57 time=27.1 ms
64 bytes from ams15s21-in-f142.1e100.net (216.58.212.142): icmp_seq=3 ttl=57 time=27.1 ms
64 bytes from ams15s21-in-f142.1e100.net (216.58.212.142): icmp_seq=4 ttl=57 time=27.1 ms

--- google.com ping statistics ---
4 packets transmitted, 4 received, 0% packet loss, time 3004ms
rtt min/avg/max/mdev = 27.140/27.212/27.329/0.136 ms

How can I make sure that Red Pitaya is connected to the same network as my computer/tablet/smartphone?

The most common answer would be: just make sure that your Red Pitaya and your PC/tablet/smartphone are both connected to the same router or your smartphone hotspot.
In order to test it, you can use a PC that is connected to the same local network as your Red Pitaya and try the following:
  1. Open the terminal window.
      • Windows: Go to RUN, type in cmd and press enter.
      • Linux: Click on the application button, type in Terminal and press enter.
      • macOS: Hit cmd + space, type in Terminal and press enter.
  1. Enter the arp -a command to get a list of all devices in your local area network and try to find your Red Pitaya MAC address on the list.
    1. $ arp -a
      ? (192.168.178.117) at 00:08:aa:bb:cc:dd [ether] on eth0
      ? (192.168.178.118) at 00:26:32:f0:3d:ee [ether] on eth0
      ? (192.168.178.105) at e8:01:23:45:67:8a [ether] on eth0
      Note
      If you have a cable connection, then your MAC address is written on your Red Pitaya LAN connector.
      notion image
Note
If you have established a wireless connection, then you should check the MAC address of your wireless USB dongle. The MAC addresses are typically written on the USB dongles.
  1. Type your Red Pitaya IP into your WEB browser and connect to it.
    1. notion image
If your Red Pitaya is not listed on the list of your local network devices on the local network, then it is necessary to check that your Red Pitaya is connected to your local network.
1.4.1.7. Is Red Pitaya connected to my local network?
1. Connect your Red Pitaya to a PC over a Serial Console.
2. Type “ip a” and hit enter to check the status of your ethernet connection on Red Pitaya.
1. If you have connected to your Red Pitaya over a wireless connection, you should check the status of the wlan0 interface.
2. If you have connected to your Red Pitaya over a cable connection, you should check the eth0 interface.
3. Type Red Pitaya IP into your web browser to see if you can connect to it.
notion image

1.4.1.8. Problems connecting to RP?

notion image
  1. First, check the LEDs:
    1. If the green LED is not ON or is blinking. It seems like something is wrong with the power supply, or maybe it’s the USB cable. Make sure that:
      1. you have plugged the USB cable into the right USB connector on the Red Pitayayour power supply is 5V/2Atry to replace the USB cable and also the USB power supply
    2. If the green LED is turned ON but the blue LED is turned OFF. In this case, there is an error while loading the Red Pitaya system from the SD card. Make sure that:
      1. you have correctly inserted the Red Pitaya SD card and the Red Pitaya OS has been installed (Notice that Red Pitayas already comes with a pre-installed OS on SD cards. Anyhow, SD cards might get corrupted- in such case follow this instruction on how to Prepare SD card to properly re-install Red Pitaya OS to SD card)try to use another SD card
    3. If both the green and blue LEDs are ON, but the red and orange LEDs are not blinking. The red LED indicates CPU heartbeat, while the orange LED indicates access to the SD card. Notice that these two LEDs always start blinking 10 seconds after the green and blue LEDs are turned on.
  1. Make sure your Red Pitaya and computer are both connected to the same local network.
  1. Consult the connection guide for advice.
  1. Try disabling the VPN, because it may be preventing the connection.
  1. If you are a Windows user, please look at the note below.
Note
Windows 7/8 users should install Bonjour Print Services, otherwise access to *.local addresses will not work.
Windows 10 or higher already supports mDNS and DNS-SD, so there is no need to install additional software.

How to find the Red Pitaya URL if it is not written on the sticker?

The Red Pitaya URL is rp-xxxxxx.local where xxxxxx must be replaced with the last 6 digits of the MAC address that is written on the sticker.
If the RP MAC address is 00:26:33:F1:13:D5, the last 6 digits are F113D5 and the URL is rp-f113d5.local.
notion image

Slow WIFI connection?

If your wireless connection with Red Pitaya works very slowly and all the applications seem very unresponsive and not running smoothly, please check the following:
  • Check the WiFi signal strength on your PC/tablet/smartphone.
  • Check the WiFi signal strength of your Red Pitaya.
Connect to your Red Pitaya via an SSH connection.Enter the cat /proc/net/wireless command to get information about link quality and signal strength.Link quality measures the number of packet errors that occur. The lower the number of packet errors, the higher this will be. Link quality goes from 0-100%.Level, or signal strength, is a simple measure of the amplitude of the signal that is received. The closer you are to the access point, the higher this will be.
Note
For full performance, a wired connection is preferred.

WIFI dongle not detected?

Please note that not all are compatible. A list is in the documentation: Supported USB Wi-Fi adapters

OS

How to upgrade OS?

Is Red Pitaya not booting even after OS update?

  • Please use the Balena Etcher application to rewrite the OS manually. The latest Windows update has been reported to have broken the Win32 disc imager. Prepare SD card

Is Red Pitaya failing to update?

Please use the Balena Etcher application to rewrite the OS manually. The latest Windows update has been reported to have broken the Win32 disc imager. Prepare SD card

Applications & Web Interface

How can I start using RP measurement applications?

My device shows the wrong measurements. How can I calibrate it?

The Red Pitaya can be calibrated using the Calibration Tool
Problems with OS update application, and accessing the marketplace?
1. Make sure your Red Pitaya has access to the internet.
2. Force a refresh of the Red Pitaya application page. How?
Web interface not functioning properly, or experimenting with freezing?
Please ensure that your browser’s ad blockers are turned off for the “rp-xxxxxx.local” webpage and that your proxy settings are correct. For local connections to the Red Pitaya unit, proxy settings should not be required. A VPN may also be preventing the connection.
notion image

Undesired disconnections?

If possible, we recommend testing the setup on a different computer and a different network, as well as, checking the state of the Ethernet cables and power supply, proxy settings, and re-writing the OS.

An application is not working?

We suggest upgrading to the latest OS and trying again. Otherwise, please report the bug.
Note
It is important to note that applications developed by the Red Pitaya community are not distributed or tested by the Red Pitaya team and that our team accepts no responsibility. If you’d like to share feedback, report bugs, or need help on contributed projects, apps, or software, we highly recommend contacting the project authors.
Note
The 2.00 Unified OS update has seen registry changes in the FPGA, so, likely, older applications will not work after the OS update (Xilinx also changed how the FPGA is loaded into the FPGA).

Software

For establishing an SSH connection, creating a custom FPGA image, custom ecosystem, and/or custom web applications, please refer to Developers guide Software.
How can I acquire data with Red Pitaya?There are multiple approaches to acquiring data with Red Pitaya. Here is a quick description of each possiblity:
Oscilloscope application – The data is acquired at full speed, but all the limitations of a standard oscilloscope apply (currently, the data can only be extracted upon user request via the application. Remote data collection is currently impossible). More info here.
SCPI data acquisition (Python, MATLAB, LabVIEW) – Triggered data acquisition. The data is acquired in 16384 sample-long buffers. The code is executed on a computer, and string commands are sent to the Red Pitaya via socket communication. Data is acquired on the Red Pitaya and then sent back as a string that can be converted to a floating-point format. Trigger can be set to either IN1, IN2, or External (also IN3 and IN4 for STEMlab 125-14 4-Input). Trigger level can be specified. The acquisition must be restarted before a new “data buffer” can be acquired. There is a dead time between capturing two consecutive buffers where data is not saved. More details here.
API commands (C, Python) – Functions exactly the same as SCPI data acquisition, but it is faster since everything is running on the Red Pitaya board itself (the code is executed on the board). More info here.
Streaming application – Continuous data acquisition. The data is streamed from one or both inputs directly to a file on a computer. The data can be acquired indefinitely, but there are speed limitations.The total data flow at the inputs (IN1 and IN2) must not exceed 20 MB/s when streaming directly to a computer or 10 MB/s when streaming to the SD card. More details on the limitations are available here.
Deep Memory (AXI mode) (only OS 2.00-23 – latest Beta) – Long sequence triggered data acquisition. The data can be acquired at different speeds (up to 125 MHz), and it is saved directly into the DDR RAM. The buffer length can be specified by the user but must not exceed 256 MB for both channels. After the acquisition is complete, Red Pitaya needs some time to transfer the whole file to the computer (the RAM must be emptied) before the acquisition can be reset. Functions exactly the same as API commands. More details are available here.
Custom Acquisition (FPGA) – Red Pitaya is open-source so any mode above can be customized by the user to tune it to their specific application.
How can I generate data with Red Pitaya?Here are all possible generation options on the Red Pitaya (please be aware of AC coupling limitations on SDRlab 122-16):
Oscilloscope application - basic waveform generation. More info here.
SCPI commands (Python, MATLAB, LabVIEW), remote control from computer - can generate basic waveforms as well as custom/arbitrary waveforms (defined in a 16384 sample-long buffer which represents one period of the signal - the frequency is calculated for the whole buffer). More details here.
API commands (C, Python), on-board program - same functionality as standard SCPI commands, but generally faster and includes the benefit of possible direct communication with the FPGA. More info here.
Custom/user-defined (FPGA reprogramming) - Red Pitaya is open-source, so anyone has the option of reprogramming the FPGA image to customise the functionality.

How to control Red Pitaya remotely using LabVIEW, MATLAB, and Python?

Where can I find the ecosystem, software, and FPGA images?

Note
Impossible. Perhaps the archives are incomplete.
If you need a specific old version of the ecosystem or the OS that is missing from the archives, we suggest you ask the community on the Red Pitaya Forum. There is a chance someone has it lying around on the disk.

How to start with FPGA development?

Hardware

For hardware schematics, step models, and specifications, please refer to Developers guide Hardware.

Where can I find Red Pitaya schematics, 3D models (.step), and important componetns?

Please take a look at Developers guide Hardware => board model => Schematics, Mechanical Specifications and 3D Models. See the general link above, or board-specific links below.

Is there a hardware difference between the STEMlab125-14 and the ISO17025 versions?

No, the hardware is identical. The only difference is that the latter would have been sent to a certification lab and the appropriate measurements would have been made.

What are the main differences between different Red Pitaya boards?

Take a look at the board comparison table.

How to report a bug?

Please send us an e-mail at support@redpitaya.com with the following information:
  • The model of Red Pitaya used,
  • Version of Red Pitaya OS,
  • Information about the bug,
  • Clear instructions about how to reproduce it.