preparation
TogetheROS.Bot supports installation on Ubuntu 20.04/Ubuntu 22.04 systems running on both RDK and x86 platforms. Installing via DEB packages on Ubuntu is simple and fast, and we recommend this method for users who are trying it out for the first time.
The following sections describe environment preparation details for the RDK and x86 platforms, respectively.
RDK Platform
System Installation
Before installing tros.b, we recommend upgrading your RDK system image to the latest version. Instructions for flashing Ubuntu 20.04/Ubuntu 22.04 images are as follows:
- RDK X3/X5/Ultra
- RDK S100
- If you are using an RDK X3 with a 1.x system version installed, you must upgrade to version 2.x.
- For instructions on checking your system version number and further details, please refer to the FAQs.
If the image is already installed, you can perform an upgrade by running sudo apt update and sudo apt upgrade.
If the sudo apt update command fails or returns an error, please refer to the section Q10: How to handle failures or errors when running apt update? in Common Issues for solutions.
System Configuration
After successfully flashing the image, you need to configure the RDK’s IP address for convenient daily usage. Login credentials: username root, password root.
To ensure smooth installation and use of tros.b later on, please log in using the root account.
During development and testing, you will frequently need to access the RDK via commands like scp/ssh using its IP address. Therefore, we recommend configuring the network dynamically, as described below:
- RDK X3/X5/Ultra
- RDK S100
Try pinging Baidu's server:
root@ubuntu:~# ping www.baidu.com
PING www.a.shifen.com (180.101.49.11) 56(84) bytes of data.
64 bytes from 180.101.49.11 (180.101.49.11): icmp_seq=1 ttl=52 time=4.10 ms
64 bytes from 180.101.49.11 (180.101.49.11): icmp_seq=2 ttl=52 time=4.34 ms
64 bytes from 180.101.49.11 (180.101.49.11): icmp_seq=3 ttl=52 time=4.28 ms
64 bytes from 180.101.49.11 (180.101.49.11): icmp_seq=4 ttl=52 time=4.21 ms
64 bytes from 180.101.49.11 (180.101.49.11): icmp_seq=5 ttl=52 time=4.19 ms
64 bytes from 180.101.49.11 (180.101.49.11): icmp_seq=6 ttl=52 time=4.98 ms
^C
--- www.a.shifen.com ping statistics ---
6 packets transmitted, 6 received, 0% packet loss, time 5008ms
rtt min/avg/max/mdev = 4.100/4.348/4.978/0.291 ms
A successful ping response indicates that internet access and DNS configuration are working correctly.
Update the system image and package sources by running sudo apt update and sudo apt upgrade.
Test SSH connectivity by running ssh root@<RDK_IP_ADDRESS>. In this example, the RDK’s IP address is 10.64.61.228, so you would run ssh root@10.64.61.228. The first SSH login attempt will display the following prompt:
ssh root@10.64.61.241
The authenticity of host '10.64.61.241 (10.64.61.241)' can't be established.
ECDSA key fingerprint is SHA256:5NQuzIkfNYZftPkxrzCugbQs5Gy5CEC5U3Nhtu+sJs8.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Type yes and press Enter, then enter the password root to successfully access the RDK:
ssh root@10.64.61.241
The authenticity of host '10.64.61.241 (10.64.61.241)' can't be established.
ECDSA key fingerprint is SHA256:5NQuzIkfNYZftPkxrzCugbQs5Gy5CEC5U3Nhtu+sJs8.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '10.64.61.241' (ECDSA) to the list of known hosts.
root@10.64.61.241's password:
Permission denied, please try again.
root@10.64.61.241's password:
Welcome to Ubuntu 20.04.4 LTS (GNU/Linux 4.14.87 aarch64)
* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/advantage
Last login: Sat Apr 2 05:57:05 2022 from 10.64.37.219
root@ubuntu:~#
x86 Platform
Install a 64-bit Ubuntu 20.04 system on a physical x86 machine and configure the network environment properly. Alternatively, you may use a virtual machine or Docker container, though performance may be lower.