Jetson/Cameras

Camera interfaces on Jetson Platform
The Jetson boards provide several different interfaces that allow camera input:
 * USB 3.0 port (supports many USB 2.0 or USB 3.0 webcams). Additional USB 3.0 ports can be added through mini-PCIe, eg: mini-PCIe (untested).
 * USB 2.0 port (through a micro-B to female USB-A adapter, that is sometimes included with Jetson).
 * Gigabit Ethernet port. Additional Gigabit or Dual-Gigabit Ethernet ports can be added through mini-PCIE, eg: mini-PCIe (untested).
 * MIPI CSI-2 camera ports (up to 12 lanes at 2.5Gbps each)
 * Firewire (available through mini-PCIe), eg: mini-PCIe (untested).
 * Analog video capture cards, available through mini-PCIe (eg: mini-PCIe (untested)), USB 3.0 (eg: USB 3.0 (untested)), or USB 2.0 (eg: USB 2.0 (untested)).

It is also possible to use Multiple cameras, Stereo cameras, or Specialized camera sensors as discussed further below.

Many of these cameras can be accessed by following the Camera access section, also further bellow.

= Interface details =

USB 2.0
USB 2.0 (480 Mbps) is the most common & cheapest method for camera input, since USB 2.0 webcams range from $5 - $200. However, USB 2.0 is the slowest of the possible camera interfaces, so it usually only supports upto 720p 30fps (eg: Logitech C310 $45 (untested)), (except for the few USB 2.0 cameras supporting 1080p video compression, such as Logitech C910 (untested)). Logitech C910 is known to work on Jetson TK1 in uncompressed modes but has not been tested in 1080p compressed mode.

Typically, webcams are successfully giving the same frame-rates & resolutions on Jetson TK1 as on an x86 desktop running Linux (eg: 640x480 @ 30 FPS, 960x720 @ 15 FPS, and 1920x1080 @ 15 FPS). Note that many webcams will run slower if there is low lighting, so for example, it might be 30 FPS when pointed at a bright light but only 10 FPS when pointed at a shadow.

Disabling USB auto-suspend
Some USB devices & cameras have problems on Jetson TK1 due to automatic suspending of inactive USB ports in L4T 19.2 OS to save power. So you might need to disable USB auto-suspend mode. This will disable it temporarily until you reboot: sudo bash -c 'echo -1 > /sys/module/usbcore/parameters/autosuspend' To automatically disable USB auto-suspend on bootup, follow the instructions to Run a command automatically on bootup.

Or edit kernel parameters in  to add. (usbcore is built in the kernel so modprobe method would not work.)

USB 2.0 webcams known to be working

 * Rocksoul WC-102 5MP
 * e-CAM83_USB - 4K High resolution HDR USB camera
 * e-CAM82_USB - 8MP SONY STARVIS™ IMX415 USB camera
 * e-CAM512_USB - 5MP Edge AI Smart Camera
 * e-CAM51_USB - 5MP USB Board Camera (OEM)
 * Hyperyon® - 2MP SONY STARVIS IMX290 USB camera
 * Gearhead WC4500AFW
 * Logitech C210
 * Logitech C615
 * Logitech C920
 * Rocketfish HD Webcam Pro
 * Creative Live! Cam Chat VF0700
 * Generic "Full HD 1080p" webcams using the Realtek chipset
 * Microsoft LifeCam HD-3000
 * Microsoft LifeCam Studio


 * Sony PlayStation Eye (PS3 Eye) (can give very fast framerates, but some extra steps are required).

USB 2.0 webcams with known problems

 * Microsoft LifeCam HD-5000 does not work. Please use a different model such as LifeCam HD-3000 instead.

Note: If a webcam or video capture card is supported by UVC or Video4Linux (see examples) then it will probably work the same on Jetson TK1 as on a desktop, but there is a possibility that it requires the firmware to be copied to your "/lib/firmware" folder or potentially even compiling & flashing your own custom Linux kernel with appropriate drivers enabled.

USB 3.0
USB 3.0 (5 Gbps "SuperSpeed") on the full-sized USB port (J1C2 connector) has enough bandwidth to allow sending uncompressed 1080p video streams. But USB 3.0 hasn't reached the mass consumer market like USB 2.0 has, so USB 3.0 cameras are mostly still limited to expensive professional-grade cameras. eg: PointGrey Flea3 1080p @ 60 FPS (working!) or e-Con See3CAM_CU130 1080p @ 60 FPS (working!) or Ximea MQ003CG-CM 480p @ 500 FPS (not tested).

