Command Line Execution - Peripherals Tool

This section describes the Command Line Interface (CLI) commands supported by the Peripherals Tool.

Table 1. Commands supported in Peripherals Tool
​Command name​ ​Definition and parameters ​Description ​Restriction ​Example
Enable tool -Enable

Enable tool if it is disabled in the current configuration

 ​Requires -HeadlessTool Peripherals -HeadlessTool Peripherals -Enable

Import C files

 -ImportC

Import .c files into configuration

Importing is done after loading mex and before generating outputs

 Requires -HeadlessTool Peripherals -HeadlessTool Peripherals -ImportC C:/imports/file1.c C:/imports/file2.c

​​Export all generated files

(to simplify all exports commands to one command)

 ​​-ExportAll

​Export generated files (with source code etc.)

Code will be regenerated before export

Includes -ExportSrc, -ExportHTML and in framework -ExportMEX

Argument is expected to be a folder

 ​Requires ​​-HeadlessTool​ Peripherals -HeadlessTool​ Peripherals ​-ExportAll C:/exports/generated
​​Export Source fil​es ​-ExportSrc​

Export generated source files

Code will be regenerated before export

Argument is expected to be a folder

 ​Requires ​​-HeadlessTool​ Peripherals ​​​-HeadlessTool​ Peripherals -ExportSrc C:/exports/src​
Export HTML report file -ExportHTML

Export generated html report file

Code will be regenerated before export

Argument is expected to be a folder

 Requires -HeadlessTool Peripherals -HeadlessTool Peripherals -ExportHTML C:/exports/html
​* for internal commands, internal plugin must be installed into production application
Examples:
  • Generate code and export configuration in .mex file and HTML format:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini /path/to/S32DS/installation/eclipse/s32ds.ini \
            -HeadlessTool Peripherals \
            -MCU /processor/name \
            -SDKVersion /sdk/version/name \
            -ExportMEX /path/where/to/export/file \
            -ExportHTML /path/where/to/export/file

    OR

    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini  \
            -HeadlessTool Peripherals \
            -MCU S32S247TV \
            -SDKVersion s32sdk_s32s_rtm_100 \
            -ExportMEX C:\Output \
            -ExportHTML C:\Output
  • Import configuration from existing .mex file and generate code:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini /path/to/S32DS/installation/eclipse/s32ds.ini \
            -HeadlessTool Peripherals \
            -Load /path/to/mex/file \
            -ExportSrc /path/where/to/export/generated/files