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 ​Enables the tool if it is disabled in the current configuration ​Requires -HeadlessTool Pins ​-HeadlessTool Pins -Enable
​Import C files ​​-ImportC

​​Imports .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​

​​Export all generated files

(to simplify all exports commands to one command)

​​-ExportAll

​​Exports generated files (with the source code, and so on)

The code is regenerated before the export.

Includes -ExportSrc,-ExportCSV, -ExportHTML and in framework -ExportMEX

The argument is expected to be a folder

​Requires ​​-HeadlessTool​ Pins ​​-HeadlessTool Pins

​-ExportAll C:/exports/generated
​Export Source files ​-ExportSrc

​Exports generated source files.

The code is regenerated before the export.

The argument is expected to be a folder.​

​Requires ​​-HeadlessTool​ Pins ​​​-HeadlessTool Pins

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

​Exports the generated .csv file.

The code is regenerated before export.

The argument is expected to be a folder.

​Requires ​​-HeadlessTool​ Pins ​​​​-HeadlessTool Pins

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

​Exports the generated HTML report file.

The code is regenerated before the export.

The argument is expected to be a folder.

​Requires ​​-HeadlessTool​ Pins ​​-HeadlessTool Pins

​-ExportHTML C:/exports/html
​Export registers ​-Export

Registers

​Exports the registers tab into a folder.

The code is regenerated before the export.​

The argument is expected to be a folder.

​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