Installation of AIM 2024 software stack

Guide to install setup for NXP AIM CUP CHALLENGE.

To run Gazebo you will need an Ubuntu Linux (22.04) environment. You can run the Ubuntu as a native OS or as a virtual machine. Recommended specs for running the Gazebo simulation environment are as follows:

ComponentAmount

Processor

Any modern quad-core processor or better

RAM

8GB of RAM or better

Hard Disk Space

~20GB of space (SSD recommended)

Installation of Ubuntu 22.04

Notice

It is advised to have a steady internet collection and system to be plugged onto power as installation and setting up the setup will take a long time to finish. We also advise you to perform this installation on a clean Ubuntu 22.04 installation.

Steps for Ubuntu 22.04 setup

Steps to setup ubuntu are described in the attached PPT below. Both methods for dual boot and only ubuntu BIOS are mentioned below:

The slides are made in reference for ubuntu ver 20.04, but same steps apply for latest versions as well.

Setting up SSH keys

To use NXP Gazebo, you will need to have a GitHub account. The installation scripts require a GitHub account with an SSH key.

Creating an SSH key

To create an SSH key, run the following in a terminal:

$ ssh-keygen

Follow the prompt. We suggest just pressing enter until you reach the end. It will be easier if you just use the default path for the id_rsa file and if you go without a passphrase (though you're welcome to use one!). You should get the output below. Note that the RSA key is not shown here for security reasons:

Next, you'll want to install xclip. This program will allow you to copy the contents of the id_rsa.pub file to your clipboard so you can paste it into GitHub. To install xclip, run the following command:

$ sudo apt install xclip git

Once you've installed xclip, you need to copy the id_rsa.pub file to your clipboard. To do so, run the following command:

$ xclip -sel clip < ~/.ssh/id_rsa.pub

Adding your SSH key to GitHub

Now, log into your GitHub account and paste your SSH key. The SSH key field is located in your account settings under "SSH and GPG keys". Add a new SSH key by pressing "New SSH key" and pasting your SSH key in the box. Make sure to give it a name!

Once you've done this, you're ready to begin the installation.

Installing the Setup

Install the following package which contains a python installation script to be used in next steps.

Please make sure you are using the updated installer, uploaded on 15th July,2024 (10 PM IST).

Python version check

You can check your python version by using the following command:

$ python3 --version

The output should be something like this:

If python version is 3.11 or greater than 3.11, make sure to run the following command:

$ sudo rm /usr/lib/python3.11/EXTERNALLY-MANAGED

(Note: Replace the python3.11 with you installed version. For example, if your installed version is 3.12.06, the you should write python3.12)

Running the Installation Script

To run the installation script follow the steps below:

  1. Install streamlit

$ sudo pip install streamlit

  1. Navigate to the folder where you have downloaded the installation script

  2. Run the following command

$ streamlit run AIM_S3_Install_Script.py

On running this command, if it asks for your email, you can skip that by just pressing enter. After that the following should be opened on your default browser:

If the above page does not open on its own, you can go to your default web browser and paste this:

$ localhost:8051

Make sure to check that username and password have been entered before executing any SET

Step-1

Execute SET 1 commands by pressing the Sart Installation (SET 1) button Wait for the script to run. After the script has been run, the following can be seen:

The progress and the outcome can also be verified from the terminal on which you ran the ‘streamlit run …’ command. The output will be something like:

** After runing SET 1, please restart your device. **

If SET 1 fails, you can manually follow SET 1 steps from this link: https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html

Step-2

Now, after restart, again go the directory where you downloaded the installation script and run the ‘streamlit run …’ command again. Now the Start Installation (SET 2) button should be enabled

Once again enter your username and password and press the Start Installation (SET 2) button. Now wait for some time till the commands ran successfully message pops up

Now wait for a pop-up terminal window to open… Enter 1, to choose the airy release

Again Enter 1, to choose native installer

Enter your device password

Enter y, when asked to clone repositories with git using already setup github ssh keys

Enter yes, when asked if you are sure you want to continue connecting

This will take some time to download and install. After successfully running, the terminal will automatically close and you will be notified with following on main terminal:

Now run the following command in a seperate terminal:

$ source ~/.bashrc

After successful Installation there should be a folder named cognipilot in the home directory and the ~/cognipilot/ directory should look like this:

Now please restart your device.

Step-3

Now the Start Installation (SET 3) button should be enabled

Once again enter your username and password and press the Start Installation (SET 3) button. Now wait for some time till the commands ran successfully message pops up. _This may take some time (upto 10 mins) depending on your device configurations.

After running SET 3, the directory structure inside the ~/cognipilot/ folder should look like the following:

If SET 3 fails multiple times, or if the directory structure does not resemble the picture above, restart your device and run the following command on terminal after restart:

$ cd ~/cognipilot
$ build_workspace

Now please restart your device.

Step-4

Now the Start Installation (SET 4) button should be enabled.

Once again enter your username and password and press the Start Installation (SET 4) button. Now wait for some time till the commands ran successfully message pops up:

Now please restart your device.

Step-5

  1. Download the file from the following link:

https://396338415-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU93yDWZcgjXGgsC1Duqv%2Fuploads%2FlOvM24532lSgdGTQmH49%2Fupdate_repos_native.sh?alt=media&token=dce08eda-26f1-440e-8ca7-cf8ac297b1d4

  1. Rename the file as: update_repos_native.sh

  2. Save the file in the following directory: _~/cognipilot/

  3. Run the following commands in a new terminal

$ cd ~/cognipilot
$ chmod +x update_repos_native.sh
$ ./update_repos_native.sh

Close this terminal and now run SET 5 of installation script, which should be enabled now:

Once again enter your username and password and press the Start Installation (SET 5) button. Now wait for some time till the commands ran successfully message pops up.This may take some time (upto 10 mins) depending on your device configurations.

Now please restart your device.

Step-6

Now the Start Installation (SET 6) button should be enabled.

Once again enter your username and password and press the Start Installation (SET 6) button. Now wait for some time till the commands ran successfully message pops up:

_Congratulations, you are done with the Install and Setup!

Troubleshooting after final step of installation

If you are getting a similar error message at the end of step-6:

It means that there was some error in one of the modules. To rectify this follow the following steps: Run the following command in a new terminal:

$ cd ~/cognipilot/cranium
$ colcon build

You will get a similar output as follows:

Over here you can see that there was a error in synapse_ros , Identify where all error is coming in your case in a similar way. Now run the following commands in the folder where the error is identified. For example for _synapse_ros error as above, we need to run the following command in the _~/cognipilot/cranium/src/synapse_ros/

$ cd ~/cognipilot/cranium/src/synapse_ros/
$ git checkout

The branch should be airy. If it is any other branch (like in the image below):

Run the following command to change the branch:

$ git checkout airy
$ git pull

Output should be as follows:

After doing the above steps for all the nodes that had error, run the following command:

$ cd ~/cognipilot/cranium
$ colcon build

Now you should get the following output:

And a similar popup should appear:

Now you are ready to run the simulation.

PreviousIntroduction to AIM 2024NextRunning of AIM 2024 software stack

Last updated