1 /***************************************************************************
2 * Copyright (C) 2009 by Zachary T Welch <zw@superlucidity.net> *
4 * Copyright (C) 2011 by Mauro Gamba <maurillo71@gmail.com> *
6 * This program is free software; you can redistribute it and/or modify *
7 * it under the terms of the GNU General Public License as published by *
8 * the Free Software Foundation; either version 2 of the License, or *
9 * (at your option) any later version. *
11 * This program is distributed in the hope that it will be useful, *
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
14 * GNU General Public License for more details. *
16 * You should have received a copy of the GNU General Public License *
17 * along with this program. If not, see <http://www.gnu.org/licenses/>. *
18 ***************************************************************************/
20 #ifndef OPENOCD_JTAG_DRIVERS_LIBUSB_HELPER_H
21 #define OPENOCD_JTAG_DRIVERS_LIBUSB_HELPER_H
25 int jtag_libusb_open(const uint16_t vids[], const uint16_t pids[],
27 struct libusb_device_handle **out);
28 void jtag_libusb_close(struct libusb_device_handle *dev);
29 int jtag_libusb_control_transfer(struct libusb_device_handle *dev,
30 uint8_t requestType, uint8_t request, uint16_t wValue,
31 uint16_t wIndex, char *bytes, uint16_t size, unsigned int timeout);
32 int jtag_libusb_bulk_write(struct libusb_device_handle *dev, int ep,
33 char *bytes, int size, int timeout, int *transferred);
34 int jtag_libusb_bulk_read(struct libusb_device_handle *dev, int ep,
35 char *bytes, int size, int timeout, int *transferred);
36 int jtag_libusb_set_configuration(struct libusb_device_handle *devh,
39 * Find the first interface optionally matching class, subclass and
40 * protocol and claim it.
41 * @param devh _libusb_ device handle.
42 * @param usb_read_ep A pointer to a variable where the _IN_ endpoint
43 * number will be stored.
44 * @param usb_write_ep A pointer to a variable where the _OUT_ endpoint
45 * number will be stored.
46 * @param bclass `bInterfaceClass` to match, or -1 to ignore this field.
47 * @param subclass `bInterfaceSubClass` to match, or -1 to ignore this field.
48 * @param protocol `bInterfaceProtocol` to match, or -1 to ignore this field.
49 * @param trans_type `bmAttributes Bits 0..1 Transfer type` to match, or -1 to ignore this field.
50 * @returns Returns ERROR_OK on success, ERROR_FAIL otherwise.
52 int jtag_libusb_choose_interface(struct libusb_device_handle *devh,
53 unsigned int *usb_read_ep,
54 unsigned int *usb_write_ep,
55 int bclass, int subclass, int protocol, int trans_type);
56 int jtag_libusb_get_pid(struct libusb_device *dev, uint16_t *pid);
58 #endif /* OPENOCD_JTAG_DRIVERS_LIBUSB_HELPER_H */