Reference
48
TSG 1001 Programmable TV Generator User Manual
Commands are not case-sensitive; headers and parameters may be entered in
either capitals or lowercase. In this manual, the short form of the header is
capitalized; the remainder of the complete form is in lowercase. Parameters
are shown in italics. To control the TSG, either the short or the complete
form may be used. For example, entering :EXT? will have the same effect as
entering :EXTERNAL?.
Parameters can be numeric, Up/Down, On/Off, or a character string. String
parameters—for example, “white field”—are always enclosed in double
quotation marks.
If a variable has a range of adjustment, the limits (minimum and maximum
values) may be queried with the forms :VARIABLE? Min and :VARIABLE?
Max. There must be a space between the question mark and the parameter.
A variable with a range of adjustments may also be set to the minimum or
maximum with the forms :VARIABLE Min and :VARIABLE Max.
Most variables with numeric values are incremented in discrete steps.
Therefore, the variable may not take on the exact value specified with the
command parameter. For instance, the horizontal position of the Trigger
pulse—set with :TRIGger:HORizonta
l—
can only be a sample number that is
an integer multiple of 4. Thus, specifying sample 1601, 1602, or 1603 (as in
:TRIG:HOR 1603) will place the trigger pulse on sample 1600.
Compound command headers (for example, :TRIGger:VERTical) are used to
set or query lower-level, or “subordinate,” variables. The level of a command
variable corresponds to its position in the compound header, as in
:VAR_LEVEL1:VAR_LEVEL2:VAR_LEVEL3
and so on. A convenient consequence of the serial RC command structure is
that, once a command level is entered, it is not necessary to repeat higher-
level variables to set or query other variables on the same level.
For example, the following sequence of commands is valid for querying
various system parameters:
ÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁ
:SYSTem:ERRor?
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
[:ERRor? is in level 2]
ÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁ
:VERSion?
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
[:VERSion? is also in level 2]
ÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁ
:VERSion:SRAM?
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
[:SRAM? is a level 3 variable]
ÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁ
:ZPLAte?
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
[:ZPLAte is also in level 3]
ÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁ
:SYSTem:ERRor?
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
ÁÁÁÁÁÁÁÁÁÁÁÁÁÁÁ
[:ERR? is NOT in level 3; must repeat the entire
compound header]
A line can contain several commands separated only by semicolons
(:VARIABLE1 Parameter1;:VARIABLE2 Parameter2;
…
). However, no
line may exceed 256 characters.