扫描 USB 设备¶

语法¶

  usbscan <setting>

示例¶

扫描所有 USB 设备¶

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

描述¶

从指定设置中的 USB bus:dev 地址开始扫描 USB 总线，并把下一个设备的 USB bus:dev 地址存储到指定设置中。如果指定设置为空，则从第一个 USB 设备开始扫描。

如果没有更多 USB 设备，命令会以错误状态静默失败。

命令状态¶

成功	找到了一个 USB 设备，bus:dev 地址已存储到设置中
失败	没有找到更多 USB 设备

另请参阅¶

构建选项¶

此命令仅在启用构建选项 USB_CMD 时可用。

备注¶

你可以使用 USB bus:dev 地址从 USB 设备描述符和字符串描述符中提取信息。例如，列出所有 USB 设备的厂商 ID、设备 ID 和产品名称：

  #!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

usbscan 命令需要使用 iPXE 的原生 USB 主控制器驱动。如果你显式启用了（不常用的）构建选项 USB_HCD_USBIO，它将无法工作。