Command line interface
6 Command line interface
6.1 Introduction
You can connect to the internal software of the DM24 over its output serial port and
communicate with it.
To enter command mode from Scream!, right-click on the digitiser's icon ( ) and
select
Terminal…
from the menu that pops up. A window will open, and once the
digitiser and computer are communicating properly you will see the prompt
ok
If you prefer, you can use a terminal program on your computer (such as
minicom
on
Linux, or PuTTY on Microsoft Windows) to connect to the DM24.
Whilst you are in terminal mode, data transfer will be interrupted; the digitiser may
use any Flash memory as a temporary store, depending on how you have configured
it. Some commands, such as
SET-TAPS
, require a reboot to take effect.
When you are finished with your command-line session, simply close the Scream! or
emulator window. Scream! will automatically issue the
GO
command to resume data-
stream transmission. The session will, in any case, time-out after a minute. If this
happens while you are using
minicom
or PuTTY, and the digitiser starts transmitting
stream data (which will appear as bursts of unintelligible characters), key
+
to interrupt the streams and resume your session.
Güralp EAM modules also allow you to send commands direct to the digitiser using
the command-line tool
data-terminal
. Older DCMs and AMs used the command-
line tool
gcli
. For more information, please see the manual for your data module.
If you have problems connecting to the digitiser's console, you should check that the
serial port's options and baud rate are set correctly in Scream! or your terminal
program. As supplied, the DM24 expects connections at 19200 baud, with eight data
bits, no parity bit and one stop bit. No flow control is used: neither hardware nor
software.
6.1.1 FORTH
The DM24 uses a FORTH interpreter to implement its features. To issue a command
in FORTH, you must supply the arguments before the command, for example:
3 SENSOR-TYPE
In FORTH, anything you enter is termed a
word
. New words (case insensitive) are
placed on a stack. Some words are known to the system, and may represent
commands; if a command finds itself at the top of the stack (e.g. because it is the last
56
Issue U - December, 2021