Enabling support for USB 3.0 on the full-sized USB port
Note that early versions of Linux4Tegra didn't come with USB 3.0 support enabled, and thus you might need to enable USB 3.0 support and re-flash your whole L4T system. According to the L4T R19.2 Release Notes, you should modify the odmdata settings (in "pm375_release_armhf/Linux_for_Tegra/jetson-tk1.conf") to enable USB 3.0: ODMDATA=0x6209C000; Then flash your L4T system and reboot.
 * 1) Use ODMDATA=0x6009C000 for USB 2.0 operation or for use as a root device.
 * 2) Use ODMDATA=0x6209C000 for USB 3.0 operation. Requires firmware loaded from userspace or initial ramdisk.

Enabling USB 3.0 support on L4T 21.2 is easier. You only have to change one parameter in: /boot/extlinux/extlinux.conf Change usb_port_owner_info=0 to usb_port_owner_info=2 and reboot.

USB 3.0 webcams known to be working

 * NT - Not Tested

e-con Systems have tested many of their USB 3.0 cameras with Jetson TK1] [Jetson TX1] [[Jetson TX2. They require flashing a custom Linux kernel that has the CONFIG_HIDRAW setting enabled, by following their tutorial, or using the The Grinch kernel by Korneliusz Jarzębski.

Several PointGrey USB 3.0 cameras with CS-mount lens and Global Shutter have been tested as working on Jetson TK1:
 * PointGrey BlackFly model BFLY-U3-20S4C-CS with 1624x1224 @ 15 FPS works (tested on L4T 21.3.3).
 * PointGrey Flea3 model FL3-U3-13E4C-C with 1280x1024 @ 60 FPS has been tested and works with L4T 21.2 on Jetson TK1.

Setup steps for the PointGrey Flea3 camera to work on Jetson TK1: usbcore.usbfs_memory_mb=1000 to /boot/extlinux/extlinux.conf
 * Install FlyCapture SDK for ARM Hard Float
 * Enable USB 3.0 support
 * Disable USB auto suspend
 * You need to configure USBFS so that all pixel formats of the camera can be used. Configure USBFS describes how to do it for Grub. The same can be done on Jetson TK1 by adding:

IDS uEye cameras
 * UI-3241LE tested on L4T 21.3, can capture at full frame rate and resolution (1280x1024, 60fps, 8bit mono) through native USB3 port. Experienced very poor performance when connected through this mini-PCIe USB3 adapter, (see forum).

Gigabit Ethernet


"IP Cameras" are fairly easy to find and are a good option for single or multiple cameras. Gigabit Ethernet (1 Gbps) has enough bandwidth for uncompressed 1080p video streams. eg: GigE cameras (untested) or regular IP network cameras. Nico notes that older GigE cameras typically do not apply any compression, since compression is a feature of the newer GigE Vision 2 standard, and thus most industrial GigE cameras for computer vision don't have compression and send Bayer images instead. IP cameras typically have M-JPEG compression as well as a video streaming server such as by providing a URL where M-JPEG or JPEG frames are available.

Firewire


Firewire has been used for professional video capture for a long time, since Firewire cameras do a lot of both the compression and the data transmission in hardware and thus don't put nearly as much stress on the host CPU compared to USB.

CSI MIPI
CSI-2 MIPI is the method used for smartphone cameras and is the most efficient method for camera input, since the cameras are tiny (just a few millimeters in size!) and the images can be processed directly by the ISP rather than needing to be stored into the computer's DRAM first before processing. However using a raw CSI MIPI camera sensor directly requires much more work than using a USB, Ethernet or Firewire camera. If you are designing your own custom embedded product for mass-production then CSI MIPI is the recommended camera solution. Luckily, for hobbyists & DIY there are now some MIPI CSI camera modules starting to appear for Jetson TK1, that are fairly plug & play.

Building your own custom MIPI CSI-2 camera module
Some embedded systems engineers may wish to design their own MIPI CSI-2 camera boards. This is not an easy task, but it is possible by using the information shown in the Tegra K1 Embedded Platform Design Guide (Chapter 3.6: Video Input Interfaces) and taking care of the following guidelines:
 * 1) GPIO/Pinmux selection, take care of the same power rail level and on/off power domain in different use case
 * 2) Take care of the FPC and connector quality
 * 3) EMI isolation from the nearby source
 * 4) Suggest independent LDO source for sensitive rails
 * 5) Check the I2C speed of the clients on the same I2C bus, which impact the camera response time

