Skip to the content
4 layers44 × 64 mmJTAGProgrammer, the printed circuit board in 3D

FTDI-based JTAG Programmer Circuit for FPGAs

Size
44 × 64 mm
Copper layers
4
Thickness
1.6 mm
Parts
122
Nets
93
Pads
365
Tracks, vias
791, 123
Pours
6
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
6 Oct 2024
Updated
3 Jun 2025

Overview

JTAGProgrammer is an open-source printed circuit board by anthony-bernaert, from the anthony-bernaert/ftdi-jtag-programmer repository on GitHub, published under the CERN-OHL-P-2.0 licence. It is a 4-layer board of 44 × 64 mm with 122 parts on 93 nets, routed with 791 tracks and 123 vias.

It is built around the 74LVC3G17DP, 93LC56B and FT2232HL, with the LP2985-25DBV, LP2985-33DBV and PGB1010603MR among its other parts. Its parts include 33 capacitors, 28 resistors, 20 diodes, 8 ICs and 5 connectors. It belongs with the interfaces and adapters and fPGA and programmable logic boards and the FPGA and CPLD boards of this library.

Main components

10

README

README.md

FTDI-based JTAG Programmer for FPGAs

This JTAG programmer board is based on an FTDI chip and supports Lattice, AMD (Xilinx), Intel (Altera) FPGAs, and probably more. It allows those devices to be programmed and debugged over USB through their regular toolchains.

The board also provides a separate UART port for general-purpose serial communication between a PC application and any other board.

If you work with a lot of different FPGAs, this solution can be used as a universal, cost-effective replacement for most of your vendor-specific JTAG cables.

Features

  • Based on the FT2232H chip
  • USB-C connector
  • On-board resettable fuse to protect your host's USB port
  • 1 JTAG port
    • Programs and debugs Lattice, AMD/Xilinx, Altera/Intel, and probably also other FPGAs through their respective toolchains
    • Standard 2 mm Xilinx 2x7 header connector
    • Also has a 6-pin 2.54 mm header for use with jumper wires
    • Voltage reference input pin configures the I/O voltage (2.5-5V)
    • An LED indicates presence of an external VREF voltage
  • 1 UART port
    • Generic serial communication through virtual COM port
    • 6-pin 2.54 mm header, pinout compatible with FTDI's TTL-232R cables
    • Configurable 5V output or voltage reference input (2.5-5V) (*)
    • An LED indicates presence of an external VREF voltage
  • Buffered I/O pins with surge protection
    • Outputs are current-limited
    • Inputs are 5V tolerant
  • For Xilinx/AMD and Lattice, only the standard FTDI software drivers are needed

(*) These are mounting variations, so to be decided during PCB assembly.

Build overview

This board was designed using KiCad 7.0.2.

Navigate to the releases section to obtain the latest production files and schematic. The BOM contains references to LCSC parts, so that you can easily order PCB assemblies at e.g. JLCPCB.

Files for 3D printing an optional enclosure are also provided. The enclosure is recommended to prevent accidental shorts during use.

It consists of a top and bottom part, which slide in horizontally; no screws or glue are necessary. For resilience and visibility of the LEDs, it is recommended to print it in a translucent PETG material.

How to use

First-time configuration

Install FTDI's VCP/D2XX drivers for your operating system from their website.

Also install FT_PROG. This utility will be used to initialize the EEPROM of the board with the correct settings.

Now you can choose to either initialize the EEPROM using FT_PROG or directly flash the device using an existing EEPROM dump.

[!TIP] The most versatile solution is to flash the EEPROM with the Digilent SMT1 dump. The programmer then works simultaneously for Vivado, ISE, Diamond and Quartus (details in the Xilinx ISE section).

However, for the very first startup of your board, please try to write the following settings using the FT_PROG utility. This way, you can make sure that your hardware and drivers are working properly.

When FT_PROG is installed, connect the board to your PC. At this point, the green PWREN LED should be on: this means the PC has enumerated the device. If this is not the case, see the Troubleshooting Guide.

In FT_PROG, scan and parse the connected devices. Configure your board as follows:

  • Port A
    • Set the hardware mode to "245 FIFO"
    • Set the driver to D2XX Direct
  • Port B
    • Set the hardware mode to "RS232 UART"
    • Set the driver to Virtual COM Port

Finally, program this configuration into the EEPROM. Depending on the vendor of the FPGA you want to program, a few additional steps might be needed. These are described below.

Lattice

To use the programmer with Lattice devices, just open the programming software such as Diamond Programmer and select the 'HW-USBN-2B (FTDI)' option as the cable type.

