1.5. Prepare SD card¶
1.5.1. Download and install the SD card image¶
The next procedure will create a clean SD card image.
Download the Red Pitaya SD card image:
RedPitaya OS 2.0:
Note
This version of the ecosystem includes a build for all boards. Boards currently supported:
STEMlab 125-10
STEMlab 125-14
STEMlab 125-14-Z7020
STEMlab 125-14 4-Input
SDRlab 122-16 (Currently not supported)
SIGNALlab 250-12
Unfify ecosystem now includes master/slave functionality for streaming.
Warning
If you have a very old Red Pitaya (STEMlab 125-14) and the UNIFIED OS does not work for you, please send us the picture of the board (MAC address), so that we can add the address range to the system.
Warning
- To run the C applications please use one of the following combinations of OS and ecosystem:
UNIFIED OS and 2023.1 release of the GitHub ecosystem
Any other OS version and the 2022.2 release of the GitHub ecosystem
STEMlab 125-14 & STEMlab 125-10:
STEMlab 125-14 (SLAVE board):
STEMlab 125-14-Z7020:
STEMlab 125-14 4-Input:
SDRlab 122-16:
SIGNALlab 250-12:
Unzip the SD card image.
Write the image onto an SD card. Instructions are available for various operating systems:
Insert the SD card into the Red Pitaya.
Note
This video shows how to identify your Red Pitaya model and write a memory card.
1.5.1.1. Windows¶
Insert the SD card into your PC or SD card reader.
Download Balena Ethcer and install it.
Open the newly installed Balena Etcher application.
Under Flash from file select an unzipped Red Pitaya image file.
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.
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.
Close Balena Etcher.
1.5.1.2. Linux¶
Note
You can also use Balena Ethcer on Linux and macOS. Instructions are under Windows section.
1.5.1.2.1. Ubuntu using Image Writer¶
Right-click on the extracted SD card image and select Open With > Disk Image Writer.
Context menu¶
Select tool dialog¶
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¶
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.
1.5.1.2.2. 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.
Insert the SD card into your PC or SD card reader.
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.$ 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
Unmount all SD card partitions with
umount /dev/sdxN
(make sure you replace N with the right numbers).$ sudo umount /dev/sdx1 /dev/sdx2
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.$ sudo dd bs=1M if=red_pitaya_image_file.img of=/dev/device_name
Wait until the process has finished.
1.5.1.3. macOS¶
Note
You can also use Balena Ethcer on Linux and macOS. Instructions are under Windows section.
1.5.1.3.1. Using ApplePi-Baker¶
Insert the SD card into your PC or SD card reader.
Download ApplePi-Baker. Direct link:
Click on ApplePi-Baker icon, then click Open in order to run it.
Drag and drop ApplePi-Baker for installation.
Enter your admin password and click OK.
Select the SD card drive. This can be recognised by the size of the card, which is 16 GB.
Select the Red Pitaya OS image file.
It’s coffee time. The application will show you the estimated time for accomplishment.
When the operation is finished, the status will change to idle.
1.5.1.3.2. Command line¶
Insert the SD card into your PC or SD card reader.
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!).
Click cmd + space, then enter
cd
into the Terminal. Then typecd Desktop
and press enter once more.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 numbern
of your disk correctly!)Type:
sudo dd bs=1m if=path_of_your_image.img of=/dev/rdiskn
(Remember to replacen
with the number that you noted before!) (notice that there is a letterr
in front of the disk name, use that as well!)Type in your password and wait a few minutes for the image to be written.
When the image is written, type:
diskutil eject /dev/diskn
and press enter.Safely eject the SD card.
1.5.2. Background¶
A Red Pitaya SD card contains two partitions:
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
~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 development Red Pitaya OS images and Ecosystem zipfiles on our download server.
Note
A list of new features, bugfixes, and known bugs for each Red Pitaya release can be found in our CHANGELOG.
1.5.3. 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.
Download a zip file from our download server.
Insert the SD card into the card reader.
Delete all files from the FAT partition. Use
Shift + Delete
to avoid placing files into the trash bin on the same partition.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
1.5.4. 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, you can try to manually run the command:
root@rp-f03dee:~# sudo resize2fs /dev/mmcblk0p2