Table of Contents Table of Contents General Information ..................3 Cautions ......................3 Hardware ......................5 Software ......................5 Assembling the Hardware ................. 6 Image Acquisition ..................... 9 Using ‘tcam-capture’ ..................9 Using tiscamera SDK Examples ..............12 Using GStreamer ................... 12 Driver Configuration ..................
This application note describes how to get started with the 2-Channel MIPI CSI-2 Carrier Board with Jetson Orin NX SoM, Part-No. CBM-NVA-ONX-16-128-V2. Figure 1: NVIDIA Jetson Orin Reference Design, 2-Channel MIPI CSI-2 Carrier Board with Jetson Orin NX 16 GB SoM and two MIPI CSI-2 cameras.
Page 4
Getting Started Guide CBM-NVA-ONX-16-128-V2 DO NOT INSTALL NEW JETPACK If you install a new JetPack version, The Imaging Source MIPI CSI-2 cameras will not work anymore. MIPI CSI-2 CAMERAS HANDLING Connect MIPI-based cameras ONLY when the system is powered off.
Software For your convenience, some software packages have been pre-installed: • JetPack 5.1.2 with Ubuntu 20.04 LTS. • The Imaging Source drivers, e.g., theimagingsource-drivers_rxxxx.deb: o Drivers required to operate different MIPI-based cameras and carrier boards. tiscamera, e.g., tiscamera_1.1.0.4139_arm64_ubuntu_2004.deb: • GStreamer-based SDK for straightforward image acquisition and image preprocessing.
Getting Started Guide CBM-NVA-ONX-16-128-V2 Assembling the Hardware The procedures described in this chapter should be followed to ensure the best first-time experience with this reference design. 1. Begin by screwing the TBL 8 C lens (for use with the color camera) and the TBL 8 lens (for use with the monochrome camera) into the TLH 10-M lens mount holders.
Page 7
Getting Started Guide CBM-NVA-ONX-16-128-V2 4. Connect the other ends of the FFC cables to the DxM 36SX462-ML cameras (please see image below). MIPI CSI-2 CABLE “CAM SIDE” Pay attention on the lettering of the MIPI CSI-2 cable. Ensure that the cable end with the inscription “CAM SIDE”...
Page 8
Getting Started Guide CBM-NVA-ONX-16-128-V2 MIPI CSI-2 CAMERAS HANDLING Connect MIPI-based cameras ONLY when the system is powered off. Make sure to unplug the power supply and any USB or GigE cables before connecting or re-connecting MIPI-based cameras. Otherwise, the cameras may be damaged, may not be detected, or may not work properly.
Getting Started Guide CBM-NVA-ONX-16-128-V2 Image Acquisition Using ‘tcam-capture’ The easiest way to start with image acquisition and image display is by using the GUI appli- cation tcam-capture which is part of the pre-installed tiscamera SDK. To launch tcam-capture go to Show Applications > type in tcam-capture in the search bar...
Page 10
Getting Started Guide CBM-NVA-ONX-16-128-V2 Select one of the cameras to start image acquisition: and launch image display: AN20250208-01 Application Notes Page 10 of 20...
Page 11
Getting Started Guide CBM-NVA-ONX-16-128-V2 To launch another instance of tcam-capture > right click on the already running tcam-cap- ture instance and select New Window > then open the second camera. Note tcam-capture offers advanced image enhancement functionalities, e.g., auto-exposure, auto-gain, saturation, hue, sharpness, tone-mapping, etc., which are performed on the CPU and may cause higher CPU load.
Getting Started Guide CBM-NVA-ONX-16-128-V2 Using tiscamera SDK Examples The tiscamera SDK provides different SDK examples for the programming languages C and Python. You can find them under: /home/nvidia/tiscamera/examples To get started, change to the C folder and call ‘make’: #cd /home/nvidia/tiscamera/examples/c...
Page 13
Getting Started Guide CBM-NVA-ONX-16-128-V2 For camera '1': #gst-launch-1.0 nvarguscamerasrc sensor-id=0 ! queue ! nv3dsink Note The proper configuration and use of GStreamer is not covered by this docu- ment. AN20250208-01 Application Notes Page 13 of 20...
Getting Started Guide CBM-NVA-ONX-16-128-V2 Driver Configuration If you would like to use a camera model other than the ones included with this reference design, you must reconfigure the camera drivers and reboot the system. To do so, execute the following command in a terminal:...
Page 15
Getting Started Guide CBM-NVA-ONX-16-128-V2 Use the Tab key to select Ok and confirm your choice: Confirm to make the current selection the default one: AN20250208-01 Application Notes Page 15 of 20...
Page 16
Getting Started Guide CBM-NVA-ONX-16-128-V2 Reboot the system to apply the changes, e.g.: #sudo reboot Note If you do not reconfigure the drivers to match your camera model, the camera may not be detected or may not work properly. If you do not reboot the board after reconfiguring the driver, the changes will not take effect.
Getting Started Guide CBM-NVA-ONX-16-128-V2 Documentation Refer to the following offline documentation: To find the Technical Reference Manuals for 36S MIPI CSI-2 cameras, refer to: • https://www.theimagingsource.com/en-de/embedded/mipi-csi-2/36s/ • To open the tiscamera documentation, go to e.g.: /usr/share/theimagingsource/tcamdutils/html # firefox index.html •...
Page 18
Getting Started Guide CBM-NVA-ONX-16-128-V2 Note: The information in the local driver documentation may not always be up to date. Contact the customer support for more information or help. • To find online documentation, e.g., Technical Reference Manual for the carrier board, refer to: https://www.theimagingsource.com/embedded/...
Getting Started Guide CBM-NVA-ONX-16-128-V2 Revision History Document Number Date Changes Initial release version of this document. AN20250208-01 08 February 2025 AN20250208-01 Application Notes Page 19 of 20...
Page 20
The source code presented in this document is exclusively used for didactic pur- poses. The Imaging Source does not assume any kind of North and South America: The Imaging Source, LLC warranty expressed or implied, resulting from the use of 4600 Park Road, Suite 470, Charlotte, NC 28209, USA the content of this document or the source code.
Need help?
Do you have a question about the CBM-NVA-ONX-16-128-V2 and is the answer not in the manual?
Questions and answers