Diamond programmer can use any FTDI device configured in D2XX mode. No additional configuration is needed.

image

[!NOTE] This programmer is known to work with Diamond Programmer software - other tools, such as Radiant Programmer, have not been tested yet.

AMD/Xilinx Vivado

For AMD/Xilinx tools, the software looks for a Xilinx signature in the FTDI device EEPROM. Once this is done, the programmer appears as any other official programming cable in Vivado Hardware Manager. To add the signature, you have two options: either write a recognized EEPROM dump to the device (recommended), or use AMD's program_ftdi utility.

The recommended way is to use the Digilent SMT1 dump; refer to the Xilinx ISE section on how to do this.

If you really want to do it AMD's way: recent Vivado versions (starting from 2022) contain the program_ftdi tool that configures FTDI chips as AMD/Xilinx JTAG programmers. Running this utility (once) will make the programmer work with Vivado. You can execute it from the TCL console, e.g. in the Hardware Manager of Vivado. Run a command similar to this one:

text
program_ftdi -write -ftdi FT2232H -serial 0ABC01 -vendor "my vendor co" -board "my board" -desc "my product desc"

Note that the 'serial' parameter must match the serial number generated by FT_PROG. After programming, the programmer should show up in the Hardware Manager of Vivado.

image

[!WARNING] Unfortunately, it seems that the program_ftdi is broken in Vivado 2024.1. If you see it complaining about missing DLLs while trying to program, try using an older version of Vivado, e.g. 2023.2, which is known to work.

Xilinx ISE

To use this programmer with Xilinx' older ISE toolchain, you'll need to flash the EEPROM to mimick a legacy Digilent SMT1 device. You will find the required EEPROM dump on dragonlock2's ftdi_dumps repository. Afterwards, the device appears as a Digilent SMT1 device in the cable setup window.

Note that this dump has the advantage that you can make the programmer work simultaneously for Vivado, ISE, Diamond and Quartus, turning your programmer in an (at least) 4-in-1 solution!

[!TIP] Writing the EEPROM configuration can be done using the (Linux) utility ftdi_eeprom or my own FTDI EEPROM cloning tool.

Once the EEPROM is programmed, the cable appears as a Digilent USB JTAG cable:

image

Altera/Intel

For Quartus software to work with FT2232HL devices, one option is to add a library file to your Quartus installation directory. You'll find a ready-made DLL (if you're on Windows) here. This is a fork of an open-source solution that adds FTDI MPSSE support to Quartus Programmer/Signal Tap. Linux is also supported, though I did not test this.

After installing the .dll/.so file, the JTAG programmer board should show up in the available hardware list of Quartus and your FPGA is ready to be programmed:

If you don't like modifying your Quartus installation manually, an alternative solution is to configure the USB device as an 'Arrow USB Blaster'. You will find the required EEPROM dump on dragonlock2's ftdi_dumps repository.

[!TIP] Writing the EEPROM configuration can be done using the (Linux) utility ftdi_eeprom or my own FTDI EEPROM cloning tool.

In this case, you also need to install the Arrow USB Blaster driver. After this, your FTDI programmer should appear in the hardware list of Quartus Programmer and your FPGA is ready to be programmed.

image

Troubleshooting

If you experience problems while using this board, check out the Troubleshooting Guide.

Parts

