Siemens SIMOTION Function Manual page 90

Changing the active configuration or the active kernel
6.1 Activating a configuration
card of the SIMOTION device. After the machine module is connected to the base machine,
the user program identifies the relevant machine module.
System function
When the _activateConfiguration system function is initiated, the user program loads the
required configuration and restarts the SIMOTION device. Provide the configuration to be
activated in parameter projectDataId (data type UDINT). The hexadecimal number to be
provided corresponds to the last six characters of the relevant file name assigned to the card
image of the respective configuration on the memory card (example: File name =
PR000001.ZIP, projectDataId = 16#000001).
The syntax of this system function is described in detail in the "System Functions/Variables
Devices" List Manual (reference list) and in the online help (see index).
Note
Note when activating a configuration:
● Retentive global device variables are always initialized.
● The values of the following variables of the last active configuration can be preserved:
● If the SINAMICS Safety Integrated Functions configuration is used, an acceptance test is
● After restarting the SIMOTION device, check the Activation state of the configuration
The activated configuration remains after the SIMOTION device is turned off. After the device
is turned on (POWER ON), the configuration is reloaded.
A detailed description of how the card images of configurations are created is provided in
Section "Procedure for creating the card images of configurations" (Page 107).
Note
The following applies up to version V4.2 of the SIMOTION Kernel:
● If one or more CX32/CX32‑2 controller extensions are connected to a SIMOTION D4x5/
● Note the information in the Section "Special considerations when a CX32/CX32‑2
As of SIMOTION Kernel version V4.3, restart of the CX32/CX32‑2 takes place automatically
with the function _activateConfiguration.
90
Retentive unit variables and retentive system variables of the technology objects. Observe
the measures described in Retaining retentive data in the event of a configuration
change (Page 105).
mandatory when the SIMOTION device is restarted (see "SINAMICS S120 Safety
Integrated" Function Manual).
(Page 104) with the _getConfigurationData system function.
D4x5‑2, note the following when activating a configuration with the _activateConfiguration
function:
The activated configuration will only take effect on the CX32/CX32‑2 controller extension
after the CX32/CX32‑2 has been restarted. This restart must be specifically initiated by
the user, as the _activateConfiguration function does not perform a restart automatically.
controller extension is connected" (Page 91).
Basic Functions for Modular Machines
Function Manual, 04/2014