boards/arm/ht32f491x3: Add support for the HT32F49163 Starter Kit board by FelipeMdeO · Pull Request #18573 · apache/nuttx

FelipeMdeO · 2026-03-21T21:45:11Z

Summary

This PR improves the existing HT32F491x3 ESK32 board support.

Changes included:

enable board bring-up for esk32:nsh
mount /bin and /proc
enable hello, ostest, dumpstack, and leds in esk32:nsh
add HT32F491x3 internal GPIO helpers
add ESK32 user LED support and register /dev/userleds
add ESK32 board documentation

Impact

Is new feature added? Yes
Impact on user: esk32:nsh now provides /bin, /proc, /dev/userleds, and useful built-in apps
Impact on build: No global build changes
Impact on hardware: Yes, ARM/HT32F491x3 ESK32 board support
Impact on documentation: Yes
Impact on security: No

Testing

./tools/configure.sh -l esk32:nsh
make -j
make -C Documentation html

Hardware tested on HT32F49163 Starter Kit:

NSH boot on USART1
/bin and /proc mounted
/dev/userleds registered
hello, ostest, dumpstack, and leds executed successfully
LED2, LED3, and LED4 toggled correctly

FelipeMdeO · 2026-03-21T23:05:45Z

Hello @acassis , @linguini1 , @xiaoxiang781216 , can you give me some tips before open PR officially, please?

lupyuen · 2026-03-22T06:43:38Z

@FelipeMdeO Can you Rebase with Master Branch to trigger the CI Build? We just fixed the CI Build. Thanks :-)

arch/arm/src/ht32f491x3/Make.defs

acassis · 2026-03-23T13:51:03Z

@FelipeMdeO nice work, please divide this PR in three commits: arch support, board support, documentation

Add initial HT32F491x3 support with startup, IRQ handling, serial console, GPIO helpers, custom vectors, and CMake build files. Signed-off-by: Felipe Moura <moura.fmo@gmail.com>

FelipeMdeO · 2026-03-25T01:15:31Z

@lupyuen , can you review this PR also, please?

xiaoxiang781216 · 2026-03-25T04:27:48Z

please fix:

====================================================================================
Configuration/Tool: esk32/nsh,CONFIG_ARM_TOOLCHAIN_GNU_EABI
2026-03-25 02:01:58
------------------------------------------------------------------------------------
  Cleaning...
  Configuring...
  Disabling CONFIG_ARM_TOOLCHAIN_GNU_EABI
  Enabling CONFIG_ARM_TOOLCHAIN_GNU_EABI
  Building NuttX...
  [1/1] Normalize esk32/nsh
