+
From Milkymist Wiki
+
+
+
[edit] ftdi library variants
+
This is the chip support library, you will need it for your tools.
+
There are currently 3 independent variants. You need to select one!
+
+
+
+| method
+ | comment
+ |
+
+| D2XX
+ | Binary drivers from [ftdichip.com]
+ |
+
+| libftdi
+ | Git repository at [libftdi] however this requires libboost to compile which pulls in a ton of additional code and is less portable than the method below.
+ |
+
+| libftdi-1.0
+ | Git repository at [libftdi-1.0] this is the preferred method, discussed in the next steps
+ |
+
+
+
[edit] 1. Build the libftdi-1.0
+
1.1. First, get a clone of the repository :
+
1.1.1. Create and go to a directory where you want to store the git projects
+
+
# mkdir ~/git
+ # cd ~/git
+
+
1.1.2. Clone the repository
+
+
# git clone git://developer.intra2net.com/libftdi-1.0
+ Cloning into libftdi-1.0...
+ remote: Counting objects: 2008, done.
+ remote: Compressing objects: 100% (942/942), done.
+ remote: Total 2008 (delta 1285), reused 1643 (delta 1056)
+ Receiving objects: 100% (2008/2008), 902.65 KiB | 449 KiB/s, done.
+ Resolving deltas: 100% (1285/1285), done.
+
+
It'l create a directory called libftdi-1.0 with some file in it.
+
1.2. Prepare to build with the autotools
+
1.2.1. Go to the directory of libftdi-1.0, you need some file
+
+
# ln -s /usr/share/libtool/config/config.guess
+ # ln -s /usr/share/libtool/config/config.sub
+ # ln -s /usr/share/libtool/config/install-sh
+ # ln -s /usr/share/libtool/config/ltmain.sh
+ # ln -s /usr/share/libtool/config/missing
+ # ln -s /usr/share/libtool/config/depcomp
+
+
1.2.2 Build the auto-conguration
+
+
# autoscan
+ # aclocal
+ # autoheader
+ # autoconf
+ # automake
+
+
1.3.1. Now, you can normally build and install the libftdi
+
+
# ./configure
+ ...
+
+
# make
+ ...
+
+
1.3.2. You need to be root for installing the lib
+
+
(root)# make install
+ ...
+
+
1.3.3. Quit root, and if there's no error, you can continue to build ftdi_eeprom, you maybe needs run
+
+
# ldconfig.
+
+
[edit] 2. Build the ftdi_eeprom tool
+
2.1. Go to the directory ftdi_eeprom
+
+
# cd ftdi_eeprom
+
+
2.2. Replace it in libftdi-1.0/ftdi_eeprom/main.c :
+
+
/***************************************************************************
+ main.c - description
+ -------------------
+ begin : Mon Apr 7 12:05:22 CEST 2003
+ copyright : (C) 2003,2008 by Intra2net AG
+ email : opensource@intra2net.com
+ ***************************************************************************/
+
+/***************************************************************************
+ * *
+ * This program is free software; you can redistribute it and/or modify *
+ * it under the terms of the GNU General Public License version 2 as *
+ * published by the Free Software Foundation. *
+ * *
+ ***************************************************************************/
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <string.h>
+
+#include <confuse.h>
+#include "../src/ftdi.h"
+#include "ftdi_eeprom_version.h.in"
+
+int str_to_cbus(char *str, int max_allowed)
+{
+ #define MAX_OPTION 14
+ const char* options[MAX_OPTION] = {
+ "TXDEN", "PWREN", "RXLED", "TXLED", "TXRXLED", "SLEEP",
+ "CLK48", "CLK24", "CLK12", "CLK6",
+ "IO_MODE", "BITBANG_WR", "BITBANG_RD", "SPECIAL"};
+ int i;
+ max_allowed += 1;
+ if (max_allowed > MAX_OPTION) max_allowed = MAX_OPTION;
+ for (i=0; i<max_allowed; i++) {
+ if (!(strcmp(options[i], str))) {
+ return i;
+ }
+ }
+ printf("WARNING: Invalid cbus option '%s'\n", str);
+ return 0;
+}
+
+int main(int argc, char *argv[])
+{
+ /*
+ configuration options
+ */
+ cfg_opt_t opts[] =
+ {
+ CFG_INT("vendor_id", 0, 0),
+ CFG_INT("product_id", 0, 0),
+ CFG_BOOL("self_powered", cfg_true, 0),
+ CFG_BOOL("remote_wakeup", cfg_true, 0),
+ CFG_STR_LIST("chip_type", "{AM,BM,2232C,R,2232H,4232H,other}", 0),
+ CFG_BOOL("in_is_isochronous", cfg_false, 0),
+ CFG_BOOL("out_is_isochronous", cfg_false, 0),
+ CFG_BOOL("suspend_pull_downs", cfg_false, 0),
+ CFG_BOOL("use_serial", cfg_false, 0),
+ CFG_BOOL("change_usb_version", cfg_false, 0),
+ CFG_INT("usb_version", 0, 0),
+ CFG_INT("max_power", 0, 0),
+ CFG_STR("manufacturer", "Acme Inc.", 0),
+ CFG_STR("product", "USB Serial Converter", 0),
+ CFG_STR("serial", "08-15", 0),
+ CFG_BOOL("high_current", cfg_false, 0),
+ CFG_STR_LIST("cbus0", "{TXDEN,PWREN,RXLED,TXLED,TXRXLED,SLEEP,CLK48,CLK24,CLK12,CLK6,IO_MODE,BITBANG_WR,BITBANG_D,SPECIAL}", 0),
+ CFG_STR_LIST("cbus1", "{TXDEN,PWREN,RXLED,TXLED,TXRXLED,SLEEP,CLK48,CLK24,CLK12,CLK6,IO_MODE,BITBANG_WR,BITBANG_D,SPECIAL}", 0),
+ CFG_STR_LIST("cbus2", "{TXDEN,PWREN,RXLED,TXLED,TXRXLED,SLEEP,CLK48,CLK24,CLK12,CLK6,IO_MODE,BITBANG_WR,BITBANG_D,SPECIAL}", 0),
+ CFG_STR_LIST("cbus3", "{TXDEN,PWREN,RXLED,TXLED,TXRXLED,SLEEP,CLK48,CLK24,CLK12,CLK6,IO_MODE,BITBANG_WR,BITBANG_D,SPECIAL}", 0),
+ CFG_STR_LIST("cbus4", "{TXDEN,PWRON,RXLED,TXLED,TX_RX_LED,SLEEP,CLK48,CLK24,CLK12,CLK6}", 0),
+ CFG_BOOL("invert_txd", cfg_false, 0),
+ CFG_BOOL("invert_rxd", cfg_false, 0),
+ CFG_BOOL("invert_rts", cfg_false, 0),
+ CFG_BOOL("invert_cts", cfg_false, 0),
+ CFG_BOOL("invert_dtr", cfg_false, 0),
+ CFG_BOOL("invert_dsr", cfg_false, 0),
+ CFG_BOOL("invert_dcd", cfg_false, 0),
+ CFG_BOOL("invert_ri", cfg_false, 0),
+ CFG_END()
+ };
+ cfg_t *cfg;
+
+ /*
+ normal variables
+ */
+ unsigned char _read = 0, _erase = 0, _flash = 0;
+ int size_check;
+ int i;
+ char * type;
+ unsigned int invert;
+ FILE * fp;
+ unsigned short device_vid = 0;
+ unsigned short device_pid = 0;
+ FILE * device;
+ struct ftdi_context ftdi;
+ struct ftdi_eeprom *eeprom;
+
+ printf("\nFTDI eeprom generator v%s\n", EEPROM_VERSION_STRING);
+ printf ("(c) Intra2net AG <opensource@intra2net.com>\n");
+
+ if (argc < 3)
+ {
+ printf("Syntax sample :\n");
+ printf(" %s --read-eeprom /dev/bus/usb/002/003 ftdi-backup.conf\n", argv[0]);
+ printf(" %s --erase-eeprom /dev/bus/usb/002/003\n", argv[0]);
+ printf(" %s --flash-eeprom /dev/bus/usb/002/003 ftdi-source.conf\n", argv[0]);
+ exit (-1);
+ }
+ else
+ {
+ if (strcmp(argv[1], "--read-eeprom") == 0)
+ _read = 1;
+ else if (strcmp(argv[1], "--erase-eeprom") == 0)
+ _erase = 1;
+ else if (strcmp(argv[1], "--flash-eeprom") == 0)
+ _flash = 1;
+ }
+
+ ftdi_init(&ftdi);
+ ftdi_eeprom_initdefaults (&ftdi, "Acme Inc.", "FTDI Chip", NULL);
+ eeprom = ftdi.eeprom;
+
+ if ((device = fopen(argv[2], "r")) == NULL)
+ {
+ printf ("Can't open device file\n");
+ exit (-1);
+ }
+
+ fseek(device, 8, SEEK_SET);
+ fread(&device_vid, 1, 2, device);
+ fread(&device_pid, 1, 2, device);
+
+ fclose(device);
+
+ printf("\nFound device with VID:PID : 0x%X:0x%X\n", device_vid, device_pid);
+
+ i = ftdi_usb_open(&ftdi, device_vid, device_pid);
+
+ if (i == 0)
+ {
+ printf("EEPROM size: %d\n", eeprom->size);
+ }
+ else
+ {
+ printf("Unable to find FTDI devices under given vendor/product id: 0x%X/0x%X\n", device_vid, device_pid);
+ printf("Error code: %d (%s)\n", i, ftdi_get_error_string(&ftdi));
+ exit (-1);
+ }
+
+
+ if (_read)
+ {
+ printf("FTDI read eeprom: %d\n", ftdi_read_eeprom(&ftdi));
+
+ ftdi_eeprom_decode(&ftdi, 0);
+
+ const char* chip_types[] = {"other", "", "AM", "", "BM", "2232C", "R", "2232H", "4232H"};
+
+ FILE *fp = fopen (argv[3], "wb");
+/*
+To implement
+ CFG_BOOL("high_current", cfg_false, 0),
+ CFG_STR_LIST("cbus0", "{TXDEN,PWREN,RXLED,TXLED,TXRXLED,SLEEP,CLK48,CLK24,CLK12,CLK6,IO_MODE,BITBANG_WR,BITBANG_D,SPECIAL}", 0),
+ CFG_STR_LIST("cbus1", "{TXDEN,PWREN,RXLED,TXLED,TXRXLED,SLEEP,CLK48,CLK24,CLK12,CLK6,IO_MODE,BITBANG_WR,BITBANG_D,SPECIAL}", 0),
+ CFG_STR_LIST("cbus2", "{TXDEN,PWREN,RXLED,TXLED,TXRXLED,SLEEP,CLK48,CLK24,CLK12,CLK6,IO_MODE,BITBANG_WR,BITBANG_D,SPECIAL}", 0),
+ CFG_STR_LIST("cbus3", "{TXDEN,PWREN,RXLED,TXLED,TXRXLED,SLEEP,CLK48,CLK24,CLK12,CLK6,IO_MODE,BITBANG_WR,BITBANG_D,SPECIAL}", 0),
+ CFG_STR_LIST("cbus4", "{TXDEN,PWRON,RXLED,TXLED,TX_RX_LED,SLEEP,CLK48,CLK24,CLK12,CLK6}", 0),
+ CFG_BOOL("invert_txd", cfg_false, 0),
+ CFG_BOOL("invert_rxd", cfg_false, 0),
+ CFG_BOOL("invert_rts", cfg_false, 0),
+ CFG_BOOL("invert_cts", cfg_false, 0),
+ CFG_BOOL("invert_dtr", cfg_false, 0),
+ CFG_BOOL("invert_dsr", cfg_false, 0),
+ CFG_BOOL("invert_dcd", cfg_false, 0),
+ CFG_BOOL("invert_ri", cfg_false, 0),
+*/
+ fprintf(fp, "vendor_id=0x%04x\n", eeprom->vendor_id);
+ fprintf(fp, "product_id=0x%04x\n", eeprom->product_id);
+ fprintf(fp, "self_powered=%s\n", eeprom->self_powered?"true":"false");
+ fprintf(fp, "remote_wakeup=%s\n", eeprom->remote_wakeup?"true":"false");
+ fprintf(fp, "chip_type=%s\n", chip_types[ftdi.type]);
+ fprintf(fp, "max_power=%d\n", eeprom->max_power);
+ fprintf(fp, "in_is_isochronous=%s\n", eeprom->in_is_isochronous?"true":"false");
+ fprintf(fp, "out_is_isochronous=%s\n", eeprom->out_is_isochronous?"true":"false");
+ fprintf(fp, "suspend_pull_downs=%s\n", eeprom->suspend_pull_downs?"true":"false");
+ fprintf(fp, "use_serial=%s\n", eeprom->use_serial?"true":"false");
+ fprintf(fp, "change_usb_version=%s\n", eeprom->use_usb_version?"true":"false");
+ fprintf(fp, "usb_version=%d\n", eeprom->usb_version);
+ fprintf(fp, "manufacturer=\"%s\"\n", eeprom->manufacturer);
+ fprintf(fp, "product=\"%s\"\n", eeprom->product);
+ fprintf(fp, "serial=\"%s\"\n", eeprom->serial);
+
+ fclose (fp);
+
+ goto cleanup;
+ }
+ else if (_erase)
+ {
+ printf("FTDI erase eeprom: %d\n", ftdi_erase_eeprom(&ftdi));
+ }
+ else if (_flash)
+ {
+ if ((fp = fopen(argv[3], "r")) == NULL)
+ {
+ printf ("Can't open configuration file\n");
+ exit (-1);
+ }
+ fclose (fp);
+
+ cfg = cfg_init(opts, 0);
+ cfg_parse(cfg, argv[3]);
+
+ if (cfg_getbool(cfg, "self_powered") && cfg_getint(cfg, "max_power") > 0)
+ printf("Hint: Self powered devices should have a max_power setting of 0.\n");
+
+ eeprom->vendor_id = cfg_getint(cfg, "vendor_id");
+ eeprom->product_id = cfg_getint(cfg, "product_id");
+
+ type = cfg_getstr(cfg, "chip_type");
+ if (!strcmp(type, "AM")) {
+ ftdi.type = TYPE_AM;
+ } else if (!strcmp(type, "BM")) {
+ ftdi.type = TYPE_BM;
+ } else if (!strcmp(type, "2232C")) {
+ ftdi.type = TYPE_2232C;
+ } else if (!strcmp(type, "R")) {
+ ftdi.type = TYPE_R;
+ } else if (!strcmp(type, "2232H")) {
+ ftdi.type = TYPE_2232H;
+ } else if (!strcmp(type, "4232H")) {
+ ftdi.type = TYPE_4232H;
+ }
+
+ eeprom->self_powered = cfg_getbool(cfg, "self_powered");
+ eeprom->remote_wakeup = cfg_getbool(cfg, "remote_wakeup");
+ eeprom->max_power = cfg_getint(cfg, "max_power");
+ eeprom->in_is_isochronous = cfg_getbool(cfg, "in_is_isochronous");
+ eeprom->out_is_isochronous = cfg_getbool(cfg, "out_is_isochronous");
+ eeprom->suspend_pull_downs = cfg_getbool(cfg, "suspend_pull_downs");
+ eeprom->use_serial = cfg_getbool(cfg, "use_serial") == 0 ? 0 : USE_SERIAL_NUM;
+ eeprom->use_usb_version = cfg_getbool(cfg, "change_usb_version");
+ eeprom->usb_version = cfg_getint(cfg, "usb_version");
+ eeprom->manufacturer = cfg_getstr(cfg, "manufacturer");
+ eeprom->product = cfg_getstr(cfg, "product");
+ eeprom->serial = cfg_getstr(cfg, "serial");
+ eeprom->high_current = cfg_getbool(cfg, "high_current");
+ eeprom->cbus_function[0] = str_to_cbus(cfg_getstr(cfg, "cbus0"), 13);
+ eeprom->cbus_function[1] = str_to_cbus(cfg_getstr(cfg, "cbus1"), 13);
+ eeprom->cbus_function[2] = str_to_cbus(cfg_getstr(cfg, "cbus2"), 13);
+ eeprom->cbus_function[3] = str_to_cbus(cfg_getstr(cfg, "cbus3"), 13);
+ eeprom->cbus_function[4] = str_to_cbus(cfg_getstr(cfg, "cbus4"), 9);
+
+ invert = 0;
+ if (cfg_getbool(cfg, "invert_rxd")) invert |= INVERT_RXD;
+ if (cfg_getbool(cfg, "invert_txd")) invert |= INVERT_TXD;
+ if (cfg_getbool(cfg, "invert_rts")) invert |= INVERT_RTS;
+ if (cfg_getbool(cfg, "invert_cts")) invert |= INVERT_CTS;
+ if (cfg_getbool(cfg, "invert_dtr")) invert |= INVERT_DTR;
+ if (cfg_getbool(cfg, "invert_dsr")) invert |= INVERT_DSR;
+ if (cfg_getbool(cfg, "invert_dcd")) invert |= INVERT_DCD;
+ if (cfg_getbool(cfg, "invert_ri")) invert |= INVERT_RI;
+ eeprom->invert = invert;
+
+ size_check = ftdi_eeprom_build(&ftdi);
+
+ if (size_check == -1)
+ {
+ printf ("Sorry, the eeprom can only contain 128 bytes (100 bytes for your strings).\n");
+ printf ("You need to short your string by: %d bytes\n", size_check);
+ goto cleanup;
+ } else if (size_check < 0) {
+ printf ("ftdi_eeprom_build(): error: %d\n", size_check);
+ }
+ else
+ {
+ printf ("Used eeprom space: %d bytes\n", 128-size_check);
+ }
+
+ printf ("FTDI write eeprom: %d\n", ftdi_write_eeprom(&ftdi));
+
+ cfg_free(cfg);
+ }
+
+cleanup:
+/*
+fp = fopen("eeprom.img", "w");
+fwrite(eeprom->buf, 1, 128, fp);
+fclose (fp);
+*/
+ printf("FTDI close: %d\n", ftdi_usb_close(&ftdi));
+
+ ftdi_deinit (&ftdi);
+
+ printf("\n");
+
+ return 0;
+}
+
+
2.3. Compile the source
+
+
# gcc main.c -I/usr/include/libusb-1.0/ -lconfuse -L/usr/local/lib/ -lftdi -o ftdi_eeprom
+
+
+That's all.
+
+
+
+
+
+
+
+
+
