You are on page 1of 17

V1.

0
5

38DLP Series Remote Command Set

38DLP Series Remote Command Set V1.05 · 1


Contents

FORWARD 2

Introduction................................................................................................................................2

Multi-Character Commands 3

Introduction................................................................................................................................3
FTP Block Information.....................................................................................................................................4
Gage Information.............................................................................................................................................4
File Directory....................................................................................................................................................4
File Read...........................................................................................................................................................5
File Write..........................................................................................................................................................5
File Create........................................................................................................................................................6
File Delete.........................................................................................................................................................6
Application Setup Directory.............................................................................................................................7
Application Setup Read....................................................................................................................................7
Application Setup Write...................................................................................................................................8
Make Application Setup Active........................................................................................................................8
Transducer List.................................................................................................................................................9
Database Memory Status..................................................................................................................................9
ID Data Send..................................................................................................................................................10
Version Get.....................................................................................................................................................10
Units Get.........................................................................................................................................................10
Velocity Get.....................................................................................................................................................11
Mode Get........................................................................................................................................................11
Data Window 1 Get........................................................................................................................................11
Data Window 2 Get........................................................................................................................................12
Sample Rate Get.............................................................................................................................................12
Waveform Grab (not implemented)...............................................................................................................12
Range Send.....................................................................................................................................................13
Battery Level Get............................................................................................................................................13
Velocity Set.....................................................................................................................................................13
Go to Monitor mode (not implemented)........................................................................................................14
Communication Protocol change...................................................................................................................14

Single-Character Commands 15

Introduction..............................................................................................................................15

38DLP Series Remote Command Set V1.05 · 2


FORWARD

Introduction

This document describes remote command operations of the 38DLP via communications link. The
command set is divided in two formats, multi-character commands and single-character
commands. Multi-character commands consist of two or more characters and maybe followed by
a terminator. Single-character commands consist of a single character with no terminator, used to
imitate keystrokes on the gage remotely.

Switching the command format can be done using remote commands or the gage keypad. You can
use the PROTO=SINGLE multi-character command to switch from multi-character format to
single-character format and you can use the + single-character command to switch from single-
character format to multi-character format. Refer to the gage manual for details on changing the
command format using the gage keypad.

38DLP Series Remote Command Set V1.05 FORWARD · 3


Multi-Character Commands
Introduction

This chapter describes all Multi-Character commands and illustrates the syntax used with each
command. The term host used in the command descriptions always refers to the sender of the
command. Commands are case sensitive and except where noted are terminated with a carriage-
return line-feed pair (i.e./r/n).

Many responses to the Multi-Character commands documented here are conveyed using the FTP
protocol described in the Olympus NDT 38DLP Series FTP companion document. Please see
that document for more details.

FTP Block Information


This command will instruct the gage to send to the host information about the FTP blocks
supported by the gage. See Olympus-NDT document 38DLP Series FTP for details on
the FTP INFO block sent back by the gage.
COMMAND FORMAT: FTPINFO?\r\n
Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A byte hexadecimal value).

Gage Information
This command will instruct the gage to send to the host general information about the
gage. See Olympus-NDT document 38DLP Series FTP for details on the GAGE INFO
block sent back by the gage.

COMMAND FORMAT: GAGEINFO?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A byte hexadecimal value).

File Directory
This command will instruct the gage to send to the host the file directory that exists on the
gage. See Olympus-NDT document 38DLP Series FTP for details on the DIR INFO
block sent back by the gage.

COMMAND FORMAT: FILEDIR?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

File Read
This command will instruct the gage to send to the host a file that exists on the gage. See
Olympus-NDT document 38DLP Series FTP for details on the FREAD INFO block and
the file transmission blocks sent back by the gage.
COMMAND FORMAT: FILEREAD?\2\r\n
FREAD INFO block
\3\r\n
Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 \2 is the STX character (0x02 hexadecimal byte value).
 \3 is the ETX character (0x03 hexadecimal byte value).

File Write
This command will instruct the gage to receive a file that is sent by the host. See Olympus-
NDT document 38DLP Series FTP for details on the file info transmission blocks sent to
the gage.

COMMAND FORMAT: FILEWRITE=\2\r\n


TRANSMISSION INFO block
FILE HEADER INFO block
ID INFO block
SU TABLE INFO block
NOTE TABLE INFO block
\3\r\n
Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 \2 is the STX character (0x02 hexadecimal byte value).
 \3 is the ETX character (0x03 hexadecimal byte value).

File Create
This command will instruct the gage to create a file that is described by the host. See
Olympus-NDT document 38DLP Series FTP for details on the file info transmission
blocks sent to the gage.