122
QtyValueFootprintReferences
20100nCapacitor_SMD:C_0603_1608MetricC2, C10, C12, C13, C16, C17, C18, C19, C20, C21, C22, C23, C24, C25, C26, C28 +4
16TestPointTestPoint:TestPoint_Pad_D1.0mmTP1, TP2, TP3, TP4, TP5, TP6, TP7, TP8, TP9, TP10, TP11, TP12, TP13, TP14, TP15, TP16
11PGB1010603MRPGB1010603MR:DIOC1608X36ND1, D2, D6, D7, D8, D9, D10, D11, D12, D13, D14
9150RResistor_SMD:R_0603_1608MetricR10, R11, R12, R13, R14, R15, R19, R20, R21
84.7uCapacitor_SMD:C_1206_3216MetricC1, C4, C8, C9, C11, C29, C32, C33
710KResistor_SMD:R_0603_1608MetricR5, R7, R16, R17, R18, R27, R28
6CUS520,H3FDiode_SMD:D_SOD-323D4, D5, D15, D16, D17, D18
474LVC3G17Package_SO:VSSOP-8_3.0x3.0mm_P0.65mmU4, U5, U6, U7
4MountingHoleMountingHole:MountingHole_3.2mm_M3H1, H2, H3, H4
3100RResistor_SMD:R_0603_1608MetricR9, R25, R26
310nCapacitor_SMD:C_0603_1608MetricC3, C6, C27
3BLM18AG601SN1DInductor_SMD:L_0603_1608MetricFB1, FB2, FB3
3LEDLED_SMD:LED_0603_1608MetricD3, D19, D20
20RResistor_SMD:R_0603_1608MetricR1, R22
210RResistor_SMD:R_0603_1608MetricR2, R3
210pCapacitor_SMD:C_0603_1608MetricC14, C15
25K1Resistor_SMD:R_0603_1608MetricR23, R24
2BSS123Package_TO_SOT_SMD:SOT-23Q1, Q2
2Conn_01x06Connector_PinSocket_2.54mm:PinSocket_1x06_P2.54mm_VerticalJ3, J4
10805L075SLYRFuse:Fuse_0805_2012MetricF1
112KResistor_SMD:R_0603_1608MetricR6
115KResistor_SMD:R_0603_1608MetricR4
12.2KResistor_SMD:R_0603_1608MetricR8
1878325623878325623:CONN_87832-5623_MOLJ2
193LC56BPackage_TO_SOT_SMD:SOT-23-6U3
1Conn_01x03Connector_PinSocket_2.54mm:PinSocket_1x03_P2.54mm_VerticalJ5
1FT2232HLPackage_QFP:LQFP-64_10x10mm_P0.5mmU2
1LP2985-2.5Package_TO_SOT_SMD:SOT-23-5U8
1LP2985-3.3Package_TO_SOT_SMD:SOT-23-5U1
1RH100-12.000-10-3030-TRCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
1USB_C_Receptacle_USB2.0Connector_USB:USB_C_Receptacle_GCT_USB4105-xx-A_16P_TopMnt_HorizontalJ6

The 121 most common of 122 parts.

Similar boards

  • 4 layers65 × 56.5 mmTangnano9k kr260-hat, the printed circuit board in 3D

    Tangnano9k kr260-hat

    calperxd/tangnano9k-kr260-hat

    FPGA HAT for the AMD Kria KR260 based on the Tang Nano 9K (Gowin GW1NR-9, FT2232H, 16-bit parallel link on J21): KiCad 10 schematic, 4-layer PCB and JLCPCB production files

    181 parts1
  • 2 layers100 × 100 mmExplorer, the printed circuit board in 3D

    Explorer

    anyshake/explorer

    🌏 Detecting seismic wave using 3 geophones and 3-axis accelerometer, pack & send data to AnyShake Observer over RS232 / RS485 serial.

    266 parts100
  • 12 layers55 × 40 mmArvsom, the printed circuit board in 3D

    Arvsom

    antmicro/arvsom

    System on Module based on StarFive 71x0 SoC.

    452 parts46Apache-2.0
  • 2 layers68.6 × 53.3 mmGowinduino, the printed circuit board in 3D

    Gowinduino

    SushiBits/Gowinduino

    Arduino-compatible evaluation board with Gowin GW1NSR-4C FPGA

    86 parts8
  • 4 layers140 × 140 mmFpgaboard, the printed circuit board in 3D

    Fpgaboard

    msinger/gbreveng

    Stuff for Gameboy reverse engineering and some documentation

    342 parts6
  • 2 layers65 × 56 mmRadioberry juice, the printed circuit board in 3D

    Radioberry juice

    pa3gsb/Radioberry-2.x

    Ham Radio hat for Raspberry PI

    87 parts678
  • 4 layers115 × 85 mmDual adc usb, the printed circuit board in 3D

    Dual adc usb

    devbisme/ai-circuit-design-tests

    Tests of KiCad-related AI tools.

    175 parts10
  • 2 layers51 × 20 mmJtag to usb, the printed circuit board in 3D

    Jtag to usb

    zeodotdev/zeo-boards

    ESP32-S3 development board with onboard BME280 (temperature, humidity, pressure) and LSM6DS3 (6-axis IMU) sensors. This repo contains the designs, ESP-IDF firmware, and a Python plotter for visualization.

    27 parts3

Questions

How big is the JTAGProgrammer PCB?

It measures 44 × 64 mm and has 4 copper layers, 1.6 mm thick.

What parts does the JTAGProgrammer use?

122 parts, built around the 74LVC3G17DP, 93LC56B, FT2232HL and LP2985-25DBV. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the JTAGProgrammer KiCad files?

From the anthony-bernaert/ftdi-jtag-programmer repository on GitHub, at the commit this page was made from: the board is JTAGProgrammer/JTAGProgrammer.kicad_pcb and its schematic JTAGProgrammer/FTDI.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the JTAGProgrammer design in my own project?

Its repository publishes it under the CERN-OHL-P-2.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).