Unit Under Test (UUT)

You can identify each unit under test with serial numbers, part numbers, revision numbers, and batch numbers.

TofuPilot Framework stores unit information in test reports for traceability.

Identify Unit

To ensure UUT is identified during a run, TofuPilot adds an automatic Identify Unit phase. This phase uses default_values when provided and waits for user input of at least serial number and part number.

Serial Number

You can set a unique identifier for each individual unit.

unit:
  serial_number: 
    default_value: "SN00012345"

def identify_unit(unit):
    unit.serial_number = "SN00012345"

TofuPilot Framework requires a serial number for every test run.

Part Number

You can set the unit type or model number.

unit:
  part_number: 
    default_value: "PCB-MAIN-V2"

def set_part(unit):
    unit.part_number = "PCB-MAIN-V2"

TofuPilot Framework requires a part number for every test run.

Revision Number

You can optionally set the revision of the unit.

unit:
  revision_number: 
    default_value: "Rev C"

def set_revision(unit):
    unit.revision_number = "Rev C"

TofuPilot Framework stores revision numbers in reports and syncs them to your Dashboard.

Batch Number

You can optionally set the production batch or lot number.

unit:
  batch_number: 
    default_value: "BATCH-2024-001"

def set_batch(unit):
    unit.batch_number = "BATCH-2024-001"

TofuPilot Framework stores batch numbers in reports and syncs them to your Dashboard.

Sub-units

You can track component serial numbers linked to the main unit under test.

unit:
  sub_units: 
    - label: "Battery"
      serial_number: 
        placeholder: "Scan battery"
        pattern: "^BAT-.*"
    - label: "Motor"
      serial_number: 
        placeholder: "Scan motor"

def test_phase(unit):
    # Dict access (case-insensitive)
    battery_sn = unit.sub_units["battery"]
    motor_sn = unit.sub_units["motor"]

    # Attribute access (lowercase)
    battery_sn = unit.sub_units.battery
    motor_sn = unit.sub_units.motor

    # Iterate all sub-units (keys are lowercase)
    for key, serial in unit.sub_units.items():
        print(f"{key}: {serial}")  # "battery: BAT-...", "motor: MOT-..."

TofuPilot Framework collects sub-unit serial numbers during the Identify Unit phase and makes them available in Python as a dictionary.

Each sub-unit requires a label and optionally a serial_number configuration. The serial_number field supports the same validation options as the main unit fields — see Validation for all available options.

Validation

You can configure validation rules for unit fields.

unit:
  serial_number: 
    min_length: 8
    max_length: 20
    pattern: "^SN\\d{8}$"
  part_number: 
    max_length: 50
    pattern: "^PCB-[A-Z]+-V\\d+$"
  revision_number: 
    pattern: "^Rev [A-Z]$"
  batch_number: 
    pattern: "^BATCH-\\d{4}-\\d{3}$"

TofuPilot Framework trims whitespace, validates length constraints, and checks regex patterns before test execution.

You can use these validation options for each unit field:

Python

You can set unit information from any phase function by adding unit as a parameter.

def identify_unit(unit, device):
    # Read serial number from device registry
    serial = device.read_register(0x1000)
    unit.serial_number = serial 

    # Derive part number from serial prefix
    if serial.startswith("IX"):
        unit.part_number = "IXRouter-V3"
    elif serial.startswith("SN"):
        unit.part_number = "PCB-MAIN-V2"

TofuPilot Framework passes the unit object to your phase function via dependency injection when you add it as a parameter.