Skip to main content

5.1.2 apt installation and upgrade

This section describes how to install TogetheROS.Bot using apt on both RDK and X86 platforms.

RDK Platform​

Prerequisites:

  • Completed the steps in the Environment Preparation section
  • Ubuntu OS is already installed on the RDK
  • The RDK has normal internet access
  • The RDK supports remote SSH access
📋 Confirm System Version and Download

Before installing TogetheROS, confirm your system version and download the latest image. For system image downloads, refer to: Download Resources Summary

Note for RDK X3 platform users:

Attention
  • tros.b version 2.x only supports system images of version 2.x; tros.b version 1.x only supports system version 1.x.
  • If you are using a system image of version 1.x, you must upgrade your system to version 2.x.
  • For instructions on checking system and tros.b versions and further details, please see the FAQs.
Dependencytros.b 1.xtros.b 2.x
System Image 1.x√x
System Image 2.xx√

Installing tros.b​

Note: The RDK IP used here is 10.64.61.241. Replace it with your actual RDK IP during installation.

Log into the RDK:

ssh root@10.64.61.241

Install the tros.b package:

sudo apt update
sudo apt install tros
Attention
  • If the sudo apt update command fails or returns an error, refer to the FAQ section titled Q10: How to resolve failures or errors when running apt update?
  • If after running the installation command you receive the message E: Unmet dependencies. Try 'apt --fix-broken install' with no packages (or specify a solution)., first run apt --fix-broken install to install required dependencies before proceeding with the tros.b installation.

After installation, check the contents of the /opt directory:

root@ubuntu:/userdata# ls /opt/
hobot  tros

You can see that tros.b has been installed under the /opt directory.

Upgrading tros.b​

The following example uses the RDK platform; the upgrade procedure for X86 Ubuntu is identical.

Log into the RDK:

ssh root@10.64.61.241

Upgrade the tros.b deb package:

sudo apt update
sudo apt upgrade
Attention

If the sudo apt update command fails or returns an error, refer to the FAQ section titled Q10: How to resolve failures or errors when running apt update?

Checking the Current tros.b Version​

root@ubuntu:~# apt show tros
Package: tros
Version: 2.0.0-20230523223852
Maintainer: kairui.wang <kairui.wang@d-robotics.cc>
Installed-Size: unknown
Depends: hobot-models-basic, tros-ros-base, tros-ai-msgs, tros-audio-control, tros-audio-msg, tros-audio-tracking, tros-body-tracking, tros-dnn-benchmark-example, tros-dnn-node, tros-dnn-node-example, tros-dnn-node-sample, tros-elevation-net, tros-gesture-control, tros-hand-gesture-detection, tros-hand-lmk-detection, tros-hbm-img-msgs, tros-hobot-app-xrrobot-body-tracking, tros-hobot-app-xrrobot-gesture-control, tros-hobot-codec, tros-hobot-cv, tros-hobot-falldown-detection, tros-hobot-hdmi, tros-hobot-image-publisher, tros-hobot-mot, tros-hobot-usb-cam, tros-image-subscribe-example, tros-img-msgs, tros-imu-sensor, tros-line-follower-model, tros-line-follower-perception, tros-mipi-cam, tros-mono2d-body-detection, tros-mono2d-trash-detection, tros-mono3d-indoor-detection, tros-parking-perception, tros-parking-search, tros-rgbd-sensor, tros-websocket, tros-xrrobot, tros-xrrobot-msgs
Download-Size: 980 B
APT-Manual-Installed: yes
APT-Sources: http://archive.d-robotics.cc/ubuntu-rdk focal/main arm64 Packages
Description: TogetheROS Bot

You can see that the current tros.b version has been upgraded to version 2.0.0.

X86 Platform​

Prerequisites:

  1. Set locale and enable the universe repository:

    sudo apt update && sudo apt install locales
    sudo locale-gen en_US en_US.UTF-8
    sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8
    export LANG=en_US.UTF-8

    sudo apt install software-properties-common
    sudo add-apt-repository universe

  2. Download the GPG key file and add the repository list:

    sudo apt update && sudo apt install curl

    sudo curl -sSL http://archive.d-robotics.cc/keys/sunrise.gpg -o /usr/share/keyrings/sunrise.gpg
    echo "deb [arch=amd64 signed-by=/usr/share/keyrings/sunrise.gpg] http://archive.d-robotics.cc/ubuntu-rdk-sim focal main" | sudo tee /etc/apt/sources.list.d/sunrise.list > /dev/null

    sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
    echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

  3. Update repository information and install tros.b:

sudo apt update
sudo apt install tros
caution
  • If you have already installed tros.b version 1.x on your x86 platform, please first remove it using the command sudo apt remove tros before installing tros.b version 2.x.
  • For instructions on how to check the tros.b version number, please refer to the FAQs.
Last updated on