Template:Eval SDK Download, Demo Image download and Contact Us buttons

Problems running the pipelines shown on this page?
Please see our GStreamer Debugging guide for help.

Keywords: OS08A10 Jetson TX2, Gstreamer, NVIDIA, RidgeRun, V4L2 Driver

OS08A10 Features

The Omnivision OS08A10 is an image sensor with the following features:

2 µm x 2 µm pixel
Optical size of 1/1.8"
Programmable controls for:
- Frame rate
- Mirror and flip
- Cropping
- Windowing
Supports output formats:
- 12-/10-bit RGB RAW
Supports image sizes:
- 4K2K (3840x2160)
- 2560 x 1440
- 1080p (1920x1080)
- 720p (1280x720)
Supports 2x2 binning
Standard serial SCCB interface
12-bit ADC
Up to 4-lane MIPI/LVDS serial output interface (supports maximum speed up to 1500 Mbps/lane)
2-exposure staggered HDR support
Programmable I/O drive capability
Light sensing mode (LSM)
PLL with SCC support
Support for FSIN

RidgeRun has developed a driver for the Jetson TX1 platform with the following support:

L4T 28.2.1 and Jetpack 3.3
V4l2 Media controller driver
Tested resolution 3840 x 2160 @ 30 fps
Capture with v4l2src and also with nvcamerasrc using the ISP.

Enabling the driver

In order to use this driver, you have to patch and compile the kernel source using JetPack:

Using Jetpack

Follow the instructions in [1] to get the kernel source code.

Once you have the source code, apply the following three patches in order to add the changes required for the os08a10 cameras at kernel and dtb level.

3.2.1_os08a10.patch

Follow the instructions in (Build Kernel) for building the kernel, and then flash the image.

Make sure to enable os08a10 driver support:

make menuconfig

-> Device Drivers                                                                                                                        
  -> Multimedia support                                                                                           
    -> Encoders, decoders, sensors and other helper chips
       -> <*> OS08A10 camera sensor support

Using the driver

Gstreamer examples

The Gstreamer version distributed with Jetpack doesn't support bayer RAW10 only RAW8 so gstreamer needs to be patched in order to capture using v4l2src. Follow the steps in the following wiki page to add the support for RAW10:

http://developer.ridgerun.com/wiki/index.php?title=Compile_gstreamer_on_tegra_X1

Important Note: When you are accessing to the board through serial or ssh and you want to run a pipeline to display with autovideosink, nveglglessink, xvimagesink or any other video sink, you have to run your pipeline with DISPLAY=:0 at the beginning of the description:

DISPLAY=:0 gst-launch-1.0 ...

Snapshots

In order to check the snapshot, you can use the following tool:

https://github.com/jdthomas/bayer2rgb

So, run the following commands to download the tool and compile it:

git clone git@github.com:jdthomas/bayer2rgb.git
cd bayer2rgb
make
cp bayer2rgb /usr/bin/

Bayer2rgb will convert naked (no header) bayer grid data into rgb data. There are several choices of interpolation (though they all look essentially the same to my eye). It can output tiff files, and can integrate with ImageMagick to output other formats.

3280x2464

gst-launch-1.0 -v v4l2src device=/dev/video0 num-buffers=1 ! "video/x-bayer, format=rggb, width=3280, height=2464" ! filesink location=test_3280x2464.bayer

./bayer2rgb --input=test_3280x2464.bayer --output=data.tiff --width=3296 --height=2464 --bpp=16 --first=RGGB --method=BILINEAR --tiff