JeVois Tutorials  1.15
JeVois Smart Embedded Machine Vision Tutorials
Share this page:
Programming a live JeVois camera using Python

In this tutorial, we modify some existing sandbox machine vision module written in Python and already pre-installed on the standard JeVois microSD image. We do this by accessing the microSD inside JeVois live over the USB connection.

For this tutorial, you do not need to install any software (except for a video capture program, if you do not already have one): We will directly edit the Python code on the microSD card that is inside JeVois.


Here, we will focus on step-by-step instructions for how to make all of this work.

Getting started

  • Connect JeVois to your host with the latest microSD image inside
  • Start your video grabber and select resolution YUYV 352x288 @ 30fps which starts the PythonSandbox module. By default this module computes the Laplacian of the input video image and streams the results to USB. It is pretty much identical to the sandbox module covered in Tutorial on how to write new machine vision modules in Python. You should see something like this:
  • The basic workflow for live editing of machine vision modules on JeVois is as follows:
    • Stop grabbing video
    • Instruct JeVois to export its microSD card as a virtual USB drive
    • Browse the virtual USB drive on the host computer
    • Open the Python source code on that USB drive using a text editor
    • Modify the code and save
    • Eject the virtual USB drive. Upon eject, JeVois will restart and when it comes back online we can check the results of our edits by starting the video capture software again.
  • Let's do this! First, quit your video capture software. This is necessary as JeVois will refuse to export its microSD as a virtual USB drive while video is streaming. The reason for that is that accessing that drive at the same time by the JeVois CPU and the host computer poses datacoherency and caching problems. So we shutdown all machine vision modules on JeVois before exporting the microSD over USB.
  • We need to send the command usbsd to JeVois over a serial link to let it know that we want to export the microSD over USB. You can do that by first connecting to JeVois using a serial terminal and then typing this command. For example, use the Arduino IDE to connect, as done in Using the Arduino IDE (Integrated Development Environment) to talk to JeVois.

    Here, since we only want to give that one command to JeVois, we can instead do: