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, write to the *
18 * Free Software Foundation, Inc., *
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. *
20 ***************************************************************************/
26 #include "libusb1_common.h"
28 static struct libusb_context
*jtag_libusb_context
; /**< Libusb context **/
29 static libusb_device
**devs
; /**< The usb device list **/
31 static bool jtag_libusb_match(struct libusb_device_descriptor
*dev_desc
,
32 const uint16_t vids
[], const uint16_t pids
[])
34 for (unsigned i
= 0; vids
[i
]; i
++) {
35 if (dev_desc
->idVendor
== vids
[i
] &&
36 dev_desc
->idProduct
== pids
[i
]) {
43 /* Returns true if the string descriptor indexed by str_index in device matches string */
44 static bool string_descriptor_equal(libusb_device_handle
*device
, uint8_t str_index
,
49 char desc_string
[256+1]; /* Max size of string descriptor */
54 retval
= libusb_get_string_descriptor_ascii(device
, str_index
,
55 (unsigned char *)desc_string
, sizeof(desc_string
)-1);
57 LOG_ERROR("libusb_get_string_descriptor_ascii() failed with %d", retval
);
61 /* Null terminate descriptor string in case it needs to be logged. */
62 desc_string
[sizeof(desc_string
)-1] = '\0';
64 matched
= strncmp(string
, desc_string
, sizeof(desc_string
)) == 0;
66 LOG_DEBUG("Device serial number '%s' doesn't match requested serial '%s'",
71 int jtag_libusb_open(const uint16_t vids
[], const uint16_t pids
[],
73 struct jtag_libusb_device_handle
**out
)
75 int cnt
, idx
, errCode
;
77 struct jtag_libusb_device_handle
*libusb_handle
= NULL
;
79 if (libusb_init(&jtag_libusb_context
) < 0)
82 cnt
= libusb_get_device_list(jtag_libusb_context
, &devs
);
84 for (idx
= 0; idx
< cnt
; idx
++) {
85 struct libusb_device_descriptor dev_desc
;
87 if (libusb_get_device_descriptor(devs
[idx
], &dev_desc
) != 0)
90 if (!jtag_libusb_match(&dev_desc
, vids
, pids
))
93 errCode
= libusb_open(devs
[idx
], &libusb_handle
);
96 LOG_ERROR("libusb_open() failed with %s",
97 libusb_error_name(errCode
));
101 /* Device must be open to use libusb_get_string_descriptor_ascii. */
102 if (serial
!= NULL
&&
103 !string_descriptor_equal(libusb_handle
, dev_desc
.iSerialNumber
, serial
)) {
104 libusb_close(libusb_handle
);
109 *out
= libusb_handle
;
114 libusb_free_device_list(devs
, 1);
118 void jtag_libusb_close(jtag_libusb_device_handle
*dev
)
123 libusb_exit(jtag_libusb_context
);
126 int jtag_libusb_control_transfer(jtag_libusb_device_handle
*dev
, uint8_t requestType
,
127 uint8_t request
, uint16_t wValue
, uint16_t wIndex
, char *bytes
,
128 uint16_t size
, unsigned int timeout
)
132 transferred
= libusb_control_transfer(dev
, requestType
, request
, wValue
, wIndex
,
133 (unsigned char *)bytes
, size
, timeout
);
141 int jtag_libusb_bulk_write(jtag_libusb_device_handle
*dev
, int ep
, char *bytes
,
142 int size
, int timeout
)
146 libusb_bulk_transfer(dev
, ep
, (unsigned char *)bytes
, size
,
147 &transferred
, timeout
);
151 int jtag_libusb_bulk_read(jtag_libusb_device_handle
*dev
, int ep
, char *bytes
,
152 int size
, int timeout
)
156 libusb_bulk_transfer(dev
, ep
, (unsigned char *)bytes
, size
,
157 &transferred
, timeout
);
161 int jtag_libusb_set_configuration(jtag_libusb_device_handle
*devh
,
164 struct jtag_libusb_device
*udev
= jtag_libusb_get_device(devh
);
167 struct libusb_config_descriptor
*config
= NULL
;
168 int current_config
= -1;
170 retCode
= libusb_get_configuration(devh
, ¤t_config
);
174 retCode
= libusb_get_config_descriptor(udev
, configuration
, &config
);
175 if (retCode
!= 0 || config
== NULL
)
178 /* Only change the configuration if it is not already set to the
179 same one. Otherwise this issues a lightweight reset and hangs
180 LPC-Link2 with JLink firmware. */
181 if (current_config
!= config
->bConfigurationValue
)
182 retCode
= libusb_set_configuration(devh
, config
->bConfigurationValue
);
184 libusb_free_config_descriptor(config
);
189 int jtag_libusb_choose_interface(struct jtag_libusb_device_handle
*devh
,
190 unsigned int *usb_read_ep
,
191 unsigned int *usb_write_ep
,
192 int bclass
, int subclass
, int protocol
)
194 struct jtag_libusb_device
*udev
= jtag_libusb_get_device(devh
);
195 const struct libusb_interface
*inter
;
196 const struct libusb_interface_descriptor
*interdesc
;
197 const struct libusb_endpoint_descriptor
*epdesc
;
198 struct libusb_config_descriptor
*config
;
200 *usb_read_ep
= *usb_write_ep
= 0;
202 libusb_get_config_descriptor(udev
, 0, &config
);
203 for (int i
= 0; i
< (int)config
->bNumInterfaces
; i
++) {
204 inter
= &config
->interface
[i
];
206 interdesc
= &inter
->altsetting
[0];
208 k
< (int)interdesc
->bNumEndpoints
; k
++) {
209 if ((bclass
> 0 && interdesc
->bInterfaceClass
!= bclass
) ||
210 (subclass
> 0 && interdesc
->bInterfaceSubClass
!= subclass
) ||
211 (protocol
> 0 && interdesc
->bInterfaceProtocol
!= protocol
))
214 epdesc
= &interdesc
->endpoint
[k
];
216 uint8_t epnum
= epdesc
->bEndpointAddress
;
217 bool is_input
= epnum
& 0x80;
218 LOG_DEBUG("usb ep %s %02x",
219 is_input
? "in" : "out", epnum
);
222 *usb_read_ep
= epnum
;
224 *usb_write_ep
= epnum
;
226 if (*usb_read_ep
&& *usb_write_ep
) {
227 LOG_DEBUG("Claiming interface %d", (int)interdesc
->bInterfaceNumber
);
228 libusb_claim_interface(devh
, (int)interdesc
->bInterfaceNumber
);
229 libusb_free_config_descriptor(config
);
234 libusb_free_config_descriptor(config
);
239 int jtag_libusb_get_pid(struct jtag_libusb_device
*dev
, uint16_t *pid
)
241 struct libusb_device_descriptor dev_desc
;
243 if (libusb_get_device_descriptor(dev
, &dev_desc
) == 0) {
244 *pid
= dev_desc
.idProduct
;
Linking to existing account procedure
If you already have an account and want to add another login method
you
MUST first sign in with your existing account and
then change URL to read
https://review.openocd.org/login/?link
to get to this page again but this time it'll work for linking. Thank you.
SSH host keys fingerprints
1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=.. |
|+o.. . |
|*.o . . |
|+B . . . |
|Bo. = o S |
|Oo.+ + = |
|oB=.* = . o |
| =+=.+ + E |
|. .=o . o |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)