Command Line Execution - Pins Tool

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

Table 1. Commands supported in Pins
​Command name​ ​​Definition and parameters Description Restriction ​Example
​Enable tool ​-Enable ​Enable tool if it is disabled in the current configuration ​Requires -HeadlessTool Pins ​-HeadlessTool Pins -Enable
​Import C files ​​-ImportC

​​Import .c files into configuration

Importing is done after loading mex and before generating outputs

 Requires ​​-HeadlessTool Pins ​​​-HeadlessTool Pins ​​-ImportC C:/imports/file1.c C:/imports/file2.c​
​Import DTSI files ​-ImportDTSI

​Import .dtsi files into configuration

Importing is done after loading mex and before generating outputs

 ​Requires ​​-HeadlessTool​ Pins ​ ​-HeadlessTool Pins ​-ImportDTSI C:/imports/file1.dtsi C:/imports/file2.dtsi​

​​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,-ExportCSV, -ExportHTML and in framework -ExportMEX

Argument is expected as a folder name​

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

​Export generated source files.

Code will be regenerated before export

Argument is expected as a folder name​

 ​Requires ​​-HeadlessTool​ Pins ​​​-HeadlessTool Pins ​​-ExportSrc C:/exports/src
​​Export CSV file ​​-ExportCSV

​Export generated csv file.

Code will be regenerated before export

Argument is expected as a folder name​

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

​Export generated html report file.

Code will be regenerated before export

Argument is expected as a folder name​

 ​Requires ​​-HeadlessTool​ Pins ​​-HeadlessTool Pins ​-ExportHTML C:/exports/html
​Export registers ​-ExportRegisters

​Export registers tab into folder.

Code will be regenerated before export​

Argument is expected as a folder name​

 ​Requires ​​-HeadlessTool​ Pins ​​-HeadlessTool Pins ​-ExportRegisters C:/exports/regs
Examples:
  • Import configuration from C file and export full list of registers:
    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini /path/to/S32DS/installation/eclipse/s32ds.ini \
            -HeadlessTool Pins \
            -MCU /processor/name \
            -SDKVersion /sdk/version/name \
            -ImportC /path/to/C/file \
            -ExportRegisters /path/to/file/where/to/export/registers

    OR

    eclipsec.exe -noSplash \
            -application com.nxp.swtools.framework.application \
            --launcher.ini C:\NXP\S32DesignStudio\eclipse\s32ds.ini  \
            -HeadlessTool Pins \
            -MCU S32S247TV \
            -SDKVersion s32sdk_s32s_rtm_100 \
            -ImportC C:\Input\pin_mux.c \
            -ExportRegisters 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 Pins \
            -Load /path/to/mex/file \
            -ExportSrc /path/where/to/save/generated/files