summaryrefslogtreecommitdiff
path: root/doc/sphinx/userguide
diff options
context:
space:
mode:
authorNathaniel Graff <nathaniel.graff@sifive.com>2019-02-15 17:36:33 +0000
committerGitHub <noreply@github.com>2019-02-15 17:36:33 +0000
commit07bc51969ae10699346a717a6c83909cab03b02c (patch)
tree76326dba468385e7e4dd6feaf6a213ac56d52836 /doc/sphinx/userguide
parent5d713aebb10998e6269e0c3dc690828cc0edc472 (diff)
parent493ca238fcd9b034c8888b2769adb5ed53bcb3e7 (diff)
Merge pull request #175 from sifive/docs
Update User Guide and Contents
Diffstat (limited to 'doc/sphinx/userguide')
-rw-r--r--doc/sphinx/userguide/buildingcoreip.rst2
-rw-r--r--doc/sphinx/userguide/buildingdevboard.rst19
2 files changed, 21 insertions, 0 deletions
diff --git a/doc/sphinx/userguide/buildingcoreip.rst b/doc/sphinx/userguide/buildingcoreip.rst
index a6f1dae..5af29fb 100644
--- a/doc/sphinx/userguide/buildingcoreip.rst
+++ b/doc/sphinx/userguide/buildingcoreip.rst
@@ -23,6 +23,8 @@ Core IP target, you would instead run the command
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 BSP=mee [PROGRAM=hello] [TARGET=coreip-e31] clean
diff --git a/doc/sphinx/userguide/buildingdevboard.rst b/doc/sphinx/userguide/buildingdevboard.rst
index 4b5822b..b276d51 100644
--- a/doc/sphinx/userguide/buildingdevboard.rst
+++ b/doc/sphinx/userguide/buildingdevboard.rst
@@ -23,6 +23,13 @@ Arty FPGA Evaluation target, you would instead run the command
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 BSP=mee [PROGRAM=hello] [TARGET=sifive-hifive1] upload
@@ -30,6 +37,16 @@ Uploading to the Target Board
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 BSP=mee [PROGRAM=hello] [TARGET=sifive-hifive1] debug
@@ -37,6 +54,8 @@ Debugging a Target Program
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 BSP=mee [PROGRAM=hello] [TARGET=sifive-hifive1] clean