Quick Start

Last updated: September 8, 2021

JeVois-Pro: Take a quick tour

Congratulations on getting a JeVois=Pro smart camera. The future of machine vision now lies on your hands. Please take a moment to familiarize yourself with the external features of your JeVois-Pro smart camera.

Download MicroSD card image

If you have received a MicroSD card with all JeVois-Pro software pre-loaded, advance to Safe Handling and Inserting the MicroSD card.

All the operating system and machine vision software for JeVois-Pro resides on a MicroSD card that you insert directly into the smart camera. Download the pre-packaged JeVois-Pro MicroSD card image. This is for cards at least 64GB in size.

Download MicroSD Image

Flash image to MicroSD card

The JeVois disk image is a raw, sector-by-sector dump of the whole MicroSD card. Flash it to the physical MicroSD as you would with any raw disk image.

Ubuntu tip

On Ubuntu, to prevent Nautilus from opening 3 windows each time you insert a JeVois microSD card (which gets annoying after a while), type this in a terminal:

gsettings set org.gnome.desktop.media-handling automount-open false

Perhaps the easiest is to use the free program Etcher from balena.io, as follows:

  • Download and install the free and open-source Etcher program. We have cached versions here:

    Etcher 1.5.18 Windows x64   Etcher 1.5.18 Linux x64   Etcher 1.5.18 MacOS

  • Attach your microSD card to your computer using a USB-to-microSD adapter or other card reader.
  • Start Etcher.
  • Select the .zip image file you downloaded, or the .img file if you have unzipped.
  • Select the drive corresponding to your microSD card.
  • Click flash and wait until complete. Your card is ready to be inserted into your JeVois smart camera.

If needed, you can also see detailed instructions here.

Safe Handling and Inserting the MicroSD card

Always observe these safe handling instructions:

  • Avoid electrostatic discharge by using proper grounding when touching the device.
  • Do not expose to rain.
  • Do not push on the center of the fan. It is held by three small prongs that can very easily break.
  • Instead, always hold the smart camera from its sides.
  • Do not disassemble. No user-serviceable parts inside.
  • Avoid liquids or moisture.
  • Do not use wet hands.
  • Consumer-grade device: Do not use in medical or life-sustaining applications, or with heavy machinery.
  • Read and understand the user manual at http://jevois.org/doc before using.
  • Dispose of the device according to your country's requlations about disposal of electronic devices.

Handle with care!

JeVois-Pro is a sensitive high-technology device. Make sure you handle it with care and be especially mindful of protecting the cooling fan and allowing good airflow that is essential for operation.

Be careful with the connectors!

The connectors on JeVois-Pro are fragile and are not designed for mechanical stress. This is especially true for the micro-HDMI connector. If you rip or bend it, it will be nearly impossible to replace (it has 2 rows of pins with pitch 0.4mm, one of which is completely under the connector body). Be sure to provide strain relief when mounting JeVois-Pro on a mobile platform. For example, use zip ties to secure the HDMI cable to the platform onto which JeVois-Pro is mounted, so that when the platform moves there is no force applied to the connector.

See the photograph below for an example where JeVois-Pro is mounted on a tripod. To avoid stress on the micro-HDMI connector, we secured the HDMI cable to the tripod using zip ties. This way, pulling on the HDMI cable will not stress the micro-HDMI connector.

Insert the MicroSD card as shown here:

Push-Push MicroSD slot

Your JeVois smart camera features a push-push MicroSD card slot: Push until it clicks to insert it, push again until it clicks to eject it. Never try to pull on the MicroSD card. When properly inserted, your MicroSD card should not stick out of the JeVois case, but should be completely in, about 1.5mm or 1/16" past the edge of the mini-USB connector.

Click on the photograph above for a high resolution view.

Some MicroSD cards are a bit thicker than others, and will not fully eject. In this case, first push on the card until it sticks out of the case by a few millimeters, then carefully pull it out with tweezers.

Connect monitor, keyboard, mouse and enjoy!

Connect JeVois-Pro to an HDMI monitor or TV (must be able to display 1080p/30Hz), USB keyboard, USB mouse, and finally to power, and enjoy!

Take the JeVois guided tour

Want to discover what your new JeVois smart camera is capable of? Our guided tour will walk you through many of its available machine vision modules, from simple edge detection, to QR-code decoding, to detecting and recognizing objects in complex scenes.

Download Guided Tour              

  • Brief explanation of what each machine vision module does.
  • Example screenshots.
  • Sample images that you can show to your JeVois camera.

Try it out with your kids!

Video Tutorials

Coming soon!

Included machine vision algorithms and demos

The following machine vision algorithms are included and ready to run from the MicroSD card image.

