HDL_workflow/microwatt.mdwn

   1 # Build instructions for Microwatt
   2
   3 TODO WIP integrate from <https://libre-soc.org/irclog/%23libre-soc.2022-01-26.log.html>
   4
   5 useful links:
   6
   7 * <https://codeconstruct.com.au/docs/microwatt-orangecrab/>
   8 * <https://shenki.github.io/boot-linux-on-microwatt/>
   9 * <https://github.com/gregdavill/OrangeCrab-test-sw>
  10
  11 prerequisite tools:
  12
  13 * install verilator: <https://git.libre-soc.org/?p=dev-env-setup.git;a=blob;f=verilator-install;hb=HEAD>
  14 * install yosys <https://git.libre-soc.org/?p=dev-env-setup.git;a=blob;f=hdl-tools-yosys;hb=HEAD>
  15 * install ghdl-yosys-plugin
  16
  17 After installing ghdl-yosys-plugin use schroot to switch environment
  18
  19     schroot -c bullseye_ghdl
  20     git clone https://git.libre-soc.org/git/microwatt.git
  21     git checkout -b verilator_trace
  22     export FPGA_TARGET=verilator
  23     make microwatt-verilator
  24
  25 Then run the resulting binary
  26
  27     time ./microwatt-verilator
  28
  29 If everything works correcly it will print out an light bulb in ascii art
  30 with the message Microwatt, it works. On my ASUS KGPE D16 this takes
  31
  32      real       1m4.986s
  33      user       1m4.373s
  34      sys        0m0.013s
  35
  36 ## Building the kernel
  37 On a POWER9 there is no need to install gcc-powerpc64le-linux-gnu,
  38 you can omit CROSS_COMPILE and ARCH in this case
  39
  40         apt install gcc-powerpc64le-linux-gnu
  41         apt install flex bison lz4
  42         git clone -b microwatt-5.7 https://git.kernel.org/pub/scm/linux/kernel/git/joel/microwatt.git
  43         cd microwatt
  44         wget https://ftp.libre-soc.org/microwatt-linux-5.7.patch
  45         patch -p1 < microwatt-linux-5.7.patch
  46         wget https://ftp.libre-soc.org/rootfs.cpio
  47         CROSS_COMPILE="ccache powerpc64le-linux-gnu-" ARCH=powerpc make -j8 O=microwatt microwatt_defconfig
  48         CROSS_COMPILE="ccache powerpc64le-linux-gnu-" ARCH=powerpc make -j8 O=microwatt
  49
  50 This will produce a file
  51         microwatt/arch/powerpc/boot/dtbImage.microwatt
  52
  53 ## Building sdram_init.bin
  54 This needs gcc-powerpc64le-linux-gnu if cross compilation is used.
  55
  56         cd microwatt
  57         cd litedram/gen-src/sdram_init/
  58         make
  59
  60 ## Building microwatt-verilator using the libre-soc core
  61
  62         cd /path/to/soc
  63         make microwatt_external_core
  64         cp external_core_top.v /path/to/microwatt
  65         cd /path/to/microwatt
  66         export FPGA_TARGET=verilator
  67         export GHDLSYNTH=ghdl
  68         make microwatt-verilator
  69
  70 ## Running the simulation
  71
  72         cp microwatt/arch/powerpc/boot/dtbImage.microwatt
  73         ./microwatt-verilator sdram_init.bin dtbImage.microwatt
  74
  75 ## Building the bitstring for OrangeCrab
  76
  77   cd microwatt
  78   export FPGA_TARGET=ORANGE-CRAB
  79   export GHDLSYNTH=ghdl
  80   make microwatt.bit
  81
  82 ## flashing the bitstring to the OrangeCrab
  83
  84   make prog # this will run OpenOCD
  85
  86
  87
  88 ## TODO: buildroot
  89
  90 * https://github.com/shenki/buildroot/commits/microwatt
  91 * https://codeconstruct.com.au/docs/microwatt-orangecrab/
  92
  93 # Notes for ulx3s
  94
  95 notes for how to compile for ulx3s
  96
  97     git clone https://github.com/kost/fujprog
  98     (follow build procedure shown in fujprog README)
  99     git clone https://git.libre-soc.org/git/microwatt.git
 100     git checkout -b verilator_trace
 101     export FPGA_TARGET=ulx3s
 102     make microwatt.svf
 103     fujprog microwatt.svf
 104
 105
 106 # Notes for nextpnr-xilinx
 107
 108 for compiling nextpnr-xilinx and making it useable for nmigen
 109 to compile for the digilent arty-a7-100t, requires a little
 110 futzing around, using the symbiflow version of prjxray-db
 111 instead of the one recommended as a submodule
 112
 113     git clone https://github.com/gatecat/nextpnr-xilinx
 114     cd nextpnr-xilinx
 115     git checkout cd8b15db6ff5c1a7f10a9e
 116     git submodule init
 117     git submodule update
 118     cd xilinx/external
 119     mv prjxray-db prjxray-db-no
 120     git clone https://github.com/SymbiFlow/prjxray-db
 121     cd prjxray-db
 122     git checkout 0a0addedd73e7
 123     cp ./artix7/xc7a100t/*.json \
 124        ./artix7/xc7a100tcsg324-1
 125     cd ../../..
 126     cmake -DARCH=xilinx .
 127     make
 128     make install
 129     python3 xilinx/python/bbaexport.py --device xc7a100tcsg324-1 --bba xilinx/xc7a100t.bba
 130     ./bbasm --l xilinx/xc7a100t.bba xilinx/xc7a100t.bin
 131     mkdir -p /usr/share/nextpnr/xilinx-chipdb
 132     cp xilinx/*.bin /usr/share/nextpnr/xilinx-chipdb
 133     cp -aux xilinx/external/prjxray-db /usr/share/nextpnr