Newport User Commands
Newport User Commands
Revision History
Introduction
This document is an updated and detailed description of the various commands that are used for
remote control of the new line of Newport meters (843-R-USB, 1919-R, 841-PE-USB, 844-PE-USB,
845-PE-RS, and x938-R). For each command, we list which devices support the command as well as
providing examples when necessary and listing limitations, as applicable.
Note: All commands work in an ASCII-based command and response protocol. As such, data delivery
rates will not be as high as when working with the standard data streaming methods provided by the
COM object. Therefore, for top performance, we recommend fully embracing working with the COM
object. However, if there is a need to support legacy code, or RS-232 communication, this is here for
you.
1919-R, x938-R
In addition to USB, the 1919-R and x938-R instruments are equipped with RS-232 communication
capabilities.
845-PE-RS
The 845-PE-RS communicates over RS-232 only.
Page 1 of 31
User Commands
This section describes the commands available to control the Newport devices. It is divided into 3
sections.
When using the COM object, commands are sent to the device by calling the Write method and
responses are received by calling the Read method. Alternatively, for instruments which support it,
commands can be sent and responses received via RS-232 using any standard method.
Note: Devices expect a command before sending a response. Every read of a response must be
preceded by sending a command, and every command sent must be followed by reading a response.
Failure to follow these rules may lead to communication problems.
Note: The COM Object Write method for communication appends and removes the flags at the
beginning and end of the ASCII strings.
Multichannel devices
The 2938 has more than one channel. The CL command is provided to indicate which channel to
operate on, for those commands which are specific to a channel.
Page 2 of 31
Command Summary
The following table contains a listing of all commands available with Newport devices.
Page 3 of 31
Basic Commands
Command: High Resolution
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • •
Page 4 of 31
Command: Average Query
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• •
Syntax AQ <average-setting>
Description Query and set the average setting of the sensor. Returns index of presently active
Average setting as well as literal description of set of all available Average settings. If
an unsupported index is specified, will prefix a '?' to the response.
Syntax AR
Description Returns all ranges available in sensor. This is prefixed by the index of the
presently active range.
Example For an 818-SL-DB sensor in the 30 microwatt range, this command will return
“* 3 AUTO 30.0mW 3.00mW 300uW 30.0uW 3.00uW 300nW 30.0nW”.
Note: The index of the highest numeric range is 0. The index of AUTO (when
applicable) is -1
Limitations None
See Also GU, RN, SX, and WN; Command Summary
Page 5 of 31
Command: All Wavelengths
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax AW
Description Returns string fully describing the wavelengths that the sensor is configured to work
with.
Example Example 1. 918D with Filter Out. Device returns
“*CONTINUOUS 350 1100 1 633 488 978 NONE NONE NONE”
The user would know that it is a continuous curve sensor (from the prefix
CONTINUOUS), that the range of wavelengths is 350nm through 1100nm, that the
present wavelength that the sensor is configured to measure for is 633 (from the index
1), and the 6 favorite settings as they would be displayed in PMManager (above
10000nm would be displayed as 10.0). The second and third parameters delimit the
range of values that the $WL command would succeed with.
The user would know that this sensor is configured for a discrete set of wavelengths
(from the prefix DISCRETE), that the sensor is presently configured to work at the VIS
wavelength (from the index 1) and that the set of wavelengths that the sensor could
be configured to work with (via the $WW command) is "VIS" and "NIR".
Limitations None
See Also WD, WE, WI, and WL; Command Summary
The change takes effect after the response is sent; the response is sent at the old
baud rate.
Example • User sent “BD”. Device returns “*115200”
• User sent “BD 9600”. Device returns “*9600”
Limitations None
See Also Command Summary
Page 6 of 31
Command: BeamTrack
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax BT
Description Query device for latest PEPS position and size measurements
Response Format: "F" <Errors> "X" <X> "Y" <Y> "S" Size.
Where F is followed by Hex map of error codes
X is followed by the location of the laser spot on the X-axis in mm
Y is followed by the location of the laser spot on the Y-axis in mm
S is followed by the size of the laser beam in mm
The following is the listing of possible error codes. Other codes may be returned by
the sensor but can be ignored; they are either meant as diagnostic information for
Newport personnel or are reserved for future use.
Page 7 of 31
Command: Diffuser Query
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax DQ <diffuser-setting>
Description Query and set the diffuser setting of the sensor.
Example 2. 919E-10-35-250.
• User sent “DQ”. Device returns “*1 OUT IN”. Sensor is in Diffuser Out mode.
• User sent “DQ 2”. Device returns “* 2 OUT IN”. Sensor is now in Diffuser In
mode.
• User sent “DQ 3”. Device returns “? 2 OUT IN”. Request is invalid and
sensor remains in Diffuser In mode.
Limitations For Pyroelectric sensor only
See Also HC; Command Summary
Syntax EE
Description Instructs device to report up do date exposure measurement, number of pulses (for
Pyroelectric sensors), and time elapsed (in tenths of a second).
Example Example 1. Pyroelectric sensor in exposure mode. Device returns
“* 1.064E-1 2773 124”
Total exposure is 106.4mJ, 2773 pulses have been measured, and 12.4 seconds
have elapsed since the start of exposure measurement.
Page 8 of 31
Command: Energy Flag
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax EF
Description Polls device if a new energy reading has been processed and not yet communicated
to the user.
Example Device returns “*1” if there is a new reading or “*0” if there isn’t.
Limitations For Pyroelectric measuring power or energy; Thermopile sensors measuring energy.
See Also ER (Thermopile only), SE, and SP (for Pyroelectric only); Command Summary
Syntax ER
Description Polls device if sensor is ready to take a new energy reading. This is useful for users
that can control when their laser fires.
Example Device returns “*1” if it’s ready for a new energy pulse or “*0” if it isn’t.
Limitations For Thermopile sensors only, in energy or pulsed power measuring modes
See Also EF and SE; Command Summary
Page 9 of 31
Command: Energy Threshold
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax ET <threshold>
Description Query and set the threshold setting of the sensor.
Syntax FB
Description Puts instrument into Position Measurement mode. Device returns “*” if successful and
“?HEAD CANNOT MEASURE BEAMTRACK” if not.
Example User sent “FB”. Device returns “*”. Sensor is now measuring Position.
Limitations For PEPS series of sensors only.
See Also FE, FP, FX, HC, HI, MM, and SE; Command Summary
Syntax FE
Description Puts instrument into Energy Measurement mode. Device returns “*” if successful and
“?HEAD CANNOT MEASURE ENERGY” if not.
Example User sent “FE”. Device returns “*”. Sensor is now measuring Energy.
Limitations For Thermopile and Pyroelectric sensors.
See Also FB, FP, FX, HC, HI, MM, and SE; Command Summary
Page 10 of 31
Command: Force Power
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax FP
Description Puts instrument into Power Measurement mode. Device returns “*” if successful and
“?HEAD CANNOT MEASURE POWER” if not.
Example User sent “FP”. Device returns “*”. Sensor is now measuring Power.
Limitations None
See Also FB, FE, FX, HC, HI, MM, and SP; Command Summary
Syntax FQ <filter-setting>
Description Query and set the filter setting of the sensor.
Note: On the 1919-R, for sensors that auto-detect the filter state, this is a query only
and cannot be used to change the filter state
Example Example 1. 918D sensor with Filter OUT.
• User sent “FQ”. Device returns “*1 OUT”.
Example 2. 918D sensor with Filter IN.
• User sent “FQ”. Device returns “*1 IN”.
Example 3. 818-SL-DB sensor.
• User sent “FQ”. Device returns “*1 OUT IN”. Sensor is in Filter Out mode.
• User sent “FQ 2”. Device returns “* 2 OUT IN”. Sensor has been
reconfigured to Filter In mode.
• User sent “FQ 3”. Device returns “? 2 OUT IN”. Invalid setting and sensor
remains in Filter In mode.
Limitations For Photodiode sensors only
See Also HC; Command Summary
Syntax FX
Description Puts instrument into exposure measurement mode. Device returns “*” upon success.
Example User sent “FX”. Device returns “*”. Sensor is now measuring Exposure.
Limitations On some instruments for Pyroelectric sensors only, on some instruments also for
Photodiodes (see table above).
See Also EE, FE, FP, MM, and SE; Command Summary
Page 11 of 31
Command: Get range in Use
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax GU
Description When in autoranging, returns presently active numeric range.
Example 918D with Filter Out in autoranging. The latest readings have been about 2mW.
Device returns “*1”.
Limitations None
See Also AR, RN, SX, and WN; Command Summary
Syntax HC <configuration>
Description Save selected Sensor Configuration Settings.
Page 12 of 31
Command: Head Information
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax HI
Description Returns type, serial number, name, and measurement abilities of sensor.
Measurement abilities are reported as an 8 byte hexadecimal code where
Bit 0 is lit if sensor can measure power.
Bit 1 is lit if sensor can measure energy.
Bit 31 is lit if sensor can measure frequency.
All other bits are reserved and are not guaranteed to be 0 or 1.
Example Example 1. 919P-003-10 sensor. Device returns “* TH 12345 919P-003-10
00000183”.
The user knows that this is a Thermopile sensor (TH), its serial number (12345) and
name (919P-003-10), and that it can be used to measure power or energy (bits 0 and
1 are lit).
The user knows that this is a Pyroelectric sensor (PY), the serial number and name,
and that it can measure power, energy, and frequency
Limitations None
See Also FE, FP, HT, and II; CommandSummary
Syntax HT
Description Returns more specific sensor type than the HI command
Return Codes:
• BT: BeamTrack
• CP: Pyroelectric
• SI : Photodiode
• TH : Thermopile
• XX : No sensor connected
Example 919P-003-10 sensor. Device returns “*TH”
919E-0.1-12-25K sensor. Device returns “*CP”
Limitations None
See Also FE, FP, HI, and II; CommandSummary
Page 13 of 31
Command: Instrument Configuration
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax IC
Description Save Instrument Configuration. The new settings will be saved in the device’s
memory. Device returns “*SAVED” on success, “*UNCHANGED” if nothing needed
to be updated, or “?FAILED” if not successful.
Example None
Limitations None
See Also MA; CommandSummary
Syntax II
Description Returns id, serial number, and name of instrument being queried
Example Device returns “* 843R 113217 843R”. The user knows that this is an 843-R-USB and
its serial number (113217)
Limitations None
See Also HI; CommandSummary
Command: MAins
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax MA <line-frequency>
Description Query and set the line-frequency setting of the instrument.
Response: String containing index of presently active mains setting as well as literal
description of both mains settings. If Remote User specified an unsupported
index, will prefix a '?' to the response.
Example 2. European customer wants to set the device to correct line frequency and
sends “MA 1”. Device returns “* 1 50Hz 60Hz”
Limitations None
See Also IC; CommandSummary
Page 14 of 31
Command: Maximum Frequency
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Example 2. 919E-10-24-10K set to 5mS pulse width. Device returns “*100”. The
sensor can sample pulses of a laser whose frequency is 100 Hertz.
Limitations For Pyroelectric and Photodiode energy sensors only
See Also HI, PL, and SF; CommandSummary
Page 15 of 31
Command: Measurement Mode
The following table indicates which modes are supported for which instruments. 4C means exposure
is supported on Pyroelectric sensors only. 4CD means exposure is supported on Pyroelectric and
Photodiode sensors.
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
1, 2, 3, 5 1, 2, 3, 4CD, 5, 1, 2, 3, 4C, 5, 1, 2, 3, 4C, 5, 1, 2, 3, 4C, 5, 2, 3, 4CD, 5,
14, 16 14, 16 14, 16 14, 16 14, 15, 16
Syntax MM <measurement-mode>
Description Set instrument to selected Measurement Mode
Device returns “*” on success, “?NOT SUPPORTED” if the sensor doesn’t support
this measurement mode, or “?PARAM ERROR” if it doesn’t recognize the
<measurement-mode>.
Page 16 of 31
Command: Pulse Length
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax PL <pulse-length>
Description Query and set maximum pulse-length (in time) that sensor is configured to measure.
Syntax RN
Description Returns presently active measurement range.
Example Example 1. 918D in autoranging. Device responds “*-1”.
Page 17 of 31
Command: Send Energy
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax SE
Description Queries device for Energy Measurement
Example This command returns the most recent energy measurement. To verify that the device
has not previously reported it to the user, this command should be used in together
with the EF command.
Example.
1. User sends EF command.
2. Read device response. If response is “*0” repeat step 1. If response is “*1”
continue with step 3.
3. User send SE command
4. Device responds “*1.100E-4” (110uJ)
Limitations Not for Photodiode sensors. Sensor must be measuring Energy
See Also EF, ER, FE, SF, and SP; Command Summary
Syntax SF
Description Queries device for frequency at which the laser is firing.
Note: Although sensors can measure frequency up to 1000’s of Hertz, to actually
measure each of those pulses, you must work with the COM object
Example Example. Device returns “*1.000E3”. The laser is firing at a frequency of 1000Hz.
Limitations For Pyroelectric and Photodiode energy sensors only
See Also MF, PL, SE, and SP; Command Summary
Syntax SI
Description Queries meter for present measurement mode. Returns a single character that
represents the present measurement mode.
• d: dBm
• J: Joules
• W: Watts
• X: Passive mode. Nothing being measured
Example 919P-003-10 measuring power. Device returns “*W”.
Limitations None.
See Also Command Summary
Page 18 of 31
Command: Simulate Key-press
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• •
• 0: Left-most softkey
• 1: 2nd softkey.
• 2: 3rd softkey
• 3: Right-most softkey
Syntax SP
Description Queries device for Power Measurement
Example For all sensors except Pyroelectric sensors:
Return next power measurement
• Example. User sent “SP”. Device returns “*1.300E-5”. Power measured is 13
microwatts.
Example.
1. User sends EF command.
2. Read device response. If response is “*0” repeat step 1. If response is “*1”
continue with step 3.
3. User sends SP command
4. Device returns “*1.100E-1” (110mW)
Limitations Sensor must be measuring Power
See Also EF, FP, SE, and SF; Command Summary
Page 19 of 31
Command: Send maX
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax SX
Description Queries device for the maximum allowable reading on present scale.
Example Returns Max allowable reading for present range in scientific notation or AUTO if in
autoranging.
Examples:
• “*AUTO” for sensor in autoranging.
• “*3.000E-2” for sensor in the 30mW range.
Limitations None
See Also AR, GU, RN, WN; Command Summary
Syntax TA <TTL-setting>
Description Queries or sets the devices TTL output setting.
When <TTL-setting> is 0, this is a query which returns the current setting and the
available settings. When <TTL-setting> is greater than 0 it is the 1-based index of the
desired setting. The following settings are available:
• 1 Disable_(Low): The output will be set low
• 2 On_(High): The output will be set high
• 3 Signal_On_Error: The output will be high when there is a measurement
error (out of range), and low when there is no measurement error
• 4 Pass/Fail_Limits: The output will be high when there is a measurement error
or when the measurement is out of the range set with the AATL command; at
other times it will be high
Example • User sent “TA 0”. Device returns “*1 Disable_(Low) On_(High)
Signal_On_Error Pass/Fail_Limits”. TTL is set low
• User sent “TA 2”. Device returns “*2 Disable_(Low) On_(High)
Signal_On_Error Pass/Fail_Limits”. TTL is now set high
Limitations None
See Also AATL; Command Summary
Page 20 of 31
Command: TRigger Gate Type
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
•
Page 21 of 31
Command: TRigger gate StoP
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
•
Page 22 of 31
Command: TRigger stop TIme
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
•
Page 23 of 31
Command: eXternal TRigger Holdoff time
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
•
Syntax UT <0..2500>
Description Queries and sets threshold for Pyroelectric and Photodiode energy sensors. This aids
in screening out false triggers due that may arise due to electronic noise.
Example Examples:
• “$UT”. Device returns “*300 169 2500”. Present threshold setting is 3%,
minimum is 1.69%, maximum is 25%
• “$UT 2000” Device returns “*2000 169 2500”. Threshold now set to 20%,
minimum is 1.69%, maximum is 25%
Limitations For Pyroelectric and Photodiode energy sensors only.
See Also ET; Command Summary
Page 24 of 31
Command: VErsion
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax VE
Description Query device for version of embedded software
Example Firmware version 1.33 is installed. The 843-R-USB returns “*EF1.33”
Limitations None
See Also Command Summary
Syntax WE <Index>
Description Instructs device to delete from its list of favorite wavelengths the wavelength at
location <Index>. Index must be between 1 and 6 and not the presently active index.
Example 919E-0.1-12-25K with these settings as returned by the AW command
“*CONTINUOUS 193 12000 4 248 366 532 1064 2100 10.6”
Page 25 of 31
Command: Wavelength Index
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax WI <Index>
Description Set the device to work with wavelength at location <Index> in list of favorite
wavelengths.
Example 919E-0.1-12-25K with these settings as returned by the AW command
“*CONTINUOUS 193 12000 4 248 366 532 1064 NONE 10.6”
Command: WaveLength
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax WL <Wavelength>
Description Set wavelength at presently active index to new value. <Wavelength> must be
between the lower and upper limits of the spectrum as returned in the AW command
Example 919E-0.1-12-25K with these settings as returned by the AW command
“*CONTINUOUS 193 12000 1 248 366 532 1064 NONE 10.6”
Syntax WN <range-setting>
Description Configure sensor to measure in a specific range
Note: The index of the highest numeric range is 0. The index of AUTO (when
applicable) is -1
Example To force a 918D in Filter Out mode into the 3mW range enter “WN 1”. Device returns
“*”.
Limitations None
See Also AR, GU, RN, and SX; Command Summary
Page 26 of 31
Advanced Commands
Commands described in this chapter will affect the measurement performance of the sensor. They
should be used with caution.
General Overview
Syntax CQ <factor-index> <new-factor>
Description Query and set presently active calibration factors.
Photodiode Sensors
Syntax See CQ (Calibration Query – Overview)
Description Will return overall factor presently in use (depends on the Filter setting). Photodiode
sensors only have an overall factor. Therefore Factor-index should not be set to 2.
Example • User sent “CQ”. Device responded “*1.025” (correction factor of 2.5%)
• User sent “CQ 2 10000”. Device responded “?1.025” (factor not changed).
• User sends “CQ 1 22000”. Device responds “?PARAM ERROR” (new-factor
is greater than 20000).
• User sends “CQ 1 10100”. Device responds “*1.0100” (factor set to 1%).
Note. In order to adjust the calibration factors for both Filter Out and Filter In modes
the User should perform the following steps
1. FQ 1 (Set the sensor to Filter Out mode)
2. Adjust Filter Out factor with the CQ command
3. FQ 2 (Set the sensor to Filter In mode)
4. Adjust Filter In factor with the CQ command
5. HC C (to save calibration factors permanently)
Limitations None
See Also FQ and HC; Calibration Query – Overview
Page 27 of 31
Thermopile Sensors
Syntax See CQ (Calibration Query – Overview)
Description CQ returns 4 values
• User Power or Energy factor (depending on measurement mode). This factor
can be updated by “CQ 1 <value>”. It affects measurements with any laser.
• User Laser factor. This factor can be updated by “CQ 2 <value>”. It affects
measurement with the presently active laser only
• Overall Laser factor. This is the factor that the Device uses for the present
Laser in use. It is affected by the User Laser Factor and by a Newport
calibration factor for this wavelength that cannot be adjusted by the User
• Overall Sensitivity. This is a composite of the User Power factor, the Laser
factors in use, and a Newport overall sensitivity factor that cannot be adjusted
by the User. Note that changes in the Power Factor affect this field for all
Lasers. Changes in the User Laser Factor affect this field only for the present
laser in use.
Example • User sent “AW”. Device responded “*DISCRETE 1 CO2 YAG VIS”.
Presently active laser is CO2
• User sent “SI”. Device responded “*W”. Sensor is in power mode.
• User sent “CQ”. Device responded “*1.0000 1.0000 1.0000 2.5926E-8”.
These are the factors for CO2 laser in Power Mode.
• User sent “CQ 1 11000”. Device responded “*1.1000 1.0000 1.0000
2.3569E-8”. Note the change in fields 1 and 4.
• User sent “CQ 2 11000”. Device responded “*1.1000 1.1000 1.1000
2.1426E-8”. Note the change in fields 2, 3, and 4
• User sent “WI 2”. Device responded “*”. Presently active laser is now YAG.
• User sent “CQ”. Device responded “*1.1000 1.0000 1.0950 2.1524E-8”.
Fields 2, 3, and 4 were replaced by values for YAG laser
• User sent “CQ 2 9000”. Device responded “*1.1000 0.8999 0.9853 2.3919E-
8”. Note change in fields 2, 3, and 4
• User sent “WI 1”. Device responded “*”. Presently active laser is now CO2.
• User sent “CQ”. Device responded “*1.1000 1.1000 1.1000 2.1426E-8”.
Notice that the values are the same as in step 5. The laser specific changes
of step 8 have no effect on a different laser.
• User sent “FE”. Device responded “*”. Sensor is in energy mode
• User sent “CQ”. Device responded “*1.0000 1.1000 1.1000 2.1426E-8”.
Field 1 is the energy factor. It has no effect on field 4.
Limitations None
See Also AW, FE, FP, HC, and WI; Calibration Query – Overview
Note. In order to adjust the calibration factors for all pulse widths, use CQ in
conjunction with the PL command.
Limitations None
See Also PL and HC; Calibration Query – Overview
Page 28 of 31
Pyroelectric Sensors – Discrete
Syntax See CQ (Calibration Query – Overview)
Description CQ returns 3 values
• Overall Energy Factor. This factor can be updated by “CQ 1 <value>”. It
affects measurements with any laser.
• User Laser factor. This factor can be updated by “CQ 2 <value>”. It affects
measurement with the presently active laser only
• Overall Laser factor. This is the factor that the Device uses for the present
Laser in use. It is affected by the User Laser Factor and by a Newport
calibration factor for this wavelength that cannot be adjusted by the User
Example • User sent “AW”. Device responds “* DISCRETE 2 248 1064 193”. Presently
active wavelength is 1064
• User sent “CQ”. Device responds “*1.0000 1.0000 1.2500”
• User sent “CQ 1 11000”. Device responds “*1.1000 1.0000 1.2500”. Only
first factor changed.
• User sent “CQ 2 12000”. Device responds “*1.1000 1.2000 1.5000”. Note
change in fields 2 and 3.
• User sent “WI 1”. Device responds “*”. Presently active laser is now 248
• User sent “CQ”. Device responds “*1.1000 1.0000 1.0000”. Overall Energy
factor is unchanged. Factors 2 and 3 have been replaced by values for 248
• User sent “CQ 2 9000”. Device responds “*1.1000 0.8999 0.8999”. Note
change in fields 2 and 3.
• User sent “WI 2”. Device responds “*”. Presently active laser is now 1064.
• User sent “CQ 2 12000”. Device responds “*1.1000 1.2000 1.5000”. Note
values of factors 2 and 3 are same as in step 4. The laser specific changes of
step 8 have no effect on a different laser.
Note. In order to adjust the calibration factors for all pulse widths, use CQ in
conjunction with the PL command. For sensors with an adjustable diffuser, use CQ
together with the DQ command.
Limitations None
See Also AW, DQ, HC, PL, and WI; Calibration Query – Overview
Syntax RQ <response-factor>
Description Query and set the User adjustable response time factor.
Page 29 of 31
Command: Zero Abort
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax ZA
Description Aborts request to zero the device’s measurement circuitry. Device returns status of
the zeroing process.
“*ZEROING NOT STARTED”. If ZA was sent before the ZE command.
“*ZEROING ABORTED”. If ZA was sent before zeroing was completed.
“*ZEROING COMPLETED”. If ZA was sent after zeroing was completed.
Example User sent “ZE” followed by the “ZA” command. Device returned “*ZEROING
ABORTED”.
Limitations None
See Also ZE, ZQ, and ZS; Command Summary
Command: ZEro
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • •
Syntax ZE
Description Analog components occasionally “drift” thereby introducing small errors in the meter’s
measurement circuitry. This command measures that drift and subtracts it from
measurements. We suggest zeroing the device once in two months.
Example Example 1. User sent “ZE”. Device responded “*”.
Example 2. User sent “ZE” before previous zeroing request terminated. Device
responded “?ZEROING IN PROGRESS”.
Page 30 of 31
Command: Zero Query
Supported on the following meters:
843-R-USB 1919-R 841-PE-USB 844-PE-USB 845-PE-RS x938-R
• • • • • •
Syntax ZQ
Description User request to determine status of zeroing process. Device will return
“*ZEROING NOT STARTED”. If ZE command has not been sent.
“*ZEROING IN PROGRESS”. If ZE command was sent but the zeroing process has
not yet terminated.
“*ZEROING COMPLETED”. If the zeroing process terminated successfully.
“*ZEROING FAILED”. If the zeroing process terminated unsuccessfully.
“*ZEROING ABORTED”. If the zeroing process was terminated by the ZA command.
Example • User sent “ZQ”. Device responded “*ZEROING NOT STARTED”.
• User sent “ZE”. Device responded “*”.
• User sent “ZQ”. Device responded “*ZEROING IN PROGRESS”.
• Delay about 30 seconds.
• User sent “ZQ”. Device responded “*ZEROING COMPLETED”.
Limitations None
See Also ZA, ZE, and ZS; Command Summary
Syntax ZS
Description Save results of the zeroing process to the device’s memory.
Device returns
“?ZEROING ABORTED”. If ZS is issued after zero was aborted.
“?ZEROING IN PROGRESS”. If ZS is issued during zeroing process.
“?ZEROING FAILED”. If ZS is issued after zeroing process failed.
“*SAVED”. Upon success
Example • User sent “ZS”. Device responded “?ZEROING NOT STARTED”.
• User sent “ZE”. Device responded “*”.
• User sent “ZS”. Device responded “?ZEROING IN PROGRESS”.
• Delay about 30 seconds.
• User sent “ZS”. Device responded “*SAVED”.
Limitations None
See Also ZA, ZE, and ZQ; Command Summary
Page 31 of 31