Installation of AIM 2024 software stack
Guide to install setup for NXP AIM CUP CHALLENGE.
Last updated
Guide to install setup for NXP AIM CUP CHALLENGE.
Last updated
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:
Component | Amount |
---|---|
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 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.
To use NXP Gazebo, you will need to have a GitHub account. The installation scripts require a GitHub account with an SSH key.
To create an SSH key, run the following in a terminal:
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:
Once you've installed xclip, you need to copy the id_rsa.pub file to your clipboard. To do so, run the following command:
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.
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).
You can check your python version by using the following command:
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:
(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)
To run the installation script follow the steps below:
Install streamlit
Navigate to the folder where you have downloaded the installation script
Run the following command
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:
Make sure to check that username and password have been entered before executing any SET
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
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:
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.
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:
Now please restart your device.
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.
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
Rename the file as: update_repos_native.sh
Save the file in the following directory: _~/cognipilot/
Run the following commands in a new terminal
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.
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!
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:
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/
The branch should be airy. If it is any other branch (like in the image below):
Run the following command to change the branch:
Output should be as follows:
After doing the above steps for all the nodes that had error, run the following command:
Now you should get the following output:
And a similar popup should appear:
Now you are ready to run the simulation.
Enter your device usename and password
Processor
Any modern quad-core processor or better
RAM
8GB of RAM or better
Hard Disk Space
~20GB of space (SSD recommended)