Quick Start

Last updated: March 16, 2017

Take a quick tour

Congratulations on getting a JeVois 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 smart camera.

Download MicroSD card image

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

Download Image (438 MB)

Make sure you unzip the file. You should now have a microSD image file named jevois-image-1.0-8G.img or similar.

Flash image to MicroSD card

The JeVois disk image ia 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 resin.io, as follows:

  • Download and install the free and open-source Etcher program.
  • Attach your microSD card to your computer using a USB-to-microSD adapter or other method (e.g., microSD-to-SD adapter on Macs with an SD slot).
  • Start Etcher.
  • Select the .img image file you downloaded and 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.
  • Dispose of the device according to your country's requlations about disposal of electronic devices.

Handle with care!

JeVois 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.

Insert the MicroSD card as shown here, with the golden contacts on the card visible when you are looking down towards the JeVois camera fan:

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.

Connect mini-USB cable and enjoy!

Connect the mini-USB cable to a host computer (desktop or laptop). Make sure you connect your JeVois smart camera to either two USB 2.0 ports (using a Y-type cable that has two USB type-A plugs for two ports on your computer), or one USB 3.0 port.

You should see the following (exact timing depends on speed of your MicroSD card):
  • Immediately after connecting mini-USB cable, LED on JeVois smart camera turns green and fan turns on.
  • About 3 to 5 seconds later, LED briefly flashes orange. This means the operating system has correctly started and the camera video sensor is correctly detected. Machine vision software then loads.
  • About 1 to 2 seconds later, LED turns solid orange. This means machine vision software is ready to run and the JeVois camera is announcing itself as a new device to your host computer.
  • Allow a few more seconds for your host computer to detect and configure the smart camera.
Start a video capture software and enjoy!

  • Linux: sudo apt-get install guvcview && guvcview -ao none -f YUYV -x 640x360
  • Windows: Download and install the free AMCap software.
  • Mac: Start PhotoBooth in your Applications folder.

For more guidance on this last step, see:

Video Tutorials

JeVois intro video from our Kickstarter campaign - advance to 0:35 to see how to insert MicroSD card, plug in mini-USB cable, and start
JeVois mode switching demo - select different machine vision modes by changing video resolution in your video capture software
JeVois getting started with Linux
JeVois getting started with Windows
JeVois getting started with Mac

Included machine vision algorithms and demos

The following machine vision algorithms are included and ready to run when using the latest JeVois MicroSD card image. Note that more machine vision algorithms are available, but they have been turned off to allow compatibility out of the box with Mac host computers, which seem to not support some of the video modes used by JeVois. See the user documentation on video modes and mappings for information and guidance.

  • 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
  • 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
  • Demo Saliency + Gist + Face Detection + Object Recognition - Saliency, gist, face detection, and object recognition.
    • YUYV 640x312 @ 50.0 fps
  • JeVois Intro - Simple introduction to JeVois and demo that combines saliency, gist, face detection, and object recognition.
    • YUYV 640x360 @ 30.0 fps
    • YUYV 640x480 @ 30.0 fps (video is flipped horizontally, for use on Macs with PhotoBooth apps, which flips video)
  • Demo Saliency - Simple demo of the visual saliency algorithm of Itti et al., IEEE PAMI, 1998.
    • YUYV 640x300 @ 60.0 fps
  • Demo Background Subtract - Simple background subtraction, pretty much straight from the OpenCV tutorials.
    • YUYV 320x120 @ 30.0 fps
  • Demo QR-Code - Simple demo of QRcode and barcode detection and decoding using the ZBar library.
    • YUYV 320x286 @ 30.0 fps
  • Road Navigation - Detects road using a combination of edge detection and tracking, 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 NEON - Simple demo of ARM Neon (SIMD) extensions, comparing a box filter (blur) between CPU and Neon.
    • YUYV 960x240 @ 30.0 fps
  • Dense SIFT - Simple demo of dense SIFT feature descriptors extraction.
    • GREY 128x117 @ 5.0 fps (note: slow and buggy!)
  • Salient Regions - Extract the most salient regions and send them out.
    • YUYV 64x192 @ 25.0 fps
  • Demo Eye Tracker - Simple demo of an eye-tracker using the openEyes toolkit.
    • GREY 176x144 @ 120.0 fps
  • Demo ArUco - Simple demo of ArUco augmented reality markers detection and decoding.
    • YUYV 320x260 @ 30.0 fps
  • Edge Detection - Simple module to detect edges using the Canny algorithm from OpenCV.
    • GREY 640x480 @ 29.0 fps
    • GREY 320x240 @ 59.0 fps
  • Edge Detection X4 - Simple module to detect edges, running 4 filters in parallel with 4 different settings.
    • GREY 320x960 @ 45.0 fps
  • Object Tracker - Simple color-based object detection/tracking.
    • YUYV 320x254 @ 60.0 fps
  • Demo CPU + GPU - Simple image filtering demo using 4-core CPU processing and OpenGL-ES 2.0 shaders on the Mali-400MP2 GPU.
    • GREY 160x495 @ 60.0 fps
  • Optical Flow - Fast optical flow computation using OF_DIS.
    • GREY 176x288 @ 100 fps
  • Object Detect - Simple object detection using keypoint matching.
    • YUYV 320x252 @ 30.0 fps
  • Saliency SURF - Simple salient region detection and identification using keypoint matching.
    • YUYV 320x288 @ 30.0 fps
  • Burn Test - This is a 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

Use this convenient quick reference card in the future:

Troubleshooting

Green LED and/or fan does not turn on

This means that there is no power or insufficient power to the camera. Check USB cable and USB port. If powering from a battery bank, check that it is charged and turned on.

Green LED and fan turn on, but LED does not flash orange and does not later turn solid orange

Power seems good but software on the microSD card is not loading. Check that card is fully inserted (see photos above). Check that software has been correctly flashed.

Green LED and fan turn on, orange LED flashes then turns solid, but camera not detected or video capture fails

Power seems ok (at least during startup) and software on the microSD card loads and starts. This suggests that the JeVois hardware is not faulty, yet your host computer fails to properly stream video from it. We have been able to reproduce this condition when using "thin" USB cables, not specified as charging+data cables, but instead specified as data sync cables, and not featuring 28/24AWG wire thickness. The critical number here is 24AWG, which means that the wires in the USB cable that carry power to the camera are thicker and can carry more current. Try a high-quality 28/24AWG or better (28/22AWG, or even 28/20AWG if you can find some; the lower the AWG value, the thicker the wires). We have had good reports with Monoprice brand mini-USB cables that mention 24AWG in their specs, available from Amazon, Newegg, Ebay, etc.

More detailed guidance and troubleshooting

For more troubleshooting tips, see:

and also see the JeVois Tech Zone community forum for user tips and discussions. In particular, it seems that older Mac OSX versions may have difficulties recognizing the JeVois camera, and upgrading to the latest OSX solves the issue. Other reports of failures to start have been solved by getting better USB cables and/or more fully inserting the microSD card.

When all else fails

You may have received a defective unit despite the thorough testing that each unit is subjected to before it leaves the factory. If you have tried the steps above, please contact us through Kickstarter (so that we get your backer info) to request a replacement unit. We will gladly cross-ship a new unit to you immediately. Please keep in mind that the likelihood of defective hardware seems low, so far we have shipped 3 replacement units to backers (out of 1800 units produced), and we have not yet confirmed with these backers that the problem indeed was a defective unit, as opposed to bad USB cables, bad USB ports on their host computer, etc.

If that fails too just email 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.