4,7c4,6
< # You can use "make menuconfig" to make any modifications to the installed
< # .config file.
< # You can then do "make savedefconfig" to generate a new defconfig file that
< # includes your modifications.
---
> # You can use "make menuconfig" to make any modifications to the installed .config file.
> # You can then do "make savedefconfig" to generate a new defconfig file that includes your
> # modifications.
13,14d11
< # CONFIG_NSH_DISABLE_IFCONFIG is not set
< # CONFIG_NSH_DISABLE_PS is not set
25d21
< CONFIG_EXAMPLES_LEDS=y
26a23
> CONFIG_EXAMPLES_LEDS=y
30d26
< CONFIG_HT32F491X3_PCLK2_FREQUENCY=150000000
32d27
< CONFIG_HT32F491X3_USART1_SERIALDRIVER=y
50a46
> CONFIG_TASK_NAME_SIZE=0
54,59d49
< CONFIG_TASK_NAME_SIZE=0
< CONFIG_USERLED=y
< CONFIG_USERLED_LOWER=y
< CONFIG_USART1_BAUD=115200
< CONFIG_USART1_BITS=8
< CONFIG_USART1_PARITY=0
62a53,54
> CONFIG_USERLED=y
> CONFIG_USERLED_LOWER=y
Saving the new configuration file
HEAD detached at pull/18573/merge
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   boards/arm/ht32f491x3/esk32/configs/nsh/defconfig
```
by ./tools/refresh.sh --silent esk32/nsh @FelipeMdeO

simbit18 · 2026-03-25T10:54:06Z

Hi @FelipeMdeO I think we need to change the title

boards/arm/ht32f491x3: Add support for the HT32F49163 Starter Kit board

https://www.bestmodulescorp.com/en/esk32-31402.html?srsltid=AfmBOoqVKM-qHVVYK9N7h2s0Mgthe3-KJbZConuKTtdMiuU-q2g0dxVN

This is a new board

Add the ESK32 board with nsh configuration, linker script, board bring-up, flashing helper, and user LED support. Signed-off-by: Felipe Moura <moura.fmo@gmail.com>

FelipeMdeO · 2026-03-25T11:26:32Z

please fix:

====================================================================================
Configuration/Tool: esk32/nsh,CONFIG_ARM_TOOLCHAIN_GNU_EABI
2026-03-25 02:01:58
------------------------------------------------------------------------------------
  Cleaning...
  Configuring...
  Disabling CONFIG_ARM_TOOLCHAIN_GNU_EABI
  Enabling CONFIG_ARM_TOOLCHAIN_GNU_EABI
  Building NuttX...
  [1/1] Normalize esk32/nsh
4,7c4,6
< # You can use "make menuconfig" to make any modifications to the installed
< # .config file.
< # You can then do "make savedefconfig" to generate a new defconfig file that
< # includes your modifications.
---
> # You can use "make menuconfig" to make any modifications to the installed .config file.
> # You can then do "make savedefconfig" to generate a new defconfig file that includes your
> # modifications.
13,14d11
< # CONFIG_NSH_DISABLE_IFCONFIG is not set
< # CONFIG_NSH_DISABLE_PS is not set
25d21
< CONFIG_EXAMPLES_LEDS=y
26a23
> CONFIG_EXAMPLES_LEDS=y
30d26
< CONFIG_HT32F491X3_PCLK2_FREQUENCY=150000000
32d27
< CONFIG_HT32F491X3_USART1_SERIALDRIVER=y
50a46
> CONFIG_TASK_NAME_SIZE=0
54,59d49
< CONFIG_TASK_NAME_SIZE=0
< CONFIG_USERLED=y
< CONFIG_USERLED_LOWER=y
< CONFIG_USART1_BAUD=115200
< CONFIG_USART1_BITS=8
< CONFIG_USART1_PARITY=0
62a53,54
> CONFIG_USERLED=y
> CONFIG_USERLED_LOWER=y
Saving the new configuration file
HEAD detached at pull/18573/merge
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   boards/arm/ht32f491x3/esk32/configs/nsh/defconfig

by ./tools/refresh.sh --silent esk32/nsh @FelipeMdeO

done

linguini1 · 2026-03-26T17:49:00Z

Hello @acassis , @linguini1 , @xiaoxiang781216 , can you give me some tips before open PR officially, please?

Some logs/artifacts from your testing would be great to include!

arch/arm/include/ht32f491x3/chip.h

boards/arm/ht32f491x3/esk32/tools/flash.sh

FelipeMdeO · 2026-03-26T20:20:43Z

Hello @acassis , @linguini1 , @xiaoxiang781216 , can you give me some tips before open PR officially, please?

Some logs/artifacts from your testing would be great to include!

Hello @linguini1 , I am adding log showing ostest and other tests.
teraterm.log

Copilot

Pull request overview

This PR adds/extends NuttX support for the Holtek HT32F491x3 family and the ESK32 (HT32F49163 Starter Kit) board, enabling a usable esk32:nsh configuration with board bring-up, user LEDs, and documentation.

Changes:

Adds an HT32F491x3 ARM chip port (startup, IRQ, SysTick timer, GPIO, USART, vector table, and hardware register headers).
Adds the ESK32 board port (clock config, bring-up mounting /bin + /proc, user LED support via /dev/userleds, build scripts, and a nsh defconfig).
Adds flashing helper scripts (Windows PowerShell + WSL bash) and Sphinx documentation for the platform/board.

Reviewed changes

Copilot reviewed 44 out of 45 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
boards/arm/ht32f491x3/esk32/tools/flash.sh	WSL flashing backend using Holtek OpenOCD package.
boards/arm/ht32f491x3/esk32/tools/flash.py	Host wrapper to dispatch to Windows/WSL flashing backends.
boards/arm/ht32f491x3/esk32/tools/flash.ps1	Native Windows flashing backend using Holtek OpenOCD package.
boards/arm/ht32f491x3/esk32/src/ht32_userleds.c	Implements `board_userled*` APIs for ESK32 LEDs and `/dev/userleds` support.
boards/arm/ht32f491x3/esk32/src/ht32_boot.c	Board clock setup for 150 MHz via HEXT->PLL sequence.
boards/arm/ht32f491x3/esk32/src/ht32_appinit.c	Board bring-up: registers user LEDs and mounts `/bin` + `/proc`.
boards/arm/ht32f491x3/esk32/src/Makefile	Adds board source compilation rules.
boards/arm/ht32f491x3/esk32/src/CMakeLists.txt	Adds board sources for CMake builds and sets LD script.
boards/arm/ht32f491x3/esk32/scripts/ld.script	Linker script for HT32F49163 (256K flash / 48K SRAM).
boards/arm/ht32f491x3/esk32/scripts/Make.defs	Board toolchain/link settings.
boards/arm/ht32f491x3/esk32/include/board.h	Board pin mapping for USART1 and LEDs; board prototypes.
boards/arm/ht32f491x3/esk32/configs/nsh/defconfig	Enables NSH, binfs/procfs mounts, userleds, and test apps for ESK32.
boards/arm/ht32f491x3/esk32/Kconfig	Board-specific Kconfig notes.
boards/arm/ht32f491x3/esk32/CMakeLists.txt	Adds ESK32 board subdirectory for CMake.
boards/Kconfig	Registers `ARCH_BOARD_ESK32` and default board name mapping.
arch/arm/src/ht32f491x3/ht32f491x3_timerisr.c	SysTick setup and timer ISR for HT32F491x3.
arch/arm/src/ht32f491x3/ht32f491x3_start.h	Startup hooks prototypes for HT32F491x3.
arch/arm/src/ht32f491x3/ht32f491x3_start.c	Reset entry/startup, `.bss` clear, `.data` init, then `nx_start()`.
arch/arm/src/ht32f491x3/ht32f491x3_serial.h	USART init and pinmux hook prototypes.
arch/arm/src/ht32f491x3/ht32f491x3_serial.c	USART driver implementation (console + ttyS devices).
arch/arm/src/ht32f491x3/ht32f491x3_lowputc.h	Early console and UART config prototypes.
arch/arm/src/ht32f491x3/ht32f491x3_lowputc.c	Early low-level console setup and board pinmux dispatch for USART.
arch/arm/src/ht32f491x3/ht32f491x3_irq.c	NVIC/exception/IRQ enable/disable/prioritize implementation.
arch/arm/src/ht32f491x3/ht32f491x3_gpio.h	Public internal GPIO helper API for the HT32F491x3 port.
arch/arm/src/ht32f491x3/ht32f491x3_gpio.c	GPIO helper implementation (mode/AF/pull/drive + read/write).
arch/arm/src/ht32f491x3/ht32f491x3_config.h	Consolidates `HAVE_UART`/`HAVE_CONSOLE` feature flags.
arch/arm/src/ht32f491x3/hardware/ht32f491x3_uart.h	UART register offsets/bitfields for HT32F491x3.
arch/arm/src/ht32f491x3/hardware/ht32f491x3_pwc.h	PWC register/bit definitions (LDO output select).
arch/arm/src/ht32f491x3/hardware/ht32f491x3_memorymap.h	Memory map base addresses for HT32F491x3.
arch/arm/src/ht32f491x3/hardware/ht32f491x3_gpio.h	GPIO register offsets and bitfield helper macros.
arch/arm/src/ht32f491x3/hardware/ht32f491x3_flash.h	Flash interface register definitions (wait states).
arch/arm/src/ht32f491x3/hardware/ht32f491x3_crm.h	CRM register offsets/bitfields (clock tree setup).
arch/arm/src/ht32f491x3/chip.h	Chip glue (memory map include, IRQ include, interrupt count).
arch/arm/src/ht32f491x3/arm_vectors.c	Custom vector table layout matching Holtek reserved slots and FWID entry.
arch/arm/src/ht32f491x3/Make.defs	Adds HT32F491x3 chip sources to the ARM build.
arch/arm/src/ht32f491x3/Kconfig	Chip selection + clock frequency config + USART1 serial driver option.
arch/arm/src/ht32f491x3/CMakeLists.txt	Adds HT32F491x3 chip sources to the ARM CMake build.
arch/arm/src/Makefile	Makes `clean/distclean` resilient if the chip dirlink/Make.defs is missing.
arch/arm/include/ht32f491x3/irq.h	Top-level IRQ definitions for HT32F491x3 include tree.
arch/arm/include/ht32f491x3/ht32f491x3_irq.h	External interrupt numbering table for HT32F491x3.
arch/arm/include/ht32f491x3/chip.h	Chip-wide constants (flash size variants, SRAM size, clock macros, NVIC priorities).
arch/arm/Kconfig	Registers `ARCH_CHIP_HT32F491X3` and sources the chip Kconfig.
Documentation/platforms/arm/ht32f491x3/index.rst	Adds platform documentation index and board toctree.
Documentation/platforms/arm/ht32f491x3/boards/esk32/index.rst	Adds ESK32 board documentation (features, pinout, build/flash/testing).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

arch/arm/src/ht32f491x3/ht32f491x3_timerisr.c

arch/arm/src/ht32f491x3/ht32f491x3_start.c

Document the HT32F491x3 ESK32 board, build steps, flashing flow, and validation commands. Add WSL and PowerShell flash backends plus a Python wrapper. Signed-off-by: Felipe Moura <moura.fmo@gmail.com>

github-actions bot added Area: Build system Arch: arm Issues related to ARM (32-bit) architecture Size: XL The size of the change in this PR is very large. Consider breaking down the PR into smaller pieces. Board: arm labels Mar 21, 2026

FelipeMdeO force-pushed the feature/ht32f49xx_port branch 2 times, most recently from 8050202 to 1e40242 Compare March 21, 2026 22:16

simbit18 reviewed Mar 22, 2026

View reviewed changes

arch/arm/src/ht32f491x3/Make.defs Show resolved Hide resolved

FelipeMdeO force-pushed the feature/ht32f49xx_port branch from 1e40242 to a63d9ad Compare March 25, 2026 00:20

arch/arm/ht32f491x3: add initial support

fb32c5f

Add initial HT32F491x3 support with startup, IRQ handling, serial console, GPIO helpers, custom vectors, and CMake build files. Signed-off-by: Felipe Moura <moura.fmo@gmail.com>

FelipeMdeO force-pushed the feature/ht32f49xx_port branch from 98c405a to 48beede Compare March 25, 2026 00:54

FelipeMdeO marked this pull request as ready for review March 25, 2026 01:13

FelipeMdeO requested review from acassis, jerpelea, raiden00pl and xiaoxiang781216 as code owners March 25, 2026 01:13

FelipeMdeO requested a review from simbit18 March 25, 2026 01:13

FelipeMdeO changed the title ~~boards/arm/ht32f491x3: improve ESK32 nsh bring-up and userled support~~ boards/arm/ht32f491x3: Add support for the HT32F49163 Starter Kit board Mar 25, 2026

boards/arm/ht32f491x3: add ESK32 board support

166197e

Add the ESK32 board with nsh configuration, linker script, board bring-up, flashing helper, and user LED support. Signed-off-by: Felipe Moura <moura.fmo@gmail.com>

FelipeMdeO force-pushed the feature/ht32f49xx_port branch from 48beede to 9bf613f Compare March 25, 2026 11:25

xiaoxiang781216 previously approved these changes Mar 26, 2026

View reviewed changes

acassis reviewed Mar 26, 2026

View reviewed changes

arch/arm/include/ht32f491x3/chip.h Outdated Show resolved Hide resolved

boards/arm/ht32f491x3/esk32/tools/flash.sh Show resolved Hide resolved

Copilot AI review requested due to automatic review settings March 26, 2026 21:07

FelipeMdeO dismissed xiaoxiang781216’s stale review via 447f2b5 March 26, 2026 21:07

FelipeMdeO force-pushed the feature/ht32f49xx_port branch from 9bf613f to 447f2b5 Compare March 26, 2026 21:07

Copilot started reviewing on behalf of FelipeMdeO March 26, 2026 21:07 View session

FelipeMdeO requested review from acassis and xiaoxiang781216 March 26, 2026 21:09

FelipeMdeO force-pushed the feature/ht32f49xx_port branch from 447f2b5 to c9b7689 Compare March 26, 2026 21:11

Copilot AI reviewed Mar 26, 2026

View reviewed changes

arch/arm/src/ht32f491x3/ht32f491x3_timerisr.c Show resolved Hide resolved

arch/arm/src/ht32f491x3/ht32f491x3_start.c Show resolved Hide resolved

ht32f491x3/esk32: add docs and flash helpers

981ca61

Document the HT32F491x3 ESK32 board, build steps, flashing flow, and validation commands. Add WSL and PowerShell flash backends plus a Python wrapper. Signed-off-by: Felipe Moura <moura.fmo@gmail.com>

FelipeMdeO force-pushed the feature/ht32f49xx_port branch from c9b7689 to 981ca61 Compare March 26, 2026 21:16

xiaoxiang781216 approved these changes Mar 27, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

boards/arm/ht32f491x3: Add support for the HT32F49163 Starter Kit board#18573

boards/arm/ht32f491x3: Add support for the HT32F49163 Starter Kit board#18573
FelipeMdeO wants to merge 3 commits intoapache:masterfrom
FelipeMdeO:feature/ht32f49xx_port

FelipeMdeO commented Mar 21, 2026 •

edited

Loading

Uh oh!

FelipeMdeO commented Mar 21, 2026

Uh oh!

lupyuen commented Mar 22, 2026

Uh oh!

Uh oh!

acassis commented Mar 23, 2026

Uh oh!

FelipeMdeO commented Mar 25, 2026

Uh oh!

xiaoxiang781216 commented Mar 25, 2026

Uh oh!

simbit18 commented Mar 25, 2026

Uh oh!

FelipeMdeO commented Mar 25, 2026

Uh oh!

linguini1 commented Mar 26, 2026

Uh oh!

Uh oh!

Uh oh!

FelipeMdeO commented Mar 26, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

Conversation

FelipeMdeO commented Mar 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Impact

Testing

Uh oh!

FelipeMdeO commented Mar 21, 2026

Uh oh!

lupyuen commented Mar 22, 2026

Uh oh!

Uh oh!

acassis commented Mar 23, 2026

Uh oh!

FelipeMdeO commented Mar 25, 2026

Uh oh!

xiaoxiang781216 commented Mar 25, 2026

Uh oh!

simbit18 commented Mar 25, 2026

Uh oh!

FelipeMdeO commented Mar 25, 2026

Uh oh!

linguini1 commented Mar 26, 2026

Uh oh!

Uh oh!

Uh oh!

FelipeMdeO commented Mar 26, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

FelipeMdeO commented Mar 21, 2026 •

edited

Loading