f4pga-examples/xc7/linux_litex_demo
Alessandro Comodi 21902aae65 xc7: linux-litex: add information on the ethernet boot
Signed-off-by: Alessandro Comodi <acomodi@antmicro.com>
2022-02-02 11:50:34 +01:00
..
buildroot Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
emulator Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
Makefile xc7: lite sata add third party code for VexRiscV and improve docs 2021-11-30 13:41:25 +01:00
README.rst xc7: linux-litex: add information on the ethernet boot 2022-02-02 11:50:34 +01:00
arty.pcf Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
arty.sdc Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
arty.xdc Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
baselitex_arty.v formatted files 2021-05-13 12:07:40 -06:00
images.json formatted files 2021-05-13 12:07:40 -06:00
mem.init Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
mem_1.init Remove the extra examples directory. 2020-07-29 12:26:38 -07:00
mem_2.init Remove the extra examples directory. 2020-07-29 12:26:38 -07:00

README.rst

Linux LiteX demo
~~~~~~~~~~~~~~~~

This example design features a Linux-capable SoC based around VexRiscv soft
CPU. It also includes DDR and Ethernet controllers. To build the litex example,
run the following commands:

To build the linux-litex-demo example, first re-navigate to the directory that contains examples for Xilinx 7-Series FPGAs. Then depending on your hardware, run:


.. code-block:: bash
   :name: example-litex-a35t-group

   TARGET="arty_35" make -C linux_litex_demo

.. code-block:: bash
   :name: example-litex-a100t-group

   TARGET="arty_100" make -C linux_litex_demo

At completion, the bitstreams are located in the build directory:

.. code-block:: bash

   linux_litex_demo/build/<board>

Now you can upload the design with:

.. code-block:: bash

   TARGET="<board type>" make download -C linux_litex_demo

.. note::

   The LiteX design is provided with an Ethernet module that uses the ``192.168.100.100/24``
   IPv4 address that needs to be set on your network interface.

   You may find these information useful to correctly setup the network interface:
   https://github.com/timvideos/litex-buildenv/wiki/Networking

You should observe the following line in the OpenOCD output:

.. code-block:: bash

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

In the ``picocom`` terminal, you should observe the following output:

.. image:: ../../docs/images/linux-example-console.gif
   :align: center
   :width: 80%

Additionally, two LED's on the board should be turned on

.. image:: ../../docs/images/linux-example-arty.jpg
   :width: 49%
   :align: center