Extended instructions
9.7 Diagnostics (PROFINET or PROFIBUS)
S7-1200 Programmable controller
System Manual, V4.2, 09/2016, A5E02486680-AK
453
Get_Name (Read the name of a PROFINET IO device)
The "Get_Name" instruction reads the name of a PROFINET IO device, PROFIBUS slave, or
AS-i slave. The name is displayed in the network view and in the properties of the IO device.
Table 9- 154 Get_Name instruction
LADDR:=_uint_in_,
STATION_NR:=_uint_in_,
DONE=>_bool_out_,
BUSY=>_bool_out_,
ERROR=>_bool_out_,
LEN=>_dint_out_,
STATUS=>_word_out_,
DATA:=_variant_inout_);
Use the Get_Name instruction to read
the name of a PROFINET IO device
or PROFIBUS slave.
STEP 7 automatically creates the DB when you insert the instruction.
2
In the SCL example, "Get_Name_DB" is the name of the instance DB.
You select the IO device by using the hardware identifier of the distributed IO system (at the
LADDR parameter) and the device number of the PROFINET IO device or the PROFIBUS
address of the PROFIBUS slave (at the STATION_NR parameter).
Once the instruction has been executed, the program writes the name of the IO device to the
area addressed with the DATA parameter.
The name that is read depends on the type of IO device:
● DP slave or IO device: Name of the head module
● I-slave or I-device: Name of the interface module
● HMI panel: Name of the interface
● PC station: Name of the interface module
● GSD devices: Displays the name of the Device Access Point (DAP) (name of the
interface or head module)
The instruction writes the length of the name at the LEN parameter. If the name is longer
than the area specified at the DATA parameter, the program writes only that section which
corresponds to the maximum length of the addressed area.
The maximum length for a name is 128 characters.
Note
Name of the CPU readout (Version 1.1)
If you assign a "0" at each of the parameters LADDR and STATION_NR, the ins
truction
writes the name of the CPU.