aboutsummaryrefslogtreecommitdiff
path: root/tcl
diff options
context:
space:
mode:
authorTim 'mithro' Ansell <mithro@mithis.com>2015-09-27 20:33:59 +1000
committerPaul Fertser <fercerpav@gmail.com>2015-10-21 09:10:56 +0100
commit561cd67cff90522ad85589ffd4e626dd0295d28b (patch)
tree3973413f9ae69eed7e9775ca9cd13caf11a055b4 /tcl
parentd52070c8552617b8631f80c117f43686f76e7c52 (diff)
downloadriscv-openocd-561cd67cff90522ad85589ffd4e626dd0295d28b.zip
riscv-openocd-561cd67cff90522ad85589ffd4e626dd0295d28b.tar.gz
riscv-openocd-561cd67cff90522ad85589ffd4e626dd0295d28b.tar.bz2
tcl: Setting lowlevel driver for ixo-usb-jtag
Also add further documentation about the project and how to use it. Change-Id: Ia9878de566b3c8c1ea29f129287d5aea904d861d Signed-off-by: Tim 'mithro' Ansell <mithro@mithis.com> Reviewed-on: http://openocd.zylin.com/2961 Tested-by: jenkins Reviewed-by: Paul Fertser <fercerpav@gmail.com>
Diffstat (limited to 'tcl')
-rw-r--r--tcl/interface/usb-jtag.cfg34
1 files changed, 31 insertions, 3 deletions
diff --git a/tcl/interface/usb-jtag.cfg b/tcl/interface/usb-jtag.cfg
index f0164ca..15274d5 100644
--- a/tcl/interface/usb-jtag.cfg
+++ b/tcl/interface/usb-jtag.cfg
@@ -1,9 +1,37 @@
+# ixo-usb-jtag - Emulation of a Altera Bus Blaster I on a Cypress FX2 IC.
#
-# Kolja Waschk's USB-JTAG
+# The ixo-usb-jtag firmware can be loaded onto a bunch of different hardware
+# including;
+# * Xilinx USB Platform Cable
+# * Many Digilent boards such as the Nexys, Nexys 2 and Atlys boards
+# * Many fpga4fun.com boards from such as the Saxo and Xylo boards
+# * The Numato Opsis
#
-# http://www.ixo.de/info/usb_jtag/
+# Original version - http://www.ixo.de/info/usb_jtag/
+# Updated version - http://ixo-jtag.sourceforge.net/
+# Newest version - http://github.com/mithro/ixo-usb-jtag
#
+# Procedure for using is;
+# * Get the ixo-usb-jtag firmware for your hardware (or build it yourself).
+# * Load the firmware using the fxload tool.
+# * Use openocd.
+#
+# Unless you burn the firmware into the EEPROM on your device, power cycling
+# will require you to reload the firmware using the fxload tool. This can be
+# automated by using udev rules (which can be found in the firmware
+# repository).
+#
+# Ubuntu packages built from mithro's version (with prebuilt firmware and udev
+# rules) can be found at
+# https://launchpad.net/~timvideos/+archive/ubuntu/fpga-support
+#
+# TODO: Refactor the usb_blaster driver to allow loading firmware using any low
+# level driver. Loading firmware is currently only supported on the ublast2
+# driver but ixo-usb-jtag requires the ftdi or ftd2xx driver.
interface usb_blaster
usb_blaster_vid_pid 0x16C0 0x06AD
-usb_blaster_device_desc "USB-JTAG-IF"
+usb_blaster_device_desc "Van Ooijen Technische Informatica"
+# ixo-usb-jtag is only compatible with the ublast1 protocol implemented via the
+# ftdi or ftd2xx modes, using ublast2 will cause openocd to hang.
+usb_blaster_lowlevel_driver ftdi