J-Link 使用相关
==========================

.. figure:: ../_static/image/Start/j-link.png
   :width: 80%
   :align: center
   :alt: J-Link

   J-Link


J-Link 补丁安装
------------------------

1. 先下载 **J-Link Software** 软件，并安装软件（默认选项安装即可）。

`J-Link Software 下载`_  

.. _J-Link Software 下载: https://www.segger.com/downloads/jlink

.. tip:: J-Link Software 建议使用 ``V756d`` 版本，过高版本可能和补丁不相容。

.. figure:: ../_static/image/Tools/jlink/image001.png
   :width: 80%
   :align: center
   :alt: J-Link Software

   J-Link Software


.. figure:: ../_static/image/Tools/jlink/image002.png
   :width: 80%
   :align: center
   :alt: J-Link Software 安装

   J-Link Software 安装


2. 安装 **J-Link 补丁包**  ``HT32_J-Link_Plugin.exe`` （默认选项安装即可）。


**J-Link 补丁包**  在 ``资料包\Tools\HT32_J-Link_Plugin.exe`` , **资料包** 下载 :doc:`/Start/package`         

.. figure:: ../_static/image/Tools/jlink/image003.png
   :width: 80%
   :align: center
   :alt: J-Link 补丁

   J-Link 补丁

.. tip:: 
   **J-Link 补丁包**  ``HT32_J-Link_Plugin.exe`` 也可在官网 `开发工具页面 <https://www.holtek.com.cn/ice>`_ 下载。

   .. figure:: ../_static/image/Tools/jlink/image004.png
      :width: 80%
      :align: center
      :alt: HT32_J-Link_Plugin

      HT32_J-Link_Plugin


3. 安装 **J-Link 补丁包** 完成后，打开 **J-Link 烧录软件** ``J-Flash`` ，可查看到现在 **J-Link** 支持HT32型号的列表。

.. figure:: ../_static/image/Tools/jlink/image006.png
   :width: 80%
   :align: center
   :alt: J-Flash

   J-Flash



J-Link + KEIL 仿真&烧录 配置
------------------------------------------------


1. 在 KEIL5 工程中， ``Option -> Debug`` 中， 使用 **J-Link** 选择 ``J-LINK J-TRACE Cortex``  。

.. figure:: ../_static/image/Tools/jlink/image010.png
   :width: 80%
   :align: center
   :alt: 选择 Debugger

   选择 Debugger



2. 在 ``Option -> Debug`` 选项中，打开 ``Setting`` 设置，将 ``CMSIS-DAP-JTAG/SW Adapter`` 设置如下：  

   - **Port** ： ``SW``
   - **Max Clock** ： ``1MHz``  ，请保证接线较短，接触良好，否则建议降低速度，如选择 ``500kHz`` 。
   - **Auto Clk** ：自动测量当前可使用的 **Max Clock** 。


.. figure:: ../_static/image/Tools/jlink/image011.png
   :width: 80%
   :align: center
   :alt: J-Link 配置

   J-Link 配置


3. 其余配置项目和仿真&烧录方法，与 **e-Link32Pro** 配置 **Debugger** 操作相同，可参考 :ref:`Debugger 配置 <Debugger set>` 。





J-Link + J-Flash 烧录 
-------------------------------

1. 打开 **J-Link 烧录软件** ``J-Flash`` ：


.. figure:: ../_static/image/Tools/jlink/image020.png
   :width: 30%
   :align: center
   :alt: J-Flash

   J-Flash


2.  在 ``J-Flash`` 中，选择 **新建烧录工程** ``Create new project`` ：
   
   - **target device** ：选择需要烧录的HT32型号，如选择 HT32F52352 
   - **target interface** : SWD 烧录速率，如果烧录过程失败，建议降低 SWD 烧录速率。
   - **Speed** ：使用SWD接口;
  

.. figure:: ../_static/image/Tools/jlink/image006.png
   :width: 80%
   :align: center
   :alt: J-Flash 新建烧录工程

   J-Flash 新建烧录工程

.. tip:: 如果之前有 ``J-Flash`` 烧录工程，选择 **打开烧录工程** ``Open recent project`` 即可。



3. J-Link SWD 和 MCU SWD 接口连接，在 ``Target`` 下拉项目中，选择 ``Connect`` 进行连接MCU。

   SWD 连接方法：
   - J-Link - **Vtref** <--> MCU - **VDD**
   - J-Link - **SWCLK** <--> MCU - **SWCLK**
   - J-Link - **SWDIO** <--> MCU - **SWDIO**
   - J-Link - **RESET** <--> MCU - **nRST** （按需连接，如有SWD端口复用为其他功能，则必须连接。）
   - J-Link - **GND**   <--> MCU - **VSS**


.. figure:: ../_static/image/Tools/jlink/image024.png
   :width: 80%
   :align: center
   :alt: J-Flash 连接MCU

   J-Flash 连接MCU


4. 连接成功，在 ``J-Flash`` 的 ``Log`` 窗口会提示 ``Connect successfully``。

.. figure:: ../_static/image/Tools/jlink/image025.png
   :width: 80%
   :align: center
   :alt: J-Link 连接成功

   J-Link 连接成功


.. note:: 
   如果连接失败， ``J-Flash`` 会弹出 ``Failed to connect.`` 窗口，请注意以下几点：

   - **J-Link** 和 **MCU** 的 SWD 接口是否连接正确，请连接上 **nRST** 接口。
   - 设置的 **Speed** 通讯速率是否过快，可适当调低，如 4000kHZ ->  500kHz.
   - **J-Link** - Vtef 是外部电压 **侦测** 端口，并不会对外供电，所以 MCU 需要额外供电。
  
   .. figure:: ../_static/image/Tools/jlink/image026.png
      :width: 80%
      :align: center
      :alt: J-Link 连接失败

      J-Link 连接失败
   
5. 在 ``J-Flash`` 的 ``File`` 下拉项目中，选择 ``Open data file`` 打开烧录文件，如 **.hex** , **.bin** 文件。

.. figure:: ../_static/image/Tools/jlink/image021.png
   :width: 80%
   :align: center
   :alt: J-Flash 打开烧录文件

   J-Flash 打开烧录文件


6. **J-Link** 连接成功的情况下，在 ``Target`` 下拉项目中，可选择：
   
   - **Production Programming** ：产品烧录，即按产品流程操作烧录。
   - **Manual Programming** ：烧录操作，可单选操作操作。

.. figure:: ../_static/image/Tools/jlink/image027.png
   :width: 80%
   :align: center
   :alt: 烧录选项

   烧录选项

7. 如选择 **Production Programming** 产品烧录，烧录成功：

.. figure:: ../_static/image/Tools/jlink/image028.png
   :width: 80%
   :align: center
   :alt: Production Programming 烧录成功

   Production Programming 烧录成功