For Bell employees and partners, work items are tracked on Trello.
.github
: GitHub Actions files.vscode
: VS Code settingsGUI
: All-in-one GUIPCC
: PCC firmwarePX4
: PX4 and MAVLink filesscripts
: Development scriptsVMC
: VMC flight software
Documentation is located on the docs
branch.
To do development work, you'll want to have Docker setup, along with Python 3.9
with the venv
module.
If you need to install Python 3.9 on Linux, do the following:
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt install python3-pip python3.9 python3.9-venv
sudo -H python3.9 -m pip install pip wheel --upgrade
If you want to build/run Docker images not on a Jetson, run
docker run --rm --privileged docker.io/multiarch/qemu-user-static --reset -p yes
once first.
Refer to individual module README files for specific instructions.
Clone the repository with submodules:
git clone --recurse-submodules https://github.com/bellflight/AVR-2022
cd AVR-2022
If you already have the repo cloned, run
git submodule update --init --recursive
to initialize and/or update the submodules.
We recommend setting git.pullTags
to false
in VS Code workspace settings
to prevent tag errors when doing git pull
, along with installing the
recommended extensions.
Create a Python 3.9 virtual environment:
py -3.9 -m venv .venv # Windows
python3.9 -m venv .venv # Linux
Activate the virtual environment:
.venv\Scripts\Activate # Windows
source .venv/bin/activate # Linux
Finally, you can install all the dependencies so you get autocomplete and type hinting:
python scripts/install_requirements.py
If on a Jetson, clone the repository and check out the git branch you want.
You can now follow the instructions inside
VMC/README.md to run the setup.py
script and add --dev
for development.
Note, with start.py
commands, make sure to add --local
to the command.
This builds the Docker images locally rather than using prebuilt ones from GitHub CR.