Skip to content

Latest commit

 

History

History
51 lines (37 loc) · 2.71 KB

README.md

File metadata and controls

51 lines (37 loc) · 2.71 KB

camera-caps

This is a graphical user interface over the v4l2-ctl command line tool. This program supports an upcoming JetsonHacks article and video. There is experimental support for ROI.

Intended Spirit

This app is a simple software sketch built to support a demonstration. It is not fully featured, and certainly not production quality code, but you may find it useful for your own study and experimentation.

On the NVIDIA Jetson family of products, connected cameras generally stream through the V4L2 module. USB cameras go through the uvcvideo module which interfaces with the v4l2 module. Cameras connected through the CSI/MIPI ports (Raspberry Pi camera, GMSL cameras for example) interface with the tegra-video module, which in turn interfaces with the v4l2 module.

Connected cameras show up as /dev/videoX (where X is the ID number) when connected with the proper drivers installed. Properly connected and registered, you can use the v4l2-ctl utility to examine the properties of the cameras. This includes the available pixel formats, frame sizes, frame rates, and properties. There are controls to adjust the properties of the camera. The GUI provides a consolidated view:

Screenshot

ROI

There's a quick and dirty Region of Interest (ROI) feature. Select the camera window, then use the left mouse button to select a rectangle. The rectangle becomes the region of interest, and the camera window displays only the ROI. Press 'Esc' to remove the ROI. Only one ROI may be selected, subsequent attempts are ignored after the first.

Note

Not all cameras provide a V4L2 interface. Some cameras have proprietary interfaces that are not exposed through V4L2.

Installation

$ sudo apt update
$ sudo apt install python3-pip
$ pip3 install dataclasses
# Install v4l2-ctl
$ sudo apt install v4l-utils
$ sudo apt install python3-pyqt5

Running the Program

Before running the program, first make sure that the cameras you want to examine are attached. The program does not detect dynamic attachment. If you plug/unplug a camera, restart the program. Also note that USB cameras do not have a guaranteed address in their /dev/videoX designation. In other words, the address may change when the machine reboots or other cameras are added. To run:

$ python3 camera_caps.py

The preview button attempts to build a GStreamer pipeline and run it in a preview window. The preview window is not the full size of the video image size.

Releases

May, 2024

  • Added ROI for demo purposes

March, 2023

  • Support Ubuntu 20.04/Jetson Linux 35.X
  • Added jetpack-5.x branch

January, 2022

  • Initial Release
  • JetPack 4.6, L4T 32.6.1
  • Test on Jetson Nano, Jetson Xavier NX - Other Jetsons should work