Build — Integrated CMake + ARM GCC toolchain, with Debug / Release
multi-configuration support.
Flash & Erase — Program firmware to, or erase, the target board through
J-Link or GD-Link.
Source-Level Debug — GDB-based debugging (J-Link / GD-Link) with
breakpoints, stepping, and full call-stack / variable inspection.
Peripheral Registers — Inspect and edit peripheral registers and bit
fields live during a debug session, with one-click Hex / Dec / Bin display
switching.
Disassembly & Memory — Open a disassembly view and a raw memory panel
from the editor context menu while debugging.
Device Management — Scan connected J-Link / GD-Link probes and
view their status; The active probe for flash/debug is chosen
by the current project's .project.json.
Getting Started
Install this GD32 DevSuite VS Code extension.
Open the GD32 Explorer view and check Environment Check — make sure
all required tools (CMake, Ninja, ARM GCC toolchain ...) are installed.
Run GD32: Toolchain Configuration to set the tool paths.
Use GD32: New Project to create a new GD32 MCU project.
Build, erase and flash to develop your MCU application.
Shortcuts
F7 — Build Project
Ctrl+F7 — Erase
Ctrl+F8 — Flash
F5 — Debug
Ctrl+F9 — Project Properties
Requirements
VS Code 1.80.0 or newer
Windows 10/11
A GD32 target board and a J-Link or GD-Link probe for flash/debug workflows
License
See the LICENSE file in the extension folder
(%USERPROFILE%\.vscode\extensions\gigadevicesemiconductor.gd32-devsuite-vscode-<version>-win32-x64\LICENSE).
VS Code only shows a License link for Marketplace extensions, not for VSIX installs.
Feedback
Please file issues on the project tracker or contact the GD32 development team.
