# Sipeed RV Debugger

High-speed 3-IN-1 fast USB ARM/ESP32 JTAG, USB-to-RS232 virtual port and power supply 5VDC device. Official reference can be found here.

Contents

- Configuration

- Drivers

- Wiring Connections

- Platforms

- Frameworks

- Boards

## Configuration

You can configure debugging tool using debug_tool option in “platformio.ini” (Project Configuration File):

    [env:myenv]
    platform = ...
    board = ...
    debug_tool = sipeed-rv-debugger

If you would like to use this tool for firmware uploading, please change upload protocol:

    [env:myenv]
    platform = ...
    board = ...
    debug_tool = sipeed-rv-debugger
    upload_protocol = sipeed-rv-debugger

More options:

- Debugging options

- Upload options

## Drivers

Windows

  - Step-by-step guide: Drivers, Zadig, Wiring

  - Video tutorial

Mac

  macOS contains default FTDIUSBSerialDriver driver which conflicts with debug tools which are based on this chip. FTDI Chip company recommends removing this default driver from a system. Everything should work after system rebooting. See detailed instruction in official application note (Page 16, Section 4: Uninstalling FTDI Drivers on OS X) AN134: FTDI Drivers Installation guide for MAC OS X

Linux

  Please install “udev” rules 99-platformio-udev.rules. If you already installed them before, please check that your rules are up-to-date or repeat steps.

## Wiring Connections

Sipeed RV Debugger Connector | Board JTAG Pin | Description
--- | --- | ---
1 | GND | Digital ground
2 | TDI | Test Data In pin
6 | TMS | Test Mode State pin
10 | TCK | JTAG Return Test Clock
8 | TDO | Test Data Out pin
4 | RST | Connect this pin to the (active low) reset input of the target CPU

## Platforms

Name | Description
--- | ---
GigaDevice GD32V | The GigaDevice GD32V device is a 32-bit general-purpose microcontroller based on the RISC-V core with an impressive balance of processing power, reduced power consumption and peripheral set.
Kendryte K210 | Kendryte K210 is an AI capable RISCV64 dual core SoC.

## Frameworks

Name | Description
--- | ---
Arduino | Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences.
GigaDevice GD32V SDK | GigaDevice GD32VF103 Firmware Library (SDK)
Kendryte Standalone SDK | Kendryte Standalone SDK without OS support
Kendryte FreeRTOS SDK | Kendryte SDK with FreeRTOS support

## Boards

Note

For more detailed `board` information please scroll tables below by horizontal.

Name | Platform | Debug | MCU | Frequency | Flash | RAM
--- | --- | --- | --- | --- | --- | ---
GD32VF103V-EVAL | GigaDevice GD32V | External | GD32VF103VBT6 | 108MHz | 128KB | 32KB
Sipeed Longan Nano | GigaDevice GD32V | External | GD32VF103CBT6 | 108MHz | 128KB | 32KB
Sipeed Longan Nano Lite | GigaDevice GD32V | External | GD32VF103C8T6 | 108MHz | 64KB | 20KB
Sipeed MAIX BiT | Kendryte K210 | External | K210 | 400MHz | 16MB | 6MB
Sipeed MAIX BiT with Mic | Kendryte K210 | External | K210 | 400MHz | 16MB | 6MB
Sipeed MAIX GO | Kendryte K210 | External | K210 | 400MHz | 16MB | 6MB
Sipeed MAIX ONE DOCK | Kendryte K210 | External | K210 | 400MHz | 16MB | 6MB
Sipeed MAIXDUINO | Kendryte K210 | External | K210 | 400MHz | 16MB | 6MB
Sipeed MF1 MF1 | Kendryte K210 | External | K210 | 400MHz | 16MB | 6MB
Wio Lite RISC-V | GigaDevice GD32V | External | GD32VF103CBT6 | 108MHz | 128KB | 32KB