This article shows how to use FTDI API to interact with the devices, which have FTDI chip within. The basic API set necessary for common operations is described. The article also touches upon topic of FTDI chips EEPROM programming.
What is FTDI chip?
How to find out if the device is FTDI-based?
How to interact with it?
FTDI API usage
Opening the virtual serial port
Setting up the port
Reading and Writing
FTDI chips are the chips which are developed by Future Technology Devices International (http://www.ftdichip.com/ ).
FTDI chips are used in USB adapters to connect to RS232 and parallel FIFO hardware interfaces. The most frequent usage is USB-2-COM interface.
They are used in:
- Mobile phone cables.
The mobile phones have RS232 or UART output, and PC may have USB only, the chip converts RS232 into USB. And the driver installed on PC creates the virtual device (usually, virtual COM port), which is used for communication.
- Service Boxes
These are service tools used by Phone repair centers and Car repair service. These are the devices which are connected to PC via USB, and - on the other side - to the various hardware.
- Hardware Debuggers (JTAG)
- Any other device that needs to be USB-connected to PC, and has the RS232 port on the other side.
Well, you may disassemble it and read the labels on the chips, but it’s not the way you want it. There’s more humane method.
There are original drivers on FTDI site. If you look at the files which are included into the driver package there will be such set of files:
So if your device has any of these files in the driver list it’s FTDI-based.
To see the drivers for the device:
- Go to Device Manager
- Select the device
- Open context menu and select Properties
- Switch to Driver and click Driver Details button.
This device has FTD2XX.dll in the driver files list. And the provided name is FTDI. This device is FTDI-based. Some manufacturers may rename the driver (.sys), but the copyright information will reveal the real driver manufacturer.
Fortunately, FTDI provides the API. There’s a generic API set which can be used with all FTDI chips.
API is provided via FTD2XX.dll. It’s a DLL which interacts with FTD2XX.SYS driver.
There’s a header file and library file within FTDI driver package: ftd2xx.h and ftd2xx.lib files.
The .lib file is COFF format, so it can be used in Visual Studio without any problem.
The API set has two interfaces “classical” (functions with
“FT_” prefix) and “Win32 API” (functions with
“Classical” is cross-platform interface.
“Win32 API” is a set of Windows-only functions. It’s much alike Windows API, which is used to work with serial ports. So porting the code to FTDI functions is quite simple.
The main functions are:
FT_W32_CreateFile() / FT_OpenEx()
Opens the handle to the specified FTDI chip connection
FT_W32_WriteFile() / FT_Write()
Sends data over virtual COM port.
FT_W32_ReadFile() / FT_Read()
Reads data from virtual COM port
FT_W32_CloseHandle() / FT_Close()
Closes connection handle.
There are functions that allow to set up the port:
Sets the baud rate for the connection
Sets the number of bits in the byte, parity, etc
Clears DTR signal on the virtual COM port
Sets DTR signal on the virtual COM port
Clears RTS signal on the virtual COM port
Sets RTS signal on the virtual COM port
For Windows there’s no limitation about using the functions of Classical and Win32 API interfaces together. So you may combine it.
There are multiple ways to open FTDI device: by index, by description, by serial number, by location. These types of information may be used to open the device via
To obtain the information about the connected devices
FT_ListDevices() should be used.
There are several functions, which can provide the additional information about the connected devices:
The code for setting the typical serial port settings to 115200 Bps, 8 bit per byte, 1 stop bit and no parity will look like this:
Also there are functions to setup the port in Windows style:
FT_W32_ReadFile() functions is similar to
ReadFile(). If the handle is opened in
OVERLAPPED mode, the functions are asynchronous, otherwise they are synchronous. So reading and writing can be made in standard way:
There are also APIs that allow to program FTDI chip. FTDI chip has EEPROM within it. EEPROM contains the chip settings block and the user area block. It’s possible to read and write both of these blocks.
Warning! Programming EEPROM is dangerous operation. Writing the invalid data may cause improper work of the device. You are doing it at your own risk.
The APIs to manage user area block:
Gets the size of User Area.
Write data to User Area.
Read User Area Data
Reading the area is quite simple:
The APIs to manage whole EEPROM:
Writes to EEPROM special structure (
FT_PROGRAM_DATA), which contains chip settings
Writes to EEPROM special structure (
FT_PROGRAM_DATA), which contains chip settings, but the USB String descriptors are passed separately from
Writes data to EEPROM directly.
FT_PROGRAM_DATA structure from EEPROM data.
FT_PROGRAM_DATA structure from EEPROM data and USB String descriptors are passed separately
Reads EEPROM data directly
Erases EEPROM contents
Dumping EEPROM is a bit tricky, because some chips have the internal EEPROM, and some may have external one.
The FT2232C supports 93C46 (64 x 16 bit), 93C56 (128 x 16 bit), and 93C66 (256 x 16 bit) EEPROMs.
So there can be various sizes.
Here’s the example of EEPROM dumping for 64 x 16 bit:
Here’s a second trick. If you look at the function declaration for
dwWordOffset argument is actually index of the word value in EEPROM, not the offset in the meaning of “data offset”.
Data in the settings block
The settings block contains VID and PID of USB device, so if it’s changed, the device will be treated like some other device. Default values of VID and PID for FTDI chip are 0x0403 and 0x6001 accordingly, but these values are overwritten by the device manufacturers.
The settings block contains the product description strings (USB String descriptors): Manufacturer, Manufacturer ID and Description. Also there’s device serial number, which can be changed by EEPROM programming.
Warning one more time! Changing the EEPROM setting may also cause the software failures if the invalid data is written to EEPROM.
Download sample FTDI source code.
The information about FTDI chips can be found in Data Sheets part of FTDI official site:
Additional information about API can be found in FTD2XX Programming Manual: