Rig Reserializer Tool

Table of Contents

• Description
• Prerequisites
• Running the Tool with Rig1.0
  • Positional parameters
• Running the Tool with Rig2.0
  • Positional parameters
• Examples
  • Rig1.0 examples
  • Rig2.0 examples

Description

The NVIDIA^® DriveWorks Rig Reserializer Tool deserializes and serializes an input rig file, upgrading it to the latest version in the process.

Prerequisites

This tool is available on the x86 Host System, NVIDIA DRIVE^™ OS Linux and NVIDIA DRIVE^™ OS QNX.

This tool creates an output file that is:

• Named [input_rig_name]-new.json if no output rig file is specified
• Stored at the same path as the input rig file if no absolute path for the output rig file is specified
• Stored at the absolute path provided via the output rig file argument

Running the Tool with Rig1.0

Run this tool with Rig1.0 by executing the following with a Rig1.0 input file:

./rig_json2json input.json [output.json]

Positional parameters

[path to input file]
    Description: The rig file to be re-serialized.
                     If there is no rig file present, the tool will not launch.
        Default value: N/A

[path to output file]
    Description: The rig file containing the resulting serialized values with the latest version.
        Default value: <input-rig>-new.json

Running the Tool with Rig2.0

Run this tool with Rig2.0 by executing the following with Rig2.0 files:

./rig_json2json platform.variant.json static.calibration.json dynamic.calibration.json app.rig-config.json rig-config-name [output.json]

Positional parameters

[path to platform.variant.json]
    Description: The platform variant rig file - this is the base file containing all the sensors of the platform.
                     If there is no rig file present, the tool will not launch.
        Default value: N/A

[path to static.calibration.json]
    Description: The static calibration file - this file contains data which shall be overlaid on top of the platform variant file.
                     If you wish to skip this file, use the path "null"
        Default value: N/A

[path to dynamic.calibration.json]
    Description: The dynamic calibration file - this file contains correction values on top of the platform variant file AND static calibration file. This file can only be applied on top of the same static.calibration.json file which was used when generating the corrections.
                     If you wish to skip this file, use the path "null"
        Default value: N/A

[path to app.rig-config.json]
    Description: The app rig-config file - this file will determine the list of available sensor configurations that can be passed for the rig-config-name argument. 
                     If there is no rig-config file present, the tool will not launch.
        Default value: N/A

[path to rig-config-name]
    Description: The name of configuration to use from the rig-config file.
                     If you wish to use the default config from the rig-config file, use the name "null"
        Default value: N/A

[path to output file]
    Description: The rig file containing the resulting serialized values with the latest version.
        Default value: <input-rig>-new.json

Examples

Rig1.0 examples

./rig_json2json /home/user/input-rig.json
        Results in /home/user/input-rig-new.json

./rig_json2json /home/user/input-rig.json /home/user/result/output-rig.json
        Results in /home/user/result/output-rig.json

./rig_json2json /home/user/input-rig.json output-rig.json
        Results in /home/user/output-rig.json

Rig2.0 examples

./rig_json2json /home/user/input-rig.json null null /home/user/sample.rig-config.json my-config-name
        Results in /home/user/input-rig-new.json using the "my-config-name" config from sample.rig-config.json

./rig_json2json /home/user/input-rig.json /home/user/input-static.calibration.json null /home/user/sample.rig-config.json my-config-name /home/user/result/output-rig.json
        Results in /home/user/result/output-rig.json built from input-rig.json with input-static.calibration.json laid on top using "my-config-name" from sample.rig-config.json

./rig_json2json /home/user/input-rig.json null null /home/user/sample.rig-config.json null output-rig.json
        Results in /home/user/output-rig.json using the default config from sample.rig-config.json