System Functions - Siemens SIMOTION Function Manual

Syntax of the device name (NameOfStation)
The device name (NameOfStation) must adhere to the following conventions:
● Permissible length: 1 to 127 characters
● Organization using periods "." is permissible in several labels; length of a single label: 1 to
● Characters permitted within a label:
● The following designations are not permitted for device names:
Note
Device names which do not satisfy the general rules for identifiers (i.e. containing hyphens
or periods) must be enclosed in double inverted commas (", ASCII code 22) for use in
SIMOTION SCOUT (e.g. in the programming languages).
4.3.1

System functions

As of SIMOTION Kernel version V4.4, the following functions should be used in new projects:
● _getPnNameOfStation (as of Kernel V4.4)
● _setPnNameOfStation (as of Kernel V4.4)
Up to SIMOTION Kernel version V4.3, the following functions should be used:
Basic Functions for Modular Machines
Function Manual, 04/2014
4.3 Setting the device name (NameOfStation) of an IO device on PROFINET IO
63 characters
– Letters "A" to "Z" and "a" to "z".
– Numbers "0" to "9" (not at the beginning of the label).
– Special character hyphen "-" (not at the beginning or end of a label).
– Other special characters (such as umlauts, blank spaces, brackets, underscores) are
not permitted.
– Identifiers that start with "port-xyz-" (x, y, z = 0 ... 9).
– Identifiers of the form n.n.n.n (n = 0 ... 999).
You can use this function to determine the active device name (NameOfStation) of a
PROFINET IO interface on the SIMOTION device.
If the PROFINET IO interface has not yet been assigned a device name (NameOfStation)
which is unique within the project, a character string containing the device type and the
hexadecimal numbers of the the MAC address will be returned,
e.g. SIMOTION‑D‑08‑00‑06‑73‑6C‑E6.
You can use this function to set a new device name (NameOfStation) for a PROFINET IO
interface on the SIMOTION device and activate this name.
Setting the communication addresses via the user program
47