# Lattice Diamond

From ArchWiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Lattice Diamond is a design software for Lattice FPGA architectures.

Arch Linux is not officially supported by Lattice Diamond, but as happens with other HDL suites like Xilinx ISE WebPACK or Xilinx Vivado, most of its features can be used with a bit of hacking.

## Prerequisites

Lattice provides only 64-bit builds of the suite. So you will need a working 64-bit installation of Arch Linux.

## Installation

Just install lattice-diamondAUR. Note that the installation size is big (around 4 GB), so generating the package might take some time due to the compression stage. If you want to shorten building the package, edit the PKGBUILD file to avoid compressing it.

### Licensing

You can request a free license to Lattice Semiconductor (registration needed). These licenses are node-locked (tied to the MAC of your Ethernet card). Once you have the license file, copy it to `/usr/local/diamond/3.11_x64/license/license.dat` to be able to start the Diamond programs.

Note that in case one does have the relevant hardware or wants to uncouple Diamond from it, it is possible to create a dummy ethernet interface with an arbitrarily chosen MAC address. See MAC address spoofing#Manually, or add a new dummy interface like this:

Load the relevant kernel module and create the interface with the MAC address:

    modprobe dummy
    ip link add bond0 type dummy
    ifconfig bond0 hw ether 10:22:33:44:55:66

Cleanup for after Diamond exits:

    ip link delete bond0 type dummy
    rmmod dummy

## Troubleshooting

### Place & Route fails

If Place & Route fails with message `ERROR - par: Switch "-msgsegset" is not allowed.`, try deleting the `promote.xml` file in the root directory of your project and launch it again. It should now run normally.

### Programming with FTDI cables doesn't work

Programming FPGAs with FTDI chip based cables will not work if `ftdi_sio` kernel module is loaded. After plugging the programmer run:

    # rmmod ftdi_sio

Now the programmer should work until you re-attach it again (so you must run the command above every time the programmer is plugged).

### Diamond crashes when FTDI based serial interface exists on a Lattice starter kit

The "Lattice Diamond 3.9 Installation Notice for Linux" document describes how to manually setup the serial driver but naming the udev rule as explained in that document does not work. Below are the instructions that work.

1. Find your username which is given in /etc/group file. Log out if required. For example :

username:x:1000:

2. Create a working file called 51-lattice.rules.

3. Add the following information to the 51-lattice.rules file:

- Lattice - from Lattice Diamond 3.9 Installation Notice for Linux p.20 and https://github.com/jandob/lattice-diamond-archlinux showing a higher number used for the .rules file

    SUBSYSTEM=="usb",ACTION=="add",ATTRS{idVendor}=="1134",ATTRS{idProduct}=="8001",MODE=="0660",GROUP=="username:x:1000:",SYMLINK+="lattice-%n"

- FTDI

    SUBSYSTEM=="usb",ACTION=="add",ATTRS{idVendor}=="0403",ATTRS{idProduct}=="6010",MODE=="0666",GROUP=="username:x:1000:",SYMLINK+="ftdi-%n"
    SUBSYSTEM=="usb",ATTRS{idVendor}=="0403",ATTRS{idProduct}=="6010",RUN+="/bin/sh -c 'basename %p > /sys/bus/usb/drivers/ftdi_sio/unbind'"

Category:

- Electronic design automation