* Originally released under the Be Sample Code License.
* Copyright 2000, Be Incorporated. All rights reserved.
*
* Modified for Haiku by François Revol and Michael Lotz.
* Copyright 2007-2008, Haiku Inc. All rights reserved.
*/
#include <Directory.h>
#include <Entry.h>
#include <Path.h>
#include <String.h>
#include <stdio.h>
#include <usb/USB_audio.h>
#include <usb/USB_cdc.h>
#include <usb/USB_video.h>
#include "usbspec_private.h"
#include "usb-utils.h"
#include "listusb.h"
void
DumpCDCDescriptor(const usb_generic_descriptor* descriptor, int subclass)
{
if (descriptor->descriptor_type == 0x24) {
printf(" Type ............. CDC interface descriptor\n");
printf(" Subtype .......... ");
switch (descriptor->data[0]) {
case USB_CDC_HEADER_FUNCTIONAL_DESCRIPTOR:
printf("Header\n");
printf(" CDC Version ...... %x.%x\n",
descriptor->data[2], descriptor->data[1]);
return;
case USB_CDC_CM_FUNCTIONAL_DESCRIPTOR:
{
printf("Call management\n");
const usb_cdc_cm_functional_descriptor* cmDesc
= (const usb_cdc_cm_functional_descriptor*)descriptor;
printf(" Capabilities ..... ");
bool somethingPrinted = false;
if ((cmDesc->capabilities & USB_CDC_CM_DOES_CALL_MANAGEMENT) != 0) {
printf("Call management");
somethingPrinted = true;
}
if ((cmDesc->capabilities & USB_CDC_CM_OVER_DATA_INTERFACE) != 0) {
if (somethingPrinted)
printf(", ");
printf("Over data interface");
somethingPrinted = true;
}
if (!somethingPrinted)
printf("None");
printf("\n");
printf(" Data interface ... %d\n", cmDesc->data_interface);
return;
}
case USB_CDC_ACM_FUNCTIONAL_DESCRIPTOR:
{
printf("Abstract control management\n");
const usb_cdc_acm_functional_descriptor* acmDesc
= (const usb_cdc_acm_functional_descriptor*)descriptor;
printf(" Capabilities ..... ");
bool somethingPrinted = false;
if ((acmDesc->capabilities & USB_CDC_ACM_HAS_COMM_FEATURES) != 0) {
printf("Communication features");
somethingPrinted = true;
}
if ((acmDesc->capabilities & USB_CDC_ACM_HAS_LINE_CONTROL) != 0) {
if (somethingPrinted)
printf(", ");
printf("Line control");
somethingPrinted = true;
}
if ((acmDesc->capabilities & USB_CDC_ACM_HAS_SEND_BREAK) != 0) {
if (somethingPrinted)
printf(", ");
printf("Send break");
somethingPrinted = true;
}
if ((acmDesc->capabilities & USB_CDC_ACM_HAS_NETWORK_CONNECTION) != 0) {
if (somethingPrinted)
printf(", ");
printf("Network connection");
somethingPrinted = true;
}
if (!somethingPrinted)
printf("None");
printf("\n");
return;
}
case 0x03:
printf("Direct line management\n");
break;
case 0x04:
printf("Telephone ringer management\n");
break;
case 0x05:
printf("Telephone call and line state reporting\n");
break;
case USB_CDC_UNION_FUNCTIONAL_DESCRIPTOR:
printf("Union\n");
printf(" Control interface %d\n", descriptor->data[1]);
for (int32 i = 2; i < descriptor->length - 2; i++)
printf(" Subordinate ..... %d\n", descriptor->data[i]);
return;
case 0x07:
printf("Country selection\n");
break;
case 0x08:
printf("Telephone operational mode\n");
break;
case 0x09:
printf("USB Terminal\n");
break;
case 0x0A:
printf("Network channel\n");
break;
case 0x0B:
printf("Protocol init\n");
break;
case 0x0C:
printf("Extension unit\n");
break;
case 0x0D:
printf("Multi-channel management\n");
break;
case 0x0E:
printf("CAPI control\n");
break;
case 0x0F:
printf("Ethernet\n");
break;
case 0x10:
printf("ATM\n");
break;
case 0x11:
printf("Wireless handset\n");
break;
case 0x12:
printf("Mobile direct line\n");
break;
case 0x13:
printf("Mobile direct line detail\n");
break;
case 0x14:
printf("Device management\n");
break;
case 0x15:
printf("Object Exchange\n");
break;
case 0x16:
printf("Command set\n");
break;
case 0x17:
printf("Command set detail\n");
break;
case 0x18:
printf("Telephone control\n");
break;
case 0x19:
printf("Object Exchange service identifier\n");
break;
case 0x1A:
printf("NCM\n");
break;
default:
printf("0x%02x\n", descriptor->data[0]);
}
printf(" Data ............. ");
for (int32 i = 1; i < descriptor->length - 2; i++)
printf("%02x ", descriptor->data[i]);
printf("\n");
return;
}
#if 0
if (descriptor->descriptor_type == 0x25) {
printf(" Type ............. CDC endpoint descriptor\n",
return;
}
#endif
DumpDescriptorData(descriptor);
}
void
DumpDescriptorData(const usb_generic_descriptor* descriptor)
{
printf(" Type ............. 0x%02x\n",
descriptor->descriptor_type);
printf(" Data ............. ");
for (int32 i = 0; i < descriptor->length - 2; i++)
printf("%02x ", descriptor->data[i]);
printf("\n");
}
void
DumpDescriptor(const usb_generic_descriptor* descriptor,
int classNum, int subclass)
{
switch (classNum) {
case USB_AUDIO_DEVICE_CLASS:
DumpAudioDescriptor(descriptor, subclass);
break;
case USB_VIDEO_DEVICE_CLASS:
DumpVideoDescriptor(descriptor, subclass);
break;
case USB_COMMUNICATION_DEVICE_CLASS:
case USB_COMMUNICATION_WIRELESS_DEVICE_CLASS:
DumpCDCDescriptor(descriptor, subclass);
break;
default:
DumpDescriptorData(descriptor);
break;
}
}
static void
DumpInterface(const BUSBInterface* interface)
{
if (!interface)
return;
char classInfo[128];
usb_get_class_info(interface->Class(), 0, 0, classInfo, sizeof(classInfo));
printf(" Class .............. 0x%02x (%s)\n",
interface->Class(), classInfo);
usb_get_class_info(interface->Class(), interface->Subclass(), 0, classInfo, sizeof(classInfo));
printf(" Subclass ........... 0x%02x%s\n",
interface->Subclass(), classInfo);
usb_get_class_info(interface->Class(), interface->Subclass(), interface->Protocol(), classInfo,
sizeof(classInfo));
printf(" Protocol ........... 0x%02x%s\n",
interface->Protocol(), classInfo);
printf(" Interface String ... \"%s\"\n",
interface->InterfaceString());
for (uint32 i = 0; i < interface->CountEndpoints(); i++) {
const BUSBEndpoint* endpoint = interface->EndpointAt(i);
if (!endpoint)
continue;
printf(" [Endpoint %" B_PRIu32 "]\n", i);
printf(" MaxPacketSize .... %d\n",
endpoint->MaxPacketSize());
printf(" Interval ......... %d\n",
endpoint->Interval());
if (endpoint->IsControl())
printf(" Type ............. Control\n");
else if (endpoint->IsBulk())
printf(" Type ............. Bulk\n");
else if (endpoint->IsIsochronous())
printf(" Type ............. Isochronous\n");
else if (endpoint->IsInterrupt())
printf(" Type ............. Interrupt\n");
if (endpoint->IsInput())
printf(" Direction ........ Input\n");
else
printf(" Direction ........ Output\n");
}
char buffer[256];
usb_descriptor* generic = (usb_descriptor*)buffer;
for (uint32 i = 0;
interface->OtherDescriptorAt(i, generic, 256) == B_OK; i++) {
printf(" [Descriptor %" B_PRIu32 "]\n", i);
DumpDescriptor(&generic->generic, interface->Class(), interface->Subclass());
}
}
static void
DumpConfiguration(const BUSBConfiguration* configuration)
{
if (!configuration)
return;
printf(" Configuration String . \"%s\"\n",
configuration->ConfigurationString());
for (uint32 i = 0; i < configuration->CountInterfaces(); i++) {
printf(" [Interface %" B_PRIu32 "]\n", i);
const BUSBInterface* interface = configuration->InterfaceAt(i);
for (uint32 j = 0; j < interface->CountAlternates(); j++) {
const BUSBInterface* alternate = interface->AlternateAt(j);
printf(" [Alternate %" B_PRIu32 "%s]\n", j,
j == interface->AlternateIndex() ? " active" : "");
DumpInterface(alternate);
}
}
}
static void
DumpInfo(BUSBDevice& device, bool verbose)
{
const char* vendorName = NULL;
const char* deviceName = NULL;
usb_get_vendor_info(device.VendorID(), &vendorName);
usb_get_device_info(device.VendorID(), device.ProductID(), &deviceName);
if (!verbose) {
printf("%04x:%04x /dev/bus/usb%s \"%s\" \"%s\" ver. %04x\n",
device.VendorID(), device.ProductID(), device.Location(),
vendorName ? vendorName : device.ManufacturerString(),
deviceName ? deviceName : device.ProductString(),
device.Version());
return;
}
char classInfo[128];
printf("[Device /dev/bus/usb%s]\n", device.Location());
usb_get_class_info(device.Class(), 0, 0, classInfo, sizeof(classInfo));
printf(" Class .................. 0x%02x (%s)\n", device.Class(), classInfo);
usb_get_class_info(device.Class(), device.Subclass(), 0, classInfo, sizeof(classInfo));
printf(" Subclass ............... 0x%02x%s\n", device.Subclass(), classInfo);
usb_get_class_info(device.Class(), device.Subclass(), device.Protocol(), classInfo,
sizeof(classInfo));
printf(" Protocol ............... 0x%02x%s\n", device.Protocol(), classInfo);
printf(" Max Endpoint 0 Packet .. %d\n", device.MaxEndpoint0PacketSize());
uint32_t version = device.USBVersion();
printf(" USB Version ............ %d.%d\n", version >> 8, version & 0xFF);
printf(" Vendor ID .............. 0x%04x", device.VendorID());
if (vendorName != NULL)
printf(" (%s)", vendorName);
printf("\n Product ID ............. 0x%04x", device.ProductID());
if (deviceName != NULL)
printf(" (%s)", deviceName);
printf("\n Product Version ........ 0x%04x\n", device.Version());
printf(" Manufacturer String .... \"%s\"\n", device.ManufacturerString());
printf(" Product String ......... \"%s\"\n", device.ProductString());
printf(" Serial Number .......... \"%s\"\n", device.SerialNumberString());
for (uint32 i = 0; i < device.CountConfigurations(); i++) {
printf(" [Configuration %" B_PRIu32 "]\n", i);
DumpConfiguration(device.ConfigurationAt(i));
}
if (device.Class() != 0x09)
return;
usb_hub_descriptor hubDescriptor;
size_t size = device.GetDescriptor(USB_DESCRIPTOR_HUB, 0, 0,
(void*)&hubDescriptor, sizeof(usb_hub_descriptor));
if (size == sizeof(usb_hub_descriptor)) {
printf(" Hub ports count......... %d\n", hubDescriptor.num_ports);
printf(" Hub Controller Current.. %dmA\n", hubDescriptor.max_power);
for (int index = 1; index <= hubDescriptor.num_ports; index++) {
usb_port_status portStatus;
size_t actualLength = device.ControlTransfer(USB_REQTYPE_CLASS
| USB_REQTYPE_OTHER_IN, USB_REQUEST_GET_STATUS, 0,
index, sizeof(portStatus), (void*)&portStatus);
if (actualLength != sizeof(portStatus))
continue;
printf(" Port %d status....... %04x.%04x%s%s%s%s%s%s%s%s\n",
index, portStatus.status, portStatus.change,
portStatus.status & PORT_STATUS_CONNECTION ? " Connect": "",
portStatus.status & PORT_STATUS_ENABLE ? " Enable": "",
portStatus.status & PORT_STATUS_SUSPEND ? " Suspend": "",
portStatus.status & PORT_STATUS_OVER_CURRENT ? " Overcurrent": "",
portStatus.status & PORT_STATUS_RESET ? " Reset": "",
portStatus.status & PORT_STATUS_POWER ? " Power": "",
portStatus.status & PORT_STATUS_TEST ? " Test": "",
portStatus.status & PORT_STATUS_INDICATOR ? " Indicator": "");
}
}
}
class DumpRoster : public BUSBRoster {
public:
DumpRoster(bool verbose)
: fVerbose(verbose)
{
}
virtual status_t DeviceAdded(BUSBDevice* device)
{
DumpInfo(*device, fVerbose);
return B_OK;
}
virtual void DeviceRemoved(BUSBDevice* device)
{
}
private:
bool fVerbose;
};
int
main(int argc, char* argv[])
{
bool verbose = false;
BString devname = "";
for (int i = 1; i < argc; i++) {
if (argv[i][0] == '-') {
if (argv[i][1] == 'v')
verbose = true;
else {
printf("Usage: listusb [-v] [device]\n\n");
printf("-v: Show more detailed information including "
"interfaces, configurations, etc.\n\n");
printf("If a device is not specified, "
"all devices found on the bus will be listed\n");
return 1;
}
} else
devname = argv[i];
}
if (devname.Length() > 0) {
BUSBDevice device(devname.String());
if (device.InitCheck() < B_OK) {
printf("Cannot open USB device: %s\n", devname.String());
return 1;
} else {
DumpInfo(device, verbose);
return 0;
}
} else {
DumpRoster roster(verbose);
roster.Start();
roster.Stop();
}
return 0;
}
