Quantum Data 802BT, User Manual

Page: 265 / 744

Video Test Generator User Guide 255
CALL
CALL internal function
Class Direct processor control
Description Calls internal C functions. Address address is the entry point of the C function to be called.
Parameter passed indicates the number of parameters to be passed. If passed is not zero,
then parameters being passed p(1) through p(n) immediately follow the passed parameter
on the command line.
The CALL? query is similar to the CALL command except that returned parameters are
expected. Here, a third parameter returned is added to indicate the number of parameters
returned by the function. If BASE= -10 or -16 and a returned value of -1 is given
(4,294,967,295 if BASE=10 or FFFFFFFF if BASE=16), then a single value is read from
register A8 of the TMS34010 (rather than being popped off the C stack). Most C functions
that return a single parameter return their single parameter in this way. Returned
parameters are space-delimited and formatted according to the current radix (see BASE
command). All parameters passed to the CALL and CALL? must be formatted according
to the current radix. This includes the parameters passed and returned.
Note: This command is used only with custom applications and command files created by
Quantum Data. Indiscriminate use of this command can cause the generator to stop
operating or loss of stored data in non-volatile RAM.
Command syntax CALL address passed [ p(1) [ p(2) [ p(3) …[ p(18) ]…]]]
address
0 to 4,294,967,295 (BASE = 10)
-2,147,483,648 to 2,147,483,647 (BASE = -10)
0 to FFFFFFFF (BASE = 16)
-80000000 to 7FFFFFFF (BASE = -16)
passed
0 to 18 (BASE = -10 or 10)
0 to 12 (BASE = -16 or 16)
p(n)
0 to 4,294,967,295 (BASE = 10)
-2,147,483,648 to 2,147,483,647 (BASE = -10)
0 to FFFFFFFF (BASE = 16)
-80000000 to 7FFFFFFF (BASE = -16)
Query syntax CALL? address passed returned [ p(1) [ p(2) [ p(3) …[ p(17) ]…]]]