Skip to content

README.md

Latest commit

 

History

History
128 lines (98 loc) · 5.01 KB

README.md

File metadata and controls

128 lines (98 loc) · 5.01 KB

Jetson RPM Tests

This directory contains pytest-based tests for Jetson RPMs using SSH connections via fabric (high-level paramiko wrapper).

Jetson Structure

  • HARDWARE ACCELERATORS: GPU (CUDA), DLA (AI), PVA (Vision), Video Enc/Dec
  • INTERFACES: CSI Camera, USBs, PCIe, Ethernet, CAN bus, Display
  • SOFTWARE FRAMEWORKS: GStreamer (MultiMedia), TensorRT (AI), VPI (Vision)

Reposetory Tests Structure

infra_tests/                    # infrastructure for the tests (e.g SSH)
├── ssh_client.py               # SSHConnection class using fabric
└── __init__.py

infra_resources/                # Shared utilities/functions for all tests suites
├──  tests_resources            # Device operations for Jetson RPM tests
└──  hardware_info.py           # Collect hardware and system information from a Jetson device.

tests_suites/
├── conftest.py                 # Shared pytest fixtures (Import ssh_client.py, hardware_info collect function and set global variables)
├── jetson_hardware_specs.yaml  # Jetson hardware expected values per test category
├── kmod/                       # Kernel module (nvidia-jetpack-kmod)
├── cuda/                       # CUDA tests
├── dla/                        # DLA tests
├── pva/                        # PVA tests
├── video_enc_dec/              # Video Encoder/Decoder tests
├── usbs/                       # USB tests
├── pcis/                       # PCI tests
├── can_bus/                    # CAN bus tests
├── csi_camera/                 # CSI camera tests
├── display/                    # Display tests (X11, DRM/GBM, Wayland)
├── tools/                      # nvidia-jetpack-tools tests (nvpmodel, nvfancontrol)
└── ethernet/                   # Ethernet tests

Requirements

pip install -r requirements.txt

Configuration

Tests can be configured via environment variables:

  • JETSON_HOST: Hostname or IP address of the Jetson device name
  • JETSON_USERNAME: SSH username
  • JETSON_PASSWORD: SSH password
  • JETSON_PORT: SSH port (default: 22)

Another configuration you need to make sure is your host is knowns for the system

ssh-keyscan -H ${JETSON_HOST} >> ~/.ssh/known_hosts

Running Tests

Run all tests:

pytest tests_suites/

Run tests for a specific component:

pytest tests_suites/cuda/
pytest tests_suites/dla/
pytest tests_suites/pva/

Run only critical tests:

pytest -m critical tests_suites/

Run with verbose output:

pytest -v tests_suites/

Run with log level:

pytest -v tests_suites/ --log-cli-level=INFO

How to Warn

for more information look at tests_suites/WARNING_BEHAVIOR.md

Test Markers

  • @pytest.mark.critical: Critical tests that must pass
  • @pytest.mark.xfail: Tests that are expected to fail on certain hardware

Hardware / System Variables (for developers)

When running pytest, the session collects hardware and system info from the Jetson via SSH and exposes the following variables to all tests. All variables default to None if the value is not found. You can import them from conftest and use them to skip or adapt tests by RHEL version, Jetpack, firmware, bootc, RPMs, etc.

Variable Type Description
RHEL_VERSION str or None RHEL version as string (e.g. '9.7', '9.10' from /etc/redhat-release).
L4T_VERSION float, str, or None L4T version from /etc/nv_tegra_release: str if X.Y.Z (e.g. '36.5.0'), float if X.Y.
JETPACK_VERSION str or None JetPack userspace RPM version (e.g. '6.2.2' from nvidia-jetpack-*-core RPM).
JETPACK_KMOD_VERSION str or None JetPack kmod RPM version (e.g. '6.2.2' from nvidia-jetpack-*-kmod RPM).
FIRMWARE_VERSION float, str, or None Firmware version: str if X.Y.Z (2 dots), float if X.Y (1 dot).
FIRMWARE_TYPE str or None Firmware type (e.g. UEFI, BIOS).
HARDWARE_MODEL_NAME str or None Hardware model name.
KERNEL_VERSION str or None Kernel version (e.g. uname -r).
CPU_ARCH str or None CPU architecture (e.g. aarch64, x86_64).
BOOTC_AVAILABLE bool Whether bootc / rpm-ostree is available (default False).
BOOTC_VERSION float, str, or None Bootc version: str if X.Y.Z, float if X.Y (only if bootc is available).
BOOTC_IMAGE_VERSION str or None Bootc image version, including last modify date (only if bootc is available).
BOOTC_IMAGE_URL str or None Bootc image URL including tag (only if bootc is available).

Example usage in a test:

from tests_suites import conftest as _conftest

def test_something():
    if not _conftest.RPMS_AVAILABLE:
        pytest.skip("nvidia-jetpack: need all 23 RPMs installed with same version")
    # ...

At the start of each pytest run, a SETUP block is printed with: RHEL version, Jetpack version, firmware type and version, hardware model name, whether bootc is available, and whether the nvidia-jetpack RPM is available.