65 lines
1.9 KiB
ReStructuredText
65 lines
1.9 KiB
ReStructuredText
.. _longan_nano:
|
|
|
|
Sipeed Longan Nano
|
|
##################
|
|
|
|
Overview
|
|
********
|
|
|
|
The Sipeed Longan Nano and Longan Nano Lite is an simple and tiny development board with
|
|
an GigaDevice GD32VF103 SoC that based on N200 RISC-V IP core by Nuclei system technology.
|
|
More information can be found on:
|
|
|
|
- `Sipeed Longan website <https://longan.sipeed.com/en/>`_
|
|
- `GD32VF103 datasheet <https://www.gigadevice.com/datasheet/gd32vf103xxxx-datasheet/>`_
|
|
- `GD32VF103 user manual <http://www.gd32mcu.com/data/documents/shujushouce/GD32VF103_User_Manual_EN_V1.2.pdf>`_
|
|
- `Nuclei website <https://www.nucleisys.com/download.php>`_
|
|
- `Nuclei Bumblebee core documents <https://github.com/nucleisys/Bumblebee_Core_Doc>`_
|
|
- `Nuclei ISA Spec <https://doc.nucleisys.com/nuclei_spec/>`_
|
|
|
|
Programming and debugging
|
|
*************************
|
|
|
|
Building
|
|
========
|
|
|
|
Applications for the ``logan_nano`` board configuration can be built as usual
|
|
(see :ref:`build_an_application`) using the corresponding board name:
|
|
|
|
.. zephyr-app-commands::
|
|
:board: logan_nano
|
|
:goals: build
|
|
|
|
Flashing
|
|
========
|
|
|
|
In order to upload the application to the device, you'll need OpenOCD with
|
|
GD32V support. Download the tarball for your OS from the
|
|
`SiPEED longan nano download site
|
|
<http://dl.sipeed.com/LONGAN/platformio/dl-packages/>`_ and extract it.
|
|
|
|
The Zephyr SDK uses a bundled version of OpenOCD by default. You can
|
|
overwrite that behavior by adding the
|
|
``-DOPENOCD=<path/to/riscv-openocd/bin/openocd>``
|
|
parameter when building:
|
|
|
|
.. zephyr-app-commands::
|
|
:board: longan_nano
|
|
:goals: build
|
|
:gen-args: -DOPENOCD=<path/to/riscv-openocd/bin/openocd>
|
|
|
|
When using a custom toolchain it should be enough to have the downloaded
|
|
version of the binary in your ``PATH``.
|
|
|
|
Now you can flash the application as usual (see :ref:`build_an_application` and
|
|
:ref:`application_run` for more details):
|
|
|
|
.. code-block:: console
|
|
|
|
west flash
|
|
|
|
Debugging
|
|
=========
|
|
|
|
Refer to the detailed overview about :ref:`application_debugging`.
|