Red Pitaya OS Update

Background

1. 128 MB FAT containing 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

2. ~4 GB Ext4 containing the OS:
• Ubuntu/Debian OS
• Various libraries
• Network setup customization
• Systemd services customization

Resize file system

graphqlKopiraj kodo
root@rp-f03dee:~# /opt/redpitaya/sbin/resize.sh

graphqlKopiraj kodo
root@rp-f03dee:~# df -h

graphqlKopiraj kodo
root@rp-f03dee:~# sudo resize2fs /dev/mmcblk0p2

How to upgrade the OS using the web interface?

1. Open the Red Pitaya desktop using your web browser.

2. Click on the upgrade alert or on the ecosystem version label in the bottom right corner.

3. Select the ecosystem version and start the OS updater.

4. Follow the steps in the OS updater app to install the new OS.

How to manually upgrade the OS?

All OS versions are available on this link (locate your board model and download the appropriate OS version):

Download and install the SD card image

1. Select an appropriate OS version from the above link and download it.

2. Unzip the SD card image.

3. Write the image onto an SD card. Instructions are available for various operating systems:

4. Insert the SD card into the Red Pitaya.

Installing OS on the SD card for Windows Users

1. Insert the SD card into your PC or SD card reader.

2. Download Balena Etcher and install it.

3. Open the newly installed Balena Etcher application.

4. Under Flash from file, select the unzipped Red Pitaya image file.

5. Under Select target, choose the drive letter of the SD card. Balena Etcher will only show external drives.



Note
Balena Etcher will only show external drives, but please be careful to select the correct drive if you have multiple cards or USBs plugged into your computer. Choosing the wrong one risks 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 complete.

7. Close Balena Etcher.

Installing OS on the SD card for Linux Users

Using Image Writer on Ubuntu

1. Right-click on the extracted SD card image and select Open With > Disk Image Writer.

2. 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).

3. 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.

Using Command Line

1. Insert the SD card into your PC or SD card reader.

2. 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.

bashKopiraj kodo
$ 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

3. Unmount all SD card partitions with umount /dev/sdxN (make sure you replace N with the right numbers).

shellKopiraj kodo
$ sudo umount /dev/sdx1 /dev/sdx2

4. Write the image onto the SD card with the following command. Replace 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.

shellKopiraj kodo
$ sudo dd bs=1M if=red_pitaya_image_file.img of=/dev/device_name

5. Wait until the process has finished.

Installing OS on the SD card for macOS Users

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 the ApplePi-Baker icon, then click Open 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 recognized 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 completion.

9. When the operation is finished, the status will change to idle.

Using 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 can overwrite the disk. Type diskutil list into the Terminal and press Enter. This will show you the list of all memory devices.

5. Unmount with: diskutil UnmountDisk /dev/diskn (insert the number n of your disk correctly!)

6. 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!)

7. Type in your password and wait a few minutes for the image to be written.

8. When the image is written, type: diskutil eject /dev/diskn and press Enter.

9. Safely eject the SD card.

Red Pitaya not booting even after OS update?

Manual upgrade

1. Download a zip file from our download server.

2. Insert the SD card into the card reader.

3. Delete all files from the FAT partition. Use Shift + Delete to avoid placing files into the trash bin on the same partition.

4. Extract the ecosystem zip file contents onto the now empty partition.

• wpa_supplicant.conf

• hostapd.conf