This document describes how to install and run XXICC on your computer, either by compiling XXICC source code or installing binaries.
This is revision 0.1, which is almost identical to 0.0q. Current users don't need to do anything differently.
install01.pdf has instructions for installing XXICC for all versions (GNU/Linux and Windows) and for all purposes. This means finding all the steps you need for a particular platform can be a little involved. Here are the specific steps for installing XXICC and Flavia on a 32-bit GNU/Linux machine that uses an FTDI FT2232H or FT232H USB serial IC as a JTAG controller.
- Create a directory for XXICC. You can call it anything you want, but the instructions assume you have called it XXICC and it’s in your home directory.
- Change to your XXICC directory: cd ~/XXICC
- Download the XXICC source code code00q.zip into your XXICC directory and unzip it:
- Before compiling XXICC, you need to install the libxft developer’s libraries:
sudo apt-get update
sudo apt-get install libxft-dev
- Make a subdirectory for XXICC object code: mkdir xxicc.od
- Compile XXICC’s C files: make T=XGL
This should create the XXICC executable xxicc.
- Install libftdi.so, which XXICC needs to talk to an FTDI FT2232D/H or FT232H USB serial IC:
sudo apt-get install libftdi1
This installs libftdi.so.1. However, XXICC needs it to be named libftdi.so, so you must add a symbolic link in /usr/lib/arm-linux-gnueabihf (or similar /usr/lib subdirectory such as /usr/lib/i386-linux-gnu):
sudo ln -s libftdi.so.1 libftdi.so
- Compile XXICC’s GalaxC source code, including the files needed for Flavia:
XXICC will compile the GalaxC files and link in libftdi.so. If the library is not present, you will get an error message. Review Step 7 and/or install00q.pdf to see how to deal with this.
When XXICC finishes compiling, it should bring up a file selection dialog. For now, close the dialog and xxicc terminates. The next time you run xxicc it will load object code and come up in less than a second.
- Before you use JTAG, download 85-ftdi.rules (udev rules file for FTDI FT2232D/H, FT232H, and Papilio DUO) and copy it (using sudo) to /etc/udev/rules.d. 85-ftdi.rules to set permissions so that XXICC can talk to FTDI serial devices without having to run as superuser. 85-ftdi.rules takes effect when you reboot or you can reload udev rules with the command:
sudo udevadm control --reload
85-ftdi.rules requires that you are a member of the dialout group. See if you’re in dialout by giving the groups command. If you’re not in dialout, give the command:
sudo adduser <userid> dialout
You will need to log out and log back in again for the change to take effect.
That should do it! Please comment if you have any questions or helpful suggestions.