Note that if the DSA is being used with an oscilloscope display,
the set-up display will remain on the screen until a key is pressed
or a KEY command is sent. Where immediate use of the display is
required the command for ESCAPE (KEY,112) should be sent.
2. Reading back the front panel status
The front panel status can be read by sending the primary
command for one of the control areas followed by a question
mark (followed by a carriage return).
The valid commands are therefore:
CH1? CH2? TRG? TMB? TRA? TRB?
EXAMPLE: the command CH1? CR will cause the DSA to
send a string of the form CH1,ON,2V,AC,ZERO,0000, OK CR.
3. Controlling and checking the DSA acquisition modes
There are three primary commands for controlling acquisitions.
Each is an ASCII string terminated with a carriage return. There
are no secondary commands.
RUN This sets Run/Hold to Run, enabling continuously
repeating acquisitions.
HOLD This sets Run/Hold to Hold, freezing the digitising
memories.
SINGL (only when Run/Hold is at Hold) This enables a
single acquisition.
EXAMPLE: RUN CR
There is also a command for checking the current acquisition
status of the DSA.
BUSY? This causes the DSA to send back a status letter. The
letter is H if the DSA is in Hold, or B if the DSA is either in Run
or is still completing a Single.
4. Reading waveform data from the DSA
The data from any of the digitising memories, trace memories or
indexed memories can be sent over the interfaces. The data can
be sent in either binary, hex or decimal. In binary mode each
word of the memory is sent as a single byte. In hex and decimal
modes the characters are sent in ASCII, two characters per word
in hex mode and three characters per word in decimal mode.
The DSA is factory initialised to send in decimal. To change the
mode, send the primary command MODE followed by a comma
followed by one of the secondary commands BIN, HEX or DEC
(followed by a carriage return). Once changed, the new mode is
retained in non-volatile memory.
EXAMPLE: MODE,BIN CR
To read the data, send the primary command MEM? followed by
a comma followed by one of the secondary commands listed
below (followed by a carriage return).
The secondary commands are as follows:
AQU1 or AQU2 This causes 4096 words to be read from the
digitising memory of CH 1 or CH2.
TRA or TRB This causes 1024 words to be read from the trace
memory of Trace A or Trace B.
TRAB This causes 512 words to be read from each of the
trace memories in an interleaved manner (only every
alternate word in each memory is read). A total of 1024
words is sent. N (where N is a number between 1 and 16)
This causes 1024 words to be read from the corresponding
indexed memory.
EXAMPLE: MEM?,7 CR
After the final word has been sent, the DSA will send the string:
SPACE OK CR.
5. Loading data into the waveform memories
Data can be loaded into any of the digitising memories, trace
memories or indexed memories. The data can be sent in binary,
hex or decimal formats. The format is changed using the MODE
command (see previous section for an explanation of this
command).
To load the data, send the primary command MEM followed by
a comma followed by one of the secondary commands listed
below (followed by a carriage return).
The secondary commands are as follows:
ACQ1 or AQU2 This loads the digitising memory of CH1 or
CH2. 4096 words must be sent.
TRA or TRB This loads the trace memory of Trace A or
Trace B. 1024 words must be sent.
N (where N is a number from 1 to 16) This loads one of the
indexed memories. 1024 words must be sent.
EXAMPLE: MEM,TRA CR
After this command has been sent the DSA will send back the
string: READY CR indicating that it is ready to accept the data.
When the correct number of bytes have been received it will
send back the string: OK CR.
6. Further primary commands
IDENT? This causes the DSA to send back an identity
string which includes the firmware level, e.g.
DSA524 V2.67
BEEP This causes the audio transducer on the DSA
to give a short "beep".
TEXT,STRING where STRING is a string of up to 20 ASCII
characters from the set listed below; This
causes the string to be displayed on the
screen for 3 seconds.
FPOFF This causes the DSA front panel to be
disabled. The front panel lamp marked REM
(remote) will be illuminated.
FPON This causes the DSA front panel to be enabled
again.
Note that FPOFF also disabled the primary command KEY, thus
if KEY commands are required when the front panel is disabled
it will be necessary to send FPON followed by the appropriate
KEY commands followed by FPOFF.
List of allowable ASCII characters for the TEXT command:
All upper case letters A to Z, numbers 0 to 9, plus the following
lower case letters and symbols: m, n, u, +, -, *, /, =. In
addition, sending the ASCII character ! will produce a delta
symbol, [will produce a left facing arrow and] will produce a
right facing arrow. Space will produce a space.
7. Saving and restoring the total contents of the DSA
memories
The total contents of the non-volatile memories of the DSA (i.e.
digitising memories, screen memories, indexed waveform
stores, front panel set-up memory, and Program mode
memory) can be saved to a remote location (e.g. a disk store)
and restored from a remote location using the commands
DUMP? and LOAD.
To save data from the DSA, send the command string DUMP?
CR the DSA will send 30,000 bytes of data followed by the
string SPACE OK CR. The data will be sent in the format set by
the MODE command (see Section 4).
To restore data to the DSA, send the command string LOAD CR
the DSA will send back the string READY CR indicating it is
ready to accept data. When 30,000 bytes have been received it
will send back the string OK CR.
Important note! No modifications must be made to the data
saved using the DUMP? command. Also the MODE setting (see
Section 4) must be the same when the data is restored as it
was when it was saved. To guard against this, any save and
restore program should incorporate a MODE command before
both the DUMP? and the LOAD commands. If the DSA memory
were to be restored with invalid data a total system corruption
would occur. In this event it would be necessary to switch the
DSA off and then on, and then to use "FUNCTION 78" to totally
clear the memories (see Section R27.).