From 1a2901e224bbff8494ed99da953e28c0a4187ec3 Mon Sep 17 00:00:00 2001 From: Nathaniel Graff Date: Thu, 7 Mar 2019 13:43:12 -0800 Subject: Updates to documentation for SDK contents Signed-off-by: Nathaniel Graff --- doc/sphinx/contents.rst | 33 ++++++++++++++++++++++++++++----- doc/sphinx/userguide/buildingcoreip.rst | 6 +++--- 2 files changed, 31 insertions(+), 8 deletions(-) diff --git a/doc/sphinx/contents.rst b/doc/sphinx/contents.rst index e7a7613..0408900 100644 --- a/doc/sphinx/contents.rst +++ b/doc/sphinx/contents.rst @@ -11,20 +11,35 @@ Freedom E SDK comes packaged with the following board support packages under the - sifive-hifive1 +- SiFive HiFive 1 Rev B + + - sifive-hifive1-revb + - `SiFive Freedom E310 Arty `_ - freedom-e310-arty -- SiFive CoreIP +- SiFive CoreIP RTL - - coreip-e31 - - coreip-s51 + - coreip-e20-rtl + - coreip-e21-rtl + - coreip-e24-rtl + - coreip-e31-rtl + - coreip-s51-rtl + - coreip-s54-rtl + - coreip-e76-rtl + - coreip-s76-rtl - SiFive CoreIP Arty FPGA Evaluation targets + - coreip-e20-arty + - coreip-e21-arty - coreip-e24-arty - coreip-e31-arty - coreip-s51-arty + - coreip-s54-arty + - coreip-e76-arty + - coreip-s76-arty The board support files for the Freedom Metal library are located entirely within a single target directory in ``bsp//``. For example, the HiFive 1 @@ -38,12 +53,12 @@ and consist of the following: so that users of Freedom Metal are aware of what features and peripherals are available on the target. -* ``mee.h`` +* ``metal.h`` - The Freedom Metal machine header which is used internally to Freedom Metal to instantiate structures to support the target device. -* ``mee.lds`` +* ``metal.lds`` - The linker script for the target device. @@ -75,10 +90,18 @@ Example Programs The example programs can be found under the ``software/`` directory. +- empty + + - An empty project. Serves as a good starting point for your own program. + - hello - Prints "Hello, World!" to stdout, if a serial device is present on the target. +- example-coreip-welcome + + - Prints a welcome message and interacts with the LEDs. + - return-pass - Returns status code 0 indicating program success. diff --git a/doc/sphinx/userguide/buildingcoreip.rst b/doc/sphinx/userguide/buildingcoreip.rst index 7479931..986ad68 100644 --- a/doc/sphinx/userguide/buildingcoreip.rst +++ b/doc/sphinx/userguide/buildingcoreip.rst @@ -8,7 +8,7 @@ To compile a bare-metal RISC-V program: .. code-block:: bash - make [PROGRAM=hello] [TARGET=coreip-e31] software + make [PROGRAM=hello] [TARGET=coreip-e31-rtl] 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 @@ -18,7 +18,7 @@ Core IP target, you would instead run the command .. code-block:: bash - make PROGRAM=timer-interrupt TARGET=coreip-s51 software + make PROGRAM=timer-interrupt TARGET=coreip-s51-rtl software Cleaning a Target Program Build Directory ----------------------------------------- @@ -27,5 +27,5 @@ The ``clean`` target can be used to restore a target program's directory to a cl .. code-block:: bash - make [PROGRAM=hello] [TARGET=coreip-e31] clean + make [PROGRAM=hello] [TARGET=coreip-e31-rtl] clean -- cgit v1.2.3 From 4978fcac7f106ceb02697702b0b28d6954c58ef6 Mon Sep 17 00:00:00 2001 From: Nathaniel Graff Date: Thu, 7 Mar 2019 13:45:50 -0800 Subject: Update generated docs Signed-off-by: Nathaniel Graff --- doc/html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/html b/doc/html index d2eda59..c4ace9c 160000 --- a/doc/html +++ b/doc/html @@ -1 +1 @@ -Subproject commit d2eda59002f476819dc79fd489b735684dfd88f2 +Subproject commit c4ace9ccd13fb0dfbbb5c1d742dfc909f1811462 -- cgit v1.2.3