measure - Probe Measurement

measure <channel> - Take a measurement of a signal.

In this usage, the measure command is used to take a measurement of a signal using a particular measurement channel.

Usage:

- command: measure <channel> [<signal>|<rail>] <range>|<acceptance> [<reference>]
  [extractKey: <key>]
  [retry: <retryCount>]
  [ground: <ground>]
  [with:
    [- dutyCycle <dutyCycleRange>]
    [- disableAutoRange]]

Argument	Description
channel	Measurement channel
signal	DDTPxx/RDTPxx probe for pin or DATPxx/DDTPxx probe for DMM-based measurement
rail	Power Rail for currentDMM measurement
range	Acceptable range
acceptance	Signal acceptance criteria, e.g. True or False for continuity measurement.
reference	Reference voltage for impedance measurement (optional, default: 5V)
key	Key in which to store the measurement results (optional)
retryCount	Number of times to retry the test step (optional)
ground	Measurement reference ground (optional)
with	Additional command parameters. (optional) disableAutoRange - Turn off DMM auto-ranging for this measurement. Available for currentDMM, resistance, and voltageDMM channels. dutyCycle - Duty cycle range for frequency measurement. Available for frequency channel, only on PLT-300A.

Note

For the voltageDiff channel, 2 signal names must be provided, separated with a -. For example: DATP00-DATP01 for a differential measurement between DATP00 and DATP01.

The measure command supports the following channels:

channel	Description	Max Voltage
capacitance	Capacitance, using DMM	100V
continuity	Continuity, using DMM	100V
current1V8	1V8 current draw, using ADC	5.5V
current3V3	3V3 current draw, using ADC	5.5V
current5V	5V current draw, using ADC	5.5V
currentVARV	VARV current draw, using ADC	24V
currentDMM	Current, using DMM	100V
frequency	Frequency (CLK0 or CLK1)	100V
impedance	Impedance measurement (RVREF/RA)	100V
pin	Digital pin measurement (DDTPxx/RDTPxx)	5.5V
resistance	Resistance, using DMM	100V
voltageDATP00	DATP00 voltage, using ADC	5.5V
voltageDATP01	DATP01 voltage, using ADC	5.5V
voltageDATP02	DATP02 voltage, using ADC	5.5V
voltageDATP03	DATP03 voltage, using ADC	5.5V
voltageDATP04	DATP04 voltage, using ADC	5.5V
voltageDATP05	DATP05 voltage, using ADC	5.5V
voltageDATP06	DATP06 voltage, using ADC	5.5V
voltageDATP07	DATP07 voltage, using ADC	5.5V
voltageDATP08	DATP08 voltage, using ADC	5.5V
voltageDATP09	DATP09 voltage, using ADC	5.5V
voltageDATP10	DATP10 voltage, using ADC	5.5V
voltageDATP11	DATP11 voltage, using ADC	5.5V
voltageDATP12	DATP12 voltage, using ADC	5.5V
voltageDiff	Differential voltage, using ADC	5.5V
voltageDMM	Voltage, using DMM	100V
voltageMUX0	MUX0 voltage, using ADC	5.5V
voltageMUX1	MUX1 voltage, using ADC	5.5V
voltageMUX2	MUX2 voltage, using ADC	5.5V
voltageMUX3	MUX3 voltage, using ADC	5.5V

Caution

In order to avoid damage to the PLT, take care that signals are below the Max Voltage for the selected measurement channel.

Note

On the PLT-300A, the DATP00 ... DATP06 pins need to be connected to the Multiplexer sub-system, in order to use voltageDATP00 ... voltageDATP06.

Use the mux connect DDTPxx command to to connect such a pin to the Multiplexer sub-system.

DMM-based measurements (capacitance, continuity, currentDMM, resistance, voltageDMM) can be performed for the following probes:

signal	Description
DATP000…DATP06	Direct Analog Test Probe #0…#6
DDTP00…DDTP08	Direct Digital Test Probe #0…#8
RA	RA MUX signal

For DMM-based measurements, the PLT-300A allows measurements to be taken against a specific ground signal. This can be requested by adding a ground: <ground> field to the measure command, with the following supported values:

ground	Description
GND	PLT System ground (default)
GND1	DUT Ground #1
GND2	DUT Ground #2
GND3	DUT Ground #3
GND4	DUT Ground #4
1V8OUT	1.8V supply
3V3OUT	3.3V supply
5VOUT	5V supply
VARVOUT	VARV supply
RVREF	RVREF mux signal

The following suffixes are supported for electrical measurement ranges:

Kind	Suffix	Description
Frequency	Hz	Hertz (default)
Frequency	kHz, KHZ	Kilohertz
Frequency	MHz	Megahertz
Frequency	GHz	Gigahertz
Voltage	nV	Nanovolt
Voltage	uV, µV	Microvolt
Voltage	mV	Millivolt
Voltage	V	Volt (default)
Voltage	kV, KV	Kilovolt
Voltage	MV	Megavolt
Current	nA	Nanoampere
Current	uA, µA	Microampere
Current	mA	Milliampere
Current	A	Ampere (default)
Resistance/Impedance	nOhm	Nanoohm
Resistance/Impedance	uOhm, µOhm	Microohm
Resistance/Impedance	mOhm	Milliohm
Resistance/Impedance	Ohm	Ohm (default)
Resistance/Impedance	kOhm, KOhm	Kiloohm
Resistance/Impedance	MOhm	Megaohm

Examples

• Electrical Measurements

measure start and measure stop - Take continuous measurements over time.

In this usage of the measure command, the start and stop subcommands are used to start a continuous measurement, and then stop it.

This functionality is only available on the PLT-300A, and the specified channel must support continuous measurement.

Other commands can be used between start and stop to wait for measurement (e.g., sleepms), or to exercise the DUT (e.g., power, GPIO, etc). Measurements will be taken continuously, and results will be tested against the pass criteria specified in the start command when stop is called.

Multiple continuous measurements can be started and stopped in parallel, as long as they are on separate channels.

measure start Usage:

- command: measure start <channel>
  [id: <usbDeviceID>]
  [path: <usbDevicePath>]
  [retry: <retryCount>]
  [with:
    [- voltageAverage:<voltageAverageRange>]
    [- voltageLimit:<voltageLimitRange>]
    [- currentAverage:<currentAverageRange>]
    [- currentLimit:<currentLimitRange>]
    [- powerAverage:<powerAverageRange>]
    [- powerLimit:<powerLimitRange>]]

measure stop Usage:

- command: measure stop [<channel>]
  [id: <usb_device_id>]
  [path: <usb_device_path>]

Argument	Description
channel	Measurement channel. Note: The selected channel must support continuous measurement.
usb_device_id	Optional: USB device identifiers: VID:PID.
usb_device_path	Optional: USB device path: port. ... .port.
retryCount	Optional: Number of times to retry the test step.
with	Optional: Additional command parameters. (Note: If none of the parameters below are specified, no pass criteria will be applied.)
voltage_average_range	Optional: Acceptable voltage average range.
voltage_limit_range	Optional: Acceptable voltage limit range.
current_average_range	Optional: Acceptable current average range.
current_limit_range	Optional: Acceptable current limit range.
power_average_range	Optional: Acceptable power average range.
power_limit_range	Optional: Acceptable power limit range.

The following channels are supported for continuous measurement:

channel	Description
joulescope	Jetperch Joulescope JS220 Precision Energy Analyzer. External USB peripheral. Supports continuous measurement of voltage, current, and power.

Examples

• Continuous Measurement