COMMAND FORMAT: FILECREATE=\2\r\n


TRANSMISSION INFO block
FILE HEADER INFO block
ID INFO block
NOTE TABLE INFO block
\3\r\n
Notes:
 ID INFO block is same as for FILEWRITE command except individual
ID specific packets (ID0, ID1, WFD, etc.) are omitted.
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 \2 is the STX character (0x02 hexadecimal byte value).
 \3 is the ETX character (0x03 hexadecimal byte value).

File Delete
This command will instruct the gage to delete a file that is on the gage. See Olympus-NDT
document 38DLP Series FTP for details on the FILEDELETE INFO block.

COMMAND FORMAT: FILEDELETE\2\r\n


FILEDELETE INFO block
\3\r\n
Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 \2 is the STX character (0x02 hexadecimal byte value).
 \3 is the ETX character (0x03 hexadecimal byte value).

Application Setup Directory


This command will instruct the gage to send to the host the active setup and all of the user
setups that exists on the gage. See Olympus-NDT document 38DLP Series FTP for
details on the APP SU TABLE INFO block sent back by the gage.
COMMAND FORMAT: APPSUDIR?\r\n
Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Application Setup Read


This command will instruct the gage to send to the host the application setup that is
requested. See Olympus-NDT document 38DLP Series FTP for details on the APP SU
INDEX block and the APP SU INFO block sent back by the gage.

COMMAND FORMAT: APPSUREAD?\2\r\n


APP SU INDEX block
\3\r\n
Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 \2 is the STX character (0x02 hexadecimal byte value).
 \3 is the ETX character (0x03 hexadecimal byte value).

Application Setup Write


This command will instruct the gage to receive an application setup that is sent from the
host. See Olympus-NDT document 38DLP Series FTP for details on the APP SU
INDEX and APP SU INFO blocks.

COMMAND FORMAT: APPSUWRITE=\2\r\n


APP SU INDEX block
APP SU INFO block
\3\r\n
Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 \2 is the STX character (0x02 hexadecimal byte value).
 \3 is the ETX character (0x03 hexadecimal byte value).

Make Application Setup Active


This command will instruct the gage to make the given application setup the active setup.
See Olympus-NDT document 38DLP Series FTP for details on the APP SU INDEX
block.

COMMAND FORMAT: APPSUACTIVE=\2\r\n


APP SU INDEX block
\3\r\n

Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 \2 is the STX character (0x02 hexadecimal byte value).
 \3 is the ETX character (0x03 hexadecimal byte value).

Transducer List
This command will instruct the gage to send to the host the list of transducers supported
by the gage. See Olympus-NDT document 38DL Plus Series FTP for details on the
XDCR LIST INFO block sent back by the gage.

COMMAND FORMAT: XDCRLIST?\r\n

Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Database Memory Status


This command will instruct the gage to send information about the amount of free memory
remaining in the database. Three numbers are encoded into an ASCII string:
1. Number of IDs without waveforms that can be created in a new
file
2. Number of IDs with waveforms that can be created in a new file
3. Memory usage ratio for computations involving files that are a
mix of IDs with and without waveforms (egs. 16 means that an ID with a
waveform uses the same memory as 16 IDs without a waveform).
The numbers may be decoded by the standard C scanf function (egs. scanf(“%d %d %d”,
&iIds, &iIdsWfs, &IdsToIdsWfs)).

COMMAND FORMAT: MEMORY?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

ID Data Send
This command will instruct the gage to send information to the host about a single ID (the
current measurement in the context of the current ID) or all the IDs in the current file.
COMMAND FORMAT: SEND=SINGLE\r\n
Or SEND=FILE\r\n

Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
Version Get
This command will instruct the gage to send the versions of the gage and monitor
software to the host (egs. “VERSION: 1.01/1.20C”).

COMMAND FORMAT: VER?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Units Get
This command will instruct the gage to send the current units specification (“IN” or
“MM”) to the host.

COMMAND FORMAT: UNITS?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Velocity Get
This command will instruct the gage to send the active setup velocity to the host. The
velocity is encoded into an ASCII string and may be decoded by the standard C scanf
function (egs. scanf(“%f”, &fVel))

COMMAND FORMAT: VELOCITY?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
Mode Get
This command will instruct the gage to send the active setup measurement mode (“1”, “2”
or “3”) to the host. The mode number is encoded into an ASCII string and may be
decoded by the standard C scanf function (egs. scanf(“%d”, &iMode)).

COMMAND FORMAT: MODE?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Data Window 1 Get


This command will instruct the gage to send the current data window number 1. The data
window is encoded into an ASCII string and may be decoded by the standard C scanf
function (egs. scanf(“%d”, &iDataWin1)). Barrier Measurement must be enabled.

COMMAND FORMAT: DATAWIN1?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Data Window 2 Get


This command will instruct the gage to send the current data window number 2. The data
window is encoded into an ASCII string and may be decoded by the standard C scanf
function (egs. scanf(“%d”, &iDataWin2)). Barrier Measurement must be enabled.

COMMAND FORMAT: DATAWIN2?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Sample Rate Get


This command will instruct the gage to send the current sampler rate.
COMMAND FORMAT: SRATE?\r\n
Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Waveform Grab (not implemented)


This command will instruct the gage to send screen data in FX80 format to the host.

COMMAND FORMAT: WFGRAB?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Range Send
This command will instruct the gage to do a range send of all of the
IDs in the current file to the host.

COMMAND FORMAT: ntt

Battery Level Get


This command will instruct the gage to send the battery level percentage (egs. “99” to
indicate 99%) to the host. The battery level is encoded into an ASCII string and may be
decoded by the standard C scanf function (egs. scanf(“%d”, &iBattLevel)).

COMMAND FORMAT: BATTLEVEL?\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Velocity Set
This command will instruct the gage to set the active setup velocity to the specified value.

COMMAND FORMAT: VELOCITY=value\r\n

Example: VELOCITY=.2232\r\n
Notes:
 value should be specified in the current gage measurement units.
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Go to Monitor mode (not implemented)


This command will instruct the gage to go to the monitor mode.

COMMAND FORMAT: MONITOR=GO\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Communication Protocol change


This command will instruct the gage to change the communication protocol from multiple
to single.

COMMAND FORMAT: PROTO=SINGLE\r\n


Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).

Get Setup Name


This command will instruct the gage to send the active application setup name to the host
(egs. DEFM1-M112).

COMMAND FORMAT: SETUPNAME?\r\n

Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 This command is valid for single element transducer setups only.

Set Setup Name


This command will instruct the gage to set the active application setup name to the
specified value (egs. USER-M112).

COMMAND FORMAT: SETUPNAME=name\r\n

Notes:
 \r is the carriage-return character (0x0D hexadecimal byte value).
 \n is the line-feed character (0x0A hexadecimal byte value).
 This command is valid for single element transducer setups only.
Single-Character Commands
Introduction

This chapter describes all Single-Character commands and illustrates the syntax used with each
command.

Command COMMAND Syntax Corresponding Gage Key


Name ASCII Char Dec Hex Stroke(s)
MEAS m 109 6D [MEAS]
ID# i 105 69 [ID#]
NOTE I 73 49 [2nd], [ID#]
FILE c 99 63 [FILE]
nd
CLR MEM C 67 43 [2 ], [FILE]
XDCRRECALL x 120 78 [XDCRRECALL]
REF VALUE X 88 58 [2nd], [XDCRRECALL]
CAL VEL v 118 76 [CAL VEL]
VEL V 86 56 [2nd], [CAL VEL]
CAL ZERO z 122 7A [CAL ZERO]
DO ZERO Z 90 5A [2nd], [CAL ZERO]
SETUP MENU p 112 70 [SETUP MENU]
SP MENU P 80 50 [2nd], [SETUP MENU]
DISPLAY y 121 79 [DISPLAY]
RANGE n 110 6E [RANGE]
DELAY N 78 4E [2nd], [RANGE]
ZOOM o 111 6F [ZOOM]
E-TO-E O 79 4F [2nd], [ZOOM]
SLEW DOWN d 100 64 []
2nd F SLEW DOWN D 68 44 [2nd],[]
SLEW LEFT l 108 6C []
2nd F SLEW LEFT L 76 4C [2nd], []
SLEW RIGHT r 114 72 []
2nd F SLEW RIGHT R 82 52 [2nd], []
SLEW UP u 117 75 []
2nd F SLEW UP U 85 55 [2nd], []
ENTER e 101 65 [ENTER]
2nd F ENTER E 69 45 [2nd],[ENTER]
FREEZE f 102 66 [FREEZE]
GAIN g 103 67 [GAIN]
WAVE ADJ w 119 77 [WAVE ADJ]
SAVE s 115 73 [SAVE/SEND]
SAVE WAVE S 83 53 [2nd], [SAVE/SEND]
SEND t 116 74 [SEND]
Communication + 43 2B None
Protocol change Note: Changes comm protocol from single
to multi-character.