# Steps for Hello World Microwatt ls2 for fpga/boards 

* Currently works for Arty A7-100t, VERSA_ECP5 and in future others
* Bugzilla page <https://bugs.libre-soc.org/show_bug.cgi?id=802>

# Install Instructions

    git clone https://git.libre-soc.org/git/dev-env-setup.git
    cd dev-env-setup
    sudo bash
    ./mk-deb-chroot ls2-hello-world
    ./cp-scripts-to-chroot ls2-hello-world
    schroot -c ls2-hello-world
    cd ~/dev-env-setup
    ./install-hdl-apt-reqs
    ./hdl-dev-repos
    ./hdl-tools-yosys
    ./nextpnr-xilinx-install
    export PATH=/usr/local/nextpnr-xilinx/bin:$PATH
    export XRAY_DIR=/usr/local/nextpnr-xilinx
    ./hdl-dev-ls2
    cd ~/src
    cd tercel-qspi/
    cd hello_world/
    make
    cp hello_world.bin ../../ls2
    cd ../..

    # pip3 may install newer nmigen from repo which may cause error
    # in next step. If so you can run "python3 setup.py develop"
    # in nmigen source directory.

    cd soc
    make microwatt_external_core
    cp external_core_top.v ../ls2
    cd ../ls2
    git checkout 426e2d9585cd4b1fb96a38987f97878285ee5ba7

    # plug in FPGA board (Arty A7-100t, VERSA_ECP5, other)
    # run in 2nd terminal "minicom -D /dev/ttyUSB1"

    python3 src/ls2.py arty_a7 hello_world.bin    # for Arty A7-100t
    python3 src/ls2.py versa_ecp5 hello_world.bin # (for a VERSA_ECP5)

This directly programs a tmp bitstream using xc3sprog to nexys4 board.
If needed modify sources to produce a fixed file bitstream and

    copy build/top.bit to board/server (scp, rsync)
    minicom -D /dev/ttyUSB1
    xc3sprog -c nexys4 top.bit