2 * Driver for USB-JTAG, Altera USB-Blaster II and compatibles
4 * Copyright (C) 2013 Franck Jullien franck.jullien@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.
21 #include <jtag/interface.h>
22 #include <jtag/commands.h>
23 #include <libusb_common.h>
24 #include <target/image.h>
26 #include "ublast_access.h"
28 #define USBBLASTER_CTRL_READ_REV 0x94
29 #define USBBLASTER_CTRL_LOAD_FIRM 0xA0
30 #define USBBLASTER_EPOUT 4
31 #define USBBLASTER_EPIN 8
33 #define EZUSB_CPUCS 0xe600
36 /** Maximum size of a single firmware section. Entire EZ-USB code space = 16kB */
37 #define SECTION_BUFFERSIZE 16384
39 static int ublast2_libusb_read(struct ublast_lowlevel
*low
, uint8_t *buf
,
40 unsigned size
, uint32_t *bytes_read
)
42 *bytes_read
= jtag_libusb_bulk_read(low
->libusb_dev
,
51 static int ublast2_libusb_write(struct ublast_lowlevel
*low
, uint8_t *buf
,
52 int size
, uint32_t *bytes_written
)
54 *bytes_written
= jtag_libusb_bulk_write(low
->libusb_dev
,
63 static int ublast2_write_firmware_section(struct jtag_libusb_device_handle
*libusb_dev
,
64 struct image
*firmware_image
, int section_index
)
67 uint8_t data
[SECTION_BUFFERSIZE
];
68 uint8_t *data_ptr
= data
;
71 uint16_t size
= (uint16_t)firmware_image
->sections
[section_index
].size
;
72 uint16_t addr
= (uint16_t)firmware_image
->sections
[section_index
].base_address
;
74 LOG_DEBUG("section %02i at addr 0x%04x (size 0x%04x)", section_index
, addr
,
77 /* Copy section contents to local buffer */
78 int ret
= image_read_section(firmware_image
, section_index
, 0, size
, data
,
81 if ((ret
!= ERROR_OK
) || (size_read
!= size
)) {
82 /* Propagating the return code would return '0' (misleadingly indicating
83 * successful execution of the function) if only the size check fails. */
87 uint16_t bytes_remaining
= size
;
89 /* Send section data in chunks of up to 64 bytes to ULINK */
90 while (bytes_remaining
> 0) {
91 if (bytes_remaining
> 64)
94 chunk_size
= bytes_remaining
;
96 jtag_libusb_control_transfer(libusb_dev
,
97 LIBUSB_REQUEST_TYPE_VENDOR
| \
99 USBBLASTER_CTRL_LOAD_FIRM
,
106 bytes_remaining
-= chunk_size
;
108 data_ptr
+= chunk_size
;
114 static int load_usb_blaster_firmware(struct jtag_libusb_device_handle
*libusb_dev
,
115 struct ublast_lowlevel
*low
)
117 struct image ublast2_firmware_image
;
119 if (!low
->firmware_path
) {
120 LOG_ERROR("No firmware path specified");
124 ublast2_firmware_image
.base_address
= 0;
125 ublast2_firmware_image
.base_address_set
= 0;
127 int ret
= image_open(&ublast2_firmware_image
, low
->firmware_path
, "ihex");
128 if (ret
!= ERROR_OK
) {
129 LOG_ERROR("Could not load firmware image");
133 /** A host loader program must write 0x01 to the CPUCS register
134 * to put the CPU into RESET, load all or part of the EZUSB
135 * RAM with firmware, then reload the CPUCS register
136 * with ‘0’ to take the CPU out of RESET. The CPUCS register
137 * (at 0xE600) is the only EZ-USB register that can be written
138 * using the Firmware Download command.
141 char value
= CPU_RESET
;
142 jtag_libusb_control_transfer(libusb_dev
,
143 LIBUSB_REQUEST_TYPE_VENDOR
| \
145 USBBLASTER_CTRL_LOAD_FIRM
,
152 /* Download all sections in the image to ULINK */
153 for (int i
= 0; i
< ublast2_firmware_image
.num_sections
; i
++) {
154 ret
= ublast2_write_firmware_section(libusb_dev
,
155 &ublast2_firmware_image
, i
);
156 if (ret
!= ERROR_OK
) {
157 LOG_ERROR("Error while downloading the firmware");
163 jtag_libusb_control_transfer(libusb_dev
,
164 LIBUSB_REQUEST_TYPE_VENDOR
| \
166 USBBLASTER_CTRL_LOAD_FIRM
,
173 image_close(&ublast2_firmware_image
);
178 static int ublast2_libusb_init(struct ublast_lowlevel
*low
)
180 const uint16_t vids
[] = { low
->ublast_vid_uninit
, 0 };
181 const uint16_t pids
[] = { low
->ublast_pid_uninit
, 0 };
182 struct jtag_libusb_device_handle
*temp
;
183 bool renumeration
= false;
186 if (jtag_libusb_open(vids
, pids
, NULL
, &temp
) == ERROR_OK
) {
187 LOG_INFO("Altera USB-Blaster II (uninitialized) found");
188 LOG_INFO("Loading firmware...");
189 ret
= load_usb_blaster_firmware(temp
, low
);
190 jtag_libusb_close(temp
);
196 const uint16_t vids_renum
[] = { low
->ublast_vid
, 0 };
197 const uint16_t pids_renum
[] = { low
->ublast_pid
, 0 };
199 if (renumeration
== false) {
200 if (jtag_libusb_open(vids_renum
, pids_renum
, NULL
, &low
->libusb_dev
) != ERROR_OK
) {
201 LOG_ERROR("Altera USB-Blaster II not found");
206 while (jtag_libusb_open(vids_renum
, pids_renum
, NULL
, &low
->libusb_dev
) != ERROR_OK
&& retry
--) {
208 LOG_INFO("Waiting for renumerate...");
212 LOG_ERROR("Altera USB-Blaster II not found");
218 jtag_libusb_control_transfer(low
->libusb_dev
,
219 LIBUSB_REQUEST_TYPE_VENDOR
| \
221 USBBLASTER_CTRL_READ_REV
,
228 LOG_INFO("Altera USB-Blaster II found (Firm. rev. = %s)", buffer
);
233 static int ublast2_libusb_quit(struct ublast_lowlevel
*low
)
235 jtag_libusb_close(low
->libusb_dev
);
239 static struct ublast_lowlevel low
= {
240 .open
= ublast2_libusb_init
,
241 .close
= ublast2_libusb_quit
,
242 .read
= ublast2_libusb_read
,
243 .write
= ublast2_libusb_write
,
244 .flags
= COPY_TDO_BUFFER
,
247 struct ublast_lowlevel
*ublast2_register_libusb(void)
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)