Add OpenULINK firmware
[openocd.git] / src / jtag / drivers / OpenULINK / README
1 This is the OpenULINK firmware for the Keil ULINK JTAG adapter.
2
3 The main components of the Keil ULINK adapter are:
4 - Cypress EZ-USB microcontroller: enhanced 8051 CPU + USB core (1.1 Full-Speed)
5 - SRAM memory chip
6 - Level shifters to support different JTAG signal voltage levels
7 - Pin headers for various JTAG pin assignments
8
9 This firmware can only be run on the ORIGINAL Keil ULINK adapter, not on the
10 newer ULINK2, ULINK-ME or ULINK-PRO, as these adapters are based on different
11 hardware.
12
13 To compile the firmware, the SDCC compiler package is required. Most Linux
14 distributions include SDCC in their official package repositories. The SDCC
15 source code can be found at http://sdcc.sourceforge.net/
16 Simply type "make hex" in the OpenULINK directory to compile the firmware.
17 "make clean" will remove all generated files except the Intel HEX file required
18 for downloading the firmware to the ULINK adapter.
19
20 Note that the EZ-USB microcontroller does not have on-chip flash, nor does the
21 Keil ULINK include on-board memory to store the firmware program of the EZ-USB.
22 Instead, upon initial connection of the ULINK adapter to the host PC via USB,
23 the EZ-USB core has enough intelligence to act as a stand-alone USB device,
24 responding to USB control requests and allowing firmware download via a special
25 VENDOR-type control request. Then, the EZ-USB microcontroller simulates a
26 disconnect and re-connect to the USB bus. It may take up to two seconds for the
27 host to recognize the newly connected device before OpenOCD can proceed to
28 execute JTAG commands. This delay is only visible when OpenOCD first uses a
29 blank (unconfigured) ULINK device.
30
31 Once the user disconnects the ULINK adapter, all its memory contents are lost
32 and the firmware download process has to be executed again. This also maintains
33 compatibility with the original Keil uVision IDE, which will happily download
34 its own firmware image to a blank ULINK adapter.

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)