Holtek Configuration Wizard

A visual configuration editor for HT32 firmware files in VS Code.
Supports Keil-compatible Configuration Wizard syntax — the same markup used in Keil MDK for graphical configuration of peripheral settings.

Features

• Wizard view for HT32 configuration files — no need to manually edit #define values
• Keil-compatible syntax — reads the same <<< Use Configuration Wizard in Context Menu >>> markup
• Offset-based write-back — only the changed value is updated; all comments, whitespace, and surrounding code are preserved
• Supports all four HT32 config file types:

Usage

Open in Wizard View

Method 1 — Editor title button (recommended):

1. Open any supported file (.h, .c, or .s) in the text editor
2. Click the Preview button ( ) in the top-right of the editor
3. The file switches to Wizard view in the same tab
4. Click the Go to File button to switch back to the text editor

Method 2 — Right-click context menu:

1. Right-click any .h, .c, or .s file in the Explorer
2. Select Open in Holtek Configuration Wizard

Method 3 — Command Palette:

1. Open the file in the text editor
2. Press Ctrl+Shift+P
3. Run HT32: Open in Holtek Configuration Wizard

Edit Values

• Checkbox (<q>) — toggle on/off
• Dropdown (<o> with options) — select from predefined values
• Number input (<o> with range) — enter a value within the allowed range
• Enable section (<e>) — master checkbox enables/disables a group of settings
• Heading (<h>) — collapsible group, click to expand/collapse

Changes are written back to the source file immediately. The text editor view reflects edits in real time.

Supported Wizard Syntax

//-------- <<< Use Configuration Wizard in Context Menu >>> -----------------

// <h> Group Title
//   <q0> Enable Feature         → checkbox, maps to #define [0]
//   <o1> Select Mode            → dropdown, maps to #define [1]
//       <0=> Mode A
//       <1=> Mode B
//   <o2> Buffer Size <4-1024:4> → number input 4~1024 step 4
// </h>

// <e0> Enable Section           → master checkbox
//   <o1.3> Enable Bit 3        → single bit of #define [1]
// </e>

Requirements

• VS Code 1.74.0 or later
• Windows x64
• Recommended: install alongside Holtek Project Assistant for VS Code

Works Best With

Holtek Project Assistant for VS Code — converts Keil uVision / HT32-IDE projects to VS Code, with build, flash, and debug support. This wizard extension is automatically installed when you install the Project Assistant.

Release Notes

0.1.0 (Preview)

• Initial release
• Supports ht32f5xxxx_conf.h, system_ht32f5xxxx_NN.c, ht32f5xxxx_NN_usbdconf.h, startup_ht32f5xxxx_NN.s
• Wizard view via Custom Editor API (Open With menu)

License

MIT © Holtek Semiconductor Inc.