Keil MDK-Holtek Edition
Introduction
The purpose of this installation guide is to familiarise users with the Keil® MDK Micro-controller Development Kit, provide installation information and how to obtain a free serial number. The Keil MDK can be applied to the Holtek Arm® Cortex-M0+ series MCUs and its V5.28 or later versions which are free for use without code size restrictions. In addition to the free versions, the Keil MDK also offers a low-cost version for the Holtek Arm Cortex-M3/M4 series products which can be purchased from Arm’s online store.
The guide includes three parts: Installation Requirements, Installation Process and Environment Confirmation. More detailed information is available at the following website.
M0+ version download website: http://www2.keil.com/holtek/ht-edition. Free serial numbers and more information are available.
M3/M4 version purchase website: https://www2.keil.com/holtek/edition
MDK licensing website: https://developer.arm.com/support
Installation Requirements
- Download the Keil MDK-ARM V5.28 or later version software
- Download and install the HT32 USB Virtual COM driver
- Download the HT32 Standard Peripheral Firmware Library
Download the Keil MDK-ARM Software
The Keil MDK-ARM software can be downloaded from http://www.keil.com. Note that the evaluation version has a limitation on its 32KB of code size. The following steps show how to download the Keil MDK-ARM software.
Step 1: Download from the https://www.keil.com/demo/eval/arm.htm website, and the following screen will appear.
Step 2: Enter your contact information.
Step 3: Press the “Submit” button.
Step 4: Click the installation file download link as shown in the following figure. Refer to the “Installation Process” section for the installation steps.
- Review the hardware requirements before installing this software.
- Note the limitations of the evaluation tools.
- Further installation instructions for MDK5
(MD5: 0be8d26d1ad650d750265a020d1f2e56)
To install the MDK-ARM Software…
- Right-click on MDK_541.EXE and save it to your computer.
- PDF files may be opened with Acrobat Reader.
- ZIP files may be opened with PKZIP or WINZIP.
Download and Install the HT32 Virtual COM Driver
To implement the environment debugging after the installation process is complete, install the HT32 USB Virtual COM driver first. Transfer the data through the Virtual COM together with the Firmware Library example during the debugging process to determine whether the environment is normal or not.
The following steps shows how to obtain and install the HT32 USB Virtual COM driver:
Step 1: Open the Holtek website and press the “MCU Tools” button at the top.
Step 2: Press the “ICE Software” button under the software category on the right corner.
Step 3: Download the “HT32 Virtual COM Driver” with the filename “HT32_VCP_Driver_vnnn. exe”, where “nnn” represents the version number.
Step 4: Execute the installation program by double-clicking on “HT32_VCP_Driver_vnnn.exe”.
Step 5: Press the “Next” button to continue when the screen below appears.
Step 6: After the target path has been confirmed, the “Ready to install” screen will appear. Press the “Install” button to start the installation.
Step 7: After the installation has completed, a completion screen will appear. Press the “Finish” button to exit the installation program.
Download HT32 Standard Peripheral Firmware Library
It is recommended to use a firmware library for development. The following steps show how to obtain a firmware library:
Step 1: Open the Holtek website and press the “MCU Tools” button at the website top.
Step 2: Click the “Development Kit Software” under the “Software” category on the right corner.
Step 3: Download the M0+ firmware library with the filename “HT32_STD_5xxxx_FWLib_ vnnn_yyyy”, where “nnn” represents the version number. In addition, if the M3 series are used, users need to select the M3 firmware library with the filename “HT32_STD_1xxxx_ FWLib_ Vnnn_ yyyy”.
Installation Process
The following two steps should be used to implement the free version.
- Keil MDK-ARM installation
- Activate the Holtek Licenses
Keil MDK-ARM Installation
The Keil MDK-ARM installation steps are shown as follows.
Step 1: Double-click on the MDK installation file with the 
icon. The filename is the “mdknnn. exe”, where “nnn” represents the version number and then press the “Next” button to continue.
Step 2: Confirm the agreement by selecting “I agree to all the terms of the preceding License Agreement”.
Step 3: Press the “Next” button to continue.
Step 4: Confirm the installation path and press the “Next” button to continue.
Step 6: Press the “Next” button to continue.
Step 7: Press the “Finish” button to exit the installation program when the installation setups are finished.
Activate the Holtek Licenses
For the Keil MDK v5.37 or later version, refer to the instructions on the ARM official website or the following steps to activate the Holtek licenses:
Step 1: Open the μVision and go to “File” → “License Management…” and select the “User-Based License” tab. Click the “Activate/Deactivate…” button.
Step 2: Follow the numerical steps labeled in the following figure.
- Enable “License Server”.
- Enter the following license server address: https://holtek-free.licensing.keil.arm.com.
- Click the “Query” button.
- Click on the “Activate” button. The window changes and shows the information of the activated license in the following figure.
If the following error message appears during compilation, change the compiler version as in Figure 16.
*** Error: The configured compiler version ‘5.06 update 7 (build 960)’ does not support the selected User Based Licensing technology.”
*** Build aborted.
Environment Confirmation
The following confirmations can be executed to quickly verify that the development environment is operating correctly.
- HT32 Family Pack Installation
- Firmware Library Debugging
HT32 Family Pack Installation
The installation confirmation steps of the HT32 family Pack are shown in the following.
Step 1: Open the Keil μVision software and press the “Pack Installer” to continue.
Step 2 ~ Step 3: Press the “OK” button when a “Welcome to the Keil Pack Installer” prompt will be generated after it has been read/downloaded.
Step 4: The Holtek devices can be searched by entering the Holtek keyword or by searching for them in the drop-down menu.
Step 5: Click on “Holtek” below the “Device”, the “Holtek::HT32_DFP” will be generated on the right.
Step 6: Click on “Install” and then the “Up to data” will display to indicate the installation is complete.
Firmware Library Debugging
The following shows an example of such a hardware circuit using the HT32F52352 Starter Kit.
Step 1: Download the firmware library compressed file from the Holtek website and unzip it. The file name is “HT32_STD_5xxxx_FWLib_vnnn_yyyy”, where “nnn” represents the version number.
Step 2: Click the “HT32_STD_5xxxx_FWLib_vnnn_yyyy” → “project_ template” → “IP” → “Example” → “MDK_ARMv5” → “Project_ xxxxx. uvprojx”, where “xxxxx” represents the MCU part number. This installation guide takes the HT32F52352 as a debugging example.
Step 3: Click on “Build (F7)”.
Step 4: Check on the “Bulid Output” window to observe whether the program compilations are correct.
Step 5: The e-link32 lite USB port on the HT32F52352 Starter Kit is connected to a PC as shown on the left. Confirm that the PC has detected the USB device normally, as shown in the right corner.
Step 6: Click on “Download (F8)”.
Step 7: Connecting a jumper to short the DAP_TX and PA5 pins. Configure the PC UART transmission software, the COM port depends on the step 5 settings, such as Baud Rate=115200, Data=8-bit, Parity=none, Stop bits=1-bit and Flow Control= none.
Step 8: When the Reset key is pressed, LED1 and LED2 will flash as observed in the lower left.
The “Hello World! 0” ~ “Hello World! 99” words will display on the Tera Term of the PC via the Virtual COM port, as shown on the right. This indicates that the
environmental debugging is complete.
Appendix: MAC Address Look-up
Windows 7 Look-up Entity Address Steps
Step 1: Open the internet access icon, 
, at the bottom right of the windows toolbar.
Step 2: Click the “Open Network and Sharing Center”
Step 3: Click the “Local Area Connection”.
Step 4: Click on “Details”.
Step 5: Fill in the entity address, Host ID.
Windows 10 Look-up Entity Address Steps
Step 1: Open the internet access icon, 
, at the bottom right of the windows toolbar.
Step 2: Click the “Network & Internet Settings”.
Step 3: Click the “View your network properties”.
Step 4: Fill in the entity address, Host ID.
Reference Material
Reference files: HT32_Keil-QuickStart and e-Link32_e-Link32 Pro User’s Guide.
For more information refer to the Holtek official website https://www.holtek.com.
Copyright© 2024 by HOLTEK SEMICONDUCTOR INC. All Rights Reserved.
The information provided in this document has been produced with reasonable care and attention before publication, however, HOLTEK does not guarantee that the information is completely accurate. The information contained in this publication is provided for reference only and may be superseded by updates. HOLTEK disclaims any expressed, implied or statutory warranties, including but not limited to suitability for commercialization, satisfactory quality, specifications, characteristics, functions, fitness for a particular purpose, and non-infringement of any third party’s rights. HOLTEK disclaims all liability arising from the information and its application. In addition, HOLTEK does not recommend the use of HOLTEK’s products where there is a risk of personal hazard due to malfunction or other reasons. HOLTEK hereby declares that it does not authorise the use of these products in life-saving, life-sustaining or safety critical components. Any use of HOLTEK’s products in life-saving/sustaining or safety applications is entirely at the buyer’s risk, and the buyer agrees to defend, indemnify and hold HOLTEK harmless from any damages, claims, suits, or expenses resulting from such use. The information provided in this document, including but not limited to the content, data, examples, materials, graphs, and trademarks, is the intellectual property of HOLTEK (and its licensors, where applicable) and is protected by copyright law and other intellectual property laws. No license, express or implied, to any intellectual property right, is granted by HOLTEK herein. HOLTEK reserves the right to revise the information described in the document at any time without prior notice. For the latest information, please contact us.
Documents / Resources
 |
HOLTEK Keil MDK-Holtek Edition [pdf] Installation Guide HT32, e-Link32 Pro, Keil MDK-Holtek Edition, MDK-Holtek Edition, Edition |
