Siemens SIMOTION Function Manual page 95

Figure 6-2
System function
To activate the SIMOTION Kernel stored on the card, call in the user program the
_activateConfiguration system function with the kernel := YES parameter. In the kernelId
parameter, specify the last six characters of the directory name on the memory card (example:
Directory name = VE004156, kernelId = 16#004156).
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).
Specify the configuration to be activated in the projectData and projectDataId parameters:
● projectData := NO: The projectDataId parameter will be ignored; the initial configuration will
● projectData := YES: The configuration specified in the projectDataId (UDINT data type)
Note
When activating a kernel and the associated configuration, please note:
● 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 kernel and the
Basic Functions for Modular Machines
Function Manual, 04/2014
Directory structure on the memory card
be activated. In this initial configuration, the required configuration will be determined, for
example, by evaluating a connector coding, and loaded by calling the
_activateConfiguration system function again.
without details of a configuration to be activated" in "Examples for activating
See "Example
a kernel" (Page 96).
For information on the initial configuration, see Selecting and activating a configuration
using an initial configuration (Page 99).
parameter will be activated. The hexadecimal number to be transferred corresponds to the
last six characters of the relevant file name of the configuration on the memory card (for
example, File name = PR000001.ZIP, projectDataId = 16#000001).
with details of a configuration to be activated" in "Examples for activating a
See "Example
kernel" (Page 96).
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).
configuration (Page 104) with the _getConfigurationData system function.
Changing the active configuration or the active kernel
6.2 Activating a kernel
95