boards/riscv/niosv_m/doc/index.rst

.. _niosv_m:

INTEL FPGA niosv_m
####################

Overview
********

niosv_m board is based on Intel FPGA Design Store Nios® V/m Hello World Example Design system and this complete system is consisted of following IP blocks:

.. code-block:: console

	Nios® V/m Processor Intel® FPGA IP
	JTAG UART Intel® FPGA IP
	On-Chip Memory Intel® FPGA IP

Nios® V/m hello world example design system
===========================================

Prebuilt Nios® V/m hello world example design system is available in Intel FPGA Design store.
- https://www.intel.com/content/www/us/en/support/programmable/support-resources/design-examples/design-store.html?s=Newest

For example, Arria10 Nios® V/m processor example design system prebuilt files can be downloaded from following link.
- https://www.intel.com/content/www/us/en/design-example/763960/arria10-niosv-based-helloworld-example-design-on-arria10-devkit.html?

ready_to_test/top.sof file is the prebuilt SRAM Object File for hello world example design system after the downloaded PAR files extracted successfully.

Create Nios® V/m processor example design system in FPGA
========================================================

Please use Intel Quartus Programmer tool to program Nios® V/m processor based system into the FPGA and execute application.

In order to create the Nios® V/m processor inside the FPGA device, please download the generated .sof file onto the board with the following command.

.. code-block:: console

	quartus_pgm -c 1 -m JTAG -o "p;top.sof@1"

.. code-block:: console

	Note:
	-c 1 is referring to JTAG cable number connected to the Host Computer.
	@1 is referring to device index on the JTAG Chain and may differ for your board.
	top.sof is referring to Nios® V/m processor based system SRAM Object File.

Download Zephyr elf file and run application
============================================

To download the Zephyr Executable and Linkable Format .elf file, please use the niosv-download command within Nios V Command Shell environment.

.. code-block:: console

	niosv-download -g <elf file>

Use the JTAG UART terminal to print the stdout and stderr of the Nios® V/m processor system.

.. code-block:: console

	juart-terminal

Similar message shown below should be appeared in the JTAG UART terminal when using hello world sample code:

.. code-block:: console

	*** Booting Zephyr OS build zephyr-vn.n.nn  ***
	Hello World! niosv_m