Command Line Switches

The following table shows the nvsipl_camera application's command line switches.

All numeric arguments may be specified in decimal (e.g., 18) or hexadecimal (e.g., 0x12).

Switch

Description

Default Setting

-h

Displays help text.

Display only if an invalid command line argument is found.

-c "name"

Specifies name of platform configuration that describes the connection of image sensors to Orin-based platforms.

Supported configurations are displayed by the -h switch.

Required switch.

--link-enable-masks "<m-AB> <m-CD> <m-EF> <m-GH>"

Enables masks for links on each deserializer connected to camera groups A, B, C, and D.

The number of masks must equal the number of deserializers in the platform configuration selected with the -c switch.

Each mask <m-…> is a two-byte unsigned integer which applies to one deserializer and controls the four links that can be enabled for that deserializer. If the mask is expressed as a four-digit hexadecimal number, the last digit may be 1 to enable link 0 or 0 to disable it; the next-to-last may be 1 to enable link 1 or 0 to disable it; and so on.

For example,

"0x0000 0x1101 0x0000 0x0000" disables all links on the deserializers connected to camera groups A, C, and D, and enables links 0, 2, and 3 on the deserializer connected to camera group B.

All links on all deserializers are enabled.

-d <n>

Specifies the number of displays to send the output to. Supported values are 1 to 2.

Display output is disabled.

-p "x0 y0 width height"

Defines display position (upper left corner is at x0, y0) and dimensions (width, height) of the display rectangle.

Full screen display.

-f "prefix"

Sets a prefix for the output file's name. The name of the created file has the form:

<p>_cam_<s>_out_<n>.<e>

Where:

  • <p> is the prefix. It may begin with a pathname.
  • <s> is the ID of the sensor that originated the images.
  • <n> is the output number, which is 0 for RAW images, 1 for ISP0 output, and 2 for ISP1 output.
  • <e> is the file extension, which is raw for RAW images and yuv for ISP output.

For example, if the prefix is /home/nvidia/test, the pathname of the RAW output file from Sensor0 is:

/home/nvidia/test_cam_0_out_0.raw

No output files are generated.

-r <n>

Exits application after n seconds.

Application runs forever.

-v <n>

Sets verbosity level. Supported values are 0 (only errors are printed) to 4 (maximum verbosity).

0

-t "file"

Specifies a custom platform configuration JSON file.

Application uses its built-in database of platform configurations.

-l

Lists platform configurations defined in the file specified by the -t switch.

-i "file"

Enables simulator mode testing and specifies the RAW file to be used as input source for the SIPL library. --link-enable-masks must be used to enable only one camera module.

Simulator mode is disabled.

--enableRawOutput

Enables RAW output.

Disabled.

--disableISP0Output

Disables ISP0 output.

Enabled.

--disableISP1Output

Disables ISP1 output.

Enabled.
--disableISP2Output Disables ISP2 output. Enabled.
--enablePassive Enable passive mode. Disabled

--showfps

Prints FPS (frames per second) messages on stdout.

Disabled.

--showmetadata

Shows metadata when RAW output is enabled.

Disabled.

--plugin <type>

Auto Control Plugin. Supported types (default: if NITO available 0, else 1):

  • 0: NVIDIA Auto Exposure/Auto White Balance (AE/AWB) Plugin
  • 1: Custom plug-in 0

Defaults to 0 if the NITO file is available for all camera modules, else 1.

--autorecovery

Automatically attempts to recover any broken links on a periodic interval.

Disabled.

--nvsci

Uses NvSciStream for frame synchronization and transfer.

Disabled.

--profile “file-prefix”

Dumps profiling timestamps in file-prefix_cam_x_out_y.csv and shows frame rate (even if --showfps is not specified).

Disabled.

--skipFrames <val>

If using the -f switch, skips val frames at the beginning before writing to file.

No frames are skipped.

--writeFrames <val>

If using the -f switch, writes a maximum of val frames to file (starting after the number of skipped frames, if specified).

All captured frames are written to file.

--nito "folder"

Specifies the directory to search for NVIDIA Image Tuning Object (NITO) files.

Search folder is /usr/share/camera/.

--icrop "y+h"

Specifies the ISP input crop where input is cropped to bottom vertical offset y plus height h.

Disabled.

--showEEPROM

Reads data (such as the sensor name and revision) from the camera module EEPROM, then displays that information on the command line.

Disabled.

--autoLED

Enables automatic LED control, specifically for AR0234.

Disabled.

--showNitoMetadata

Retrieves and displays NITO Metadata (ID, dataHash, schemaHash) for each parameter set(s) in the NITO file(s) loaded by the application to stdout.

Disabled.

--numParameterSetsInNITO <val>

Maximum number of parameter sets in NITO file. Must be greater than or equal to one (1). Use if expecting more than ten (10) parameter sets in NITO file(s).

10
--useNvSciBufPath Enables use of NvSciBuf Buffers as inputs instead of NvMediaImages. Disabled.
--ignoreError Ignore the fatal error Disabled.
--enableStatsOverrideTest Enable ISP statistics settings override Disabled.
--disableSubframe Disable Subframe feature Disabled
--enablePassive Enable passive mode Disabled.
--setSensorCharMode <expNo> Set sensor in characterization mode with exposure number (only supported for AR0820) Disabled.
--numParameterSetsInNITO <val> Number of parameter sets in NITO file. Use if expecting >10 parameter sets in NITO file(s). 10

NVIDIA Image Tuning Object (NITO) is a binary file containing ISP settings, tuning, and characterization parameters for a specific camera module.