Test Plan YAML definition¶
Example: A minimal test suite, with a single test item, scanning a bar code.
title: "PLT demo: Scan"
suite:
- ident: SCAN-T1
title: Scan MAC address
steps:
- command: scan ANY
Test Plan Structure¶
PLT test suites are encoded as YAML text files, starting with the test suite title.
title: "PLT demo: Scan"
The title:
is followed by the suite:
section, containing the test
items in the test plan.
Test Items¶
Test items are identified with an ident:
line, can contain
a descriptive title
, and should contain one or more test item steps.
The ident:
field can be omitted, in which case test items will be
automatically enumerated. A top-level identPrefix:
field can be
used to set common prefix for auto-generated test item identifiers.
During test execution, all test item steps need to complete successfully for the test item to succeed.
Test Item Steps¶
Test item steps consist of command:
or uartcmd:
blocks.
A Test Item can contain multiple Test Item steps.
Retries¶
Retry counts can be set for at the test item or at the test item step level,
by adding a retry:
field.
title: "Retries"
identPrefix: "R"
suite:
- title: Test Item retries
retry: 3
steps:
- command: sleepms 1000
- command: operator Manual
- title: Test Item retries
steps:
- command: sleepms 1000
- command: operator Manual
retry: 3
Calibration Section¶
Some test setups may require additional calibration, which can be specified
in the YAML test plan with an optional top-level calibration:
section.
calibration:
- [ppc: <ppcID>]
[impedance: <impedanceOffset>]
[voltage: <voltageOffset>]
[voltageDATP07: <voltageOffset>]
[voltageDATP08: <voltageOffset>]
[voltageDATP09: <voltageOffset>]
[voltageDATP10: <voltageOffset>]
[voltageDATP11: <voltageOffset>]
[voltageDATP12: <voltageOffset>]
[voltageMUX0: <voltageOffset>]
[voltageMUX1: <voltageOffset>]
[voltageMUX2: <voltageOffset>]
[voltageMUX3: <voltageOffset>]
[current: <currentOffset>]
[current3V3: <currentOffset>]
[current5V: <currentOffset>]
[currentVARV: <currentOffset>]
- ...
The following fields can be set in a calibration entry:
Field |
Description |
---|---|
|
Define the PPC for which this calibration entry should be applied. If omitted, the section defines the default offsets, to which a PPC-specific calibration section would be added. |
|
Specifies the offset for impedance measurements. |
|
Specifies the offset for voltage measurements. |
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements on the
|
|
Specifies the offset for voltage measurements of the
|
|
Specifies the offset for current measurements. |
|
Specifies the offset for current measurements of the
|
|
Specifies the offset for current measurements of the
|
|
Specifies the offset for current measurements of the
|
With the following argument values:
Argument |
Description |
---|---|
ppcID |
PPC identifier for a |
impedanceOffset |
Offset for impedance measurements.
Can be specified with |
voltageOffset |
Offset for voltage measurements.
Can be specified with |
currentOffset |
Offset for current measurements. Can be specified with
|
Example:
title: "test plan with calibration"
identPrefix: "ICT-T"
calibration:
# Default offsets
- impedance: -100 # 100 Ohm
voltage: +20mV # Default for all voltage channels
voltageDATP01: +40mV
voltageMUX2: +20mV
voltageMUX3: +30mV
currentVARV: -20mA
# Additional offsets specific to a particular PPC
- ppc: 39c8db # Additional offsets for this PPC
impedance: +120Ohm
voltageDATP08: -10mV
current5V: +100mA
suite:
- title: Impedance Measurement
steps:
- command: mux 0 RATP02
- command: mux 1 RATP17
- command: mux 2 RA
- command: mux 3 RVREF
- command: short 0 2 set
- command: short 1 3 set
- command: measure impedance 10-20Ohm