= Multiple Cameras =

There are several ways to handle multiple cameras on Jetson TK1 at the same time:
 * Ethernet: multiple IP cameras on a network (eg: several TRENDnet Internet Cameras (untested) at $118 each). Theoretically you could have 6 x FullHD 1080p 30fps cameras using 3 x Gigabit Ethernet ports on Jetson TK1 (discussed on the forum)!
 * CSI MIPI: 2 cameras (eg: a front camera and a rear camera (untested)).
 * CSI MIPI bridge：aim to the ADAS or 360 deg view applications,a project(named 4eyes project) had been tested by DCDZ,supports up to 4 cameras via POC(power over cable). HDR 720p 30fps OmniVision's sensors, 3 meters RG174 cable

= Stereo Cameras =

USB

 * e-con Systems : (Tara - USB Stereo Camera) for $249. 3D USB3 stereo camera is based on OnSemi imaging's MT9V024 image sensor. Known to be working correctly on Jetson TK1. It also works with the ROS.
 * Code Laboratories: (DUO MLX) (Known to be working / Manufacturer Supported on Jetson TK1. See DUO3D on Jetson).
 * Stereolabs: (Zed) for $449. USB 3.0 stereo camera that includes depth from stereo using a CUDA-capable GPU. Known to be working correctly on Jetson TK1.
 * IDS: (N10) (untested).
 * Leopard Imaging: (LI-USB30) (untested).

Firewire
(Would require a Firewire mini-PCIe card).
 * Point Grey: (Bumblebee XB3)(untested).

= Specialized camera sensors =
 * Time-Of-Flight 3D depth "RGBD" cameras (eg: Microsoft Kinect is known to work, see details below).
 * Night-vision or Thermal-imaging Infrared cameras, typically with interfaces similar to standard cameras.
 * Video frame grabbers, including a HDMI capture card discussed below.


 * e-con Systems' (3D Time-of-Flight camera) that houses both Depth and RGB cameras in a single solution.

Microsoft Kinect Structured-Light 3D Depth camera


Several users (eg: HellMood) have been able to use a Kinect camera on Jetson TK1, after disabling the USB auto-suspend (mentioned above).

Then you need to follow the Kinect Manual Installation Guide rather than the many x86 based guides, since the Tegra CPU uses ARM architecture.

User HellMood also posted a video showing the new Kinect camera working on Jetson TK1: MoodShades Preview.

Asus XTion Pro Live RGB-D Sensor using OpenNI2 library
Asus XTion Pro Live is a RGB-D sensor based on the Primesense's patent (Primesense has been acquired and deleted by Apple in the end of 2013) that drives the first Microsoft Kinect. Asus Xtion sensor, differently from Microsoft Kinect, can be powered directly by USB cable not requiring an external power source.

You can find a guide to compile OpenNI2 library for Jetson TK1 and use it to interface Asus XTion Pro Live on the blog of the robotic project MyzharBot.

AVerMedia HDMI capture card
AVerMedia sell a mini-PCIe frame grabber device that allows capturing HDMI input (or DVI or VGA) and fully supports Jetson TK1. For example, it could allow processing live video from a GoPro camera. More info here.

= Camera access = To see which video capture devices you have available: ls /dev/video* To see the supported video formats of your webcam: sudo apt-get install luvcview luvcview -d /dev/video0 -L You can also use luvcview to record video from your webcam to a video file. It will open a GUI window showing the camera preview. Then along the middle of the bottom row there are 4 rectangle buttons, click the bottom-left of the 4 buttons to start/stop video recording, and the bottom-right button to quit. To record video using the default settings of your webcam: luvcview -o out.avi To record video using a custom resolution (of those shown when running luvcview -L above): luvcview -o out.avi -s 640x480 Normally, guvcview can be used to adjust default camera settings, but it seems that the default guvcview is not working correctly on ARM due to a kernel change.

= Camera Drivers =

What happens if the driver I am looking for is not on the list? RidgeRun has a wide experience in the development of kernel drivers, if the driver you are looking for is not on the list, it is most likely because they haven't received a request for it yet, but they can create it for you. Feel free to Contact Them if you have a special driver request, they would be glad to help you. For more information, please visit this page.