arachne-pnr switched to nextpnr for basic Verilog examples
iCESugar
iCESugar
iCESugar is a FPGA board made by MuseLab, it base on Lattice iCE40UP5k, on board peripheral include RGB LED,Switch,TYPE-C-USB, Micro-USB,most IO out with standard PMOD interface
the on board debugger iCELink (base on ARM Mbed DAPLink) support drag-and-drop program, you can just drag the FPGA bitstream into the virtual disk to program, iCELink also support USB CDC serial port and JTAG

Hardware
iCE40UP5K
- 5280 Logic Cells (4-LUT + Carry + FF)
- 128 KBit Dual-Port Block RAM
- 1 MBit (128 KB) Single-Port RAM
- PLL, Two SPI and two I2C hard IPs
- Two internal oscillators (10 kHz and 48 MHz)
- 8 DSPs (16x16 multiply + 32 bit accumulate)
- 3x 24mA drive and 3x hard PWM IP
- SPI Flash use W25Q64 (8MB)
- on board switch and RGB LED
- all IO out with standard PMOD Interface
iCELink
iCESugar has a on board debugger named iCELink (base on STM32F1),you can only use one USB wire to program the FPGA and debug, here is detail:
- drag-and-drop program, just drop the bitstream into the virtual USB DISK iCELink, then wait a few second, the iCELink firmware will do the total program work
- USB CDC serial port, it can use to communicate with FPGA
- support JTAG, you can use it to debug the SoC run on FPGA
- the MCO can provide 12Mhz clock for FPGA as extern clock.
virtual-machine-image
link:https://pan.baidu.com/s/1qVSdwM7DnFbaS0xdqsPNrA
verify code:6gn3
user: ubuntu
passwd: ubuntu
or
https://mega.nz/file/uvJTWKrK#1bBgBkJPZrszwHQSTHHL-RLjxGIru0Qv0qUgmULZZVs
the env include yosys, nextpnr, icestorm, gcc, sbt.
How-to-setup-env
recommand use the virtual machine, it simple and convenient
FPGA toolchain reference icestorm
gcc toolchain reference riscv-gnu-toolchain
Alternatively, you can download the pre-built toolchain provided by xPack or SiFive
- https://xpack.github.io/riscv-none-embed-gcc/install/
- https://www.sifive.com/software
icesprogis command tool for iCESugar program,it depend libusb and hidapi
$sudo apt-get install libhidapi-dev
$sudo apt-get install libusb-1.0-0-dev
How-to-buy
you can buy iCESugar and PMOD boards from our offcial aliexpress shop Muse Lab Factory Store
Reference
RTL toolchain
http://www.clifford.at/icestorm/
Firmware toolchain
https://xpack.github.io/riscv-none-embed-gcc/install/ https://www.sifive.com/software
Examples
https://github.com/damdoy/ice40_ultraplus_examples
https://github.com/icebreaker-fpga/icebreaker-examples
SpinalHDL
https://spinalhdl.github.io/SpinalDoc-RTD/SpinalHDL/Getting%20Started/index.html
iCESugar introduce
https://www.muselab-tech.com/wan-quan-shi-yong-kai-yuan-gong-ju-lian-de-fpgadan-ban/