usb detect - USB Device Detection

Checks whether the specific USB device has been detected and enumerated by PLT.

Usage:

- command: usb detect
  [id: <usbDeviceID>]
  [path: <usbDevicePath>]
  [retry: <retryCount>]
  [timeout: <duration>]
  [with:
    - <filterKey> <value>
    - <langid>:<index> "<stringValue>"
  ]

Argument	Description
usbDeviceID	Optional: USB device identifiers: `VID:PID`.
usbDevicePath	Optional: USB device path: `port. ... .port`.
retryCount	Optional: Number of times to retry the test step.
timeout	Optional: Maximum duration to wait for detection.
with	Optional: One or more string filters. Supported keys: `manufacturer <value>` `product <value>` `serial <value>` `<langid>:<index> "<stringValue>"` for exact descriptor match Added in version PLT-OS: v2.3.28 Support for string matching filters using the `with:` section.

Note

If neither usbDeviceID nor usbDevicePath is set, path: “1” (The DUT USB-C Port) is used.

Examples

Minimal device check:

- command: usb detect
  id: "6666:8001"
  fail: "SBC not detected (USB)"

Match multiple strings:

- command: usb detect
  id: "1366:0101"
  with:
    - manufacturer "SEGGER"
    - product "J-Link"
    - serial "000609300812"

Added in version PLT-OS: v2.3.28 Support for manufacturer, product, and serial string matching.

Exact descriptor index:

- command: usb detect
  id: "0525:a4a8"
  with:
    - 0x0409:1 "QR Scanner"

Added in version PLT-OS: v2.3.28 Support for exact descriptor string matching by language ID and index.