.. _1下载安装freedom:

1.下载安装freedom
=================

该软件是已经由sifive公司配置完成直接下载后移动到安装目录便可。

下载地址：\ https://www.sifive.com/software

.. _2加载code:

2.加载code
==========

打开freedomStudio，点击\ ``File->OpenProjects fromFileSystem...``\ ，操作如下：

.. figure:: image/image-1.png
   :alt: 

选择要添加的代码路径，操作如下：

.. figure:: image/image-2.png
   :alt: 

.. _3配置debug相关参数:

3.配置debug相关参数
===================

右键工程文件，\ ``Debug As->Debug Configurations...``\ ，操作界面如下：

.. figure:: image/image-3.png
   :alt: 

main界面配置

.. figure:: image/image-4.png
   :alt: 

Debugger界面配置

-  openocd配置文件和调试硬件配置相关文件（\ ``-f tools/debug/openocd_cfg/if_bflb_link_DVK.cfg``
   和\ ``-f tools/debug/602/tgt_602_xip.cfg``\ ）（在debug文件夹下有相应的README介绍对应相应的硬件版本）

-  调试硬件初始化文件配置（\ ``-x tools/debug/602/602.init``\ ）

.. figure:: image/image-5.png
   :alt: 

Startup界面配置

.. figure:: image/image-6.png
   :alt: 

.. figure:: image/image-7.png
   :alt: 

Config配置

.. figure:: image/image-8.png
   :alt: 

Common界面配置

.. figure:: image/image-9.png
   :alt: 

.. _4debug:

4.debug
=======

首先让板子跑起来，使用快捷键 F11 启动 Debug，Freedom
Studio会先编译工程(注意使用快捷键时确认使用的.launch文件名是自己配置的launch文件，可以通过工具栏
Run > Debug As > 进行查看)，调试功能如下图所示：

.. figure:: image/image-17.png
   :alt: 

1号区功能介绍，从左向右

-  按钮 ``Resume``\ （ F8）一下，如果Debug
   congfiguration中有配置,可以看到程序停在 bfl_main()
   主函数处，此时可以点击下图中的3个按钮

-  按钮\ ``Suspend``\ 是暂停调试，当想让调试，查看代码某个数据信息时，可以点击该按钮，暂停调试；

-  按钮\ ``Terminate``\ （Ctrl + F2），点击此按钮可以终止退出调试；

-  按钮\ ``Step Into``\ （F5）
   单步执行，遇到子函数就进入并且继续单步执行；

-  按钮\ ``Step Over``
   （F6）在单步执行时，在函数内遇到子函数时不会进入子函数内单步执行，而是将子函数整个执行完在停止，也就是把子函数整个作为一步；

-  按钮\ ``Step Return``\ （F7）在单步执行到子函数内时，用Step
   Return就可以执行完子函数余下部分，并返回上一层函数。

2号功能区

Registers：该标签是对cpu通用寄存器的显示，pc，sp等寄存器；

.. figure:: image/image-11.png
   :alt: 

3号功能介绍，标签从左向右

-  标签\ ``Breakp``\ 是对断点的显示，全局有多少断点都会显示在此处；

.. figure:: image/image-12.png
   :alt: 

-  标签\ ``Variable``\ 是对环境变量的显示，当调试暂停时，你的鼠标暂停在某变量时，该标签便会显示相关参数的数据信息；

.. figure:: image/image-13.png
   :alt: 

-  标签\ ``Express``
   可以添加相关想要查看到变量，该标签添加完变量时，变量的信息会实时的变化；

.. figure:: image/image-14.png
   :alt: 

4号区

Memory该标签是对硬件内存的查看，可以添加相关硬件地址，可以看到该地区数据的变化。

.. figure:: image/image-16.png
   :alt: