A host-side DFU tool for Holtek HT32 devices in In-System Programming (ISP) mode over USB.
- libusb-1 (with headers)
- rust toolchain with cargo
-
Install MSYS2 from https://www.msys2.org/
-
Update MSYS2 environment (from
MSYS2 MINGW64console):
pacman -Syu- Install build tools and dependencies:
pacman -S base-devel \
mingw-w64-x86_64-toolchain \
mingw-w64-x86_64-rust \
mingw-w64-x86_64-libusbTo permit HT32 device access by non-root users in the plugdev group, create
a udev rule file /etc/udev/rules.d/99-ht32.rules containing the following:
# Holtek HT32 ISP USB Interface
SUBSYSTEMS=="usb", ATTRS{idVendor}=="04d9", ATTRS{idProduct}=="8010", MODE="0660", GROUP="plugdev", TAG ="uaccess"
Restart your computer or reload udev rules by running the following commands:
sudo udevadm control --reload
sudo udevadm trigger
Run the following to install directly from git repo:
cargo install --git https://github.com/hansemro/ht32-dfu-tool
To build and install from source directory, run instead:
cd ht32-dfu-tool
cargo install --path .
ht32-dfu-tool [OPTIONS] <COMMAND> [COMMAND_OPTIONS]
Commands:
list List detected devices
info Check device info
read [-c <LENGTH_IN_BYTES>] <ADDR> <FILE>
Read flash starting at ADDR to FILE.
Unless the -c option is specified to read a specific
length of flash in bytes, flash will be read until the
end of flash.
write [-m] [-v] <ADDR> <FILE> [FS_EN] [OBP_EN] [PP0] [PP1] [PP2] [PP3]
Erase affected regions of flash, then write FILE to
flash starting at ADDR, and optionally set flash
security, option byte protection, and page protection.
By default, a page erase is performed over any pages
that will be overwritten. However, if the -m or
--mass-erase option is specified, then a mass erase and
a reset will be performed. Mass erase will wipe all
flash contents including flash security and page
protection.
If -v or --verify option is specified, then the written
region of flash will be validated after writing.
reset Reset to application firmware
reset-iap Reset to IAP (or ISP depending on BOOT pin(s))
help Print this message or the help of the given subcommand(s)
Options:
-d, --device <VID:PID> Specify vendor_id:product_id in hexadecimal [default: 04d9:8010]
-n, --devnum <DEV_NUM> Match given device number in list
-w, --wait Wait for device to appear
-r, --reset Reset after performing command
-h, --help Print help
-V, --version Print version
Tested with HT32F165x and HT32F523xx. Should work with other HT32 MCUs over USB with similar ISP command interface. Refer to user manual on booting configuration to learn more about how to boot into ISP mode.
Distributed under the GPL-2.0 License.