Device...terface(3pm)

💅 Device::USB::DevInterface — the manual page, but make it cute

okay bestie, so this class encapsulates a USB Device Interface and all the methods that object would support. And this right here is the Device...terface(3pm) page, like a User Contributed Perl Documentation situation, so let's get into it 🌸

---

✨ NAME ✨

Device::USB::DevInterface — Access a device interface returned by libusb.

---

🎀 VERSION 🎀

Version 0.38

---

🦋 SYNOPSIS 🦋

So Device::USB:DevInterface provides a Perl object for accessing an interface of a configuration of a USB device using the libusb library. (yes that colon is doing its own thing, we don't gatekeep, we copy it exactly 💖)

use Device::USB;

my $usb = Device::USB->new();
my $dev = $usb->find_device( $VENDOR, $PRODUCT );

printf "Device: %04X:%04X\n", $dev->idVendor(), $dev->idProduct();
$dev->open();

my $cfg = $dev->config()->[0];
my $inter = $cfg->interfaces()->[0];
print "Interface:", $inter->bInterfaceNumber(),
   " name: ", $dev->get_string_simple($iter->iInterface()),
   ": endpoint count: ", $inter->nNumEndpoints(), "\n";

And if you wanna know what all these attributes of an interface actually mean? See the USB specification. That's the vibe. The spec is the source of truth, periodt 📚

---

🌈 DESCRIPTION 🌈

This module defines a Perl object that represents the data associated with a USB device configuration's interface. The object provides read-only access to the important data associated with the interface. So like… look, don't touch. It's giving museum rules ✋✨

💜 METHODS 💜

There are several accessor methods that return data from the interface. Each one is literally named after the field that it returns (iconic, no notes). These accessors include:

• bInterfaceNumber — the 0-based number of this interface.
• bAlternateSetting — the value used to select this alternate setting for the interface specified in bInterfaceNumber.
• bNumEndpoints — how many endpoints (not counting endpoint 0) are available on this interface. If the value is 0, only the control interface is supported.
• bInterfaceClass — the class code as specified by the USB-IF. A value of 0xff is a vendor-specific interface class.
• bInterfaceSubClass — the subclass code specified by the USB-IF. If bInterfaceClass is not 0xff, this field must use only subclasses specified by the USB-IF.
• bInterfaceProtocol — the InterfaceProtocol as specified by the USB-IF. A value of 0xff uses a vendor-specific protocol.
• iInterface — returns the index of the string descriptor describing this interface. You can grab that string with the method Device::USB::Device::get_string_simple.
• endpoints — returns a list of endpoint objects associated with this interface.

---

🔥 DIAGNOSTICS 🔥

This is an explanation of the diagnostic and error messages this module can generate. (like, it's the explanation section, she's here to explain things when stuff goes sideways 😭)

---

🧚 DEPENDENCIES 🧚

This module depends on the Carp, Inline and Inline::C modules, plus the strict and warnings pragmas. And obviously libusb has to be available, because honestly that is the entire reason for the module's existence. No libusb, no module, no cap 💀

---

👑 AUTHOR 👑

G. Wade Johnson (gwadej at cpan dot org) Paul Archer (paul at paularcher dot org)

Houston Perl Mongers Group 🫶

---

🐛 BUGS 🐛

Please report any bugs or feature requests to bug-device-usb@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Device::USB. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. Bestie that's a whole feedback loop, obsessed 😌✨

---

🌸 ACKNOWLEDGEMENTS 🌸

Thanks go to various members of the Houston Perl Mongers group for input on the module. But thanks mostly go to Paul Archer who proposed the project and helped with the development. main character energy fr fr 💖

---

⭐ COPYRIGHT & LICENSE ⭐

Copyright 2006-2013 Houston Perl Mongers

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

And that's the whole page, bestie! This one shipped as part of perl v5.42.3 and got dated 2026-08-19 — so go forth, poke at USB interfaces, and slay 💅🌈