ecuxpro

Command Line Interface for the DaVinci Configurator Classic File Pre-Processing.

Usage

Usage: ecuxpro [-vh] [COMMAND]

Description:
Command Line Interface for the DaVinci Configurator Classic File Pre-Processing.

Options:
  -v, --version   Print version information.
  -h, --help      Display the help.

Commands:
  analyze             Analyze the input files and return the information about how they have to be preprocessed to get
                        an ECU Extract. In case of only one file set, the variant name can be ignored. Not providing an
                        output folder and no script type results in a plain text listing of all ECU Instances contained
                        in the input files.
                      E.g.: ecuxpro analyze -f variant1=./file1.arxml,./file2.arxml -f variant2=./file3.dbc -e .
                        /EvaluatedVariantSet.arxml -c ./LegacyDb2SystemDescrConverter.exe -o ./output --save-script .
                        /script.bat --output-format shell_cmd
  analyze-migration   Analyze the migration instruction json file and return the instructions for preprocessing the
                        input files.
                      E.g.: ecuxpro analyze-migration --migration-instruction migration.json -c .
                        /LegacyDb2SystemDescrConverter.exe -o ./output --save-script ./script.bat --output-format
                        shell_cmd
  extract-sysd        Extract a single ECU out of the System Description given by the input files which is saved in the
                        specified output file.
                      E.g.: ecuxpro extract-sysd -i ./SystemDescription.arxml -e ECU1 ./ECU1_SystemDescription.arxml
  merge               Merge the given input files into one ECU Extract which is saved into the specified output file.
                      E.g.: ecuxpro merge -i ./file1.arxml -i ./file2.arxml ./output.arxml
                      NOTICE: The merge result strongly depends on the order of the input files.
  run-script          Execute the given script file(s) on the given input file and save the result in the specified
                        output file.
                      E.g.: ecuxpro run-script -i ./input.arxml -e ./EvaluatedVariantSet.arxml -l ./locationA,.
                        /locationB -t task1,task2 -a 'task1' -a '--name=str1 --value=1' -a 'task2, --str2 2' ./output.
                        arxml
  list-script         List script tasks from a given location.
                      E.g.: ecuxpro list-script -l ./locationA
  info-script         Display detailed information about a script task.
                      E.g.: ecuxpro info-script -t Task1 -l ./locationA
  variant-merge       Merge the given input files into one variant ECU Extract which is saved into the specified output
                        file.
                      E.g.: ecuxpro variant-merge -e ./EvaluatedVariantSet.arxml -m ./mergerConfigFile.xml -f variant1=.
                        /file1.arxml,./file2.arxml -f variant2=./file3.arxml ./output.arxml
                      NOTICE: The merge result strongly depends on the order of the file sets.
  evs-info            Find the variant names contained in an Evaluated Variant Set file.
                      E.g.: ecuxpro evs-info -e ./EvaluatedVariantSet.arxml
  validate-schema     Validate the given file against the AUTOSAR schema and return validation result which might
                        contain detailed information about eventual errors. Only ARXML files are supported.
                      E.g.: ecuxpro validate-schema -i ./input.arxml
  install-completion  Install shell completion for the CLI. Supported shells: bash and PowerShell. If no option is
                        provided it will create the completion script and then install it to all available shells.

Exit Codes:
  0    Successful program execution.
  1    Command execution failed.
  2    Usage error: User input for the command was incorrect.
130    Command was cancelled by the user.

Commands

analyze

Analyze the input files and return the information about how they have to be preprocessed to get an ECU Extract.

analyze-migration

Analyze the migration instruction json file and return the instructions for preprocessing the input files.

extract-sysd

Extract a single ECU out of the System Description given by the input files which is saved in the specified output file.

merge

Merge the given input files into one ECU Extract which is saved into the specified output file.

run-script

Execute the given script file(s) on the given input file and save the result in the specified output file.

list-script

List script tasks from a given location.

info-script

Display detailed information about a script task.

variant-merge

Merge the given input files into one variant ECU Extract which is saved into the specified output file.

evs-info

Find the variant names contained in an Evaluated Variant Set file.

validate-schema

Validate the given file against the AUTOSAR schema and return validation result which might contain detailed information about eventual errors.

install-completion

Install shell completion for the CLI.

For the meaning of the returned exit codes, see Exit Codes.