26#include <sys/stdint.h>
27#include <sys/stddef.h>
32#include <sys/socket.h>
33#include <sys/kernel.h>
35#include <sys/module.h>
38#include <sys/condvar.h>
39#include <sys/sysctl.h>
41#include <sys/unistd.h>
42#include <sys/callout.h>
43#include <sys/malloc.h>
47#include <net/if_var.h>
55#define USB_DEBUG_VAR urndis_debug
83 struct rndis_query_req *msg, uint16_t
len,
84 const void **rbuf, uint16_t *rbufsz);
86 struct rndis_set_req *msg, uint16_t
len);
88 const struct rndis_comp_hdr *hdr);
90 const struct rndis_comp_hdr *hdr,
const void **buf,
93 const struct rndis_comp_hdr *hdr);
98static int urndis_debug = 0;
99static SYSCTL_NODE(_hw_usb, OID_AUTO, urndis, CTLFLAG_RW | CTLFLAG_MPSAFE, 0,
100 "USB RNDIS-Ethernet");
101SYSCTL_INT(_hw_usb_urndis, OID_AUTO,
debug, CTLFLAG_RWTUN, &urndis_debug, 0,
113 .flags = {.short_xfer_ok = 1,},
140 .flags = {.short_xfer_ok = 1,.no_pipe_ok = 1,},
223 struct rndis_query_req query;
224 struct rndis_set_req set;
227 uint8_t eaddr[ETHER_ADDR_LEN];
253 mtx_init(&sc->
sc_mtx, device_get_nameunit(
dev), NULL, MTX_DEF);
256 for (i = 0; i != 32; i++) {
270 if ((
error != 0) || (i == 32)) {
271 device_printf(
dev,
"No valid alternate setting found\n");
279 if (
error != (
int)RNDIS_STATUS_SUCCESS) {
280 device_printf(
dev,
"Unable to initialize hardware\n");
285 memset(msg.ibuf.eaddr, 0,
sizeof(msg.ibuf.eaddr));
288 &msg.hdr.query,
sizeof(msg.hdr.query) +
sizeof(msg.ibuf.eaddr),
291 if (
error != (
int)RNDIS_STATUS_SUCCESS) {
292 device_printf(
dev,
"Unable to get hardware address\n");
295 if (bufsz != ETHER_ADDR_LEN) {
296 device_printf(
dev,
"Invalid address length: %d bytes\n", bufsz);
302 sc->
sc_filter = NDIS_PACKET_TYPE_BROADCAST |
303 NDIS_PACKET_TYPE_ALL_MULTICAST;
304 msg.ibuf.filter = htole32(sc->
sc_filter);
307 &msg.hdr.set,
sizeof(msg.hdr.set) +
sizeof(msg.ibuf.filter));
309 if (
error != (
int)RNDIS_STATUS_SUCCESS) {
310 device_printf(
dev,
"Unable to set data filters\n");
322 device_printf(
dev,
"Could not attach interface\n");
378 ifp->if_drv_flags |= IFF_DRV_RUNNING;
395 ifp->if_drv_flags &= ~IFF_DRV_RUNNING;
422 device_printf(
dev,
"Suspending\n");
430 device_printf(
dev,
"Resuming\n");
436 uint16_t index, uint16_t value,
void *buf, uint16_t buflen)
440 req.bmRequestType = rt;
464static struct rndis_comp_hdr *
467 struct rndis_comp_hdr *hdr;
477 hdr = (
struct rndis_comp_hdr *)sc->sc_response_buf;
479 DPRINTF(
"type 0x%x len %u\n", le32toh(hdr->rm_type),
480 le32toh(hdr->rm_len));
483 DPRINTF(
"ctrl message error: wrong size %u > %u\n",
492 const void **buf, uint16_t *bufsz)
498 if (buf != NULL && bufsz != NULL) {
502 switch (le32toh(hdr->rm_type)) {
503 case REMOTE_NDIS_INITIALIZE_CMPLT:
507 case REMOTE_NDIS_QUERY_CMPLT:
511 case REMOTE_NDIS_RESET_CMPLT:
515 case REMOTE_NDIS_KEEPALIVE_CMPLT:
516 case REMOTE_NDIS_SET_CMPLT:
517 rval = le32toh(hdr->rm_status);
522 "ctrl message error: unknown event 0x%x\n",
523 le32toh(hdr->rm_type));
524 rval = RNDIS_STATUS_FAILURE;
532 const struct rndis_comp_hdr *hdr)
534 const struct rndis_init_comp *msg;
536 msg = (
const struct rndis_init_comp *)hdr;
538 DPRINTF(
"len %u rid %u status 0x%x "
539 "ver_major %u ver_minor %u devflags 0x%x medium 0x%x pktmaxcnt %u "
540 "pktmaxsz %u align %u aflistoffset %u aflistsz %u\n",
541 le32toh(msg->rm_len),
542 le32toh(msg->rm_rid),
543 le32toh(msg->rm_status),
544 le32toh(msg->rm_ver_major),
545 le32toh(msg->rm_ver_minor),
546 le32toh(msg->rm_devflags),
547 le32toh(msg->rm_medium),
548 le32toh(msg->rm_pktmaxcnt),
549 le32toh(msg->rm_pktmaxsz),
550 le32toh(msg->rm_align),
551 le32toh(msg->rm_aflistoffset),
552 le32toh(msg->rm_aflistsz));
554 if (le32toh(msg->rm_status) != RNDIS_STATUS_SUCCESS) {
555 DPRINTF(
"init failed 0x%x\n", le32toh(msg->rm_status));
556 return (le32toh(msg->rm_status));
558 if (le32toh(msg->rm_devflags) != RNDIS_DF_CONNECTIONLESS) {
559 DPRINTF(
"wrong device type (current type: 0x%x)\n",
560 le32toh(msg->rm_devflags));
561 return (RNDIS_STATUS_FAILURE);
563 if (le32toh(msg->rm_medium) != RNDIS_MEDIUM_802_3) {
564 DPRINTF(
"medium not 802.3 (current medium: 0x%x)\n",
565 le32toh(msg->rm_medium));
566 return (RNDIS_STATUS_FAILURE);
570 return (le32toh(msg->rm_status));
575 const struct rndis_comp_hdr *hdr,
const void **buf, uint16_t *bufsz)
577 const struct rndis_query_comp *msg;
580 msg = (
const struct rndis_query_comp *)hdr;
582 DPRINTF(
"len %u rid %u status 0x%x "
583 "buflen %u bufoff %u\n",
584 le32toh(msg->rm_len),
585 le32toh(msg->rm_rid),
586 le32toh(msg->rm_status),
587 le32toh(msg->rm_infobuflen),
588 le32toh(msg->rm_infobufoffset));
592 if (le32toh(msg->rm_status) != RNDIS_STATUS_SUCCESS) {
593 DPRINTF(
"query failed 0x%x\n", le32toh(msg->rm_status));
594 return (le32toh(msg->rm_status));
596 limit = le32toh(msg->rm_infobuflen);
597 limit += le32toh(msg->rm_infobufoffset);
598 limit += RNDIS_HEADER_OFFSET;
600 if (limit > (uint64_t)le32toh(msg->rm_len)) {
601 DPRINTF(
"ctrl message error: invalid query info "
602 "len/offset/end_position(%u/%u/%u) -> "
603 "go out of buffer limit %u\n",
604 le32toh(msg->rm_infobuflen),
605 le32toh(msg->rm_infobufoffset),
606 le32toh(msg->rm_infobuflen) +
607 le32toh(msg->rm_infobufoffset) + RNDIS_HEADER_OFFSET,
608 le32toh(msg->rm_len));
609 return (RNDIS_STATUS_FAILURE);
611 *buf = ((
const uint8_t *)msg) + RNDIS_HEADER_OFFSET +
612 le32toh(msg->rm_infobufoffset);
613 *bufsz = le32toh(msg->rm_infobuflen);
615 return (le32toh(msg->rm_status));
620 const struct rndis_comp_hdr *hdr)
622 const struct rndis_reset_comp *msg;
625 msg = (
const struct rndis_reset_comp *)hdr;
627 rval = le32toh(msg->rm_status);
631 le32toh(msg->rm_len),
633 le32toh(msg->rm_adrreset));
635 if (rval != RNDIS_STATUS_SUCCESS) {
636 DPRINTF(
"reset failed 0x%x\n", rval);
639 if (msg->rm_adrreset != 0) {
641 struct rndis_set_req hdr;
645 msg_filter.filter = htole32(sc->
sc_filter);
648 &msg_filter.hdr,
sizeof(msg_filter));
650 if (rval != RNDIS_STATUS_SUCCESS) {
651 DPRINTF(
"unable to reset data filters\n");
661 struct rndis_init_req msg;
662 struct rndis_comp_hdr *hdr;
665 msg.rm_type = htole32(REMOTE_NDIS_INITIALIZE_MSG);
666 msg.rm_len = htole32(
sizeof(msg));
668 msg.rm_ver_major = htole32(RNDIS_VERSION_MAJOR);
669 msg.rm_ver_minor = htole32(1);
672 DPRINTF(
"type %u len %u rid %u ver_major %u "
673 "ver_minor %u max_xfersz %u\n",
674 le32toh(msg.rm_type),
677 le32toh(msg.rm_ver_major),
678 le32toh(msg.rm_ver_minor),
679 le32toh(msg.rm_max_xfersz));
683 if (rval != RNDIS_STATUS_SUCCESS) {
688 DPRINTF(
"unable to get init response\n");
689 return (RNDIS_STATUS_FAILURE);
699 struct rndis_halt_req msg;
702 msg.rm_type = htole32(REMOTE_NDIS_HALT_MSG);
703 msg.rm_len = htole32(
sizeof(msg));
706 DPRINTF(
"type %u len %u rid %u\n",
707 le32toh(msg.rm_type),
709 le32toh(msg.rm_rid));
713 if (rval != RNDIS_STATUS_SUCCESS)
725 struct rndis_query_req *msg, uint16_t
len,
const void **rbuf,
728 struct rndis_comp_hdr *hdr;
729 uint32_t datalen, rval;
731 msg->rm_type = htole32(REMOTE_NDIS_QUERY_MSG);
732 msg->rm_len = htole32(
len);
734 msg->rm_oid = htole32(oid);
735 datalen =
len -
sizeof(*msg);
736 msg->rm_infobuflen = htole32(datalen);
738 msg->rm_infobufoffset = htole32(
sizeof(*msg) -
739 RNDIS_HEADER_OFFSET);
741 msg->rm_infobufoffset = 0;
743 msg->rm_devicevchdl = 0;
745 DPRINTF(
"type %u len %u rid %u oid 0x%x "
746 "infobuflen %u infobufoffset %u devicevchdl %u\n",
747 le32toh(msg->rm_type),
748 le32toh(msg->rm_len),
749 le32toh(msg->rm_rid),
750 le32toh(msg->rm_oid),
751 le32toh(msg->rm_infobuflen),
752 le32toh(msg->rm_infobufoffset),
753 le32toh(msg->rm_devicevchdl));
757 if (rval != RNDIS_STATUS_SUCCESS) {
762 DPRINTF(
"unable to get query response\n");
763 return (RNDIS_STATUS_FAILURE);
772 struct rndis_set_req *msg, uint16_t
len)
774 struct rndis_comp_hdr *hdr;
775 uint32_t datalen, rval;
777 msg->rm_type = htole32(REMOTE_NDIS_SET_MSG);
778 msg->rm_len = htole32(
len);
780 msg->rm_oid = htole32(oid);
781 datalen =
len -
sizeof(*msg);
782 msg->rm_infobuflen = htole32(datalen);
784 msg->rm_infobufoffset = htole32(
sizeof(*msg) -
785 RNDIS_HEADER_OFFSET);
787 msg->rm_infobufoffset = 0;
789 msg->rm_devicevchdl = 0;
791 DPRINTF(
"type %u len %u rid %u oid 0x%x "
792 "infobuflen %u infobufoffset %u devicevchdl %u\n",
793 le32toh(msg->rm_type),
794 le32toh(msg->rm_len),
795 le32toh(msg->rm_rid),
796 le32toh(msg->rm_oid),
797 le32toh(msg->rm_infobuflen),
798 le32toh(msg->rm_infobufoffset),
799 le32toh(msg->rm_devicevchdl));
803 if (rval != RNDIS_STATUS_SUCCESS) {
808 DPRINTF(
"unable to get set response\n");
809 return (RNDIS_STATUS_FAILURE);
812 if (rval != RNDIS_STATUS_SUCCESS)
813 DPRINTF(
"set failed 0x%x\n", rval);
824 struct rndis_packet_msg msg;
834 DPRINTFN(1,
"received %u bytes in %u frames\n", actlen, aframes);
836 for (
offset = 0; actlen >= (uint32_t)
sizeof(msg);) {
840 if (le32toh(0x1234567U) != 0x1234567U) {
842 msg.rm_type = le32toh(msg.rm_type);
843 msg.rm_len = le32toh(msg.rm_len);
844 msg.rm_dataoffset = le32toh(msg.rm_dataoffset);
845 msg.rm_datalen = le32toh(msg.rm_datalen);
846 msg.rm_oobdataoffset = le32toh(msg.rm_oobdataoffset);
847 msg.rm_oobdatalen = le32toh(msg.rm_oobdatalen);
848 msg.rm_oobdataelements = le32toh(msg.rm_oobdataelements);
849 msg.rm_pktinfooffset = le32toh(msg.rm_pktinfooffset);
850 msg.rm_pktinfolen = le32toh(msg.rm_pktinfolen);
851 msg.rm_vchandle = le32toh(msg.rm_vchandle);
852 msg.rm_reserved = le32toh(msg.rm_reserved);
855 DPRINTF(
"len %u data(off:%u len:%u) "
856 "oobdata(off:%u len:%u nb:%u) perpacket(off:%u len:%u)\n",
857 msg.rm_len, msg.rm_dataoffset, msg.rm_datalen,
858 msg.rm_oobdataoffset, msg.rm_oobdatalen,
859 msg.rm_oobdataelements, msg.rm_pktinfooffset,
860 msg.rm_pktinfooffset);
863 if (msg.rm_type != REMOTE_NDIS_PACKET_MSG) {
864 DPRINTF(
"invalid type 0x%x != 0x%x\n",
865 msg.rm_type, REMOTE_NDIS_PACKET_MSG);
867 }
else if (msg.rm_len < (uint32_t)
sizeof(msg)) {
868 DPRINTF(
"invalid msg len %u < %u\n",
869 msg.rm_len, (
unsigned)
sizeof(msg));
871 }
else if (msg.rm_len > (uint32_t)actlen) {
872 DPRINTF(
"invalid msg len %u > buffer "
873 "len %u\n", msg.rm_len, actlen);
875 }
else if (msg.rm_dataoffset >= (uint32_t)actlen) {
876 DPRINTF(
"invalid msg dataoffset %u > buffer "
877 "dataoffset %u\n", msg.rm_dataoffset, actlen);
879 }
else if (msg.rm_datalen > (uint32_t)actlen) {
880 DPRINTF(
"invalid msg datalen %u > buffer "
881 "datalen %u\n", msg.rm_datalen, actlen);
883 }
else if ((msg.rm_dataoffset + msg.rm_datalen +
884 (uint32_t)__offsetof(
struct rndis_packet_msg,
885 rm_dataoffset)) > (uint32_t)actlen) {
886 DPRINTF(
"invalid dataoffset %u larger than %u\n",
887 msg.rm_dataoffset + msg.rm_datalen +
888 (uint32_t)__offsetof(
struct rndis_packet_msg,
889 rm_dataoffset), actlen);
891 }
else if (msg.rm_datalen < (uint32_t)
sizeof(
struct ether_header)) {
892 if_inc_counter(ifp, IFCOUNTER_IERRORS, 1);
893 DPRINTF(
"invalid ethernet size "
894 "%u < %u\n", msg.rm_datalen, (
unsigned)
sizeof(
struct ether_header));
896 }
else if (msg.rm_datalen > (uint32_t)(MCLBYTES - ETHER_ALIGN)) {
897 if_inc_counter(ifp, IFCOUNTER_IERRORS, 1);
898 DPRINTF(
"invalid ethernet size "
900 msg.rm_datalen, (
unsigned)MCLBYTES);
902 }
else if (msg.rm_datalen > (uint32_t)(MHLEN - ETHER_ALIGN)) {
903 m = m_getcl(M_NOWAIT, MT_DATA, M_PKTHDR);
905 m = m_gethdr(M_NOWAIT, MT_DATA);
910 m->m_len = m->m_pkthdr.len = msg.rm_datalen + ETHER_ALIGN;
911 m_adj(m, ETHER_ALIGN);
914 __offsetof(
struct rndis_packet_msg,
915 rm_dataoffset), m->m_data, msg.rm_datalen);
920 if_inc_counter(ifp, IFCOUNTER_IERRORS, 1);
923 actlen -= msg.rm_len;
950 struct rndis_packet_msg msg;
964 DPRINTFN(11,
"%u bytes in %u frames\n", actlen, aframes);
966 if_inc_counter(ifp, IFCOUNTER_OPACKETS, 1);
971 memset(&msg, 0,
sizeof(msg));
979 IFQ_DRV_DEQUEUE(&ifp->if_snd, m);
986 if_inc_counter(ifp, IFCOUNTER_OERRORS, 1);
992 msg.rm_type = htole32(REMOTE_NDIS_PACKET_MSG);
993 msg.rm_len = htole32(
sizeof(msg) + m->m_pkthdr.len);
995 msg.rm_dataoffset = htole32(RNDIS_DATA_OFFSET);
996 msg.rm_datalen = htole32(m->m_pkthdr.len);
1022 if_inc_counter(ifp, IFCOUNTER_OERRORS, 1);
1043 DPRINTF(
"Received %d bytes\n", actlen);
static SYSCTL_NODE(_hw_usb, OID_AUTO, dwc_otg, CTLFLAG_RW|CTLFLAG_MPSAFE, 0, "USB DWC OTG")
SYSCTL_INT(_hw_usb_dwc_otg, OID_AUTO, phy_type, CTLFLAG_RDTUN, &dwc_otg_phy_type, 0, "DWC OTG PHY TYPE - 0/1/2/3 - ULPI/HSIC/INTERNAL/UTMI+")
USB_PNP_HOST_INFO(urndis_host_devs)
static uint32_t urndis_ctrl_query(struct urndis_softc *sc, uint32_t oid, struct rndis_query_req *msg, uint16_t len, const void **rbuf, uint16_t *rbufsz)
static usb_callback_t urndis_intr_read_callback
static usb_error_t urndis_ctrl_msg(struct urndis_softc *sc, uint8_t rt, uint8_t r, uint16_t index, uint16_t value, void *buf, uint16_t buflen)
static uint32_t urndis_ctrl_init(struct urndis_softc *sc)
static uether_fn_t urndis_attach_post
MODULE_VERSION(urndis, 1)
static usb_error_t urndis_ctrl_send(struct urndis_softc *sc, void *buf, uint16_t len)
static uint32_t urndis_ctrl_set(struct urndis_softc *sc, uint32_t oid, struct rndis_set_req *msg, uint16_t len)
static uint32_t urndis_ctrl_halt(struct urndis_softc *sc)
static uether_fn_t urndis_start
MODULE_DEPEND(urndis, uether, 1, 1, 1)
static uint32_t urndis_ctrl_handle_init(struct urndis_softc *sc, const struct rndis_comp_hdr *hdr)
static uether_fn_t urndis_init
static usb_callback_t urndis_bulk_read_callback
static uint32_t urndis_ctrl_handle_query(struct urndis_softc *sc, const struct rndis_comp_hdr *hdr, const void **buf, uint16_t *bufsz)
static uint32_t urndis_ctrl_handle_reset(struct urndis_softc *sc, const struct rndis_comp_hdr *hdr)
static device_probe_t urndis_probe
static struct rndis_comp_hdr * urndis_ctrl_recv(struct urndis_softc *sc)
static usb_callback_t urndis_bulk_write_callback
DRIVER_MODULE(urndis, uhub, urndis_driver, urndis_devclass, NULL, NULL)
static uint32_t urndis_ctrl_handle(struct urndis_softc *sc, struct rndis_comp_hdr *hdr, const void **buf, uint16_t *bufsz)
static uether_fn_t urndis_stop
static device_attach_t urndis_attach
static const STRUCT_USB_HOST_ID urndis_host_devs[]
static device_method_t urndis_methods[]
static const struct usb_config urndis_config[URNDIS_N_TRANSFER]
static devclass_t urndis_devclass
static device_suspend_t urndis_suspend
static device_resume_t urndis_resume
static const struct usb_ether_methods urndis_ue_methods
static uether_fn_t urndis_setpromisc
static device_detach_t urndis_detach
static driver_t urndis_driver
static uether_fn_t urndis_setmulti
#define URNDIS_UNLOCK(sc)
#define RNDIS_TX_FRAMES_MAX
#define URNDIS_LOCK_ASSERT(sc, what)
#define RNDIS_RESPONSE_LEN
struct usb_xfer * sc_xfer[URNDIS_N_TRANSFER]
struct usbd_lookup_info info
struct usb_device * device
struct usb_xfer_flags flags
uether_fn_t * ue_attach_post
const struct usb_ether_methods * ue_methods
struct usb_device * ue_udev
uint8_t ue_eaddr[ETHER_ADDR_LEN]
#define UIPROTO_ACTIVESYNC
#define UT_READ_CLASS_INTERFACE
#define UT_WRITE_CLASS_INTERFACE
#define UISUBCLASS_ABSTRACT_CONTROL_MODEL
#define UDESC_CS_INTERFACE
void usbd_copy_in(struct usb_page_cache *cache, usb_frlength_t offset, const void *ptr, usb_frlength_t len)
void usbd_copy_out(struct usb_page_cache *cache, usb_frlength_t offset, void *ptr, usb_frlength_t len)
#define UCDC_SEND_ENCAPSULATED_COMMAND
#define UCDC_GET_ENCAPSULATED_RESPONSE
usb_error_t usbd_set_alt_interface_index(struct usb_device *udev, uint8_t iface_index, uint8_t alt_index)
void * usbd_find_descriptor(struct usb_device *udev, void *id, uint8_t iface_index, uint8_t type, uint8_t type_mask, uint8_t subtype, uint8_t subtype_mask)
const char * usbd_errstr(usb_error_t err)
void uether_rxflush(struct usb_ether *ue)
void uether_ifdetach(struct usb_ether *ue)
void * uether_getsc(struct usb_ether *ue)
struct ifnet * uether_getifp(struct usb_ether *ue)
int uether_rxmbuf(struct usb_ether *ue, struct mbuf *m, unsigned int len)
int uether_ifattach(struct usb_ether *ue)
void() uether_fn_t(struct usb_ether *)
int usbd_lookup_id_by_uaa(const struct usb_device_id *id, usb_size_t sizeof_id, struct usb_attach_arg *uaa)
usb_error_t usbd_do_request_flags(struct usb_device *udev, struct mtx *mtx, struct usb_device_request *req, void *data, uint16_t flags, uint16_t *actlen, usb_timeout_t timeout)
void usbd_transfer_submit(struct usb_xfer *xfer)
void usbd_xfer_set_frames(struct usb_xfer *xfer, usb_frcount_t n)
void usbd_transfer_unsetup(struct usb_xfer **pxfer, uint16_t n_setup)
void usbd_xfer_set_frame_len(struct usb_xfer *xfer, usb_frcount_t frindex, usb_frlength_t len)
struct usb_page_cache * usbd_xfer_get_frame(struct usb_xfer *xfer, usb_frcount_t frindex)
usb_error_t usbd_transfer_setup(struct usb_device *udev, const uint8_t *ifaces, struct usb_xfer **ppxfer, const struct usb_config *setup_start, uint16_t n_setup, void *priv_sc, struct mtx *xfer_mtx)
void usbd_transfer_start(struct usb_xfer *xfer)
void usbd_xfer_set_frame_offset(struct usb_xfer *xfer, usb_frlength_t offset, usb_frcount_t frindex)
void * usbd_xfer_softc(struct usb_xfer *xfer)
void usbd_xfer_set_stall(struct usb_xfer *xfer)
void usbd_transfer_stop(struct usb_xfer *xfer)
void usbd_xfer_status(struct usb_xfer *xfer, int *actlen, int *sumlen, int *aframes, int *nframes)
usb_frlength_t usbd_xfer_max_len(struct usb_xfer *xfer)
void device_set_usb_desc(device_t dev)
#define USB_IFACE_SUBCLASS(isc)
@ USB_ERR_NORMAL_COMPLETION
#define USB_IFACE_CLASS(ic)
#define USB_SHORT_XFER_OK
#define USB_ST_TRANSFERRED
void usbd_m_copy_in(struct usb_page_cache *cache, usb_frlength_t dst_offset, struct mbuf *m, usb_size_t src_offset, usb_frlength_t src_len)
#define USB_IFACE_PROTOCOL(ip)
void() usb_callback_t(struct usb_xfer *, usb_error_t)
#define STRUCT_USB_HOST_ID
#define USB_GET_STATE(xfer)