Scan for USB devices

  usbscan <setting>

  #!ipxe
  :scan usbscan addr || goto scan_done
    echo Found USB device ${addr:hex}
    goto scan
  :scan_done

Scan the USB bus, starting from the USB bus:dev address in the specified setting, and store the USB bus:dev address of the next device in the specified setting. If the specified setting is empty, then the scan will start from the first USB device.

If no further USB devices exist, the command will fail silently with an error status.

• ifstat
• goto
• List of all iPXE settings
• List of all iPXE commands

This command is available only when the build option USB_CMD is enabled.

You can use the USB bus:dev address to extract information from the USB device and string descriptors. For example, to list the vendor and device IDs and the product name of all USB devices:

  #!ipxe
  :scan usbscan addr || goto scan_done
    echo ${addr:hex}: ${usb/${addr}.8.2}:${usb/${addr}.10.2} ${usb/${addr}.15.0}
    goto scan
  :scan_done

The usbscan command requires the use of iPXE's native USB host controller drivers. It is will not work if you have explicitly enabled the (obscure) build option USB_HCD_USBIO.