HT32 创建 范例工程 
============================


获取固件库
-----------------------------
1. **固件库** 在 **资料包** 可以找到 或 holtek 官网 上产品页面 可以下载；
    
- **资料包** 中可以找到 **固件库** 。
  
.. figure:: ../_static/image/Software/Example_Create/image001.png
    :width: 60%
    :align: center
    :alt: 资料包 - 固件库

    资料包 - 固件库

- holtek 官网 上产品页面中，选择下载 **固件库** 。

    `holtek HT32 产品页面 <https://www.holtek.com.cn/products/100998/100999/101003#101003>`_ 

.. figure:: ../_static/image/Software/Example_Create/image002.png
    :width: 80%
    :align: center
    :alt: HT32 产品页面

    HT32 产品页面

    选择下载 **固件库** ： ``HT32_STD_xxxxxxxx.zip``。

.. figure:: ../_static/image/Software/Example_Create/image003.png
    :width: 80%
    :align: center
    :alt: 官网固件包下载

    官网固件包下载

.. tip:: 因为 **固件库** 会不定时更新，建议还是使用 **资料包** 内 **固件库** ，且其他资料也可以保持最新版。


2.  解压 **固件库** 压缩包，有如下文件:
   
.. figure:: ../_static/image/Software/Example_Create/image004.png
    :width: 80%
    :align: center
    :alt: 固件库解压

    固件库解压

.. warning::  **固件库** 文件路径 不能有 **中文** 、 **空格** 和 **特殊符号** 。


创建范例工程
------------------------------

1.  选择GPIO范例，打开 ``\example\GPIO\InputOutput`` 文件夹，运行 ``_CreateProject.bat`` 。

.. figure:: ../_static/image/Software/Example_Create/image005.png
    :width: 80%
    :align: center
    :alt: _CreateProject.bat

    _CreateProject.bat


2. 使用 ``_CreateProject.bat`` 生成范例工程。

- 选择需要生成工程的开发环境。

  如 选择 ``Keil MDK-ARM v5`` ，则输入 ``1`` ，确认后出现 ``*`` ， 再输入 ``N`` 确认；  

.. figure:: ../_static/image/Software/Example_Create/image007.png
    :width: 80%
    :align: center
    :alt: 选择开发环境

    选择开发环境

- 输入需要生成工程的HT32型号。
  
  如 **HT32F52352** 输入 ``52352`` ,并输入回车；

.. figure:: ../_static/image/Software/Example_Create/image009.png
    :width: 80%
    :align: center
    :alt: 输入HT32型号

    输入HT32型号


- 工程生成成功，按任意键结束。
  
.. figure:: ../_static/image/Software/Example_Create/image010.png
    :width: 80%
    :align: center
    :alt: 工程生成成功

    工程生成成功



3. 生成范例工程内容如下：

.. figure:: ../_static/image/Software/Example_Create/image011.png
    :width: 80%
    :align: center
    :alt: 范例工程内容

    范例工程内容

.. _ProjectCreateFail : 

.. important:: 
    - 如工程生成失败，需要将 ``_CreateProjectScript.bat`` 文件删除后，才能再使用 ``_CreateProject.bat`` 生成工程。

    .. figure:: ../_static/image/Software/Example_Create/image012.png
        :width: 80%
        :align: center
        :alt: _CreateProjectScript.bat

        _CreateProjectScript.bat 

    - 如需要更换 开发环境 和 HT32型号 ，还需要将 ``_CreateProjectConfig.bat`` 文件删除。

    .. figure:: ../_static/image/Software/Example_Create/image013.png
        :width: 80%
        :align: center
        :alt: _CreateProjectConfig.bat

        _CreateProjectConfig.bat



1.  打开 ``\MDK_ARMv5`` ，可打开对应的工程项目文件。

.. figure:: ../_static/image/Software/Example_Create/image014.png
    :width: 80%
    :align: center
    :alt: 打开工程项目文件

    打开工程项目文件


**现在可以试用范例了！**



**HT32 创建 范例工程** 常见问题，请参考 :ref:`FAQ  <project_create_faq>` 。