More are available, see the user documentation.

  • JeVois Intro - Interactive introduction to JeVois
    • YUYV 640x360 @ 30.0 fps
    • YUYV 640x480 @ 30.0 fps (video is flipped horizontally, for Mac with PhotoBooth, which flips video)
  • Object Detect - Object detection and matching using keypoint matching, can learn new objects live.
    • YUYV 320x252 @ 30.0 fps
  • Object Tracker - Color-based object detection/tracking.
    • YUYV 320x254 @ 60.0 fps
  • Demo QR-Code - QR-code and barcode detection and decoding using the ZBar library.
    • YUYV 320x286 @ 30.0 fps
  • Demo ArUco - ArUco augmented reality markers detection and decoding.
    • YUYV 320x260 @ 30.0 fps
  • Road Navigation - Detects road using a edge and texture analysis; from Chang, Siagian and Itti, IROS 2012.
    • YUYV 320x256 @ 30.0 fps
    • YUYV 176x160 @ 120.0 fps
    Additional modes with no USB output (select using the JeVois command-line interface):
    • Camera grabs at 320x240 @ 30.0 fps, no USB output
  • Demo Background Subtract - Background subtraction and moving object detection.
    • YUYV 320x120 @ 30.0 fps
  • Optical Flow - Fast optical flow computation using OF_DIS.
    • GREY 176x288 @ 100 fps
  • Saliency SURF - Salient region detection and identification using keypoint matching.
    • YUYV 320x288 @ 30.0 fps
  • Saliency + Gist + Face Detection + Object Recognition - Find salient objects, faces, handwritten digits.
    • YUYV 640x312 @ 50.0 fps
  • Demo Saliency - Visual attention using the visual saliency algorithm of Itti et al., IEEE PAMI, 1998.
    • YUYV 640x300 @ 60.0 fps
  • Demo Eye Tracker - Detect position and orientation of your pupil using the openEyes toolkit.
    • GREY 176x144 @ 120.0 fps
  • Salient Regions - Extract the most salient regions and send them out for further processing on the host computer.
    • YUYV 64x192 @ 25.0 fps
  • Edge Detection - Detect edges using the Canny algorithm from OpenCV.
    • GREY 640x480 @ 29.0 fps
    • GREY 320x240 @ 59.0 fps
  • Edge Detection X4 - Detect edges, running 4 filters in parallel with 4 different settings.
    • GREY 320x960 @ 45.0 fps
  • Demo CPU + GPU - Image filtering using 4-core CPU processing plus dual-core OpenGL-ES 2.0 shaders on the Mali-400MP2 GPU.
    • GREY 160x495 @ 60.0 fps
  • Demo NEON - Image processing using ARM Neon acceleration, comparing a box filter (blur) between CPU and Neon.
    • YUYV 960x240 @ 30.0 fps
  • Dense SIFT - Dense SIFT feature descriptors extraction.
    • GREY 128x117 @ 5.0 fps (note: slow and buggy!)
  • Save Video - Save captured camera frames into a video file.
    • YUYV 320x240 @ 60.0 fps
    • YUYV 160x120 @ 60.0 fps
    • YUYV 176x144 @ 120.0 fps
    • YUYV 88x72 @ 120.0 fps
    Additional modes with no USB output (select using the JeVois command-line interface):
    • Camera grabs at 320x240 @ 60.0 fps, no USB output
    • Camera grabs at 320x240 @ 30.0 fps, no USB output
    • Camera grabs at 176x144 @ 120.0 fps, no USB output
  • Convert - Simple module to convert between any supported camera grab formats and USB output formats.
    • MJPG 352x288 @ 60.0fps - converts from camera sensor grabbing BAYER 352x288 @ 60.0 fps
    • MJPG 320x240 @ 30.0 fps - converts from camera sensor grabbing RGB565 320x240 @ 30.0 fps
    • MJPG 320x240 @ 15.0 fps - converts from camera sensor grabbing YUYV 320x240 @ 15.0 fps
    • MJPG 320x240 @ 60.0 fps - converts from camera sensor grabbing RGB565 320x240 @ 60.0 fps
    • MJPG 176x144 @ 120.0 fps - converts from camera sensor grabbing BAYER 176x144 @ 120.0 fps
    • MJPG 160x120 @ 60.0 fps - converts from camera sensor grabbing YUYV 160x120 @ 60.0 fps
    • MJPG 88x72 @ 120.0 fps - converts from camera sensor grabbing RGB565 88x72 @ 120.0 fps
  • Burn Test - Run the quad-core saliency demo while also loading up CPU, GPU and NEON in the background.
    • YUYV 640x300 @ 10.0 fps
    Note that the BurnTest module is terminal, i.e., you may not be able to switch out of it and to something else. Just quit your video grabber software, unplug your JeVois smart camera, and start again.

See the user documentation for more!

Quickstart reference card

Coming soon!

Troubleshooting

See http://jevois.org/doc/ProUserQuick.html for some tips.

When all else fails

Just email us at jevoisinc@gmail.com and we will help you!

For more information

See the master documentation for JeVois at http://jevois.org/doc/ for more information.