-
Notifications
You must be signed in to change notification settings - Fork 53
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
doc: add initial doc for gd32vf103c_dlink board
Signed-off-by: Huaqi Fang <[email protected]>
- Loading branch information
Showing
4 changed files
with
63 additions
and
0 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,60 @@ | ||
.. _design_board_gd32vf103c_dlink: | ||
|
||
GD32VF103C DLink Debugger | ||
========================= | ||
|
||
.. _design_board_gd32vf103c_dlink_overview: | ||
|
||
Overview | ||
-------- | ||
|
||
This GD32VF103C DLink Debugger is used to debug Nuclei RISC-V CPU from Nuclei | ||
using **GD32VF103CVBT6** as main MCU. | ||
|
||
.. _figure_design_board_gd32vf103c_dlink_1: | ||
|
||
.. figure:: /asserts/images/gd32vf103c_dlink_board.jpg | ||
:width: 80 % | ||
:align: center | ||
:alt: GD32VF103C DLink Debugger Board | ||
|
||
GD32VF103C DLink Debugger Board | ||
|
||
Click https://github.com/nuclei-Software/nuclei-dlink to learn more about | ||
Nuclei DLink project. | ||
|
||
.. _design_board_gd32vf103c_dlink_setup: | ||
|
||
Setup | ||
----- | ||
|
||
|
||
.. _design_board_gd32vf103c_dlink_usage: | ||
|
||
How to use | ||
---------- | ||
|
||
For **GD32VF103C DLink Debugger** board, the **DOWNLOAD** and **CORE** variables | ||
are fixed to ``flashxip`` and ``n205``. | ||
|
||
* You can find its linker script in ``SoC/gd32vf103/Board/gd32vf103c_dlink/Source/GCC/`` | ||
|
||
- ``gcc_gd32vf103_flashxip.ld``: Linker script file for ``DOWNLOAD=flashxip`` | ||
|
||
* If you want to specify your own modified linker script, you can follow steps described in :ref:`develop_appdev_linkscript` | ||
* You can find its openocd configuration file in ``SoC/gd32vf103/Board/gd32vf103c_dlink/openocd_gd32vf103.cfg`` | ||
|
||
To run this application in GD32VF103C DLink Debugger board in Nuclei SDK, | ||
you just need to use this **SOC** and **BOARD** variables. | ||
|
||
.. code-block:: shell | ||
# Clean the application | ||
make SOC=gd32vf103 BOARD=gd32vf103c_dlink clean | ||
# Build the application | ||
make SOC=gd32vf103 BOARD=gd32vf103c_dlink all | ||
# Upload the application using openocd and gdb | ||
make SOC=gd32vf103 BOARD=gd32vf103c_dlink upload | ||
# Debug the application using openocd and gdb | ||
make SOC=gd32vf103 BOARD=gd32vf103c_dlink debug | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters