diff options
| author | Clifford Wolf <clifford@clifford.at> | 2015-12-31 11:16:27 +0100 |
|---|---|---|
| committer | Clifford Wolf <clifford@clifford.at> | 2015-12-31 11:18:05 +0100 |
| commit | 2d03b61380c3fec5f6d5b744c588eb76957db138 (patch) | |
| tree | 800717b251ea3235d280942a2f5f3dfc292754d5 /docs/notes_osx.html | |
| parent | 264499a8f595aab2355e1d1bb315a5cf15708de7 (diff) | |
| download | icestorm-2d03b61380c3fec5f6d5b744c588eb76957db138.tar.gz icestorm-2d03b61380c3fec5f6d5b744c588eb76957db138.tar.bz2 icestorm-2d03b61380c3fec5f6d5b744c588eb76957db138.zip | |
Documentation updates (install notes for OSX and Archlinux)
Diffstat (limited to 'docs/notes_osx.html')
| -rw-r--r-- | docs/notes_osx.html | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/docs/notes_osx.html b/docs/notes_osx.html new file mode 100644 index 0000000..24b9bd9 --- /dev/null +++ b/docs/notes_osx.html @@ -0,0 +1,80 @@ +<!DOCTYPE html> +<html><head><meta charset="UTF-8"> +<title>Project IceStorm – Notes for Installing on OSX</title> +</head><body> +<h1>Project IceStorm – Notes for Installing on OSX</h1> + +<p> +The toolchain should be easy to install on OSX platforms. Below are a few troubleshooting items found on Mountain Lion (10.8.2). +</p> + +<h2>Installing FTDI Library</h2> + +<p> +The libftdi package (.so lib binary and the ftdi.h header) has been renamed to libftdi0, so either do: +</p> + +<ul> +<li><p><tt>port install libftdi0</tt><br/> +(note that ports installs the tool to /opt instead of /usr, see next note)</p></li> +<li><p><tt>brew install libftdi0</tt></p></li> +</ul> + +<h2>iceprog make error on "ftdi.h not found"</h2> + +<p> +Note that Mac Ports installs to /opt instead of /usr, so change the first two lines in <tt>iceprog/Makefile</tt> to: +</p> + +<pre style="padding-left: 3em"> +LDLIBS = -L/usr/local/lib -L/opt/local/lib -lftdi -lm +CFLAGS = -MD -O0 -ggdb -Wall -std=c99 -I/usr/local/include -I/opt/local/include/ +</pre> + +<p> +Basically you are indicating where to find the lib with <tt>-L/opt/local/lib</tt> and where to find the .h with <tt>-I/opt/local/include/</tt>. +</p> + +<h2>yosys make error on "<tuple> not found"</h2> + +<p> +This is a compiler issue, i.e., you are probably running on clang and you can circumvent this error by compiling against another compiler. +Edit the Makefile of yosys and replace the two first lines for this, i.e., comment the first line (clang) and uncomment the second (gcc): +</p> + +<pre style="padding-left: 3em"> +#CONFIG := clang +CONFIG := gcc +</pre> + +<h2>error "Can't find iCE FTDI USB device (vedor_id 0x0403, device_id 0x6010)." while uploading code to FPGA (e.g., "iceprog example.bin")</h2> + +<p> +You need to unload the FTDI driver. (notes below are from Mountain Lion, 10.8.2). +First check if it is running: +</p> + +<pre style="padding-left: 3em"> +kextstat | grep FTDIUSBSerialDriver +</pre> + +<p> +If you see if on the kextstat, we need to unload it: +</p> + +<pre style="padding-left: 3em"> +sudo kextunload -b com.FTDI.driver.FTDIUSBSerialDriver` +</pre> + +<p> +Repeat the <tt>kextstat</tt> command and check that the driver was successfully unloaded. +</p> + +<p> +Try running <tt>iceprog example.bin</tt> again. It should be working now. +</p> + +<p> +Note: On newer OSes perhaps you need to also kextunload the <tt>com.apple.driver.AppleUSBFTDI</tt> driver. +</p> + |