Fetch NITO Metadata

NITO Metadata can be fetched by specifying the --showNitoMetadata switch. If enabled, the NITO file loaded by the application will have its parameter set(s) ID, schema hash, and data hash retrieved and printed to stdout in the following format:

  • Parameter Set ID: "00000000-0000-0000-0000-000000000000" (in hex)
  • Schema/data hash: "0000…" (hex string with no spaces)

Note the API instantiates an array of structures to store the metadata retrieved for each parameter set in the NITO file, thus it requires that the length of this array is greater than or equal to the number of the parameter sets in the NITO file. The app assumes by default a maximum of ten (10) parameter sets present in the NITO file.

If the user knows that greater than ten (10) parameter sets exist in the NITO file, then they can specify this using the --numParameterSetsInNITO <val> switch. Note that in order to specify this switch, the user must also specify the --showNitoMetadata switch.

An example showing how to use this feature, without setting a custom number of parameter sets, is provided below:

$ ./nvsipl_camera --platform-config "V728S1-120V1-FWC_CPHY_x4" 
--link-enable-masks "0x0001 0x0000 0x0000 0x0000" 
--showNitoMetadata

An example showing the error messages when the NITO file contains more parameter sets than the default of ten (10), is provided below: 

$ ./nvsipl_camera --platform-config "V728S1-120V1-FWC_CPHY_x4" 
--link-enable-masks "0x0001 0x0000 0x0000 0x0000" 
–-showNitoMetadata

Error messages if parameter sets retrieved from file is greater than ten (10):

... Call to fetchNitoMetadata API returned code:1, 
valid API parameters not provided, check API arguments.
... GetNitoMetadataFromMemory: Call to fetchNitoMetadata API 
failed, look at logs for error
... nvsipl_camera: ERROR: Failed to retrieve metadata from NITO file
... nvsipl_camera: ERROR: Failed to run Fetch NITO Metadata API

To resolve the above error, and in general if needed, an example showing how to use this feature when setting a custom number of parameter sets, is provided below: 

$ ./nvsipl_camera --platform-config "V728S1-120V1-FWC_CPHY_x4" 
--link-enable-masks "0x0001 0x0000 0x0000 0x0000" –-showNitoMetadata 
--numParameterSetsInNITO 12