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

DATP00DATP06

Direct Analog Test Probe #0…#6

DDTP00DDTP08

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

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