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         cd /path/to/soc
  62         make microwatt_external_core
  63         cp external_core_top.v /path/to/microwatt
  64         cd /path/to/microwatt
  65         export FPGA_TARGET=verilator
  66         export GHDLSYNTH=ghdl
  67         make microwatt-verilator
  68
  69 ## Running the simulation
  70         cp microwatt/arch/powerpc/boot/dtbImage.microwatt
  71         ./microwatt-verilator sdram_init.bin dtbImage.microwatt
  72
  73 ## TODO: buildroot
  74
  75 * https://github.com/shenki/buildroot/commits/microwatt
  76 * https://codeconstruct.com.au/docs/microwatt-orangecrab/
  77
  78 # Notes for ulx3s
  79
  80 notes for how to compile for ulx3s
  81
  82     git clone https://github.com/kost/fujprog
  83     (follow build procedure shown in fujprog README)
  84     git clone https://git.libre-soc.org/git/microwatt.git
  85     git checkout -b verilator_trace
  86     export FPGA_TARGET=ulx3s
  87     make microwatt.svf
  88     fujprog microwatt.svf
  89
  90
  91 # Notes for nextpnr-xilinx
  92
  93 for compiling nextpnr-xilinx and making it useable for nmigen
  94 to compile for the digilent arty-a7-100t, requires a little
  95 futzing around, using the symbiflow version of prjxray-db
  96 instead of the one recommended as a submodule
  97
  98     git clone https://github.com/gatecat/nextpnr-xilinx
  99     cd nextpnr-xilinx
 100     git checkout cd8b15db6ff5c1a7f10a9e
 101     git submodule init
 102     git submodule update
 103     cd xilinx/external
 104     mv prjxray-db prjxray-db-no
 105     git clone https://github.com/SymbiFlow/prjxray-db
 106     cd prjxray-db
 107     git checkout 0a0addedd73e7
 108     cp ./artix7/xc7a100t/*.json \
 109        ./artix7/xc7a100tcsg324-1
 110     cd ../../..
 111     cmake -DARCH=xilinx .
 112     make
 113     make install
 114     python3 xilinx/python/bbaexport.py --device xc7a100tcsg324-1 --bba xilinx/xc7a100t.bba
 115     ./bbasm --l xilinx/xc7a100t.bba xilinx/xc7a100t.bin
 116     mkdir -p /usr/share/nextpnr/xilinx-chipdb
 117     cp xilinx/*.bin /usr/share/nextpnr/xilinx-chipdb
 118     cp -aux xilinx/external/prjxray-db /usr/share/nextpnr