[usb] Expose USB device descriptor and strings via settings

Allow scripts to read basic information from USB device descriptors
via the settings mechanism.  For example:

  echo USB vendor ID: ${usb/${busloc}.8.2}
  echo USB device ID: ${usb/${busloc}.10.2}
  echo USB manufacturer name: ${usb/${busloc}.14.0}

The general syntax is

  usb/<bus:dev>.<offset>.<length>

where bus:dev is the USB bus:device address (as obtained via the
"usbscan" command, or from e.g. ${net0/busloc} for a USB network
device), and <offset> and <length> select the required portion of the
USB device descriptor.

Following the usage of SMBIOS settings tags, a <length> of zero may be
used to indicate that the byte at <offset> contains a USB string
descriptor index, and an <offset> of zero may be used to indicate that
the <length> contains a literal USB string descriptor index.

Since the byte at offset zero can never contain a string index, and a
literal string index can never be zero, the combination of both
<length> and <offset> being zero may be used to indicate that the
entire device descriptor is to be read as a raw hex dump.

Signed-off-by: Michael Brown <mcb30@ipxe.org>
This commit is contained in:
Michael Brown
2024-10-18 13:13:28 +01:00
parent c219b5d8a9
commit c69f9589cc
6 changed files with 191 additions and 6 deletions
+2 -1
View File
@@ -97,8 +97,9 @@ int ecm_fetch_mac ( struct usb_function *func,
int rc;
/* Fetch MAC address string */
buf[ sizeof ( buf ) - 1 ] = '\0';
len = usb_get_string_descriptor ( usb, desc->mac, 0, buf,
sizeof ( buf ) );
( sizeof ( buf ) - 1 ) );
if ( len < 0 ) {
rc = len;
return rc;