Upgrade process

Before running the upgrade process, make sure that:

  • The robot controller has access to the internet.
  • All your sessions and files on the controller are saved, since you need to turn off the controller at some point.
  • The robot is in a safe and stable physical position and no motion is running, since the motors loose power during the upgrade.

Upgrade the OS

In this section we check the OS of the robot controller and make sure that it is up to date before running the rest of the updates.

This section usually applies to the Dorna 2 users with the blue body paint, and you have to complete it only once.

OS version

SSH to the robot controller and run sudo lsb_release -a to find the OS version:

dorna@dorna:~ $ sudo lsb_release -a
No LSB modules are available.
Distributor ID: Raspbian
Description:    Raspbian GNU/Linux 10 (buster)
Release:        10
Codename:       buster

If the Release item is 10 or less, then follow this section, otherwise jump to Step 1.

In this section we will update the version of the OS from 10 (buster) to 11 (bullseye). This process can take up to 1 hour.

Expand the file system

SSH to the robot controller and run df -h / to check the disk space:

dorna@dorna:~ $ df -h /
Filesystem      Size  Used Avail Use% Mounted on
/dev/root       3.8G  3.0G  636M  83% /

If the Size item is below 4G then follow this part, otherwise jump to the installation section.
Expand the file system by

  1. Run sudo raspi-config
  2. Go to Advanced Options
  3. Select Expand Filesystem
  4. Select OK
  5. Select Finish
  6. Select Yes to reboot (or run sudo reboot manually)

Step-by-Step installation of Bullseye

In this section we will update the OS from 10 (buster) to 11 (bullseye) and it can take up to 1 hour.

  1. SSH to the robot controller and update the repository lists:
$ sudo apt update
  1. Install all of the latest packages (and their dependencies):
$ sudo apt full-upgrade
  1. Reboot your robot controller to activate any packages that require a reboot:
$ sudo reboot
  1. Update to the latest version of the OS firmware:
$ sudo rpi-update

Another reboot may be necessary after updating your OS firmware.

$ sudo reboot
  1. Next, edit your sources.list file to switch your repository list from Buster to Bullseye:
$ sudo nano /etc/apt/sources.list

Locate the following line and change buster to bullseye:

deb http://raspbian.raspberrypi.org/raspbian/ buster main contrib non-free rpi

Save your changes (Ctrl+X) and proceed to the next step.

  1. Update your repository lists again (this time it will be using the Bullseye-specific repositories):
$ sudo apt update
  1. Install the latest version of Node.js (this helps avoid an error you may receive when running apt full-upgrade in step 9). This step may take several minutes.
$ sudo apt install nodejs

Note that you may receive a prompt to “Restart services during package upgrades without asking”. If so, choose “Yes”.

  1. Update to the latest version of GCC 8 (this also helps avoid an error in the next step).
$ sudo apt install gcc-8-base
  1. Run another full upgrade to install any additional Bullseye requirements and downstream dependencies:
$ sudo apt full-upgrade
  1. Clean up your packages to remove any that are obsolete or no longer used:
$ sudo apt autoclean
$ sudo apt autoremove
  1. Next, you need to alter your /boot/config.txt file to enable KMS (the new standard video driver).
$ sudo sed -i 's/dtoverlay=vc4-fkms-v3d/#dtoverlay=vc4-fkms-v3d/g' /boot/config.txt
$ sudo sed -i 's/\[all\]/\[all\]\ndtoverlay=vc4-kms-v3d/' /boot/config.txt
  1. When you're all done, reboot your robot controller:
$ sudo reboot
  1. After a reboot, check to see if everything was updated properly:
$ cat /etc/os-release

This should return the following:

PRETTY_NAME="Raspbian GNU/Linux 11 (bullseye)"
NAME="Raspbian GNU/Linux"
VERSION_ID="11"
VERSION="11 (bullseye)"
VERSION_CODENAME=bullseye
ID=raspbian
ID_LIKE=debian
HOME_URL="http://www.raspbian.org/"
SUPPORT_URL="http://www.raspbian.org/RaspbianForums"
BUG_REPORT_URL="http://www.raspbian.org/RaspbianBugs"

Step 1

SSH to the robot controller and run the following line (copy/paste everything) in the terminal:

sudo rm -rf /home/dorna/Downloads/upgrade_pvt && sudo mkdir /home/dorna/Downloads/upgrade_pvt && sudo git clone https://github.com/smhty/upgrade_pvt.git /home/dorna/Downloads/upgrade_pvt && cd /home/dorna/Downloads/upgrade_pvt && sudo sh setup_0.sh

Depending on your internet speed, the process can takes few minutes.

Step 2

Once the upgrade process is completed you should see the following messages on your terminal window.

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    Setup process is completed.                  @
@    To complete the update:                      @
@      1- Wait for 30 seconds.                    @
@      2- Then turn the controller off and on.    @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Wait for around 30 seconds, then turn the controller off and on to complete the upgrade process.

After upgrade

Once the upgrade process is completed, you can now access the updated Dorna Lab via http://robot_ip_address in your browser. For example if your robot IP address is 192.168.254.134. Then just type in http://192.168.254.134 in your browser.
Most of the time, you need to (hard) refresh your Dorna Lab browser page, to see the changes. In this case press Ctrl + F5 or press Ctrl and click on the refresh button on the browser.

Check for new updates

To check for the new updates, make sure that the robot controller, has access to the internet, then:

  • Open Dorna Lab via browser.
  • Go to the Setting > Info > Device.
  • Under the Device section click on Check for Updates and wait for the controller to check the latest updates by connecting to the Dorna Server.
  • If new updates are available then follow upgrade process and run the update.
Last updated on 8/10/2022
← Inputs and outputs