f4pga-examples/xc7/picosoc_demo
Filip Kokosinski b35be0e3c5 xc7: Add README for picosoc_demo
Signed-off-by: Filip Kokosinski <fkokosinski@antmicro.com>
2020-12-11 10:34:04 +01:00
..
Makefile Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
README.rst xc7: Add README for picosoc_demo 2020-12-11 10:34:04 +01:00
basys3.pcf Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
basys3.sdc Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
basys3_demo_no_roi.v Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
picorv32.v Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
picosoc_noflash.v Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
progmem.v Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
simpleuart.v Remove the extra examples directory. 2020-07-29 12:26:38 -07:00

README.rst

PicoSoC demo
~~~~~~~~~~~~

This example features a picorv32 soft CPU and a SoC based on it. To build the
picosoc example, run the following commands:

.. code-block:: bash
   :name: example-picosoc-basys3-group

   TARGET="basys3" make -C picosoc_demo

Now you can upload the design with:

.. code-block:: bash

   openocd -f ${INSTALL_DIR}/conda/share/openocd/scripts/board/digilent_arty.cfg -c "init; pld load 0 top.bit; exit"


You should observe the following line in the OpenOCD output:

.. code-block::

   Info : JTAG tap: xc7.tap tap/device found: 0x0362d093 (mfg: 0x049 (Xilinx), part: 0x362d, ver: 0x0)

The UART output should look as follows:

.. code-block::

   Terminal ready
   Press ENTER to continue..
   Press ENTER to continue..
   Press ENTER to continue..
   Press ENTER to continue..

    ____  _          ____         ____
   |  _ \(_) ___ ___/ ___|  ___  / ___|
   | |_) | |/ __/ _ \___ \ / _ \| |
   |  __/| | (_| (_) |__) | (_) | |___
   |_|   |_|\___\___/____/ \___/ \____|


   [9] Run simplistic benchmark

   Command>

.. note::

   PicoSoC uses baud rate of ``460800`` by default.

The board's LED should blink at a regular rate from left to the right

.. image:: ../../docs/images/picosoc-example-basys3.gif
   :width: 49%
   :align: center