# Nuclei

Configuration

  platform = `nuclei`

Find professional RISC-V Processor IP in Nuclei, first professional RISC-V IP company in Mainland China, match all your requirements in AIoT Era.

For more detailed information please visit vendor site.

Contents

- Examples

- Debugging

- Stable and upstream versions

- Packages

- Frameworks

- Boards

## Examples

Examples are listed from Nuclei development platform repository:

- freertos_demo

- rtthread_demo

- demo_dsp

- helloworld

- dhrystone

- whetstone

- demo_eclic

- ucosii_demo

- coremark

- demo_timer

## Debugging

PIO Unified Debugger - “1-click” solution for debugging with a zero configuration.

- Tools & Debug Probes

  - On-Board Debug Tools

  - External Debug Tools

### Tools & Debug Probes

Supported debugging tools are listed in “Debug” column. For more detailed information, please scroll table by horizontal. You can switch between debugging Tools & Debug Probes using debug_tool option in “platformio.ini” (Project Configuration File).

Warning

You will need to install debug tool drivers depending on your system. Please click on compatible debug tool below for the further instructions.

#### On-Board Debug Tools

Boards listed below have on-board debug probe and ARE READY for debugging! You do not need to use/buy external debug probe.

Name | MCU | Frequency | Flash | RAM
--- | --- | --- | --- | ---
GD32VF103V RVStar Kit | GD32VF103VBT6 | 108MHz | 128KB | 32KB
HummingBird Evaluation Kit | HUMMINGBIRD | 5MHz | 64KB | 64KB

#### External Debug Tools

Boards listed below are compatible with PIO Unified Debugger but DEPEND ON external debug probe. They ARE NOT READY for debugging. Please click on board name for the further details.

Name | MCU | Frequency | Flash | RAM
--- | --- | --- | --- | ---
GD32VF103V Evaluation Kit | GD32VF103VBT6 | 108MHz | 128KB | 32KB

## Stable and upstream versions

You can switch between stable releases of Nuclei development platform and the latest upstream version using platform option in “platformio.ini” (Project Configuration File) as described below.

### Stable

    ; Latest stable version
    [env:latest_stable]
    platform = nuclei
    board = ...

    ; Custom stable version
    [env:custom_stable]
    platform = nuclei@x.y.z
    board = ...

### Upstream

    [env:upstream_develop]
    platform = https://github.com/Nuclei-Software/platform-nuclei.git
    board = ...

## Packages

Name | Description
--- | ---
framework-nuclei-sdk | Nuclei N/NX Embedded Software Development Kit
tool-jlink | SEGGER J-Link Software and Documentation Pack
tool-openocd-nuclei | OpenOCD branch with Nuclei RISCV support
toolchain-riscv-gcc-nuclei | Nuclei RISC-V GCC toolchain

Warning

Linux Users:

> - Install “udev” rules 99-platformio-udev.rules

> - Raspberry Pi users, please read this article Enable serial port on Raspberry Pi.

Windows Users:

> Please check that you have a correctly installed USB driver from board manufacturer

## Frameworks

Name | Description
--- | ---
Nuclei SDK | Open Source Software Development Kit for the Nuclei N/NX processors

## Boards

Note

- You can list pre-configured boards by platformio boards command or PlatformIO Boards Explorer

- For more detailed `board` information please scroll the tables below by horizontally.

### GigaDevice

Name | Debug | MCU | Frequency | Flash | RAM
--- | --- | --- | --- | --- | ---
GD32VF103V Evaluation Kit | External | GD32VF103VBT6 | 108MHz | 128KB | 32KB

### Nuclei

Name | Debug | MCU | Frequency | Flash | RAM
--- | --- | --- | --- | --- | ---
GD32VF103V RVStar Kit | On-board | GD32VF103VBT6 | 108MHz | 128KB | 32KB
HummingBird Evaluation Kit | On-board | HUMMINGBIRD | 5MHz | 64KB | 64KB