硬件信息
=================

.. important:: 
   - 以下内容仅适用于 HT32 M0p & HT32 M3 系列芯片。


引脚图
---------------

HT32 可以从 **引脚图** 中看出， **GPIO** 所对应的电源域，因不同 **GPIO** 所对应的电源域不同，在不同状态时需注意高低电平的电位。

- HT32 M0+  example

.. figure:: ../_static/image/Hardware/HWInfo/HT32_PINMAP_M0p.png
   :width: 90%
   :align: center
   :alt: HT32 M0+ 引脚图

   HT32 M0+ 引脚图

- HT32 M3 example
  
.. figure:: ../_static/image/Hardware/HWInfo/HT32_PINMAP_M3.png
   :width: 90%
   :align: center
   :alt: HT32 M3 引脚图

   HT32 M3 引脚图

具体请参考型号对应的 ``HT32Fxxxxx_Datasheet.pdf`` 内 **引脚图** 章节。

.. tip:: 
   - HT32 相同系列 ，相同封装， MCU 脚位是 PIN to PIN , 如 **HT32F50230/48LQFP** 和 **HT32F50241/48LQFP** 是 PIN to PIN 。
   - 关于HT32 硬件设计原理图和PCB的相关内容，可参考 :doc:`./hwdesgin`


引脚分配
---------------

HT32 **GPIO** 有很多复用功能，可在 **引脚分配** 内查询对应的功能。

.. figure:: ../_static/image/Hardware/HWInfo/PIN_AFIO.png
   :width: 90%
   :align: center
   :alt: 引脚分配

   引脚分配

具体可参考型号对应的 ``HT32Fxxxxx_Datasheet.pdf`` 内 **引脚分配** 章节。

.. tip::
    - HT32 可多个 **GPIO** 复用相同的功能。
    - HT32 如 **引脚分配** 内复用的功能没有标明功能标号，即为标号 0 ，如 UR_TX ，对应为 UR0_TX .


引脚描述
---------------

1. HT32 **GPIO** 复位时，一般初始状态为 浮空状态 **Floating** ，但是有特殊的 GPIO 复位时为 上拉状态  **PULLHIGH** ，
   使用的时候需要特别注意其 **GPIO** 初始状态，如下：

+-------------------+------------------+
| M0+ GPIO PULLHIGH | M3 GPIO PULLHIGH |
+===================+==================+
| nRST              | nRST             |
+-------------------+------------------+
| X                 | PA8_BOOT0        |
+-------------------+------------------+
| PA9_BOOT          | PA9_BOOT1        |
+-------------------+------------------+
| PA12_SWCLK        | PA12_JTCK/SWCLK  |
+-------------------+------------------+
| PA13_SWDIO        | PA13_JTMS/SWDIO  |
+-------------------+------------------+
| X                 | PA14_JTDI        |
+-------------------+------------------+
| X                 | PA15_JTRST       |
+-------------------+------------------+

具体可参考型号对应的 ``HT32Fxxxxx_Datasheet.pdf`` 内 **引脚描述** 章节。

.. _HT32_CLDO_ULDO:

2. **CLDO / ULDO** 是 HT32 内核 LDO VCORE 输出电源，必须外接一个电容：
         
    - M0+ **CLDO / ULDO** 外接电容推荐使用 **MLCC电容 2.2uF** 。
     

  
    .. figure:: ../_static/image/Hardware/HWDesgin/HT32_CLDO_M0p.png
        :width: 80%
        :align: center
        :alt: HT32_CLDO_M0+

        HT32_CLDO_M0+

    .. figure:: ../_static/image/Hardware/HWDesgin/HT32_ULDO_M0p.png
        :width: 80%
        :align: center
        :alt: HT32_ULDO_M0+

        HT32_ULDO_M0+    

    - M3 **CLDO / ULDO** 外接电容推荐使用 **MLCC电容 10uF** 。
  
    .. figure:: ../_static/image/Hardware/HWDesgin/HT32_CLDO_M3.png
        :width: 80%
        :align: center
        :alt: HT32_CLDO_M3

        HT32_CLDO_M3



3. HT32 特殊功能 **GPIO** ，会在 HT32 **上电/复位状态**  时，影响HT32的运行状态。
   
.. _HT32_nRST:

    - **nRST** : 内置弱上拉，建议外部搭配 10KΩ + 0.1uF 组合，或根据需要调整。

.. _HT32_BOOT:

    - **BOOT** : **仅HT32 M0+** 使用 , **PA9_BOOT** 为 **上电/复位状态** 时，设置HT32 M0+ 的启动区域。
  
      - **启动加载器** ``Bootloader`` , 可参考 :doc:`../Software/application_iap` 
      - 内置弱上拉， **高** 电平，默认从 **主FLASH** (用户程序) 启动。
    

    .. figure:: ../_static/image/Hardware/HWInfo/HT32_M0+_BOOT.png
        :width: 90%
        :align: center
        :alt: HT32 M0+ 启动配置

        HT32 M0+ 启动配置

    **BOOT** 的详细介绍，可参考 ``HT32Fxxxxx_UserManual.pdf`` 中 **FMC -> 启动配置** 。
        
   - **BOOT0/1** : **仅HT32 M3** 使用 , **PA8_BOOT0 & PA9_BOOT1** 为 **上电/复位状态** 时，设置HT32 M3 的启动区域。

       - **启动加载器** ``Bootloader`` , 可参考 :doc:`../Software/application_iap` 
       - 内置弱上拉， **高** 电平，默认从 **主FLASH** (用户程序) 启动。

    .. figure:: ../_static/image/Hardware/HWInfo/HT32_M3_BOOT.png
        :width: 90%
        :align: center
        :alt: HT32 M3 启动配置

        HT32 M3 启动配置

    **BOOT0/1** 的详细介绍，可参考 ``HT32Fxxxxx_UserManual.pdf`` 中 **FMC -> 启动配置** 。    


.. tip:: 
    - 如果要使用 **ISP 烧录** ，HT32 需要进入 **启动加载器** ``Bootloader`` 进行，则需要将 **BOOT** 引出进行控制。
    - **BOOT** 内置弱上拉(约几十KΩ)，抗干扰较弱，建议设计电路时外加 4.7KΩ 上拉电阻，提高抗干扰能力。
    - **BOOT** 电平仅在 **上电/复位状态** 时生效，其他时候可复用为 **GPIO** ，但是需保证在 **上电/复位状态** 时不能有意外的电平出现，建议不得已不要作为 GPIO 使用。

存储器映射
--------------------------------

HT32 内部存储器都映射到一个连续的地址上，供参考：

.. figure:: ../_static/image/Hardware/HWInfo/HT32_Address.png
    :width: 50%
    :align: center
    :alt: HT32 地址映射

    HT32 地址映射

具体可参考型号对应的 ``HT32Fxxxxx_Datasheet.pdf`` 内 **存储器映射** 章节。