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.

ADC-based differential voltage measurements (voltageDiff) are supported for the following combinations of signals only:

signal	signal
`DATP00`	`DATP01`
`DATP00`	`DATP03`
`DATP01`	`DATP03`
`DATP02`	`DATP03`
`DATP04`	`DATP05`
`DATP04`	`DATP07`
`DATP05`	`DATP07`
`DATP06`	`DATP07`
`DATP08`	`DATP09`
`DATP08`	`DATP11`
`DATP09`	`DATP11`
`DATP10`	`DATP11`

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

signal	Description
`DATP00`…`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