usb power - USB Port Power Control

Control USB port power.

usb power switches power on both the USB 2.0 and USB 3.0 legs of the addressed port so that, on a dual-speed connection, the port is fully powered or fully unpowered rather than left in a mixed state.

Note

Turning off port power effectively disables the port. Even devices that don’t require power through the port will not work when port power is off.

Note

Port power can only be controlled if the port is on a hub (like the internal hubs in PLT-300A) that support power control. List of known compatible hubs.

Usage:

- command: usb power on|off
  [path: <usbDevicePath>]
  [retry: <retryCount>]

Argument

Description

on

Enable port and turn on port power.

off

Disable port and turn off port power.

usbDevicePath

Optional: USB device path: port. ... .port (see USB Device Paths). Unlike usb detect and usb reset, usb power does not accept an id: <usbDeviceID> argument — power is applied to a hub port, not to a device identified by VID:PID, so the target must always be given as a path.

retryCount

Optional: Number of times to retry the test step.

Note

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

Examples

See also