Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page will guide you through the installation process of the Lab:

  1. Install  Ubuntu 18.04.3 LTS.
    https://releases.ubuntu.com/18.04/                                                                     or

    https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu     or

    https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-windows
    Create a folder called dev in your home directory
    Clone our cpm software repository into your dev-folder by typing:
    cd ~/dev
  2. Create the folder '~/dev' and open it in a terminal:

    Code Block
    languagebash
    cd ~
    mkdir dev
    cd dev


  3. Clone the CPM Lab software repository:

    Code Block
    languagebash
    git clone https://github.com/embedded-software-laboratory/cpm_lab
    .gityou have to enter your git username and password
     software


  4. Prepare to run our installation script by getting a license.dat-file for the RTI DDS Connext Service (ask your supervisor if you are a student or get into contact with RTI). This is not required if you are running the eProsima version (which is not yet present in the master branch).
  5.  Run our script to install all necessary components.  In the software- folder you have just cloned you find 'setup_cpm_build_environment.sh'. You PC will reboot in the end to finish the environment variables setup install.sh.

    todofull installationsimulation setup only
    run


    Code Block
    languagebash
    cd software/

    
    sudo bash 
    setup_cpm_build_environment
    install.sh



    Code Block
    languagebash
    cd software/

    
    sudo bash 
    setup_cpm_build_environment
    install.sh --simulation


    What will it install?Unbuntu packagesUnbuntu packages

    Joystick/ GamepadJoystick/ Gamepad

    RTI DDS Connext or eProsimaRTI DDS Connext or eProsima

    RTI ARM or eProsima ARM

    OpenCV 4.0 for the Indoor Positioning System

    Basler Pylon 5 for the Indoor Positioning System and lab camera


    Info
    titleChange DDS Domain

    If you want to change the DDS Domain later, go to change the corresponding variable DDS_DOMAIN in /etc/profileCurrently at .d/rti_connext_dds.sh.

    The following domain IDs are used in the CPM Lab the IDs are the following:

    Domain IDPurpose
    21main PC60Lab (main computer, NUCs, vehicles)
    61-66Lab PCStudent computers



    Info
    titleChange RTI license file
    If you want to update your license file, change the file at: /opt/rti_connext_dds-6.0.0/rti_license.dat

    Run the build script.

    Info
    titleClones also cpm library
    It will also clone the cpm library so keep your git username and password on hand


  6. Reboot your PC.

  7. Optional:
    Setup MATLAB. As a student from RWTH, you can do this with a MathWorks account following these instructions.
    For RTI DDS: Download the DDS Support Package for MATLAB and install the toolbox. The native DDS addon that ships with MATLAB versions from 2021a only supports Simulink. If you are going to code in MATLAB, install the corresponding package from the link.


    To use MATLAB  with eProsima, look here.

    Note

    Make sure to create a symbolic link to the MATLAB binary during or after the setup!


  8. Run the build script.

    full setuponly simulation setup


    Code Block
    languagebash
    ./build_all.bash



    Code Block
    languagebash
    ./build_all.bash --simulation



If you
Info
Info
titleProblems during build
titlePermission denied

In case of a permission denied error, check that the scripts in ./bash have the right permissions set (chmod +x)

Troubleshooting
  • If you
    • encounter unexpected errors
    • have problems during the building process
, resolve your error (the first try should be git pull for both folders), then
    • receive an error regarding timing issues of unittests

make sure that the software is up to date and built correctly with

Code Block
languagebash
cd ~/dev/
cpm_base/
sudo
software/
git pull 
git clean -xdf
cd
 
~/dev/software/
sudo git clean -xdf

./build_all.bash


  • If you ever run build_all.bash  as root , you might run into a lot of permission denied  errors. You need to delete all files and folders that were created and rerun as your usual user.

  • If you receive an error like "dds/someheader.h" not found, run the command "rtiddsgen", which should build the necessary cpp-files