DAP Technology 1394, Руководство по эксплуатации

Страница: 191 / 458

Scriptor
191 Copyright © DapTechnology B.V., 2005-2019 - All Rights Reserved., 5/20/2019
This macro is filled in to get the values of "Source", "Destination" and "Transaction label" for a "ReadReq"
packet. The values should respectively be set to "requestor", "node" and "label". As can be seen in the
script, the macro accomplishes this by generating three calls to API functions. These calls to
"getPacketHeaderFields" are indicated with a gray color, which means that they are read-only. This is
because those statements are generated by the macro and if the user would like to change them, the user
should change the properties in the corresponding macro editor.
After reading the header fields from the "req" packet, another macro call fills the "resp" packet with the
correct header values.
Then the value of tcode is checked. If the value is a read request, the script continues on the line below,
otherwise it jumps to the else clause, which contains some constructs to create and return an error packet.
The control "type errors" on the control panel is also updated.
If the tcode was a read request, the script retreives two values "q1" and "q2" from the header. If these
values are within a specific range, the script continues on the next line. Otherwise a jump is made to the
else clause. The else clause contains some constructs to create and return an error packet. The control
"address errors" on the control panel is also updated.
If q1 and q2 are within the correct range, first a macro setPacketHeaderFields is filled such that the
response code is set to RESPONSE_COMPLETE. Then the API function "writePacketHeader" is called to
set the packet header with data from a file. The file data is referred to by the name "DATA_ID_1_FIRST".
The define statement ending in "_FIRST" always refers to the first datablock that is read from a file and
one ending in "_LAST" refers to the last datablock which should be read from file. The numbers in
between can be used to access the file data blocks in between. The data definitions for this script can be
seen in the following picture: