Modal AI VOXL2 PX4 Setup Notes

VOXL-PX4

ModalAI's official documentation - 10/9/2025

1. Quickly read over the voxl-px4 doc here

2. Download and install docker (if you dont have it already)

#!/bin/bash


function install {
    echo uninstall old versions
    sudo apt-get remove -y docker docker-engine docker.io containerd runc

    echo update
    sudo apt-get update

    echo dependencies
    sudo apt-get install -y ca-certificates curl gnupg lsb-release

    echo add gpg key
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

    echo set stable repo
    echo \
    "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
    $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    
    echo install docker
    sudo apt-get update
    sudo apt-get install -y docker-ce docker-ce-cli containerd.io

    echo add user to docker group
    sudo usermod -aG docker ${USER}

}

THIS_SCRIPT=$(basename "$0")
install | tee ../logs/$THIS_SCRIPT-$(date +%s)

1. Go to the rb5-flight-px4-build-docker and follow the instructions TO THE T for building the hexagon SDK docker image in the README.md

   
2. Clone down the voxl-px4 wrapper repo and again, follow the README.md to a T

   

3. At the end of the README.md you should have a .deb file that looks like this

   

Zach's Update:

Date: 2/10/2025

1. Go to this folder in the google drive: https://drive.google.com/drive/u/1/folders/1n-W2UfJ83skMiN1X6wTX5oEK5L0TobvK

2. Download the voxl-px4-docker.tar tar docker instance

3. Load the docker tar via: docker load -i voxl-px4-docker.tar

4. Once the docker is loaded (it should take about 20 minutes since its a ~10gb docker image, proceed to clone voxl-px4 via: git clone https://gitlab.com/voxl-public/voxl-sdk/services/voxl-px4

5. Checkout the dev branch of voxl-px4 and then run git submodule update --init --recursive

6. Once this is done and the user is inside voxl-px4 - proceed to run ./run-docker.sh

7. Once you are dropped inside the docker instance, proceed to then run ./build-deps.sh

8. Once this is done running, proceed to run ./build-apps.sh

9. Once this is done running, proceed to run ./build-slpi.sh

10. Once this is done, proceed to run ./make-package.sh- this will create the deb and you are good to go! If a user wishes to build a difference branch of px4-firmware (such as mainline or anything) proceed to just rm -rf px4-firmware, and then clone down PX4 mainline with the naming convention of px4-firmware, eg git clone https://github.com/PX4/PX4-Autopilot px4-firmware --recursive

THE BELOW IS DEPRACATED!!!

Modal AI Setup

Written by: Ascend Engineering Inc.

For: ModalAI

Date: 2/2/2022

DOCKER SETUP

1. THIS ONLY RUNS ON UBUNTU 20.04

2. Create an account with qualcomm developer - https://developer.qualcomm.com/

3. Downloads→Software Downloads → Qualcomm Package Manager - Linux

4. Untar qualcommpackagemanager.lnx_.2.0_installer_20021.2.tar - CD into the downloads dir and run “tar -xz qualcommpackagemanager.lnx_.2.0_installer_20021.2.tar”

5. Run the following commands:

   1. sudo apt-get update

   2. sudo apt-get upgrade

   3. sudo apt --fix-broken install

   4. sudo apt-get install xterm

   5. wget http://launchpadlibrarian.net/416685704/multiarch-support_2.19-0ubuntu6.15_amd64.deb

   6. wget http://launchpadlibrarian.net/201380610/libgnome-keyring0_3.12.0-1build1_amd64.deb

   7. wget http://launchpadlibrarian.net/201380608/libgnome-keyring-common_3.12.0-1build1_all.deb

   8. sudo dpkg -i multiarch-support_2.19-0ubuntu6.15_amd64.deb

   9. sudo dpkg -i libgnome-keyring-common_3.12.0-1build1_all.deb

   10. sudo dpkg -i libgnome-keyring0_3.12.0-1build1_amd64.deb

   11. sudo dpkg -i QualcommPackageManager.2.0.21.1.Linux-x86.deb

6. Run “sudo qpm” and wait about 5 minutes for the GUI to load. Download Hexagontm SDK 4.x PLEASE SELECT V 4.1.0.4 - this will not compile with other iterations of this sdk

7. Proceed to select install from the drop down and install the sdk to the default directory.

8. After finished downloading - cd to the directory the sdk was installed and run the following: tar -czvf sdk.tgz 4.1.0.4

9. Run the following: “git clone https://gitlab.com/voxl-public/rb5-flight/rb5-flight-px4-build-docker”

10. Copy or move the sdk.tgz into the rb5 git repository on your local device

11. Move into the rb5 directory and run the following: “./setup.sh”. This will install the base docker image

12. Proceed to run the “./build.sh” executable after the setup is finished. This will build the docker image.

13. Once this is done, proceed to run “./run.sh” to run the docker image - this will bring the user into the base docker container to continue programming. For some users depending on how they installed docker, they will need to edit the files above by adding sudo before all instances of “docker”.

14. Once inside the docker container, run the following “source /home/build-env.sh”

15. Then run the following: “git clone https://github.com/modalai/px4-firmware”

16. Then move into the px4-firmware directory and run the following: git checkout eric-m0052-master

17. Once done, proceed to run the following commands:

    1. make clean

    2. make modalai_rb5-flight_default

    3. make modalai_rb5-flight_qurt