Skip to content

FPGA 8-Bit TV80 SoC for Lattice iCE40 with complete open-source toolchain flow using yosys and SDCC

License

Notifications You must be signed in to change notification settings

PPlinux/iceZ0mb1e

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

iceZ0mb1e

iceZ0mb1e aims to build a TV80 based demonstration system-on-chip using complete open source FPGA toolchain flow (http://www.clifford.at/yosys/) including firmware compilation with SDCC.

This is a completely free microcontroller based on customizable open source components.

iceZ0mb1e consists of following parts

  • TV80 CPU (https://opencores.org/project,tv80,overview)
  • SoC RTL design, iceZ0mb1e consists of:
    • RAM and ROM (using BRAM or SPRAM)
    • UART 16450 compatible
    • Parallel IO
    • i2C Master
    • SPI Master (all CPOL/CPHA modes supported)
  • Top-Level designs for some iCE40 development boards (upduino, HX8K Breakout Board)
  • C based firmware, that is embedded into BRAM blocks during build
  • API Functions for all hardware interfaces
  • Complete make based flow, to be as clean as possible

Supported FPGAs

  • Lattice iCE40 HX8K
  • Lattice iCE40 UltraPlus 5K

No special blocks are used, so every comparable FPGA in size would fit.

Test Firmware

The included test firmware will check the RAM size and write some data to IO ports (blink LEDs). Simple UART access with 9600-8N1 is provided.

Address Map

  • ROM = 0x0000 - 0x1FFF (8192 Byte)
  • RAM = 0x8000 - 0x9FFF (8192 Byte)
  • 16450 UART Base IO = 0x18
  • Parallel Base IO = 0x40
  • i2C Master = 0x50
  • SPI Master = 060

Build for Target

  • UltraPlus 5K (default target): make firmware && make fpga && make flash
  • HX8K: make firmware TARGET=8k && make fpga TARGET=8k && make flash TARGET=8k

Simulate

  • make sim TARGET=8k
  • cocotb python tests - gpio loopback and spi test (introduced by jwrr)
    • cd cocotb; make -f makefile.firmware; make; gtkwaves iceZ0mb1e.fst

Running SoC

Installing yosys toolchain

Installation of essentials for running yosys, icestorm and nextpnr toolchain (Ubuntu 20.04):

sudo apt-get install make yosys nextpnr-ice40 fpga-icestorm

Installing verilog simulator

sudo apt-get install iverilog gtkwave

Installing SDCC toolchain

sudo apt-get install sdcc sdcc-doc sdcc-libraries sdcc-ucsim \
                     z80asm z80dasm srecord

About

FPGA 8-Bit TV80 SoC for Lattice iCE40 with complete open-source toolchain flow using yosys and SDCC

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Verilog 73.0%
  • C 16.9%
  • Python 5.7%
  • Makefile 3.6%
  • Assembly 0.8%