Installation#

The following tutorial has been tested on a clean install of Ubuntu 20.04 LTS Please report any installation problem on the developer forum.

Adding Linux packages#

The first step is to add Parrot packages as a trusted source for your apt packages:

$ echo "deb http://debian.parrot.com/ $(lsb_release -cs) main generic" | sudo tee /etc/apt/sources.list.d/apt.parrot.biz.list
$ curl -sS https://debian.parrot.com/gpg | sudo apt-key add -
$ sudo apt update

Note

If you are behind a firewall, you might need to change the keyserver from keys.gnupg.net to hkp://keyserver.ubuntu.com:80

Once the Parrot package server is added, you can install the required tools:

$ sudo apt install parrot-tools-gcc-aarch64-himix100-linux parrot-tools-passe-muraille

You will also need some standard packages:

$ sudo apt install git python3 python3-pip build-essential pkg-config curl
$ pip3 install pycryptodomex

Configuring GitHub#

It is good practice to configure git with your real name and email address

$ git config --global user.name "Your Name"
$ git config --global user.email "you@example.com"

You need to configure your GitHub account for SSH access. Please follow the GitHub SSH tutorial.

Installing repo#

Repo helps manage many Git repositories.

Note

You can learn how to use Repo on the Repo command reference page

You can install the last version of repo using the following commands:

  1. Make sure that you have a bin/ directory in your home directory and that it’s included in your path:

$ mkdir ~/bin
$ PATH=~/bin:$PATH
  1. Download the Repo Launcher and ensure that it’s executable:

$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo
  1. Make it executable by Python 3:

$ sed -i.bak -e 's;#!/usr/bin/env python$;#!/usr/bin/env python3;' ~/bin/repo

Cloning the workspace#

Important

you need to replace ‘<myuser>’ and ‘<mypassword>’ with the credentials provided by Parrot. To request credentials, please send an email to developer(at)parrot.com with a comprehensive description of your project.

Create your working directory

$ mkdir airsdk
$ cd airsdk

We will first create a .netrc file, so that you can clone to https git repos, without entering your credentials all the time.

$ echo "machine ftp2.parrot.biz login <myuser> password <mypassword>" | tee .netrc > /dev/null

Note

you need to replace ‘<myuser>’ and ‘<mypassword>’ with the credentials provided by Parrot (same as first step)

Initialize Repo in your working directory

$ repo init -u "ssh://git@github.com/Parrot-Developers/airsdk-samples-manifest" -b master

Download the source tree

$ repo sync

Finally, download the latest version of Air SDK.

$ ./build.sh -p classic -t download-base-sdk
$ ./build.sh -p pc -t download-base-sdk

The output should look like this:

../_images/download_airSDK_success.png

You are ready to create your first mission!