JeVois Tutorials  1.10
JeVois Smart Embedded Machine Vision Tutorials
Share this page:
Setting up for programming JeVois

This tutorial will help you get setup for programming JeVois.

If all you want to do is use existing bundled machine vision algorithms, and possibly develop new modules in Python only, then simply get and flash a microSD image from http://jevois.org/start and check out:

The programming environment is Ubuntu 64-bit, version 18.04 (bionic). Support for 16.04 LTS (xenial) will soon stop as it is becoming increasingly difficult to compile recent code (e.g., OpenCV 4.0.0) on this older Ubuntu release.

It is generally ok to setup the programming environment in a virtual machine (e.g., VirtualBox). Just beware that you may have to resolve issues having to do with granting proper access to either the video camera or the microSD card to the virtual machine. See Using Virtualbox to setup jevois-sdk in a virtual machine for more info.

The video above gets you through the steps of:

Choose your approach depending on your goals

Not all the steps shown in the video above may be required, depending on your goals.

A quick overview of the JeVois software development packages (see JeVois Ubuntu packages and source code repositories for more details):

Keeping that in mind:

Upgrading the Debian packages

Skip to the next section if installing the JeVois Debian packages for the first time.

sudo apt purge jevois-sdk-dev jevois-sdk jevoisbase-platform jevoisbase-host jevois-platform jevois-host jevois-opencv
sudo rm -rf /jevois /var/lib/jevois-build /var/lib/jevois-microsd
sudo apt -f install
sudo apt purge jevois-sdk-dev jevois-sdk jevoisbase-platform jevoisbase-host jevois-platform jevois-host jevois-opencv
dpkg --remove jevois-sdk-dev jevois-sdk jevoisbase-platform jevoisbase-host jevois-platform jevois-host jevois-opencv

You should end up in a state where dpkg --list | grep jevois returns no hits and sudo apt -f update has nothing to update. Then try again from the beginning.

Installing Debian packages the first time

Getting the latest source code from GitHub

You only need to do this if you want to update to the latest version of JeVois from github. If you just want to create your own machine vision module, all you need is to install jevois-sdk-dev as explained above. The use script jevois-create-module to create a new module. See how we do it in the Hello JeVois tutorial.

cd
git clone https://github.com/jevois/jevois.git
git clone https://github.com/jevois/jevoisbase.git
git clone https://github.com/jevois/jevois-sdk.git
git clone https://github.com/jevois/samplemodule.git
git clone https://github.com/jevois/samplepythonmodule.git
git clone https://github.com/jevois/jevois-tutorials.git
Note
If upgrading, cd to each directory instead and run a git pull command to bring your copy up to date with the master repository.

Before compiling for the first time: Getting the contributed packages

This step is automatic as of JeVois v1.5 and can be skipped for that version and later.

The directory jevoisbase/Contrib is for a collection of contributed source code packages.

Before you attempt to compile jevoisbase the first time, you should download and patch those contributed packages, as follows:

cd ~/jevoisbase/Contrib
./reinstall.sh

Compiling JeVois, JeVoisBase, samplemodule

Note
If you recompile jevois and jevoisbase from the latest version from GitHub, then you should also flash those versions to microSD before you proceed with compiling and installing your own modules to microSD. Otherwise, you may end up with older versions of jevois and jevoisbase on your microSD (if it was installed from a microSD image from http://jevois.org/start) which may not work with your new module compiled against the latest version of jevois from GitHub. See Flashing to microSD card for details, especially the section: Pulling the latest from github and re-flashing - full recompilation.