Fb 5: Getgud Read Gud Variable - Siemens SINUMERIK 828D Function Manual

P3: Basic PLC Program for SINUMERIK 840D sl
13.13 Block descriptions
U I 7.6;
U M 1.0;
R M 0.0;
CALL FB 4, DB 126 (
Req :=
PIService :=
Unit :=
Addr1 :=
Addr2 :=
Error :=
Done :=
State :=
13.13.5

FB 5: GETGUD read GUD variable

Function
The PLC user program can read a GUD variable (GUD = Global User Data) from the NCK or channel area using
the FB GETGUD.
The FB has multi-instance capability. The call is permitted only in cyclic program OB1. An assignment for all
parameters with Req = 0 is also permitted in OB 100. Capital letters must be used for the names of GUD
variables.
Every FB 5 call must be assigned a separate instance DB from the user area.
A job is started when FB 5 is called by means of a positive edge change at control input Req. This job includes
the name of the GUD variable to be read in parameter "Addr" with data type "STRING". The pointer to the name
of the GUD variables is assigned symbolically to the "Addr" parameter with <DataBlockName>.<VariableName>.
Additional information about this variable is specified in parameters "Area", "Unit", "Index1" and "Index2" (see
table of block parameters).
When parameter "CnvtToken" is activated, a variable pointer (token) can be generated for this GUD variable as
an option. This pointer is generated via the NC-VAR selector for system variables of the NC. Only this method of
generating pointers is available for GUD variables. Once a pointer has been generated for the GUD variable,
then it is possible to read and write via FB 2 and FB 3 (GET, PUT) with reference to this variable pointer. This is
the only method by which GUD variables can be read. When FB 2 or FB 3 is parameterized, only parameter
Addr1 ... Addr8 need to be parameterized for this GUD variable pointer. GUD variable fields are an exception. In
these fields Line1 to Line8 must also be parameterized with the field device from these variables. The successful
completion of the read process is displayed by the status parameter "Done"=TRUE.
The read process extends over several PLC cycles (generally 1 to 2).
970
//Manual error acknowledgment
//Error pending
//Terminate job
M0.0,
PI.SELECT,
1,
STR.Path,
STR.PName,
//Addr1:=STR.Path_WST,
//Addr2:=STR.PName_WST,
M1.0,
M1.1,
MW2);
// CHAN 1
//Main-program selection
//Workpiece-program selection
Function Manual, 09/2011, 6FC5397-0BP40-2BA0
Basic Functions