urukul-pld/README.md

Urukul gateware code (M-Labs fork)

Urukul datasheet

Urukul hardware repository

Supported Urukul Hardware Revision (HW_REV)

PLD	HW_REV
XC2 CPLD	1.4, 1.5
iCE40	1.6+

Depending on your hardware revision (right) follow the instructions below for either XC2 CPLD or iCE40 FPGA.

Instructions for Xilinx CoolRunner-II CPLD (XC2 CPLD)

Sources are in the xc2c directory.

cd xc2c

Download latest build: JED.

Building

Needs migen and Xilinx ISE. Assumes ISE is installed in /opt/Xilinx.

make

Flashing

With Digilent JTAG HS2 cable:

• download firmware to dongle. Manually (adjust USB bus as needed):

/sbin/fxload -t fx2 -I /opt/Xilinx/14.7/ISE_DS/ISE/bin/lin64/xusb_xp2.hex -D /dev/bus/usb/001/*`cat /sys/bus/usb/devices/1-3/devnum`

or automatically via the udev rule:

SUBSYSTEM=="usb", ACTION="add", ATTR{idVendor}=="0403", ATTR{idProduct}=="6014", ATTR{manufacturer}=="Digilent", RUN+="/usr/bin/fxload -v -t fx2 -I /opt/Xilinx/14.7/ISE_DS/ISE/bin/lin64/xusb_xp2.hex -D $tempnode"

• install xc3sprog

• flash_xc3.sh jtaghs2

• look for Verify: Success

Instructions for iCE40 FPGA

Sources are in the ice40 directory.

cd ice40

Download latest builds: urukul.bin suservo.bin.

Building

Needs migen, yosys, nextpnr, icestorm.

python urukul.py        # Builds non-SU-Servo firmware

To build the SU-Servo version of the firmware, add the --suservo argument when calling the script.

Flashing

Use kasli-i2c.

Otherwise you can also use an FT232H-based board. Connect the wires as follows. Top left is closest to the CPLD, right is facing the edge. Bottom is towards the end of the edge.

D4    D1
D2    D0
GND   X
X     X
D7    D6

Use iceprog (available with icestorm package):

iceprog build/urukul.bin      # non-SU-Servo
iceprog build/suservo.bin     # SU-Servo

License

GPLv3+