ColorLight_FPGA_boards

IceStudio already supports ColorLight 5A-75X, i5 and ICeSugar Pro FPGA boards in in Windows, Mac and Linux versions.

New supported boards in IceStudio and Apio

Colorlight 5A-75B
Colorlight 5A-75F
Colorlight i5
IceSugar Pro

Below you can see the new boards added and the supported versions. In parenthesis you can see the acepted programmers for each board. If there is not a JTAG programmer in parenthesis, the default JTAG programmer is FT2232H.

There is another utility for ColorLight i5 and iCESugar-Pro called ECPDAP added in the toolchain, but that program is too slow to program the board. Other JTAG programmer as STM32 with the DirtyJTAG firmware has the same problem. It is recommendable to use an external JTAG programmer as FT2232, FT232H or USB-Blaster to program these boards.

NOTE: At 7/15/2021 the las update of the toolchain-ecp5 of the FPGAWArs groups already has support to the ColorLight and IceSugar Pro boards in Windows, Mac and Linux versions of Icestudio, consequently we don't need to add any file to get this support

JTAG Programmers

Because the Colorlight 5A-75B and 5A-75E not include a JTAG programmer, you will need an external JTAG programmer In case of Colorlight i5 or ICeSugar Pro use a STM32 based programmer that is too slow (It spends more than 1 minute), so it is recomended to use an external JTAG programmer too

The recommended JTAG programmers are:

FT2232H from here --> https://www.aliexpress.com/item/1005002448969402.html
FT232H from here --> https://www.aliexpress.com/item/33052982174.html
USB-Blaster from here --> https://www.aliexpress.us/item/3256802725775256.html

I have a FT2232H programmer as the first recommended option:

Because I use the same programmer in other Xilinx Boards I have applied a mod to this programmer (If you only are going to use for Lattice ECP5 board you don't need to do it) The mod is based in change the content of its EPROM , here you have the instructions --> https://gist.github.com/rikka0w0/24b58b54473227502fa0334bbe75c3c1

if you acquire the FT232H the mod to convert in Digilent HS2 Cable compatible with Vivado is --> https://github.com/erd0spy/ft232h_to_digilent_fpga_programmer And here you have the other possible configurations for the FT232H board, as a STM1 for example --> https://github.com/vanbwodonk/ft2232hl-jtag-clone/tree/main/eeprom_binary

Install LibUSBK to work in Windows (Linux user don't need this part)

Working in windows you have to install the LibUSBk driver to get the programmer be recognized by the programmer software included in Apio

In the same way of other boards in IceStudio, you can use Zadig to install the LibUsbK driver if you want to use the programmer in IceStudio/Apio.

If you applied the mod of the EPROM in your ft2232H board and you install the Xilinx Drivers, in Zadig you will be the FT2232H board as Digilent Adept USB Device (Interface 0) and you can install the driver libUsbK

You have more information how to use ZADIG in this link --> https://github.com/foss-for-synopsys-dwc-arc-processors/arc_gnu_eclipse/wiki/How-to-Use-OpenOCD-on-Windows

But in my case, because I use the board for Lattice ECP5 and for Xilinx boards in ISE/Vivado, I don't use Zadig to install the LibUsbK driver because the FT2232H programmer will not work with Xilinx IDE. So, to recover easily the original driver that works in Xilinx, I use an alternative method. First, I install the Xilinx driver of the FT2232H board after modifying the EPROM and later I use the alternative method to modify the driver.

How to install and change the LibUSbK driver (Alternative Method to Zadig. It allows recover the driver easily)

I use the utility USB Driver Tool, you can download from https://visualgdb.com/UsbDriverTool/ The last version is here --> https://sysprogs.com/getfile/1372/UsbDriverTool-2.1.exe In case you use the FT2232H JTAG programmer, you will see the "USB Serial Converter A" with VID 0403 and VPI 6010. With FT232H is similar and with USB-Blaster you will see "Altera USB Blaster"

So, You have to press right mouse button over it and select " Install Libusb-WinUSB"

You will see in the line of "USB Srial Converter A" in parenthesis Libusb-WinUSB. Now, You have the drivers already installed

If you want to revert the original driver of the FT2232H in order to use with Xilinx ISE or Vivado IDE , you only has to press right button over "USB Serial Converter A" again and select "Restore default driver", the driver will be restored to the original.

And you will see the original state with the device name without nothing in parenthesis . Now the board has recovered the original Xilinx sriver and I can use it in ISE and Vivado Xilinx IDEs

In this way you can use the FT2232H JTAG programmer with any board
The way to install the driver is equivalent for FT232H or USB-Blaster programmers

Connections for FT2232H

Here you have the JTAG connections of the FT2232H board to program the board. Note: It is not necessary connect the VCC connector. Do not forget to connect the GND to the board

ADBUS0 --> TCLK
ADBUS1 --> TDI
ADBUS2 --> TDO
ADBUS3 --> TMS

If you apply the MOD of the EPROM, you will have an USB-UART converter in the Second port "USB Serial Converter B" and you can use as a traditional USB-UART convertor