| .. zephyr:board:: 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 <https://www.gd32mcu.com/data/documents/userManual/GD32VF103_User_Manual_Rev1.4.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/>`_ |
| |
| Hardware |
| ******** |
| |
| - 4 x universal 16-bit timer |
| - 2 x basic 16-bit timer |
| - 1 x advanced 16-bit timer |
| - Watchdog timer |
| - RTC |
| - Systick |
| - 3 x USART |
| - 2 x I2C |
| - 3 x SPI |
| - 2 x I2S |
| - 2 x CAN |
| - 1 x USBFS(OTG) |
| - 2 x ADC(10 channel) |
| - 2 x DAC |
| |
| Supported Features |
| ================== |
| |
| .. zephyr:board-supported-hw:: |
| |
| The microSD card reader in Longan Nano board is connected to SPI1. |
| |
| Serial Port |
| =========== |
| |
| USART0 is on the opposite end of the USB. |
| Connect to TX0 (PA9) and RX0 (PA10). |
| |
| Programming and debugging |
| ************************* |
| |
| .. zephyr:board-supported-runners:: |
| |
| Building & Flashing |
| =================== |
| |
| Here is an example for building the :zephyr:code-sample:`blinky` application. |
| |
| .. zephyr-app-commands:: |
| :zephyr-app: samples/basic/blinky |
| :board: longan_nano |
| :goals: build flash |
| |
| When using a custom toolchain it should be enough to have the downloaded |
| version of the binary in your ``PATH``. |
| |
| The default runner tries to flash the board via an external programmer using openocd. |
| To flash via the USB port, select the DFU runner when flashing: |
| |
| .. code-block:: console |
| |
| west flash --runner dfu-util |
| |
| Debugging |
| ========= |
| |
| You can debug an application in the usual way. Here is an example for the |
| :zephyr:code-sample:`blinky` application. |
| |
| .. zephyr-app-commands:: |
| :zephyr-app: samples/basic/blinky |
| :board: longan_nano |
| :maybe-skip-config: |
| :goals: debug |
