englebert
/
inav-simplefc
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Fork from inav at github. Modified for some special functions needs.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
12453 Commits
1 Branch
0 Tags
255 MiB
 
 
 
 
 
Branch: master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
inav-simplefc/docs/development/Building in Docker.md

2.1 KiB
Raw Permalink Blame History

Building with Docker

Building with Docker is remarkably easy: an isolated container will hold all the needed compilation tools so that they won't interfere with your system and you won't need to install and manage them by yourself. You'll only need to have Docker itself installed.

The first time that you'll run a build it will take a little more time than following executions since it will be building its base image first. Once this initial process is completed, the firmware will be always built immediately.

If you want to start from scratch - even if that's rarely needed - delete the inav-build image on your system (docker image rm inav-build).

Linux

In the repo's root, run:

./build.sh <TARGET>

Where <TARGET> must be replaced with the name of the target that you want to build. For example:

./build.sh MATEKF405SE

Run the script with no arguments to get more details on its usage:

./build.sh

Windows 10

Docker on Windows requires full paths for mounting volumes in docker run commands. For example: c:\Users\pspyc\Documents\Projects\inav becomes //c/Users/pspyc/Documents/Projects/inav . If you are getting error "standard_init_linux.go:219: exec user process caused: no such file or directory", make sure \cmake\docker.sh has lf (not crlf) line endings.

You'll have to manually execute the same steps that the build script does:

  1. docker build -t inav-build .
    • This step is only needed the first time.
  2. docker run --rm -it -u root -v <PATH_TO_REPO>:/src inav-build <TARGET>
    • Where <PATH_TO_REPO> must be replaced with the absolute path of where you cloned this repo (see above), and <TARGET> with the name of the target that you want to build.
    • Note that on Windows/WSL 2 mounted /src folder is writeable for root user only. You have to run build under root user. You can achieve this by using -u root option in the command line above, or by removing "USER inav" line from the .\DockerFile before building image.

Refer to the Linux instructions or the build script for more details.