Building the ExEFIS Application on device

This is a guide to building and compilint the application on the raspberry pi.

This guide assumes a stock version of our 5.1 or newer image found here:

Once running, ssh into the device. Image 5.1 and newer supports a local USB connection, in addition to the network addition. To ssh using usb type: “ssh pi@raspberrypi.local” into the terminal app of your choice, or if using windows, SmarTTY is a great alternative.

initial SSH into the EFIS

At this point, you’re logged into the device, but the ExEFIS application is still running. To stop the app, type “sudo pkill ExEFIS”. Once the application is stopped, let’s grab the source code from github. I’ve created a “development” folder to put it into by typing “mkdir development”

creating a development folder and checking out the source

Now that we have the source, we need to build it. Image version 5.1 and newer has the QT libraries needed to run the application, as well as the utilities to build it. If you need to manually install the Qt5 dev libraries for any reason, type ” sudo apt-get install qtbase5-dev “

verifying we have the build tools need to install

Let’s build it!

cd into ~/development/ExEFIS/ExEFIS – note that the qt project is buried two layers deep, but the git project is only one deep.

to build, type “qmake”, then type “make” – it will take about 10 minutes to build from a fresh checkout

Start of a build

If checked out from the main branch, it should compile with no errors:

Final steps of a successful build

Now let’s run the application! We’ll need to export the display and remove host access control so we can run the UI on the device from the ssh terminal. Do that by typing “export DISPLAY=:0.0” and “xhost +”. Then run the app using sudo “sudo ./ExEFIS”

running the application after compilation

To terminate the app, use CTRL + C

app termination

Finally, to copy the app into the new autorun location, copy it over ~/ExEFIS by typing “cp ExEFIS ~/ExEFIS” and then reboot. Now, on boot, your application will run.

copying the app into the default location

If you need to restore the original app, you can perform a git pull to restore the repo, or just download the application here:

Leave a Reply