Command Line Execution - IVT Tool

This section describes the Command Line Interface (CLI) commands supported in the IVT Tool.

Table 1. Commands supported in IVT
​Command name​ ​​Definition and parameters Description Restriction ​Example
​Import IVT binary image ​-ImportBin

Import the binary IVT image in the current configuration.

The path of the imported binary image is expected as argument.

 ​Requires -HeadlessTool IVT ​-HeadlessTool IVT -ImportBin C:/boot_images/ivtImg.bin
Export IVT image in binary format ​​-ExportBin

​​Export the IVT image in binary format.

Folder name is expected as argument.

Requires ​​-HeadlessTool IVT ​​​-HeadlessTool IVT -ExportBin C:/exports/generated​
​Export IVT image in C format ​-ExportC

​Export the IVT image in C format.

Folder name is expected as argument.

 ​Requires ​​-HeadlessTool​ IVT ​ ​-HeadlessTool IVT -ExportC C:/exports/generated
Export Blob image in binary format -ExportBlob

Export Blob image (the binary which contains IVT image and all loaded pointer images.

Folder name is expected as argument.

 Requires -HeadlessTool IVT

-HeadlessTool IVT -ExportBlob C:/export/generated
Export application bootloader image -ExportAB

Export the complete application bootloader image.

Folder name, path to the raw binary code file, start ram pointer address value and entry ram pointer address value are expected as arguments.

 Requires -HeadlessTool IVT

-HeadlessTool IVT

-ExportAB C:/resources/completeApp.bin

-start_pointer_addr 0x34300000

-entry_pointer_addr 0x34300000

-raw_binary C:/resources/rawCode.bin
Insert value for RAM start pointer address

-start_pointer_addr

 Value used for the RAM start pointer address for application bootloader. This value will be included in the header of the exported application bootloader. Requires -ExportAB -start_pointer_addr 0x34300000
Insert value for RAM entry pointer address -entry_pointer_addr Value used for the RAM entry pointer address for application bootloader. This value will be included in the header of the exported application bootloader. Requires -ExportAB -entry_pointer_addr 0x34300000
Path to the raw binary code for the application bootloader pointer -raw_binary Path to a binary file which contains the raw code (no header) for the application bootloader pointer. Requires -ExportAB -raw_binary C:/resources/rawCode.bin
Export the application bootloader image in serial boot format -serial_boot Export the application bootloader image in serial boot format Requires -ExportAB -serial_boot
Add transmission marker -include_marker Include the marker FEED_FACE_CAFE_BEEFh on the exported image Requires -ExportAB -include_marker

​​Export all generated files

(to simplify all export commands to one command)

 ​​-ExportAll

​​Export generated files (with source code etc.).

Code will be regenerated before export.

Includes -ExportBin,-ExportC, -ExportBlob and in framework -ExportMEX.

Folder name is expected as argument.​

 ​Requires ​​-HeadlessTool​ IVT ​​-HeadlessTool IVT ​-ExportAll C:/exports/generated

Validate configuration

 -ValidateConfiguration

Validates the current loaded configuration and display the problems found.

 Requires -HeadlessTool IVT -HeadlessTool IVT -ImportBin C:/boot_images/ivtImg.bin -ValidateConfiguration -consoleLog -noExit

Automatic alignment for IVT segments

 -AutoAlign

Automatically aligns all segments in order to fix alignment problems and segment overlapping problems. It has an optional parameter. The user can specify the start address from which the pointers will be aligned or in case no parameter is specified the auto align start address from the storage will be used.

 Requires -HeadlessTool IVT -HeadlessTool IVT -ImportBin C:/boot_images/ivtImg.bin -AutoAlign 0x0 -consoleLog -noExist
Import application bootloader image -ImportAB

Imports the complete application bootloader image in the current configuration.

The path of the imported complete application bootloader image is expected as argument.

 Requires -HeadlessTool IVT -HeadlessTool IVT -Load C:\mex_files\myMex.mex -ImportAB C:\binary_images\completeApp.bin
Export DDRC interface init application image -ExportDDRC

Export the complete DDRC interface init app image.

Folder name, start ram pointer address value, entry ram pointer address value, path to the raw binary code file, bootrom timeout value and path to the pre-defined data file are expected as arguments.

 Requires -HeadlessTool IVT -HeadlessTool IVT -ExportDDRC C:\Resources\ddrcInitAppImage -start_pointer_addr 0x34080000 -entry_pointer_addr 0x34080000 -raw_binary C: \Resources\raw_binary -bootrom_timeout 0x1 -pre_defined_data C:\Resources\pre_defined_data
Import DDRC interface init application image -ImportDDRC

Import the DDRC interface init app image into the current configuration.

The path to the imported binary image is expected as argument.

 -HeadlessTool IVT -HeadlessTool IVT -ImportDDRC C:\Input\ddrc_init_app
Examples:
  • Import IVT binary image, validate imported binary and export it in C format:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini /path/to/S32DS/installation/eclipse/s32ds.ini \
            -HeadlessTool IVT \
            -MCU /processor/name \
            -SDKVersion /sdk/version/name \
            -ImportBin /path/to/IVT/image \
            -ValidateConfiguration \
            -ExportC /path/where/to/export/C/file

    OR

    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini  \
            -HeadlessTool IVT \
            -MCU S32S247TV \
            -SDKVersion s32sdk_s32s_rtm_100 \
            -ImportBin C:\Input\ivt_image.bin \
            -ValidateConfiguration \
            -ExportC C:\Output
  • Validate configuration based on existing .mex file and report errors:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini  \
            -HeadlessTool IVT \
            -Load C:\Input\S32S247TV.mex \
            -ValidateConfiguration
  • Validate configuration based on imported IVT binary and report errors:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini  \
            -HeadlessTool IVT \
            -MCU S32S247TV \
            -SDKVersion s32sdk_s32s_rtm_100 \
            -ImportBin C:\Input\ivt_image.bin \
            -ValidateConfiguration
  • Auto align all pointers at the specified address based on existing .mex file and export IVT image with all pointers aligned:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini  \
            -HeadlessTool IVT \
            -Load C:\Input\S32S247TV.mex \
            -AutoAlign 0x1000 \
            -ExportBin C:\Output
  • Export application bootloader:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini  \
            -HeadlessTool IVT \
            -Load C:\Input\S32S247TV.mex \
            -ExportAB C:\Output\app_boot.bin \
            -start_pointer_addr 0x34300000 \
            -entry_pointer_addr 0x34300000 \
            -raw_binary C:\Input\app_boot_raw_code.bin
            -serial_boot
            -include_marker

    This command will load the configuration from the existing .mex file and will export the application bootloader based on the provided application code raw binary file using the specified pointer addresses.

  • Export all IVT binaries:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini  \
            -HeadlessTool IVT \
            -Load C:\Input\S32S247TV.mex \
            -ExportAll C:\Output

    This command will load the configuration from the existing .mex file and export the IVT image in binary and C formats, and the blob image.

  • Chaining more options:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini /path/to/S32DS/installation/eclipse/s32ds.ini \
            -HeadlessTool IVT \
            -MCU /processor/name \
            -SDKVersion /sdk/version/name \
            -ImportBin /path/to/IVT/image \
            -ValidateConfiguration \
            -ExportC /path/where/to/save/C/file \
            -AutoAlign /start/address/to/align/all/segments \
            -ExportBlob /path/where/to/save/blob/file

    This command will create a new configuration for the specified processor and sdk version, will import the IVT image, will do the validation of the current configuration (and display errors if found), will export the IVT image in the C format, will automatically try to align all pointers starting from the specified address, and will export the blob image in binary format.

  • Import application bootloader
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini   \
            -HeadlessTool IVT \
            -Load C:\Input\myMex.mex   \
            -ImportAB C:\Input\complete_boot_ap \ 
            -ExportAB C:\Output\app_boot.bin \
            -start_pointer_addr 0x34300000  \
            -entry_pointer_addr 0x34300000 \
            -raw_binary C:\Input\app_boot_raw_code.bin

    This command will load the configuration from the existing .mex file, will import the complete application bootloader image and will export it based on the provided application code raw binary file using the specified pointer addresses.

    OR

    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini \
            -HeadlessTool IVT \
            -Load C:\Input\myMEX.mex \
            -ImportAB C:\Input\complete_boot_ap \
            -ExportAB C:\Output\app_boot.bin

    This command will load the configuration from the existing .mex file, will import the complete application bootloader image and will export the image as it is.

  • Export DDRC interface init app:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini \
            -HeadlessTool IVT \
            -Load C:\Input\myMEX.mex \
            -ExportDDRC C:\Output\ddrc_init_app.bin \
            -start_pointer_addr 0x34300000 \
            -entry_pointer_addr 0x34300000 \
            -raw_binary C:\Input\raw_binary.bin \ 
            -bootrom_timeout 0x1  \ 
            -pre_defined_data C:\Input\pre_defined_data

    This command will load the configuration from the existing .mex file and will export the DDRC interface init app image based on the provided application code raw binary file using the specified pointer addresses, BootROM timeout and pre-defined data.

  • Import DDRC interface init app:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32ConfigTools\tools.ini   \
            -HeadlessTool IVT \
            -Load C:\Input\myMex.mex   \
            -ImportDDRC C:\Input\ddrc_init_app
            -ExportDDRC C:\Output\ddrc_init_app.bin \
            -start_pointer_addr 0x34300000 \
            -entry_pointer_addr 0x34300000 \
            -raw_binary C:\Input\raw_binary.bin \ 
            -bootrom_timeout 0x1  \ 
            -pre_defined_data C:\Input\pre_defined_data

    This command will load the configuration from the existing .mex file, will import the DDRC interface init app image and will export it based on the provided application code raw binary file using the specified pointer addresses, BootROM timeout and pre-defined data.

    OR

    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini \
            -HeadlessTool IVT \
            -Load C:\Input\myMEX.mex \
            -ImportDDRC C:\Input\ddrc_init_app

    This command will import a valid DDRC interface init app image in the current configuration.