blob: d972b3aa03b8169d91fa3ffe60e86ef66dcee334 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
Building for a Dev Board or FPGA
================================
Building an Example
-------------------
To compile a bare-metal RISC-V program:
.. code-block:: bash
make [PROGRAM=hello] [TARGET=sifive-hifive1] [CONFIGURATION=debug] software
The square brackets in the above command indicate optional parameters for the
Make invocation. As you can see, the default values of these parameters tell
the build script to build the ``hello`` example for the ``sifive-hifive1`` target
using the ``debug`` build configuration. If, for example, you wished to build
the ``timer-interrupt`` example for the S51 Arty FPGA Evaluation target using
the ``release`` build configuration, you would instead run the command
.. code-block:: bash
make PROGRAM=timer-interrupt TARGET=coreip-s51-arty CONFIGURATION=release software
Uploading to the Target Board
-----------------------------
Uploading a program to the target development or FPGA board depends on having both
the RISC-V GNU Toolchain and RISC-V OpenOCD installed on your development system.
See :doc:`installing` for more information on installing OpenOCD.
With the toolchain and OpenOCD installed, uploading a program is as simple as plugging
the development board into your computer and running the following command:
.. code-block:: bash
make [PROGRAM=hello] [TARGET=sifive-hifive1] [CONFIGURATION=debug] upload
Debugging a Target Program
--------------------------
Debugging a program on a target development or FPGA board depends on having both
the RISC-V GNU Toolchain and RISC-V OpenOCD installed on your development system.
See :doc:`installing` for more information on installing OpenOCD.
Debugging with Freedom E SDK also assumes that the program has already been uploaded to
the target board.
With the toolchain and OpenOCD installed, debugging a program is as simple as plugging
the development board into your computer and running the following command:
.. code-block:: bash
make [PROGRAM=hello] [TARGET=sifive-hifive1] [CONFIGURATION=debug] debug
Cleaning a Target Program Build Directory
-----------------------------------------
The ``clean`` target can be used to restore a target program's directory to a clean state.
.. code-block:: bash
make [PROGRAM=hello] [TARGET=sifive-hifive1] [CONFIGURATION=debug] clean
|
