comparison doc/Shipped-EEPROM-configs @ 37:825d3303b886

doc/Shipped-EEPROM-configs: new article
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 10 Sep 2023 05:19:50 +0000
parents
children
comparison
equal deleted inserted replaced
36:3794ad47a97f 37:825d3303b886
1 There are a number of ready-made FTDI EEPROM config files shipped with
2 fc-usbser-tools package, intended to serve as inputs to ftee-gen* tools. This
3 article describes these shipped EEPROM configs.
4
5 duart28c and duart28s
6 =====================
7
8 FreeCalypso DUART28 is an FT2232D-based custom hardware adapter produced in
9 year 2020. There are two valid EEPROM configs for this adapter, named DUART28C
10 and DUART28S - see DUART28-EEPROM-config article for further details.
11
12 ft2232-example
13 ==============
14
15 This config file is an example EEPROM config for FT2232x chips, valid for both
16 FT2232C/D and FT2232H. It is intended to serve as a starting point for custom
17 FT2232x EEPROM configurations.
18
19 ft232r-example
20 ==============
21
22 This config file is an example EEPROM config for FT232R. It is intended to
23 serve as a starting point for custom FT232R EEPROM configs.
24
25 icestick
26 ========
27
28 Lattice iCEstick is a handy FPGA board with an FT2232H USB interface chip,
29 supporting SPI programming via MPSSE on Channel A and UART communication with
30 user logic via FT2232H Channel B. However, instead of programming this FT2232H
31 chip's EEPROM with a distinctive USB VID:PID which Linux kernel ftdi_sio driver
32 can recognize as a JTAG quirk, Lattice ships these boards with blank EEPROMs,
33 causing the usual well-known problems with unquirked ftdi_sio binding.
34
35 Our supplied EEPROM config named "icestick" is intended as the solution:
36 program it into the EEPROM on your iCEstick board, and the binding of ftdi_sio
37 driver becomes sensible, with a ttyUSB device created only for Channel B.
38
39 jtag-unbuf
40 ==========
41
42 This EEPROM config is meant for generic (non-specialized) FT2232D breakout
43 boards used as unbuffered JTAG adapters, as described in this old guide
44 from 2019:
45
46 https://www.freecalypso.org/hg/freecalypso-hwlab/file/tip/doc/Unbuffered-FT2232x-JTAG
47
48 mcu-host-bus
49 ============
50
51 This EEPROM config is meant for the same generic FT2232D breakout boards used
52 in MCU host bus emulation mode, which takes up both channels and leaves no UART.