7command-line interface, 1 forth – Guralp Systems CMG-6TD User Manual

Page 80

Advertising
background image

CMG-6TD

Command-line interface

7

Command-line interface

You can connect to the internal software of the 6TD 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 6TD 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 6TD.

Whilst you are in terminal mode, data transfer will be interrupted; the 6TD

may use its 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.

Güralp EAM and AM modules also allow you to send commands direct to the
6TD using the FORTH terminal emulator in the web interface or the

command-line tool data­terminal. For more information, please see the
Platinum manual, MAN-EAM-0003.

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 6TD expects connections at 19200 Baud,
with eight data bits, no parity bit and one stop bit. No flow control (neither

hardware nor software) is used.

7.1

FORTH

The 6TD uses a FORTH-like interpreter to implement its features. To issue a
command in FORTH, you must supply the arguments before the command,

for example:

0 19200 BAUD

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 thing you typed), they will execute, remove

themselves from the stack, and then remove further items from the stack to
use as arguments.

Thus, in the command above, the numbers have no immediate effect, so stay
on the stack. BAUD removes itself and the previous two items (here 0 and
19200) off the stack, then performs its action using these as arguments.

MAN-T60-0002

80

Issue F - February 2014

Advertising