1 /* ----------------------------------------------------------------------------
2 * "THE BEER-WARE LICENSE" (Revision 42) (by Poul-Henning Kamp):
3 * <joerg@FreeBSD.ORG> wrote this file. As long as you retain this notice you
4 * can do whatever you want with this stuff. If we meet some day, and you think
5 * this stuff is worth it, you can buy me a beer in return. Joerg Wunsch
6 * ----------------------------------------------------------------------------
8 * $FreeBSD: head/share/examples/libusb20/control.c 257779 2013-11-07 07:22:51Z hselasky $
12 * Simple demo program to illustrate the handling of FreeBSD's
18 * Just list all VID:PID pairs
21 * Standard device request GET_STATUS, report two bytes of status
22 * (bit 0 in the first byte returned is the "self powered" bit)
23 * ./control -v 0x3eb -p 0x2103 in std dev get_status 0 0 2
25 * Request input reports through the interrupt pipe from a mouse
26 * device (move the mouse around after issuing the command):
27 * ./control -v 0x093a -p 0x2516 -i 0x81
42 #include <libusb20_desc.h>
44 #include <sys/queue.h>
49 * If you want to see the details of the internal datastructures
50 * in the debugger, unifdef the following.
53 # include "/usr/src/lib/libusb/libusb20_int.h"
58 #define TIMEOUT 5000 /* 5 s */
60 int intr_ep
; /* endpoints */
61 struct LIBUSB20_CONTROL_SETUP_DECODED setup
;
63 uint8_t out_buf
[BUFLEN
];
69 doit(struct libusb20_device
*dev
)
74 printf("doit(): bmRequestType 0x%02x, bRequest 0x%02x, wValue 0x%04x, wIndex 0x%04x, wLength 0x%04x\n",
82 * Open the device, allocating memory for two possible (bulk or
83 * interrupt) transfers.
85 * If only control transfers are intended (via
86 * libusb20_dev_request_sync()), transfer_max can be given as 0.
88 if ((rv
= libusb20_dev_open(dev
, 1)) != 0)
90 fprintf(stderr
, "libusb20_dev_open: %s\n", libusb20_strerror(rv
));
95 * If the device has more than one configuration, select the desired
98 if ((rv
= libusb20_dev_set_config_index(dev
, 0)) != 0)
100 fprintf(stderr
, "libusb20_dev_set_config_index: %s\n", libusb20_strerror(rv
));
104 uint8_t *data
= NULL
;
107 if ((setup
.bmRequestType
& 0x80) != 0)
109 /* this is an IN request, allocate a buffer */
110 data
= malloc(setup
.wLength
);
114 "Out of memory allocating %u bytes of reply buffer\n",
124 if ((rv
= libusb20_dev_request_sync(dev
, &setup
, data
,
127 0 /* flags */)) != 0)
130 "libusb20_dev_request_sync: %s\n", libusb20_strerror(rv
));
132 printf("sent %d bytes\n", actlen
);
133 if ((setup
.bmRequestType
& 0x80) != 0)
135 print_formatted(data
, (uint32_t)setup
.wLength
);
143 * One transfer has been requested in libusb20_dev_open() above;
144 * obtain the corresponding transfer struct pointer.
146 struct libusb20_transfer
*xfr_intr
= libusb20_tr_get_pointer(dev
, 0);
148 if (xfr_intr
== NULL
)
150 fprintf(stderr
, "libusb20_tr_get_pointer: %s\n", libusb20_strerror(rv
));
155 * Open the interrupt transfer.
157 if ((rv
= libusb20_tr_open(xfr_intr
, 0, 1, intr_ep
)) != 0)
159 fprintf(stderr
, "libusb20_tr_open: %s\n", libusb20_strerror(rv
));
163 uint8_t in_buf
[BUFLEN
];
166 if ((rv
= libusb20_tr_bulk_intr_sync(xfr_intr
, in_buf
, BUFLEN
, &rlen
, TIMEOUT
))
169 fprintf(stderr
, "libusb20_tr_bulk_intr_sync: %s\n", libusb20_strerror(rv
));
171 printf("received %d bytes\n", rlen
);
173 print_formatted(in_buf
, rlen
);
175 libusb20_tr_close(xfr_intr
);
178 libusb20_dev_close(dev
);
185 "Usage ./usb [-i <INTR_EP>] -v <VID> -p <PID> [dir type rcpt req wValue wIndex wLength [<outdata> ...]]\n");
189 static const char *reqnames
[] =
207 get_req(const char *reqname
)
210 size_t l
= strlen(reqname
);
213 i
< sizeof reqnames
/ sizeof reqnames
[0];
215 if (strncasecmp(reqname
, reqnames
[i
], l
) == 0)
218 return strtoul(reqname
, 0, 0);
223 parse_req(int argc
, char **argv
)
228 for (idx
= 0; argc
!= 0 && idx
<= 6; argc
--, idx
++)
232 /* dir[ection]: i[n] | o[ut] */
233 if (*argv
[idx
] == 'i')
235 else if (*argv
[idx
] == 'o')
239 fprintf(stderr
, "request direction must be \"in\" or \"out\" (got %s)\n",
246 /* type: s[tandard] | c[lass] | v[endor] */
247 if (*argv
[idx
] == 's')
249 else if (*argv
[idx
] == 'c')
251 else if (*argv
[idx
] == 'v')
256 "request type must be one of \"standard\", \"class\", or \"vendor\" (got %s)\n",
263 /* rcpt: d[evice], i[nterface], e[ndpoint], o[ther] */
264 if (*argv
[idx
] == 'd')
266 else if (*argv
[idx
] == 'i')
268 else if (*argv
[idx
] == 'e')
270 else if (*argv
[idx
] == 'o')
275 "recipient must be one of \"device\", \"interface\", \"endpoint\", or \"other\" (got %s)\n",
279 setup
.bmRequestType
= rt
;
283 setup
.bRequest
= get_req(argv
[idx
]);
287 setup
.wValue
= strtoul(argv
[idx
], 0, 0);
291 setup
.wIndex
= strtoul(argv
[idx
], 0, 0);
295 setup
.wLength
= strtoul(argv
[idx
], 0, 0);
304 main(int argc
, char **argv
)
306 unsigned int vid
= UINT_MAX
, pid
= UINT_MAX
; /* impossible VID:PID */
310 * Initialize setup struct. This step is required, and initializes
311 * internal fields in the struct.
313 * All the "public" fields are named exactly the way as the USB
314 * standard describes them, namely:
316 * setup.bmRequestType: bitmask, bit 7 is direction
317 * bits 6/5 is request type
318 * (standard, class, vendor)
319 * bits 4..0 is recipient
320 * (device, interface, endpoint,
322 * setup.bRequest: the request itself (see get_req() for standard
323 * requests, or specific value)
324 * setup.wValue: a 16-bit value
325 * setup.wIndex: another 16-bit value
326 * setup.wLength: length of associated data transfer, direction
327 * depends on bit 7 of bmRequestType
329 LIBUSB20_INIT(LIBUSB20_CONTROL_SETUP
, &setup
);
331 while ((c
= getopt(argc
, argv
, "i:p:v:")) != -1)
335 intr_ep
= strtol(optarg
, NULL
, 0);
339 pid
= strtol(optarg
, NULL
, 0);
343 vid
= strtol(optarg
, NULL
, 0);
353 if (vid
!= UINT_MAX
|| pid
!= UINT_MAX
)
355 if (intr_ep
!= 0 && (intr_ep
& 0x80) == 0)
357 fprintf(stderr
, "Interrupt endpoint must be of type IN\n");
365 int rv
= parse_req(argc
, argv
);
372 for (out_len
= 0; argc
> 0 && out_len
< BUFLEN
; out_len
++, argc
--)
374 unsigned n
= strtoul(argv
[out_len
], 0, 0);
377 "Warning: data #%d 0x%0x > 0xff, truncating\n",
379 out_buf
[out_len
] = (uint8_t)n
;
384 "Data count exceeds maximum of %d, ignoring %d elements\n",
390 struct libusb20_backend
*be
;
391 struct libusb20_device
*dev
;
393 if ((be
= libusb20_be_alloc_default()) == NULL
)
395 perror("libusb20_be_alloc()");
400 while ((dev
= libusb20_be_device_foreach(be
, dev
)) != NULL
)
402 struct LIBUSB20_DEVICE_DESC_DECODED
*ddp
=
403 libusb20_dev_get_device_desc(dev
);
405 printf("Found device %s (VID:PID = 0x%04x:0x%04x)\n",
406 libusb20_dev_get_desc(dev
),
407 ddp
->idVendor
, ddp
->idProduct
);
409 if (ddp
->idVendor
== vid
&& ddp
->idProduct
== pid
)
413 libusb20_be_free(be
);