Parameters - Manual - Software Loader - The AX SIMATIC SW-Loader. - Software Loader (sld),tool

Software Loader CLI Tool (sld)

Portfolio
SIMATIC AX
Product
Software Loader
Software version
3.2.2
Edition
04/2025
Language
English (original)
Package Name
@ax/sld
Parameter Description
-?,-h,--help Show the help information specific to this command.
-m, --mode Specify the download method. Values: full, delta or reset. Default: full.
Carefully review the notes and restrictions for delta-download !
Notes:
- full mode re-initializes all variables !
- reset mode extends full mode by resetting the program on the PLC first, providing a more consistent download experience in certain error cases.
-i, --input Specify the SIMATIC app file to be downloaded to the PLC.
You can omit the file name and provide only the containing folder if there is only one app file. A trailing slash is optional if you provide only the folder name.
If you don't provide an input file, the app file in the ./bin/1500 folder will be chosen.
-r, --restart The restart flag indicates that the SIMATIC PLC is set to the RUN state after download.
This flag is ignored if the switch on the PLC is in STOP state.
--accept-reinit-variables If mode is delta download, you are accepting that all variables might be re-initialized to their default values during the download. Otherwise, the download will be aborted if sld detects that variables need to be re-initialized.
Inspect carefully the notes and restrictions for delta-download !
--non-overwriting Switches the sld in the TIAX direct loading workflow.
You can also specify the start of block numbers for SIMATIC AX data blocks (e.g. --non-overwriting:20000) here so that they do not overlap with data blocks loaded from the TIA Portal project. The default value is 8192 with a range of 512 data blocks.
Additional notes about this use case can be found here.
--accept-security-disclaimer This flag needs to be set to confirm that you have read and understood the security disclaimer.
The disclaimer can be shown with option --show-security-disclaimer.

This command requires the connection parameters.

Note

You can set a variable AX_SLD_ACCEPT_SECURITY_DISCLAIMER to yes, true or 1 in your shell environment or in the apax.yml file. Thus, you can omit the option --accept-security-disclaimer on each call.