.. _eclipse_gcc:

Build and Debug with Eclipse
=================================

本节主要介绍如何使用 Eclipse 进行开发。

环境搭建
-------------

- 首先下载 `Eclipse <https://www.eclipse.org/downloads/packages>`_ , 选择  **Eclipse IDE for C/C++ Developers** , 并根据你的电脑版本进行下载。

.. figure:: img/eclipse1.png
    :alt:

- 其余步骤参考 :ref:`windows_cmd`

- 解压 Eclipse 并双击打开 `Eclipse.exe`

.. figure:: img/eclipse2.png
    :alt:

- 选择工作路径并点击 `Launch`

.. figure:: img/eclipse3.png
    :alt:

- 点击左上角 `File` 选择 `Import`，选择 `General > Existing project into workspace` 并点击 `Next`

.. figure:: img/eclipse4.png
    :alt:

- 导入 bl_mcu_sdk

.. figure:: img/eclipse5.png
    :alt:

编译
-------------

- 双击 `Build Targets` 中的 `make` 即可编译 helloworld。双击 `clean` 即可清除 helloworld 下的缓存

.. figure:: img/eclipse6.png
    :alt:

- 如果需要更换 demo ，右击 `Build Targets` 中的 `make`，修改中间方框里的内容即可，内容为指定 demo 下 Makefile 文件的路径

.. figure:: img/eclipse7.png
    :alt:

调试
-------------

完成上述步骤以后，如果是在 **flash 上调试，需要先将 bin 文件烧录到芯片中** ，然后才能够进行下面的调试环节。

- 在 Eclipse 中 点击 `debug` 图标，并点击 `Debug Configurations`

.. figure:: img/eclipse8.png
    :alt:

- 左侧打开 `GDB Hardware Debugging`，选择对应芯片的配置按钮，并导入编译生成的 **elf**, 最后点击 `Debug`

.. figure:: img/eclipse9.png
    :alt:

- 最终进入调试界面

.. figure:: img/eclipse10.png
    :alt: