This technical manual provides programming and communication instructions for
the Druck DPI 142/150 Pressure Indicator compatible with the requirements of a
programming technician.
!!
!Scope
!!
This technical manual contains the communications protocol for the operator
of this equipment .
!!
!Software
!!
This technical manual applies to software version 2.
Safety
!The manufacturer has designed this product to be safe when operated
using the procedures detailed in this manual. Do not use this product for any
other purpose than that stated.
!This publication contains operating and safety instructions that must be followed
to make sure of safe operation and to maintain the equipment in a safe
condition. The safety instructions are either warnings or cautions issued to
protect the user and the equipment from injury or damage.
!Use qualified* programming technicians and good engineering practice for all
procedures in this publication.
""
"Pressure
""
Do not apply pressure greater the maximum safe working pressure to the
Druck DPI 142/150 Pressure Indicator.
""
"Maintenance
""
The Druck DPI 142/150 Pressure Indicator must be maintained using the
manufacturers procedures and should be carried out by authorised service
agents or the manufacturers service departments.
""
"Technical Advice
""
For technical advice contact the manufacturer or subsidiary.
*A programming technician must have the necessary specialist knowledge of
programming, technical knowledge and documentation to carry out the required
work on the Druck DPI 142/150 Pressure Indicator.
Associated Druck Documents:
K343 DPI 142 User Manual
K344 DPI 150 User Manual
K382 DPI 142/150 Calibration Manual
Associated Documents:
A beginners Guide To SCPI by Barry Eppler, Published by Addison-Wesley
Publishing Company Inc. for Hewlett Packard (ISBN 0-201-56350-9).
Pressure measurement units ............................................................................................................................v
Pressure unit conversions............................................................................................................................ix
Figure 1-1System Model ............................................................................................................................ 1-1
Figure 3-1Command and Query Summary ...................................................................................... 3-2
iv
Table
List of Tables
pa ge
4-1Errors -100 to -199............................................................................................................................ 4-1
4-2Errors -200 to -299............................................................................................................................ 4-2
4-3Errors -300 to -400............................................................................................................................ 4-2
4-3Errors +201 to +212............................................................................................................................ 4-3
K381 Issue No. 1
Page 7
v
Abbreviations
The following abbreviations are used in this manual; abbreviations are the same in the singular and plural.
absAbsolute
ASCIIAmerican Standard Code for Information Interchange
ATEAutomatic test equipment
e.g.For example
etc.And so on
Fig.Figure
ftFoot
gGauge
GPIBGeneral purpose interface bus
i.e.That is
IEEE 488Institute of Electrical and Electronic Engineers standard 488 data
mMetre
maxMaximum
mbarMillibar
minMinute or minimum
No.Number
qaQuasi-absolute(combination of barometric and gauge sensor readings)
RS232Serial communications standard
SCMSensor cal ibration module
SCPIStandard commands for programmable instruments
+vePositive
CMH2Ocentimetres of water at 20°C
CMHGcentimetres of mercury
FTH2Ofeet of water at 20°C
FTH2O4feet of water at 4°C
HPAhecto Pascals
INH2Oinches of water at 20°C
INH2O4inches of water at 4°C
INH2O60inches of water at 60°F
INHGinches of mercury
KG/CM2kilogrammes per square centimetre
KG/M2kilogrammes per square metre
KPAkilo Pascals
LB/FT2pounds per square foot
MH2Ometres of water
MHGmetres of mercury
MMH2Omillimetres of water
MMHGmillimetres of mercury
MPAmega Pascals
PAPascals
PSIpounds per square inch
TORRtorr
MBARmillibar
Unit Conversion
To convert FROM pressure VALUE 1 in pressure UNITS 1
TO pressure VALUE 2 in pressure UNITS 2, calculate as follows:
VALUE 2 =VALUE 1 x FACTOR 1
FACTOR 2
Note:
The conversion factor for pressure units referenced [1] are calculated for a water temperature of
4°C. Pressure units referenced [2] are calculated for a water temperature of 68°F, these units are
normally used in the US A.
K381 Issue No. 1
Page 12
intentionally left blank
x
K381 Issue No. 1
Page 13
Druck DPI 142/150 SCPI User Manual1 - 1
UNITs
sub-system
CALibration
sub-system
SENSe
sub-system
SYSTem
sub-system
System Model
SCPI starts with a high-level block diagram of the measurement functions of
the instrument . Each functional block is broken down into smaller block
diagrams. SCPI contains a hierarchy of commands called a subsystem that
maps directly to the hierarchy of the block diagram.
1INTRODUCTION
1.1General
The IEEE 488 and RS232 interfaces of the DPI 142/150 Pressure Indicators
provide remote control of the instrument from a suitable computer or
controller. The SCPI protocol enables any instrument with a SCPI facility to be
controlled using the same commands. The DPI 142/150 Pressure Indicators
use a reduced SCPI command set and the defined SCPI syntax.
The following sections describe and define each instrument command used by
the DPI 142/150 Pressure Indicators. Each section contains a quick reference
structure of the relevant commands.
Pressure
in
Figure 1-1 System Model
K381 Issue No. 1
Page 14
1 - 2Introduction
intentionally left blank
K381 Issue No. 1
Page 15
Druck DPI 142/150 SCPI User Manual2 - 1
rootLevel 1Level 2
AB
C
D
E
F
G
H
J
2COMMAND STRUCTURE
This section describes the structure of the commands and data sent and
received by the DPI 142/150 Pressure Indicator.
2.1Notation
All SCPI commands are based on a hierarchical tree structure consisting of key
words and parameters. Associated commands are grouped together under a
common node in the hierachy.
In the command tree the command A is the root command. A tree pointer is
used to decode the SCPI commands. At power-up the pointer goes to the root
command.
2.2Message Terminators
All SCPI commands are terminated by line feed i.e., either <newline> (ASCII
character, decimal 10), EOI for IEEE. After receiving a termination character the
tree pointer returns to the root command.
Colon
A colon moves the current path down one level in the command tree, (e.g., the
colon in UNIT:PRESSURE specifies PRESSURE the is one level below UNIT).
When the colon is the first character of the command, it specifies that the next
command is a root level command (e.g., :UNIT specifies that UNIT is a root level
command).
K381 Issue No. 1
Page 16
K381 Issue No. 1
2 - 2Command Syntax
Semicolon
A semicolon separates two commands in the same message without changing
the tree pointer.
(e.g., with reference to the tree):A:B:E;F:G
This equivalent to sending three messages
:A:B:E
:A:B:F
:A:B:G
SCPI commands are not case sensitive and may have a short form. In this
manual, upper case letter identify the short form.
(e.g.):INSTrument:SN?
Some nodes can be the default node and these key words are optional when
programming the command. The instrument processes the command, with
the same effect , with or without the option node. In this manual [] enclose
[default notes].
(e.g.):UNIT[:PRESsure:]?
can be sent as
:UNIT:PRESsure?
or
:UNIT?
This gives the pressure units
Page 17
Druck DPI 142/150 SCPI User Manual2 - 3
2.3Program Headers
Program headers are keywords that identify a command, instruments accept
both upper and lower case characters in a program header. There are two
types of program header, common command headers and instrument control
headers; each header can be a command or a query.
Common Command and Query Headers
The common command and query program header syntax, specified in IEEE
488.2, are defined as follows:
Command
*<PROGRAM MNEMONIC>
Query
*<PROGRAM MNEMONIC>?
Instrument Control Command and Query Headers
The instrument control command and query program header syntax controls
and extracts data from the instrument as follows:
Command
:<MNEMONIC>
:<MNEMONIC> <PARAMETER>
Query
:<MNEMONIC>?
Queries
Most SCPI commands can be queried. A query is a command header with an
attached question mark character (?). On receiving a query command, the
current settings for the command are loaded in the output buffer. A query
does not affect the operation or set-up of the instrument .
When the parameter contains enumerated character data, both long form and
short form are recognised. Querying the command causes the return of data
in the short form.
Querying numeric parameters causes the resulting data to be returned in the
units selected by the instrument unless specified otherwise.
K381 Issue No. 1
Page 18
2 - 4Command Syntax
2.4SCPI Data Types
A variety of data types can be sent to the instrument as parameters or sent
out from the instrument as response data.
Decimal Numeric Data
All normal decimal expressions are accepted including optional signs, decimal
point and scientific notation.
Note:
This includes floating point data.
The following are valid:
123
45.67
-2.6
4.6e-10
.76
A suffix multiplier can be added to the numeric value.
:CAL:PRES:VAL 100 m
would set the calibrated pressure input to 0.1 units (100m units).
The multipliers supported are:
MnemonicMultiplier
A1e-18
G1e+9
K1e+3
M1e-3
T1e+12
If a real value is sent to the instrument when an integer is expected, it will be
rounded to an integer.
Integer Data
Integer data are whole numbers (containing no decimal places). A query of an
integer value returns numbers containing no decimal places.
Note:
Integer values can be specified in binary, octal or hexadecimal formats using
the suff ix letters (upper or lower case) B, Q and H respectively.
e.g.,#B1010binary representation of 10
#Q71octal representation of 57
#HFAhexadecimal representation of 250
Hexadecimal digits A-F can be in upper or lower case.
K381 Issue No. 1
Page 19
Druck DPI 142/150 SCPI User Manual2 - 5
Enumerated Character Program Data
Enumerated characters are used for data that has a finite number of values;
enumerated parameters use mnemonics to represent each valid setting.
The mnemonics have long and short forms just like command mnemonics.
Example:
:UNIT:BAR
selects the pressure units as bar.
Boolean Program Data
Boolean data can only be one of two conditions; the numbers 1 and 0.
Example:
:CALibration:DIODe:ABORT 1
A query of boolean data always returns 1 or 0.
String Data
String data can contain any of the ASCII characters. A string must start with a
double "quote" (ASCII 34) or a single `quote` (ASCII 39) and end with the same
character.
Example:
:SENse:RANGe 2barg
or
:SENse 2barg
selects the 2 bar g range.
A query of a string parameter always returns the string in double "quotes".
K381 Issue No. 1
Page 20
2 - 6Command Syntax
Every time a query has been successfully completed, the response, in a text
readable format is placed at the end of the output queue. The output queue
can contain up to 256 characters. If there is not enough space in the output
queue for a new message, the error -350, "Queue overflow" will be placed into
the error queue and the most recent output message will be lost .
2.5Output queue
The output queue is a text readable data queue that is read through the IEEE
488 talk command. The queue is cleared by reading all elements in it or by the
*CLS command.
K381 Issue No. 1
Page 21
Druck DPI 142/150 SCPI User Manual3 - 1
3COMMAND AND QUERY SUMMARY
The following lists of all the SCPI commands and queries that apply to the
instrument .
3.1Command structure
Some of the commands in the following summary are enabled at specific
times and conditions, most can be enabled at any time. The parameters
column shows the states, values and data contained in a command. The
command structure divides into subsystems as follows:
Command sub-system
.:CALibration - calibration commands.
.:INSTrument - instrument specific commands.
.:SENSe - directs the instrument to measure selected parameters.
The CALibration subsystem enables the calibration of the transducers and the rate
control system, refer to the user manual for further details.
:CAL:DIOD:ABOR
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
:CALibration:DIODe:ABORt
Parameter:
Boolean0-enables calibration
1-aborts calibration
Short form::CAL:ABOR
Function:stops calibration
Default:0
Description
This command is used to stop a calibration of the RPT diode, at any time, during the
procedure.
Query Syntax
n/a
K381 Issue No. 1
Page 24
3 - 4Command and Query Summary
:CAL:DIOD:ACC
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
:CALibration:DIODe:ACCept
Parameter:
Short form::CAL:DIOD:ACC
Function:accepts new RPT diode calibration data
Default:
Description
This command is used to accept the new two-point calibration values.
Query Syntax
n/a
K381 Issue No. 1
Page 25
Druck DPI 142/150 SCPI User Manual3 - 5
:CAL:DIOD:POIN
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
n/a
Query Syntax
:CALibration:DIODe:POINt?
Short form::CAL:DIOD:POIN?
Function:returns number of calibration points.
Response:number
Description
This queries the required number of RPT diode calibration points.
K381 Issue No. 1
Page 26
3 - 6Command and Query Summary
:CAL:DIOD:SAMP
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
n/a
Query Syntax
:CALibration:DIODe:SAMPle?
Short form::CAL:DIOD:SAMP?
Function:Returns number of samples remaining.
Response:number
Description
This queries the number of samples remaining in the diode calibration procedure of
the RPT; if zero is returned the calibration voltage can be entered.
K381 Issue No. 1
Page 27
Druck DPI 142/150 SCPI User Manual3 - 7
:CAL:DIOD:SAMP:STAR
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
:CALibration:DIODe:SAMPle:STARt
Parameter:Boolean0-disable
1-enable (start)
Short form::CAL:DIOD:SAMP:STAR
Function:Starts sampling
Defaults:0
Description
Starts sampling of the RPT tranducer diode voltage.
Query Syntax
n/a
K381 Issue No. 1
Page 28
3 - 8Command and Query Summary
:CAL:DIOD:VAL
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
:CALibration:DIODe:VALue <n> <value>
Parameter:integer in volts
Query Syntax
:CALibration:DIODe:VALue <n>?
Short form::CAL:DIOD:VAL?
Function:
Response:
Description
This command and query gives the voltage output from the RPT diode.
K381 Issue No. 1
Page 29
Druck DPI 142/150 SCPI User Manual3 - 9
:CAL:PRES:ABOR
Applicable to DPI 150
Command Syntax
:CALibration:PRESsure:ABORt
Parameter:
Boolean0-enables calibration
1-aborts calibration
Short form::CAL:ABOR
Function:stops calibration
Default:0
Description
This command is used to stop the current pressure calibration, at any time, during
the procedure.
Query Syntax
n/a
K381 Issue No. 1
Page 30
3 - 10Command and Query Summary
:CAL:PRES:ACC
Applicable to DPI 150
Command Syntax
:CALibration:PRESsure:ACCept
Parameter:
Short form::CAL:PRE:ACC
Function:accepts new pressure calibration values
Default:
Description
This command is used to accept the new two-point calibration values.
Query Syntax
n/a
K381 Issue No. 1
Page 31
Druck DPI 142/150 SCPI User Manual3 - 11
:CAL:PRES:POIN
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
n/a
Query Syntax
:CALibration:DIODe:POINt?
Short form::CAL:DIOD:POIN?
Function:returns number of calibration points.
Response:number
Description
This queries the required number of RPT diode calibration points.
K381 Issue No. 1
Page 32
3 - 12Command and Query Summary
:CAL:PRES:SAMP
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
n/a
Query Syntax
:CALibration:DIODe:SAMPle?
Short form::CAL:DIOD:SAMP?
Function:Returns number of samples remaining.
Response:number
Description
This queries the number of samples remaining in the diode calibration procedure of
the RPT; if zero is returned the calibration voltage can be entered.
K381 Issue No. 1
Page 33
Druck DPI 142/150 SCPI User Manual3 - 13
:CAL:PRES:SAMP:STAR
Applicable to DPI 142 and Option E of the DPI 150
Command Syntax
:CALibration:DIODe:SAMPle:STARt
Parameter:Boolean0-disable
1-enable (start)
Short form::CAL:DIOD:SAMP:STAR
Function:Starts sampling
Defaults:0
Description
Starts sampling of the RPT tranducer diode voltage.
Query Syntax
n/a
K381 Issue No. 1
Page 34
3 - 14Command and Query Summary
:CAL:PRES:VAL
Command Syntax
:CALibration:PRESsure:VALue <n> <value>
Parameter:integer
Short form:CAL:PRES:VAL
Function:Enters nth pressure value in mbar
Defaults:zero
Query Syntax
:CALibration:PRESsure:VALue <n>?
Short form::CAL:PRES:VAL?
Function:Queries nth entered pressure value in mbar
Response:<n> <value>
Description
This command enters calibration pressure values up to the nth number. The query
gives the calibration pressure values up to the nth number.
K381 Issue No. 1
Page 35
Druck DPI 142/150 SCPI User Manual3 - 15
INSTrument
The INSTrument subsystem gets information about the configuration of the
instrument and contains query only commands.
:INST:CAT
Command Syntax
n/a
Query Syntax
:INSTrument:CATalog?
Short form::INST:CAT?
Function:Query ranges fitted
Response:A list of comma separated strings of ranges fitted.
Description
This command returns a list of ranges fitted to the instrument. The reply is a comma
separated list of strings representing each range.
e.g.
2barg,3.5barqa.
If a barometer is fitted, the string BAROMETER is added to the list.
K381 Issue No. 1
Page 36
3 - 16Command and Query Summary
:INST:SN
Command Syntax
n/a
Query Syntax
:INStrument:SN?
Short form::INST:SN?
Function:Used to query the serial number of the instrument.
Asks for serial number
Response:Integer representing serial number
Description
This query only command returns the serial number of the instrument.
K381 Issue No. 1
Page 37
Druck DPI 142/150 SCPI User Manual3 - 17
SENSe
The SENSe subsystem selects and configures the sensing functions of the
instrument.
:SENS:PRESsure
Command Syntax
n/a
Query Syntax
:SENSe:PRESsure?
Short form::SENS:PRES?
Function:Used to query the current pressure reading of the instrument.
Response:<n> pressure
Description
This query only command returns the pressure reading of the instrument.
K381 Issue No. 1
Page 38
3 - 18Command and Query Summary
:SENS:ALTitude
Command Syntax
n/a
Query Syntax
:SENSe:ALTitiude?
Short form::SENS:ALT?
Function:Used to query the current altitude pressure reading of the
instrument .
Response:Altitude reading in aeronautical units.
Description
This query only command returns the altitude reading in aeronautical units of the
instrument .
K381 Issue No. 1
Page 39
Druck DPI 142/150 SCPI User Manual3 - 19
:SENS:SPEed
Command Syntax
n/a
Query Syntax
:SENSe:SPEed?
Short form::SENS:SPE?
Function:Used to query the current speed reading of the instrument.
Response:Speed reading in aeronautical units.
Description
This query only command returns the current speed reading in aeronautical units of
the instrument.
K381 Issue No. 1
Page 40
3 - 20Command and Query Summary
:SENS:MACH
Command Syntax
n/a
Query Syntax
:SENSe:MACH?
Short form::SENS:MACH?
Function:Used to query the current Mach reading of the instrument.
Response:Speed reading in Mach number.
Description
This query only command returns the current speed reading in Mach number.
K381 Issue No. 1
Page 41
Druck DPI 142/150 SCPI User Manual3 - 21
:SENS:RANGe
Command Syntax
n/a
Query Syntax
:SENSe:RANGe?
Short form::SENS:RANG?
Function:Used to query the current pressure range of the instrument .
Response:Returns the current pressure measurement range.
Description
This query only command returns the current pressure measurement range of the
instrument .
K381 Issue No. 1
Page 42
3 - 22Command and Query Summary
SYSTem
The SYSTem subsystem consists of general purpose commands.
:SYST:ERR
Command Syntax
n/a
Query Syntax
:SYStem:ERRor?
Query:ERRor?
Short form::SYST:ERR?
Function:Gets next error from the error queue
K381 Issue No. 1
Page 43
Druck DPI 142/150 SCPI User Manual3 - 23
Response:The follow list of errors are available
-102, Syntax error
-104, Data type error
-108, Parameter not allowed
-109, Missing parameter
-110, Command Header Error
-111, Header Separator Error
-112, Program mnemonic too long
-113, Undefined header
-114, Header suffix out of range
-120, Numeric data error
-121, Invalid character in number
-123, Exponent too large
-124, Too many digits
-128, Numeric data not allowed
-130, Suffix error
-131, Invalid suffix
-134, Suff ix too long
-138, Suffix not allowed
-140, Character data error
-141, Invalid character data
-144, Character data too long
-148, Character data not allowed
-150, String data error
-151, Invalid string data
-158, String data not allowed
-200, Execution error
-201, Invalid while in local
-202, Settings lost due to rtl
-220, Parameter error
-222, Data out of range
-223, Too much data
-224, Illegal parameter value
-300, Calibration error
-310, System error
-350, Queue overflow
-400, Query error
201 , Query only
202 , No query allowed
203 , Parameter(s) not expected
207 , Enumerated value not in union
208 , Illegal number of parameters
210 , Run out of memory handle
211 , Unit not matched
212 , Unit not required
Description
This command queries the error queue which holds up to five errors. The instrument
returns the message No error when no more errors are in the queue.
K381 Issue No. 1
Page 44
3 - 24Command and Query Summary
:SYST:PASS
Command Syntax
:SYSTem:PASS:[CEN] 2317100
Parameter:n/a
Short form::SYST:PASS
Function:Enters calibration mode.
Description
This command enters calibration mode.
Query Syntax
n/a
K381 Issue No. 1
Page 45
Druck DPI 142/150 SCPI User Manual3 - 25
:SYST:PASS:CDIS
Command Syntax
:SYSTem:PASS:CDIS 2317100
Parameter:n/a
Short form:SYST:PASS:CDIS
Function:Exits calibration mode
Description
This command exits calibration mode.
Query Syntax
n/a
K381 Issue No. 1
Page 46
3 - 26Command and Query Summary
:SYST:PASS:STAT
Command Syntax
n/a
Query Syntax
:SYSTem:PASS:[CEN] STAT?
Short form:SYST:PASS:STAT?
Function:Queries calibration mode
Response:0 indicates not in calibration mode
1 indicates in calibration mode
Description
This command indicates the calibration mode.
K381 Issue No. 1
Page 47
Druck DPI 142/150 SCPI User Manual3 - 27
UNIT
The UNIT sub-system configures the instruments pressure measurement units.
Note:See Pressure Measurements Units on page v for a def inition of these parameters.
Short form:UNIT <name>
Function:Selects pressure units
K381 Issue No. 1
Page 48
3 - 28Command and Query Summary
Query Syntax
:UNIT[:PRESsure]?
Short form::UNIT?
Function:Query what pressure units are selected
Response:name as above
Description
This command selects the current pressure units; USER1 and USER2 are the user
defined units.
K381 Issue No. 1
Page 49
Druck DPI 142/150 SCPI User Manual3 - 29
3.2Standard Commands
The commands identified with * are SCPI standard commands.
*CLS
Command Syntax
*CLS
Parameter:none
Short form*CLS
Function:This command clears the status registers in the status reporting
system.
Query Syntax
n/a
Description
Clears all errors..
K381 Issue No. 1
Page 50
3 - 30Command and Query Summary
K381 Issue No. 1
Page 51
Druck DPI 142/150 SCPI User Manual4 - 1
4ERRORS
Negative error numbers are used for standard SCPI errors. Positive error
numbers are device specific errors. Following the error number, a message
describes the error. An error, when detected, is held in the error queue.
When SYST:ERR? is sent any error in the error queue sets the error bit in the
event status register.
Error numbers
Each error detected causes an error number with an error message to be
returned as follows: