Call, Call call internal function – Quantum Data 802BT User Manual

Page 265

Advertising
background image

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) ]…]]]

Advertising
This manual is related to the following products: