[docs] update quick start rst
This commit is contained in:
qqwang
jzlv
parent
38a8f4e0a5
commit
bdf17c5e46
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
Before Width: | Height: | Size: 86 KiB After Width: | Height: | Size: 84 KiB |
@ -54,186 +54,16 @@ Windows 下使用 CDK (类 MDK Keil)开发指南
|
|||||||
|
|
||||||
**使用 Sipeed RV-Debugger Plus 调试工程时请按照下面的步骤进行：**
|
**使用 Sipeed RV-Debugger Plus 调试工程时请按照下面的步骤进行：**
|
||||||
|
|
||||||
打开 Hello World
|
.. toctree::
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
:maxdepth: 1
|
||||||
|
|
||||||
- 获取到 SDK 后，进入 sdk 中的 ``examples/hellowd/helloworld/cdk`` 目录下，双击 ``helloworld.cdkproj``，即可打开 ``Helloworld`` 工程
|
|
||||||
|
|
||||||
编译 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
.. figure:: img/cdk1.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
helloworld.cdkproj
|
|
||||||
|
|
||||||
- 在活动工程下拉菜单选择 ``OpenOCD_Debug`` 工程，由于 Sipeed RV-Debugger Plus 是使用 OpenOCD 调试的，所以本教程基于 ``OpenOCD_Debug`` 工程；
|
|
||||||
- 如 Sipeed RV-Debugger Plus 没有正确安装驱动，请参考 :ref:`sipeed_rv_debugger_plus` 部分，设置好驱动程序，在进行下面的步骤
|
|
||||||
|
|
||||||
- 在 CDK 工具栏中，点击编译图标即可编译工程
|
|
||||||
|
|
||||||
- 点击 ``1`` 处 图标 ``Build Project`` 即可编译当前选中的工程
|
|
||||||
- 点击 ``2`` 处 图标 ``Clean Project`` 即可清除上次编译的结果
|
|
||||||
- 点击 ``3`` 处 图标 ``Flash Download`` 即可将编译好的代码下载到芯片中 （**使用 OpenOCD Debug 不能使用 Flash 下载功能**）
|
|
||||||
- 点击 ``4`` 处 图标 ``Start/Stop Debug`` 即可进行 debug 的相关操作
|
|
||||||
- 也可以在 ``Project`` 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作
|
|
||||||
|
|
||||||
|
|
||||||
烧写 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 在 CDK 中使用 OpenOCD 模式的调试方式时，暂不支持直接使用 CDK 相关 flash 工具下载代码，所以请使用 BL Dev Cube 工具进行程序烧写，烧写代码请参考 :ref:`bl_dev_cube` 部分进行
|
|
||||||
- 代码烧写完成后使用 CDK 进行 Debug
|
|
||||||
|
|
||||||
运行 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 从 CDK 的菜单栏 ``View->Serial Pane``，打开串口面板，在打开的 ``Serial Pane`` 中右击，进行串口设置，选择你对应的串口号和波特率
|
|
||||||
|
|
||||||
.. figure:: img/cdk4.png
|
|
||||||
.. figure:: img/cdk3.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Serial Pane setting
|
|
||||||
|
|
||||||
- 按下板子上的 ``RST`` 按键，即可在串口中看到代码的运行结果
|
|
||||||
|
|
||||||
.. figure:: img/cdk6.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
HelloWorld！
|
|
||||||
|
|
||||||
|
|
||||||
调试 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 点击工具栏上方的 ``Start/Stop Debugger`` 按钮，进入 debug 界面，如下图所示
|
|
||||||
|
|
||||||
.. figure:: img/cdk10.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
Debug HelloWorld！
|
|
||||||
|
|
||||||
- 在 debug 界面下，左侧的 ``Register`` 窗口中，可以查看 ``CPU`` 内部寄存器数据；右侧的 ``Peripherals`` 外设面板中，
|
|
||||||
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 ``Peripherals->System Viewer`` 选择；
|
|
||||||
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
|
||||||
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 ``CDK Help``，这里就不作过多介绍了。
|
|
||||||
|
|
||||||
- 我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 ``Hello World！``
|
|
||||||
|
|
||||||
|
使用 Sipeed RV-Debugger <cdk_rv_debugger_plus>
|
||||||
|
|
||||||
**使用 CK-Link 调试工程时请按照下面的步骤进行：**
|
**使用 CK-Link 调试工程时请按照下面的步骤进行：**
|
||||||
|
|
||||||
打开 Hello World
|
.. toctree::
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
:maxdepth: 1
|
||||||
|
|
||||||
- 获取到 SDK 后，进入 sdk 中的 ``examples/hellowd/helloworld/cdk`` 目录下，双击 ``helloworld.cdkproj``，即可打开 ``Helloworld`` 工程
|
|
||||||
|
|
||||||
编译 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
.. figure:: img/cdk1.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
helloworld.cdkproj
|
|
||||||
|
|
||||||
- 在活动工程下拉菜单可以选择 ``CK_Link_Debug`` 或者 ``OpenOCD_Debug`` 工程，本教程基于 ``CK_Link_Debug`` 工程
|
|
||||||
|
|
||||||
- 在 CDK 工具栏中，点击编译图标即可编译工程
|
|
||||||
|
|
||||||
- 点击 ``1`` 处 图标 ``Build Project`` 即可编译当前选中的工程
|
|
||||||
- 点击 ``2`` 处 图标 ``Clean Project`` 即可清除上次编译的结果
|
|
||||||
- 点击 ``3`` 处 图标 ``Flash Download`` 即可将编译好的代码下载到芯片中
|
|
||||||
- 点击 ``4`` 处 图标 ``Start/Stop Debug`` 即可进行 debug 的相关操作
|
|
||||||
- 也可以在 ``Project`` 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作
|
|
||||||
|
|
||||||
|
|
||||||
烧写 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 由于目前 CDK 软件中还没有包含我们的 flash 算法，所以需要我们手动将 flash 算法放到 CDK 安装目录，具体操作如下：
|
|
||||||
|
|
||||||
- 进入 SDK 目录下 ``tools\cdk_flashloader`` 目录
|
|
||||||
- 将目录下的 ``bl70x_flasher.elf`` 文件，拷贝到 CDK 工具的 ``C-Sky\CDK\CSKY\Flash`` 目录中
|
|
||||||
|
|
||||||
.. figure:: img/cdk7.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Flash Loader
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
.. figure:: img/cdk8.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Project Setting
|
|
||||||
|
|
||||||
- 点击 ``Project View`` 中的项目设置按钮，打开 ``Project Setting`` 窗口，或者通过右击 ``Project`` 名称中右击菜单栏中打开
|
|
||||||
|
|
||||||
- 在打开的 ``Project Setting`` 窗口中，选择 ``Flash`` 标签，配置需要的 Flash 算法
|
|
||||||
|
|
||||||
.. figure:: img/cdk9.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Project Flash setting
|
|
||||||
|
|
||||||
- 在 ``Flash`` 标签中，点击 ``Add`` 按纽，在打开的列表中选择 ``bl70x_flash`` 算法，点击 ``Add`` 添加到工程中，``Flash`` 标签下的其他设置，如图所示：
|
|
||||||
|
|
||||||
- 点击 OK 后，如配置正确，点击 ``Flash Download`` 即可将编译好的代码下载到芯片中
|
|
||||||
|
|
||||||
|
|
||||||
.. figure:: img/cdk5.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Flashdownload Success
|
|
||||||
|
|
||||||
- 如下载失败请检查：
|
|
||||||
|
|
||||||
- 1. 代码是否被正确编译，并生成 ``.elf`` ``.bin`` 等文件
|
|
||||||
- 2. Flash 算法是否被正确设置
|
|
||||||
- 3. CK-Link 与开发板是否正确连接
|
|
||||||
- 4. 开发板是否正常供电，电源指示灯是否点亮
|
|
||||||
|
|
||||||
运行 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 从 CDK 的菜单栏 ``View->Serial Pane``，打开串口面板，在打开的 ``Serial Pane`` 中右击，进行串口设置，选择你对应的串口号和波特率
|
|
||||||
|
|
||||||
.. figure:: img/cdk4.png
|
|
||||||
.. figure:: img/cdk3.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Serial Pane setting
|
|
||||||
|
|
||||||
- 按下板子上的 ``RST`` 按键，即可在串口中看到代码的运行结果
|
|
||||||
|
|
||||||
.. figure:: img/cdk6.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
HelloWorld！
|
|
||||||
|
|
||||||
|
|
||||||
调试 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 点击工具栏上方的 ``Start/Stop Debugger`` 按钮，进入 debug 界面，如下图所示
|
|
||||||
|
|
||||||
.. figure:: img/cdk10.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
Debug HelloWorld！
|
|
||||||
|
|
||||||
- 在 debug 界面下，左侧的 ``Register`` 窗口中，可以查看 ``CPU`` 内部寄存器数据；右侧的 ``Peripherals`` 外设面板中，
|
|
||||||
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 ``Peripherals->System Viewer`` 选择；
|
|
||||||
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
|
||||||
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 ``CDK Help``，这里就不作过多介绍了。
|
|
||||||
|
|
||||||
- 我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 ``Hello World！``
|
|
||||||
|
|
||||||
.. figure:: img/cdk11.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
Debug HelloWorld！
|
|
||||||
|
|
||||||
|
使用 CK-Link <cdk_ck_link>
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -0,0 +1,116 @@
|
|||||||
|
使用 CDK + CK-Link 编译调试
|
||||||
|
=============================
|
||||||
|
|
||||||
|
|
||||||
|
打开 Hello World
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
- 获取到 SDK 后，进入 sdk 中的 ``examples/hellowd/helloworld/cdk`` 目录下，双击 ``helloworld.cdkproj``，即可打开 ``Helloworld`` 工程
|
||||||
|
|
||||||
|
编译 Hello World
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
.. figure:: img/cdk1.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
helloworld.cdkproj
|
||||||
|
|
||||||
|
- 在活动工程下拉菜单可以选择 ``CK_Link_Debug`` 或者 ``OpenOCD_Debug`` 工程，本教程基于 ``CK_Link_Debug`` 工程
|
||||||
|
|
||||||
|
- 在 CDK 工具栏中，点击编译图标即可编译工程
|
||||||
|
|
||||||
|
- 点击 ``1`` 处 图标 ``Build Project`` 即可编译当前选中的工程
|
||||||
|
- 点击 ``2`` 处 图标 ``Clean Project`` 即可清除上次编译的结果
|
||||||
|
- 点击 ``3`` 处 图标 ``Flash Download`` 即可将编译好的代码下载到芯片中
|
||||||
|
- 点击 ``4`` 处 图标 ``Start/Stop Debug`` 即可进行 debug 的相关操作（在使用 ``CK-Link`` 时可以先将代码 load 到 flash 中）
|
||||||
|
- 点击 ``5`` 处 图标 ``Start/Stop Debug whitout Download`` 即可直接进行 debug , 不 load 当前 bin 文件
|
||||||
|
- 也可以在 ``Project`` 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作
|
||||||
|
|
||||||
|
|
||||||
|
烧写 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 由于目前 CDK 软件中还没有包含我们的 flash 算法，所以需要我们手动将 flash 算法放到 CDK 安装目录，具体操作如下：
|
||||||
|
|
||||||
|
- 进入 SDK 目录下 ``tools\cdk_flashloader`` 目录
|
||||||
|
- 将目录下的 ``bl70x_flasher.elf`` 文件，拷贝到 CDK 工具的 ``C-Sky\CDK\CSKY\Flash`` 目录中
|
||||||
|
|
||||||
|
.. figure:: img/cdk7.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Flash Loader
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.. figure:: img/cdk8.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Project Setting
|
||||||
|
|
||||||
|
- 点击 ``Project View`` 中的项目设置按钮，打开 ``Project Setting`` 窗口，或者通过右击 ``Project`` 名称中右击菜单栏中打开
|
||||||
|
|
||||||
|
- 在打开的 ``Project Setting`` 窗口中，选择 ``Flash`` 标签，配置需要的 Flash 算法
|
||||||
|
|
||||||
|
.. figure:: img/cdk9.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Project Flash setting
|
||||||
|
|
||||||
|
- 在 ``Flash`` 标签中，点击 ``Add`` 按纽，在打开的列表中选择 ``bl70x_flash`` 算法，点击 ``Add`` 添加到工程中，``Flash`` 标签下的其他设置，如图所示：
|
||||||
|
|
||||||
|
- 点击 OK 后，如配置正确，点击 ``Flash Download`` 即可将编译好的代码下载到芯片中
|
||||||
|
|
||||||
|
|
||||||
|
.. figure:: img/cdk5.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Flashdownload Success
|
||||||
|
|
||||||
|
- 如下载失败请检查：
|
||||||
|
|
||||||
|
- 1. 代码是否被正确编译，并生成 ``.elf`` ``.bin`` 等文件
|
||||||
|
- 2. Flash 算法是否被正确设置
|
||||||
|
- 3. CK-Link 与开发板是否正确连接
|
||||||
|
- 4. 开发板是否正常供电，电源指示灯是否点亮
|
||||||
|
|
||||||
|
运行 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 从 CDK 的菜单栏 ``View->Serial Pane``，打开串口面板，在打开的 ``Serial Pane`` 中右击，进行串口设置，选择你对应的串口号和波特率
|
||||||
|
|
||||||
|
.. figure:: img/cdk4.png
|
||||||
|
.. figure:: img/cdk3.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Serial Pane setting
|
||||||
|
|
||||||
|
- 按下板子上的 ``RST`` 按键，即可在串口中看到代码的运行结果
|
||||||
|
|
||||||
|
.. figure:: img/cdk6.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
HelloWorld！
|
||||||
|
|
||||||
|
|
||||||
|
调试 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 点击工具栏上方的 ``Start/Stop Debugger`` 按钮，进入 debug 界面，如下图所示
|
||||||
|
|
||||||
|
.. figure:: img/cdk10.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
Debug HelloWorld！
|
||||||
|
|
||||||
|
- 在 debug 界面下，左侧的 ``Register`` 窗口中，可以查看 ``CPU`` 内部寄存器数据；右侧的 ``Peripherals`` 外设面板中，
|
||||||
|
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 ``Peripherals->System Viewer`` 选择；
|
||||||
|
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
||||||
|
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 ``CDK Help``，这里就不作过多介绍了。
|
||||||
|
|
||||||
|
- 我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 ``Hello World！``
|
||||||
|
|
||||||
|
.. figure:: img/cdk11.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
Debug HelloWorld！
|
||||||
|
|
||||||
@ -0,0 +1,70 @@
|
|||||||
|
使用 CDK + Sipeed RV-Debugger Plus 编译调试
|
||||||
|
==============================================
|
||||||
|
|
||||||
|
打开 Hello World
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
- 获取到 SDK 后，进入 sdk 中的 ``examples/hellowd/helloworld/cdk`` 目录下，双击 ``helloworld.cdkproj``，即可打开 ``Helloworld`` 工程
|
||||||
|
|
||||||
|
编译 Hello World
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
.. figure:: img/cdk1.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
helloworld.cdkproj
|
||||||
|
|
||||||
|
- 在活动工程下拉菜单选择 ``OpenOCD_Debug`` 工程，由于 Sipeed RV-Debugger Plus 是使用 OpenOCD 调试的，所以本教程基于 ``OpenOCD_Debug`` 工程；
|
||||||
|
- 如 Sipeed RV-Debugger Plus 没有正确安装驱动，请参考 :ref:`sipeed_rv_debugger_plus` 部分，设置好驱动程序，在进行下面的步骤
|
||||||
|
|
||||||
|
- 在 CDK 工具栏中，点击编译图标即可编译工程
|
||||||
|
|
||||||
|
- 点击 ``1`` 处 图标 ``Build Project`` 即可编译当前选中的工程
|
||||||
|
- 点击 ``2`` 处 图标 ``Clean Project`` 即可清除上次编译的结果
|
||||||
|
- 点击 ``3`` 处 图标 ``Flash Download`` 即可将编译好的代码下载到芯片中 （**使用 OpenOCD Debug 不能使用 Flash 下载功能**）
|
||||||
|
- 点击 ``5`` 处 图标 ``Start/Stop Debug whitout Download`` 即可直接进行 debug , 不 load 当前 bin 文件
|
||||||
|
- 也可以在 ``Project`` 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作
|
||||||
|
|
||||||
|
|
||||||
|
烧写 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 在 CDK 中使用 OpenOCD 模式的调试方式时，暂不支持直接使用 CDK 相关 ``flash`` 工具下载代码，所以请使用 BL Dev Cube 工具进行程序烧写，烧写代码请参考 :ref:`bl_dev_cube` 部分进行
|
||||||
|
- 代码烧写完成后使用 CDK 进行 Debug
|
||||||
|
|
||||||
|
运行 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 从 CDK 的菜单栏 ``View->Serial Pane``，打开串口面板，在打开的 ``Serial Pane`` 中右击，进行串口设置，选择你对应的串口号和波特率
|
||||||
|
|
||||||
|
.. figure:: img/cdk4.png
|
||||||
|
.. figure:: img/cdk3.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Serial Pane setting
|
||||||
|
|
||||||
|
- 按下板子上的 ``RST`` 按键，即可在串口中看到代码的运行结果
|
||||||
|
|
||||||
|
.. figure:: img/cdk6.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
HelloWorld！
|
||||||
|
|
||||||
|
|
||||||
|
调试 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 点击工具栏上方的 ``Start/Stop Debugger`` 按钮，进入 debug 界面，如下图所示
|
||||||
|
|
||||||
|
.. figure:: img/cdk10.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
Debug HelloWorld！
|
||||||
|
|
||||||
|
- 在 debug 界面下，左侧的 ``Register`` 窗口中，可以查看 ``CPU`` 内部寄存器数据；右侧的 ``Peripherals`` 外设面板中，
|
||||||
|
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 ``Peripherals->System Viewer`` 选择；
|
||||||
|
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
||||||
|
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 ``CDK Help``，这里就不作过多介绍了。
|
||||||
|
|
||||||
|
- 我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 ``Hello World！``
|
||||||
|
|
||||||
@ -60,6 +60,8 @@ BL706_AVB 开发板如下图所示
|
|||||||
|
|
||||||
- 1. 首先，将调试器 Type-C USB 接口使用 USB 数据线连接到 PC 主机，打开 PC 的设备管理器，在端口一栏可以看到调试器被识别为两个串口（*注：不是开发板上的串口*），或者在 ``通用串行总线控制器`` 看到 ``USB Serial Converter A`` 和 ``USB Serial Converter B``
|
- 1. 首先，将调试器 Type-C USB 接口使用 USB 数据线连接到 PC 主机，打开 PC 的设备管理器，在端口一栏可以看到调试器被识别为两个串口（*注：不是开发板上的串口*），或者在 ``通用串行总线控制器`` 看到 ``USB Serial Converter A`` 和 ``USB Serial Converter B``
|
||||||
|
|
||||||
|
.. important:: **注意:** 若在设备管理器中看到的串口名称为 “``USB 串行设备(COM*)``”，说明调试器进入了 ``Boot`` 模式。请将调试器断电重新上电，注意先不要将调试器连接到目标板；此时在到设备管理器中看是否正常
|
||||||
|
|
||||||
.. figure:: img/sipeed_rv_debugger_1.png
|
.. figure:: img/sipeed_rv_debugger_1.png
|
||||||
|
|
||||||
.. figure:: img/sipeed_rv_debugger_4.png
|
.. figure:: img/sipeed_rv_debugger_4.png
|
||||||
@ -83,6 +85,8 @@ BL706_AVB 开发板如下图所示
|
|||||||
|
|
||||||
.. caution:: 2. 在设备管理器中没有看到任何串口，但是在``通用串行总线控制器``中看到 ``USB Serial Converter A`` 和 ``USB Serial Converter B``；遇到这种情况，请到 `FTDI 官网 <https://ftdichip.com/drivers/vcp-drivers/>`_ 下载与系统匹配的驱动，将 ``USB Serial Converter B`` 重新安装为串口；``USB Serial Converter A`` 也即 Interface 0，使用 ``zadig-2.4.exe`` 替换为 WinUSB 驱动。
|
.. caution:: 2. 在设备管理器中没有看到任何串口，但是在``通用串行总线控制器``中看到 ``USB Serial Converter A`` 和 ``USB Serial Converter B``；遇到这种情况，请到 `FTDI 官网 <https://ftdichip.com/drivers/vcp-drivers/>`_ 下载与系统匹配的驱动，将 ``USB Serial Converter B`` 重新安装为串口；``USB Serial Converter A`` 也即 Interface 0，使用 ``zadig-2.4.exe`` 替换为 WinUSB 驱动。
|
||||||
|
|
||||||
|
.. caution:: 3. 如果经过上面的操作还是不能正常使用，没有出现正确的现象，那么建议从 Sipeed 官方 `GitHub <https://github.com/sipeed/RV-Debugger-BL702>`_ 仓库获取固件，重新烧写；按住调试器上的 ``Boot`` 键不要释放，将调试器插入电脑上电，使调试器进入 Boot 模式，重新刷入固件后；断电重启
|
||||||
|
|
||||||
**Linux**
|
**Linux**
|
||||||
|
|
||||||
- 安装 Openocd 及其需要的依赖项
|
- 安装 Openocd 及其需要的依赖项
|
||||||
|
|||||||
@ -16,7 +16,7 @@ BL MCU SDK 将为您提供博流 BL70X 系列 MCU 开发的全方位支持。
|
|||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
:caption: 快速开发指南
|
:caption: 快速开发指南
|
||||||
:numbered:
|
:numbered: 3
|
||||||
|
|
||||||
get_started/get_started
|
get_started/get_started
|
||||||
get_started/index
|
get_started/index
|
||||||
|
|||||||
@ -102,11 +102,11 @@
|
|||||||
<li class="toctree-l3"><a class="reference internal" href="#id2">2.3.4. 硬件连接</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="#id2">2.3.4. 硬件连接</a></li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="#bl-mcu-sdk">2.3.5. 获取 bl_mcu_sdk</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="#bl-mcu-sdk">2.3.5. 获取 bl_mcu_sdk</a></li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="#hello-world">2.3.6. 测试 Hello World 工程</a><ul>
|
<li class="toctree-l3"><a class="reference internal" href="#hello-world">2.3.6. 测试 Hello World 工程</a><ul>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id3">2.3.6.1. 打开 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id3">打开 Hello World</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id4">2.3.6.2. 编译 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id4">编译 Hello World</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id5">2.3.6.3. 烧写 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id5">烧写 Hello World</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id6">2.3.6.4. 运行 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id6">运行 Hello World</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id7">2.3.6.5. 调试 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id7">调试 Hello World</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
@ -288,7 +288,7 @@ $ wget -c https://cmake.org/files/v3.19/cmake-3.19.3-Linux-x86_64.tar.gz
|
|||||||
<div class="section" id="hello-world">
|
<div class="section" id="hello-world">
|
||||||
<h2><span class="section-number">2.3.6. </span>测试 Hello World 工程<a class="headerlink" href="#hello-world" title="永久链接至标题">¶</a></h2>
|
<h2><span class="section-number">2.3.6. </span>测试 Hello World 工程<a class="headerlink" href="#hello-world" title="永久链接至标题">¶</a></h2>
|
||||||
<div class="section" id="id3">
|
<div class="section" id="id3">
|
||||||
<h3><span class="section-number">2.3.6.1. </span>打开 Hello World<a class="headerlink" href="#id3" title="永久链接至标题">¶</a></h3>
|
<h3>打开 Hello World<a class="headerlink" href="#id3" title="永久链接至标题">¶</a></h3>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>获取到 SDK 后，进入 sdk 中的 <code class="docutils literal notranslate"><span class="pre">examples/hellowd/helloworld</span></code> 目录下，打开 <code class="docutils literal notranslate"><span class="pre">main.c</span></code>，即可编辑 helloworld 的相关代码。</p></li>
|
<li><p>获取到 SDK 后，进入 sdk 中的 <code class="docutils literal notranslate"><span class="pre">examples/hellowd/helloworld</span></code> 目录下，打开 <code class="docutils literal notranslate"><span class="pre">main.c</span></code>，即可编辑 helloworld 的相关代码。</p></li>
|
||||||
</ul>
|
</ul>
|
||||||
@ -302,7 +302,7 @@ $ wget -c https://cmake.org/files/v3.19/cmake-3.19.3-Linux-x86_64.tar.gz
|
|||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id4">
|
<div class="section" id="id4">
|
||||||
<h3><span class="section-number">2.3.6.2. </span>编译 Hello World<a class="headerlink" href="#id4" title="永久链接至标题">¶</a></h3>
|
<h3>编译 Hello World<a class="headerlink" href="#id4" title="永久链接至标题">¶</a></h3>
|
||||||
<div class="highlight-bash notranslate"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
|
<div class="highlight-bash notranslate"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
|
||||||
<span class="normal">2</span></pre></div></td><td class="code"><div class="highlight"><pre><span></span> $ <span class="nb">cd</span> ~/bl_mcu_sdk
|
<span class="normal">2</span></pre></div></td><td class="code"><div class="highlight"><pre><span></span> $ <span class="nb">cd</span> ~/bl_mcu_sdk
|
||||||
$ make build <span class="nv">BOARD</span><span class="o">=</span>bl706_iot <span class="nv">APP</span><span class="o">=</span>helloworld
|
$ make build <span class="nv">BOARD</span><span class="o">=</span>bl706_iot <span class="nv">APP</span><span class="o">=</span>helloworld
|
||||||
@ -310,7 +310,7 @@ $ wget -c https://cmake.org/files/v3.19/cmake-3.19.3-Linux-x86_64.tar.gz
|
|||||||
</td></tr></table></div>
|
</td></tr></table></div>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id5">
|
<div class="section" id="id5">
|
||||||
<h3><span class="section-number">2.3.6.3. </span>烧写 Hello World<a class="headerlink" href="#id5" title="永久链接至标题">¶</a></h3>
|
<h3>烧写 Hello World<a class="headerlink" href="#id5" title="永久链接至标题">¶</a></h3>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>烧写前请先确认烧写方式，若采用串口烧写，请先按住板子上的 <code class="docutils literal notranslate"><span class="pre">boot</span></code> 键不要释放，此时在按下 <code class="docutils literal notranslate"><span class="pre">rst</span></code> 键，然后释放两个键，此时板子进入 boot_rom 状态。</p></li>
|
<li><p>烧写前请先确认烧写方式，若采用串口烧写，请先按住板子上的 <code class="docutils literal notranslate"><span class="pre">boot</span></code> 键不要释放，此时在按下 <code class="docutils literal notranslate"><span class="pre">rst</span></code> 键，然后释放两个键，此时板子进入 boot_rom 状态。</p></li>
|
||||||
<li><p>这时在终端中输入以下命令进行烧写</p></li>
|
<li><p>这时在终端中输入以下命令进行烧写</p></li>
|
||||||
@ -344,7 +344,7 @@ $ wget -c https://cmake.org/files/v3.19/cmake-3.19.3-Linux-x86_64.tar.gz
|
|||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id6">
|
<div class="section" id="id6">
|
||||||
<h3><span class="section-number">2.3.6.4. </span>运行 Hello World<a class="headerlink" href="#id6" title="永久链接至标题">¶</a></h3>
|
<h3>运行 Hello World<a class="headerlink" href="#id6" title="永久链接至标题">¶</a></h3>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>打开新的终端，安装、运行串口工具</p></li>
|
<li><p>打开新的终端，安装、运行串口工具</p></li>
|
||||||
</ul>
|
</ul>
|
||||||
@ -362,7 +362,7 @@ $ wget -c https://cmake.org/files/v3.19/cmake-3.19.3-Linux-x86_64.tar.gz
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id7">
|
<div class="section" id="id7">
|
||||||
<h3><span class="section-number">2.3.6.5. </span>调试 Hello World<a class="headerlink" href="#id7" title="永久链接至标题">¶</a></h3>
|
<h3>调试 Hello World<a class="headerlink" href="#id7" title="永久链接至标题">¶</a></h3>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
@ -39,7 +39,7 @@
|
|||||||
|
|
||||||
<link rel="index" title="索引" href="../genindex.html" />
|
<link rel="index" title="索引" href="../genindex.html" />
|
||||||
<link rel="search" title="搜索" href="../search.html" />
|
<link rel="search" title="搜索" href="../search.html" />
|
||||||
<link rel="next" title="2.2. Windows 下使用 Eclipse 开发指南" href="Windows_quick_start_eclipse.html" />
|
<link rel="next" title="使用 CDK + Sipeed RV-Debugger Plus 编译调试" href="cdk_rv_debugger_plus.html" />
|
||||||
<link rel="prev" title="2. 开发环境搭建指南" href="index.html" />
|
<link rel="prev" title="2. 开发环境搭建指南" href="index.html" />
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
@ -99,16 +99,8 @@
|
|||||||
<li class="toctree-l3"><a class="reference internal" href="#bl-mcu-sdk">2.1.3. 下载 bl_mcu_sdk 软件开发包</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="#bl-mcu-sdk">2.1.3. 下载 bl_mcu_sdk 软件开发包</a></li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="#id4">2.1.4. 硬件连接</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="#id4">2.1.4. 硬件连接</a></li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="#hello-world">2.1.5. 测试 Hello World 工程</a><ul>
|
<li class="toctree-l3"><a class="reference internal" href="#hello-world">2.1.5. 测试 Hello World 工程</a><ul>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id5">2.1.5.1. 打开 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="cdk_rv_debugger_plus.html">使用 Sipeed RV-Debugger</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id6">2.1.5.2. 编译 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="cdk_ck_link.html">使用 CK-Link</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id7">2.1.5.3. 烧写 Hello World</a></li>
|
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id8">2.1.5.4. 运行 Hello World</a></li>
|
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id9">2.1.5.5. 调试 Hello World</a></li>
|
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id10">2.1.5.6. 打开 Hello World</a></li>
|
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id11">2.1.5.7. 编译 Hello World</a></li>
|
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id12">2.1.5.8. 烧写 Hello World</a></li>
|
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id13">2.1.5.9. 运行 Hello World</a></li>
|
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id14">2.1.5.10. 调试 Hello World</a></li>
|
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
@ -267,199 +259,16 @@
|
|||||||
<div class="section" id="hello-world">
|
<div class="section" id="hello-world">
|
||||||
<h2><span class="section-number">2.1.5. </span>测试 Hello World 工程<a class="headerlink" href="#hello-world" title="永久链接至标题">¶</a></h2>
|
<h2><span class="section-number">2.1.5. </span>测试 Hello World 工程<a class="headerlink" href="#hello-world" title="永久链接至标题">¶</a></h2>
|
||||||
<p><strong>使用 Sipeed RV-Debugger Plus 调试工程时请按照下面的步骤进行：</strong></p>
|
<p><strong>使用 Sipeed RV-Debugger Plus 调试工程时请按照下面的步骤进行：</strong></p>
|
||||||
<div class="section" id="id5">
|
<div class="toctree-wrapper compound">
|
||||||
<h3><span class="section-number">2.1.5.1. </span>打开 Hello World<a class="headerlink" href="#id5" title="永久链接至标题">¶</a></h3>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>获取到 SDK 后，进入 sdk 中的 <code class="docutils literal notranslate"><span class="pre">examples/hellowd/helloworld/cdk</span></code> 目录下，双击 <code class="docutils literal notranslate"><span class="pre">helloworld.cdkproj</span></code>，即可打开 <code class="docutils literal notranslate"><span class="pre">Helloworld</span></code> 工程</p></li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="id6">
|
|
||||||
<h3><span class="section-number">2.1.5.2. </span>编译 Hello World<a class="headerlink" href="#id6" title="永久链接至标题">¶</a></h3>
|
|
||||||
<div class="figure align-default" id="id15">
|
|
||||||
<img alt="" src="../_images/cdk1.png" />
|
|
||||||
<p class="caption"><span class="caption-text">helloworld.cdkproj</span><a class="headerlink" href="#id15" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>在活动工程下拉菜单选择 <code class="docutils literal notranslate"><span class="pre">OpenOCD_Debug</span></code> 工程，由于 Sipeed RV-Debugger Plus 是使用 OpenOCD 调试的，所以本教程基于 <code class="docutils literal notranslate"><span class="pre">OpenOCD_Debug</span></code> 工程；</p></li>
|
|
||||||
<li><p>如 Sipeed RV-Debugger Plus 没有正确安装驱动，请参考 <a class="reference internal" href="get_started.html#sipeed-rv-debugger-plus"><span class="std std-ref">调试器驱动安装设置</span></a> 部分，设置好驱动程序，在进行下面的步骤</p></li>
|
|
||||||
<li><p>在 CDK 工具栏中，点击编译图标即可编译工程</p>
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">1</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Build</span> <span class="pre">Project</span></code> 即可编译当前选中的工程</p></li>
|
<li class="toctree-l1"><a class="reference internal" href="cdk_rv_debugger_plus.html">使用 Sipeed RV-Debugger</a></li>
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">2</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Clean</span> <span class="pre">Project</span></code> 即可清除上次编译的结果</p></li>
|
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">3</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Flash</span> <span class="pre">Download</span></code> 即可将编译好的代码下载到芯片中 （<strong>使用 OpenOCD Debug 不能使用 Flash 下载功能</strong>）</p></li>
|
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">4</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debug</span></code> 即可进行 debug 的相关操作</p></li>
|
|
||||||
<li><p>也可以在 <code class="docutils literal notranslate"><span class="pre">Project</span></code> 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作</p></li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id7">
|
|
||||||
<h3><span class="section-number">2.1.5.3. </span>烧写 Hello World<a class="headerlink" href="#id7" title="永久链接至标题">¶</a></h3>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>在 CDK 中使用 OpenOCD 模式的调试方式时，暂不支持直接使用 CDK 相关 flash 工具下载代码，所以请使用 BL Dev Cube 工具进行程序烧写，烧写代码请参考 <a class="reference internal" href="bl_dev_cube.html#bl-dev-cube"><span class="std std-ref">BLDevCube 烧录工具指南</span></a> 部分进行</p></li>
|
|
||||||
<li><p>代码烧写完成后使用 CDK 进行 Debug</p></li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="id8">
|
|
||||||
<h3><span class="section-number">2.1.5.4. </span>运行 Hello World<a class="headerlink" href="#id8" title="永久链接至标题">¶</a></h3>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>从 CDK 的菜单栏 <code class="docutils literal notranslate"><span class="pre">View->Serial</span> <span class="pre">Pane</span></code>，打开串口面板，在打开的 <code class="docutils literal notranslate"><span class="pre">Serial</span> <span class="pre">Pane</span></code> 中右击，进行串口设置，选择你对应的串口号和波特率</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default">
|
|
||||||
<img alt="../_images/cdk4.png" src="../_images/cdk4.png" />
|
|
||||||
</div>
|
|
||||||
<div class="figure align-default" id="id16">
|
|
||||||
<img alt="" src="../_images/cdk3.png" />
|
|
||||||
<p class="caption"><span class="caption-text">CDK Serial Pane setting</span><a class="headerlink" href="#id16" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>按下板子上的 <code class="docutils literal notranslate"><span class="pre">RST</span></code> 按键，即可在串口中看到代码的运行结果</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id17">
|
|
||||||
<img alt="" src="../_images/cdk6.png" />
|
|
||||||
<p class="caption"><span class="caption-text">HelloWorld！</span><a class="headerlink" href="#id17" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="id9">
|
|
||||||
<h3><span class="section-number">2.1.5.5. </span>调试 Hello World<a class="headerlink" href="#id9" title="永久链接至标题">¶</a></h3>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>点击工具栏上方的 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debugger</span></code> 按钮，进入 debug 界面，如下图所示</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id18">
|
|
||||||
<img alt="" src="../_images/cdk10.png" />
|
|
||||||
<p class="caption"><span class="caption-text">Debug HelloWorld！</span><a class="headerlink" href="#id18" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>在 debug 界面下，左侧的 <code class="docutils literal notranslate"><span class="pre">Register</span></code> 窗口中，可以查看 <code class="docutils literal notranslate"><span class="pre">CPU</span></code> 内部寄存器数据；右侧的 <code class="docutils literal notranslate"><span class="pre">Peripherals</span></code> 外设面板中，
|
|
||||||
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 <code class="docutils literal notranslate"><span class="pre">Peripherals->System</span> <span class="pre">Viewer</span></code> 选择；
|
|
||||||
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
|
||||||
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 <code class="docutils literal notranslate"><span class="pre">CDK</span> <span class="pre">Help</span></code>，这里就不作过多介绍了。</p></li>
|
|
||||||
<li><p>我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 <code class="docutils literal notranslate"><span class="pre">Hello</span> <span class="pre">World！</span></code></p></li>
|
|
||||||
</ul>
|
|
||||||
<p><strong>使用 CK-Link 调试工程时请按照下面的步骤进行：</strong></p>
|
<p><strong>使用 CK-Link 调试工程时请按照下面的步骤进行：</strong></p>
|
||||||
</div>
|
<div class="toctree-wrapper compound">
|
||||||
<div class="section" id="id10">
|
|
||||||
<h3><span class="section-number">2.1.5.6. </span>打开 Hello World<a class="headerlink" href="#id10" title="永久链接至标题">¶</a></h3>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>获取到 SDK 后，进入 sdk 中的 <code class="docutils literal notranslate"><span class="pre">examples/hellowd/helloworld/cdk</span></code> 目录下，双击 <code class="docutils literal notranslate"><span class="pre">helloworld.cdkproj</span></code>，即可打开 <code class="docutils literal notranslate"><span class="pre">Helloworld</span></code> 工程</p></li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="id11">
|
|
||||||
<h3><span class="section-number">2.1.5.7. </span>编译 Hello World<a class="headerlink" href="#id11" title="永久链接至标题">¶</a></h3>
|
|
||||||
<div class="figure align-default" id="id19">
|
|
||||||
<img alt="" src="../_images/cdk1.png" />
|
|
||||||
<p class="caption"><span class="caption-text">helloworld.cdkproj</span><a class="headerlink" href="#id19" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>在活动工程下拉菜单可以选择 <code class="docutils literal notranslate"><span class="pre">CK_Link_Debug</span></code> 或者 <code class="docutils literal notranslate"><span class="pre">OpenOCD_Debug</span></code> 工程，本教程基于 <code class="docutils literal notranslate"><span class="pre">CK_Link_Debug</span></code> 工程</p></li>
|
|
||||||
<li><p>在 CDK 工具栏中，点击编译图标即可编译工程</p>
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">1</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Build</span> <span class="pre">Project</span></code> 即可编译当前选中的工程</p></li>
|
<li class="toctree-l1"><a class="reference internal" href="cdk_ck_link.html">使用 CK-Link</a></li>
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">2</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Clean</span> <span class="pre">Project</span></code> 即可清除上次编译的结果</p></li>
|
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">3</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Flash</span> <span class="pre">Download</span></code> 即可将编译好的代码下载到芯片中</p></li>
|
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">4</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debug</span></code> 即可进行 debug 的相关操作</p></li>
|
|
||||||
<li><p>也可以在 <code class="docutils literal notranslate"><span class="pre">Project</span></code> 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作</p></li>
|
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="id12">
|
|
||||||
<h3><span class="section-number">2.1.5.8. </span>烧写 Hello World<a class="headerlink" href="#id12" title="永久链接至标题">¶</a></h3>
|
|
||||||
<ul>
|
|
||||||
<li><p>由于目前 CDK 软件中还没有包含我们的 flash 算法，所以需要我们手动将 flash 算法放到 CDK 安装目录，具体操作如下：</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>进入 SDK 目录下 <code class="docutils literal notranslate"><span class="pre">tools\cdk_flashloader</span></code> 目录</p></li>
|
|
||||||
<li><p>将目录下的 <code class="docutils literal notranslate"><span class="pre">bl70x_flasher.elf</span></code> 文件，拷贝到 CDK 工具的 <code class="docutils literal notranslate"><span class="pre">C-Sky\CDK\CSKY\Flash</span></code> 目录中</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id20">
|
|
||||||
<img alt="" src="../_images/cdk7.png" />
|
|
||||||
<p class="caption"><span class="caption-text">CDK Flash Loader</span><a class="headerlink" href="#id20" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id21">
|
|
||||||
<img alt="" src="../_images/cdk8.png" />
|
|
||||||
<p class="caption"><span class="caption-text">CDK Project Setting</span><a class="headerlink" href="#id21" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">Project</span> <span class="pre">View</span></code> 中的项目设置按钮，打开 <code class="docutils literal notranslate"><span class="pre">Project</span> <span class="pre">Setting</span></code> 窗口，或者通过右击 <code class="docutils literal notranslate"><span class="pre">Project</span></code> 名称中右击菜单栏中打开</p></li>
|
|
||||||
<li><p>在打开的 <code class="docutils literal notranslate"><span class="pre">Project</span> <span class="pre">Setting</span></code> 窗口中，选择 <code class="docutils literal notranslate"><span class="pre">Flash</span></code> 标签，配置需要的 Flash 算法</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id22">
|
|
||||||
<img alt="" src="../_images/cdk9.png" />
|
|
||||||
<p class="caption"><span class="caption-text">CDK Project Flash setting</span><a class="headerlink" href="#id22" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>在 <code class="docutils literal notranslate"><span class="pre">Flash</span></code> 标签中，点击 <code class="docutils literal notranslate"><span class="pre">Add</span></code> 按纽，在打开的列表中选择 <code class="docutils literal notranslate"><span class="pre">bl70x_flash</span></code> 算法，点击 <code class="docutils literal notranslate"><span class="pre">Add</span></code> 添加到工程中，<code class="docutils literal notranslate"><span class="pre">Flash</span></code> 标签下的其他设置，如图所示：</p></li>
|
|
||||||
<li><p>点击 OK 后，如配置正确，点击 <code class="docutils literal notranslate"><span class="pre">Flash</span> <span class="pre">Download</span></code> 即可将编译好的代码下载到芯片中</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id23">
|
|
||||||
<img alt="" src="../_images/cdk5.png" />
|
|
||||||
<p class="caption"><span class="caption-text">CDK Flashdownload Success</span><a class="headerlink" href="#id23" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>如下载失败请检查：</p>
|
|
||||||
<ul>
|
|
||||||
<li><ol class="arabic simple">
|
|
||||||
<li><p>代码是否被正确编译，并生成 <code class="docutils literal notranslate"><span class="pre">.elf</span></code> <code class="docutils literal notranslate"><span class="pre">.bin</span></code> 等文件</p></li>
|
|
||||||
</ol>
|
|
||||||
</li>
|
|
||||||
<li><ol class="arabic simple" start="2">
|
|
||||||
<li><p>Flash 算法是否被正确设置</p></li>
|
|
||||||
</ol>
|
|
||||||
</li>
|
|
||||||
<li><ol class="arabic simple" start="3">
|
|
||||||
<li><p>CK-Link 与开发板是否正确连接</p></li>
|
|
||||||
</ol>
|
|
||||||
</li>
|
|
||||||
<li><ol class="arabic simple" start="4">
|
|
||||||
<li><p>开发板是否正常供电，电源指示灯是否点亮</p></li>
|
|
||||||
</ol>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="id13">
|
|
||||||
<h3><span class="section-number">2.1.5.9. </span>运行 Hello World<a class="headerlink" href="#id13" title="永久链接至标题">¶</a></h3>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>从 CDK 的菜单栏 <code class="docutils literal notranslate"><span class="pre">View->Serial</span> <span class="pre">Pane</span></code>，打开串口面板，在打开的 <code class="docutils literal notranslate"><span class="pre">Serial</span> <span class="pre">Pane</span></code> 中右击，进行串口设置，选择你对应的串口号和波特率</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default">
|
|
||||||
<img alt="../_images/cdk4.png" src="../_images/cdk4.png" />
|
|
||||||
</div>
|
|
||||||
<div class="figure align-default" id="id24">
|
|
||||||
<img alt="" src="../_images/cdk3.png" />
|
|
||||||
<p class="caption"><span class="caption-text">CDK Serial Pane setting</span><a class="headerlink" href="#id24" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>按下板子上的 <code class="docutils literal notranslate"><span class="pre">RST</span></code> 按键，即可在串口中看到代码的运行结果</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id25">
|
|
||||||
<img alt="" src="../_images/cdk6.png" />
|
|
||||||
<p class="caption"><span class="caption-text">HelloWorld！</span><a class="headerlink" href="#id25" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="id14">
|
|
||||||
<h3><span class="section-number">2.1.5.10. </span>调试 Hello World<a class="headerlink" href="#id14" title="永久链接至标题">¶</a></h3>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>点击工具栏上方的 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debugger</span></code> 按钮，进入 debug 界面，如下图所示</p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id26">
|
|
||||||
<img alt="" src="../_images/cdk10.png" />
|
|
||||||
<p class="caption"><span class="caption-text">Debug HelloWorld！</span><a class="headerlink" href="#id26" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li><p>在 debug 界面下，左侧的 <code class="docutils literal notranslate"><span class="pre">Register</span></code> 窗口中，可以查看 <code class="docutils literal notranslate"><span class="pre">CPU</span></code> 内部寄存器数据；右侧的 <code class="docutils literal notranslate"><span class="pre">Peripherals</span></code> 外设面板中，
|
|
||||||
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 <code class="docutils literal notranslate"><span class="pre">Peripherals->System</span> <span class="pre">Viewer</span></code> 选择；
|
|
||||||
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
|
||||||
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 <code class="docutils literal notranslate"><span class="pre">CDK</span> <span class="pre">Help</span></code>，这里就不作过多介绍了。</p></li>
|
|
||||||
<li><p>我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 <code class="docutils literal notranslate"><span class="pre">Hello</span> <span class="pre">World！</span></code></p></li>
|
|
||||||
</ul>
|
|
||||||
<div class="figure align-default" id="id27">
|
|
||||||
<img alt="" src="../_images/cdk11.png" />
|
|
||||||
<p class="caption"><span class="caption-text">Debug HelloWorld！</span><a class="headerlink" href="#id27" title="永久链接至图片">¶</a></p>
|
|
||||||
</div>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@ -470,7 +279,7 @@
|
|||||||
</div>
|
</div>
|
||||||
<footer>
|
<footer>
|
||||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
||||||
<a href="Windows_quick_start_eclipse.html" class="btn btn-neutral float-right" title="2.2. Windows 下使用 Eclipse 开发指南" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
<a href="cdk_rv_debugger_plus.html" class="btn btn-neutral float-right" title="使用 CDK + Sipeed RV-Debugger Plus 编译调试" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
||||||
<a href="index.html" class="btn btn-neutral float-left" title="2. 开发环境搭建指南" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
<a href="index.html" class="btn btn-neutral float-left" title="2. 开发环境搭建指南" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
@ -40,7 +40,7 @@
|
|||||||
<link rel="index" title="索引" href="../genindex.html" />
|
<link rel="index" title="索引" href="../genindex.html" />
|
||||||
<link rel="search" title="搜索" href="../search.html" />
|
<link rel="search" title="搜索" href="../search.html" />
|
||||||
<link rel="next" title="2.3. Linux OR WSL 环境开发指南" href="Linux_quick_start_ubuntu.html" />
|
<link rel="next" title="2.3. Linux OR WSL 环境开发指南" href="Linux_quick_start_ubuntu.html" />
|
||||||
<link rel="prev" title="2.1. Windows 下使用 CDK (类 MDK Keil)开发指南" href="Windows_quick_start_cdk.html" />
|
<link rel="prev" title="使用 CDK + CK-Link 编译调试" href="cdk_ck_link.html" />
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body class="wy-body-for-nav">
|
<body class="wy-body-for-nav">
|
||||||
@ -102,11 +102,11 @@
|
|||||||
<li class="toctree-l3"><a class="reference internal" href="#id4">2.2.5. 导入 bl_mcu_sdk</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="#id4">2.2.5. 导入 bl_mcu_sdk</a></li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="#id5">2.2.6. 硬件连接</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="#id5">2.2.6. 硬件连接</a></li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="#hello-world">2.2.7. 测试 Hello World 工程</a><ul>
|
<li class="toctree-l3"><a class="reference internal" href="#hello-world">2.2.7. 测试 Hello World 工程</a><ul>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id6">2.2.7.1. 打开 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id6">打开 Hello World</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id7">2.2.7.2. 编译 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id7">编译 Hello World</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id8">2.2.7.3. 烧写 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id8">烧写 Hello World</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id9">2.2.7.4. 运行 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id9">运行 Hello World</a></li>
|
||||||
<li class="toctree-l4"><a class="reference internal" href="#id10">2.2.7.5. 调试 Hello World</a></li>
|
<li class="toctree-l4"><a class="reference internal" href="#id10">调试 Hello World</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="#id11">2.2.8. 编译烧写不同的目标工程</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="#id11">2.2.8. 编译烧写不同的目标工程</a></li>
|
||||||
@ -322,13 +322,13 @@
|
|||||||
<div class="section" id="hello-world">
|
<div class="section" id="hello-world">
|
||||||
<h2><span class="section-number">2.2.7. </span>测试 Hello World 工程<a class="headerlink" href="#hello-world" title="永久链接至标题">¶</a></h2>
|
<h2><span class="section-number">2.2.7. </span>测试 Hello World 工程<a class="headerlink" href="#hello-world" title="永久链接至标题">¶</a></h2>
|
||||||
<div class="section" id="id6">
|
<div class="section" id="id6">
|
||||||
<h3><span class="section-number">2.2.7.1. </span>打开 Hello World<a class="headerlink" href="#id6" title="永久链接至标题">¶</a></h3>
|
<h3>打开 Hello World<a class="headerlink" href="#id6" title="永久链接至标题">¶</a></h3>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>打开 <code class="docutils literal notranslate"><span class="pre">examples/hellowd/helloworld/main.c</span></code> 文件，即可编辑、修改 <code class="docutils literal notranslate"><span class="pre">helloworld</span></code> 测试 demo 的代码，若修改了，请保存后在执行编译</p></li>
|
<li><p>打开 <code class="docutils literal notranslate"><span class="pre">examples/hellowd/helloworld/main.c</span></code> 文件，即可编辑、修改 <code class="docutils literal notranslate"><span class="pre">helloworld</span></code> 测试 demo 的代码，若修改了，请保存后在执行编译</p></li>
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id7">
|
<div class="section" id="id7">
|
||||||
<h3><span class="section-number">2.2.7.2. </span>编译 Hello World<a class="headerlink" href="#id7" title="永久链接至标题">¶</a></h3>
|
<h3>编译 Hello World<a class="headerlink" href="#id7" title="永久链接至标题">¶</a></h3>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>双击 <code class="docutils literal notranslate"><span class="pre">bl_make</span></code> 即可编 helloworld 工程</p></li>
|
<li><p>双击 <code class="docutils literal notranslate"><span class="pre">bl_make</span></code> 即可编 helloworld 工程</p></li>
|
||||||
<li><p>编译成功后 <code class="docutils literal notranslate"><span class="pre">Console</span></code> 窗口可以看到如下图所示的 log 信息</p></li>
|
<li><p>编译成功后 <code class="docutils literal notranslate"><span class="pre">Console</span></code> 窗口可以看到如下图所示的 log 信息</p></li>
|
||||||
@ -338,7 +338,7 @@
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id8">
|
<div class="section" id="id8">
|
||||||
<h3><span class="section-number">2.2.7.3. </span>烧写 Hello World<a class="headerlink" href="#id8" title="永久链接至标题">¶</a></h3>
|
<h3>烧写 Hello World<a class="headerlink" href="#id8" title="永久链接至标题">¶</a></h3>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>双击 <code class="docutils literal notranslate"><span class="pre">download</span></code> 即可烧写 helloworld 工程 <code class="docutils literal notranslate"><span class="pre">bin</span></code> 文件到芯片中</p></li>
|
<li><p>双击 <code class="docutils literal notranslate"><span class="pre">download</span></code> 即可烧写 helloworld 工程 <code class="docutils literal notranslate"><span class="pre">bin</span></code> 文件到芯片中</p></li>
|
||||||
<li><p>下载成功后 <code class="docutils literal notranslate"><span class="pre">Console</span></code> 窗口可以看到如下图所示的 log 信息</p></li>
|
<li><p>下载成功后 <code class="docutils literal notranslate"><span class="pre">Console</span></code> 窗口可以看到如下图所示的 log 信息</p></li>
|
||||||
@ -348,7 +348,7 @@
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id9">
|
<div class="section" id="id9">
|
||||||
<h3><span class="section-number">2.2.7.4. </span>运行 Hello World<a class="headerlink" href="#id9" title="永久链接至标题">¶</a></h3>
|
<h3>运行 Hello World<a class="headerlink" href="#id9" title="永久链接至标题">¶</a></h3>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>将开发板的 <code class="docutils literal notranslate"><span class="pre">TXD0</span></code>、<code class="docutils literal notranslate"><span class="pre">RXD0</span></code> 和 <code class="docutils literal notranslate"><span class="pre">GND</span></code> 引脚使用杜邦线连接到 USB-TTL 串口模块，将串口模块插入 PC 主机， 使用任意的串口助手软件打开串口</p></li>
|
<li><p>将开发板的 <code class="docutils literal notranslate"><span class="pre">TXD0</span></code>、<code class="docutils literal notranslate"><span class="pre">RXD0</span></code> 和 <code class="docutils literal notranslate"><span class="pre">GND</span></code> 引脚使用杜邦线连接到 USB-TTL 串口模块，将串口模块插入 PC 主机， 使用任意的串口助手软件打开串口</p></li>
|
||||||
<li><p>烧写成功后，按下板子上的 <code class="docutils literal notranslate"><span class="pre">rst</span></code> 按键，如果下载正确，即可在串口助手软件中看到如下图所示的 log 信息。</p></li>
|
<li><p>烧写成功后，按下板子上的 <code class="docutils literal notranslate"><span class="pre">rst</span></code> 按键，如果下载正确，即可在串口助手软件中看到如下图所示的 log 信息。</p></li>
|
||||||
@ -358,7 +358,7 @@
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="id10">
|
<div class="section" id="id10">
|
||||||
<h3><span class="section-number">2.2.7.5. </span>调试 Hello World<a class="headerlink" href="#id10" title="永久链接至标题">¶</a></h3>
|
<h3>调试 Hello World<a class="headerlink" href="#id10" title="永久链接至标题">¶</a></h3>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>点击 eclipse 工具栏中的 <code class="docutils literal notranslate"><span class="pre">Debug</span></code> 按钮，进入 debug 配置窗口</p></li>
|
<li><p>点击 eclipse 工具栏中的 <code class="docutils literal notranslate"><span class="pre">Debug</span></code> 按钮，进入 debug 配置窗口</p></li>
|
||||||
<li><p>选择 <code class="docutils literal notranslate"><span class="pre">GDB</span> <span class="pre">SEGGER</span> <span class="pre">J-Link</span> <span class="pre">Debugging->Jlink_bl_mcu_sdk</span></code> Debug 配置，在 <code class="docutils literal notranslate"><span class="pre">C/C++</span> <span class="pre">Application:</span></code> 选项中选择需要调试的 <code class="docutils literal notranslate"><span class="pre">.elf</span></code> 文件</p></li>
|
<li><p>选择 <code class="docutils literal notranslate"><span class="pre">GDB</span> <span class="pre">SEGGER</span> <span class="pre">J-Link</span> <span class="pre">Debugging->Jlink_bl_mcu_sdk</span></code> Debug 配置，在 <code class="docutils literal notranslate"><span class="pre">C/C++</span> <span class="pre">Application:</span></code> 选项中选择需要调试的 <code class="docutils literal notranslate"><span class="pre">.elf</span></code> 文件</p></li>
|
||||||
@ -399,7 +399,7 @@
|
|||||||
<footer>
|
<footer>
|
||||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
||||||
<a href="Linux_quick_start_ubuntu.html" class="btn btn-neutral float-right" title="2.3. Linux OR WSL 环境开发指南" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
<a href="Linux_quick_start_ubuntu.html" class="btn btn-neutral float-right" title="2.3. Linux OR WSL 环境开发指南" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
||||||
<a href="Windows_quick_start_cdk.html" class="btn btn-neutral float-left" title="2.1. Windows 下使用 CDK (类 MDK Keil)开发指南" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
<a href="cdk_ck_link.html" class="btn btn-neutral float-left" title="使用 CDK + CK-Link 编译调试" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<hr/>
|
<hr/>
|
||||||
|
|||||||
394
docs/development_guide/build/html/get_started/cdk_ck_link.html
Normal file
394
docs/development_guide/build/html/get_started/cdk_ck_link.html
Normal file
@ -0,0 +1,394 @@
|
|||||||
|
|
||||||
|
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html class="writer-html5" lang="zh-CN" >
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8" />
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
|
|
||||||
|
<title>使用 CDK + CK-Link 编译调试 — BL_MCU_SDK 开发指南 0.2 文档</title>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
|
||||||
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!--[if lt IE 9]>
|
||||||
|
<script src="../_static/js/html5shiv.min.js"></script>
|
||||||
|
<![endif]-->
|
||||||
|
|
||||||
|
|
||||||
|
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
||||||
|
<script src="../_static/jquery.js"></script>
|
||||||
|
<script src="../_static/underscore.js"></script>
|
||||||
|
<script src="../_static/doctools.js"></script>
|
||||||
|
<script src="../_static/translations.js"></script>
|
||||||
|
|
||||||
|
<script type="text/javascript" src="../_static/js/theme.js"></script>
|
||||||
|
|
||||||
|
|
||||||
|
<link rel="index" title="索引" href="../genindex.html" />
|
||||||
|
<link rel="search" title="搜索" href="../search.html" />
|
||||||
|
<link rel="next" title="2.2. Windows 下使用 Eclipse 开发指南" href="Windows_quick_start_eclipse.html" />
|
||||||
|
<link rel="prev" title="使用 CDK + Sipeed RV-Debugger Plus 编译调试" href="cdk_rv_debugger_plus.html" />
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="wy-body-for-nav">
|
||||||
|
|
||||||
|
|
||||||
|
<div class="wy-grid-for-nav">
|
||||||
|
|
||||||
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
||||||
|
<div class="wy-side-scroll">
|
||||||
|
<div class="wy-side-nav-search" >
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a href="../index.html" class="icon icon-home"> BL_MCU_SDK 开发指南
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</a>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="version">
|
||||||
|
0.2
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div role="search">
|
||||||
|
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
|
||||||
|
<input type="text" name="q" placeholder="Search docs" />
|
||||||
|
<input type="hidden" name="check_keywords" value="yes" />
|
||||||
|
<input type="hidden" name="area" value="default" />
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<p class="caption"><span class="caption-text">快速开发指南</span></p>
|
||||||
|
<ul class="current">
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="get_started.html">1. 开发前的准备</a></li>
|
||||||
|
<li class="toctree-l1 current"><a class="reference internal" href="index.html">2. 开发环境搭建指南</a><ul class="current">
|
||||||
|
<li class="toctree-l2 current"><a class="reference internal" href="Windows_quick_start_cdk.html">2.1. Windows_CDK</a><ul class="current">
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="Windows_quick_start_cdk.html#id2">2.1.1. 需要的软硬件环境</a></li>
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="Windows_quick_start_cdk.html#cdk">2.1.2. 下载剑池 CDK 软件安装包</a></li>
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="Windows_quick_start_cdk.html#bl-mcu-sdk">2.1.3. 下载 bl_mcu_sdk 软件开发包</a></li>
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="Windows_quick_start_cdk.html#id4">2.1.4. 硬件连接</a></li>
|
||||||
|
<li class="toctree-l3 current"><a class="reference internal" href="Windows_quick_start_cdk.html#hello-world">2.1.5. 测试 Hello World 工程</a><ul class="current">
|
||||||
|
<li class="toctree-l4"><a class="reference internal" href="cdk_rv_debugger_plus.html">使用 Sipeed RV-Debugger</a></li>
|
||||||
|
<li class="toctree-l4 current"><a class="current reference internal" href="#">使用 CK-Link</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="toctree-l2"><a class="reference internal" href="Windows_quick_start_eclipse.html">2.2. Windows_eclipse</a></li>
|
||||||
|
<li class="toctree-l2"><a class="reference internal" href="Linux_quick_start_ubuntu.html">2.3. Linux</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="bl_dev_cube.html">3. BLDevCube 烧录工具指南</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="cmake_quick_start.html">4. 基于 cmake 框架新建工程指南</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="connecting_hardware.html">5. 硬件连接指南</a></li>
|
||||||
|
</ul>
|
||||||
|
<p class="caption"><span class="caption-text">API 手册</span></p>
|
||||||
|
<ul>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_structure.html">1. API 分层模型</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_clock.html">2. 时钟树</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_gpio.html">3. GPIO 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_uart.html">4. UART 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_pwm.html">5. PWM 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_dma.html">6. DMA 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_i2c.html">7. I2C 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_spi.html">8. SPI 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_adc.html">9. ADC 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_dac.html">10. DAC 设备</a></li>
|
||||||
|
</ul>
|
||||||
|
<p class="caption"><span class="caption-text">基础外设例程</span></p>
|
||||||
|
<ul>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/gpio/index.html">1. GPIO 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/uart/index.html">2. UART 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/pwm/index.html">3. PWM 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/mtimer/index.html">4. MTIMER 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/dma/index.html">5. DMA 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/spi/index.html">6. SPI 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/i2c/index.html">7. I2C 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/adc/index.html">8. ADC 示例</a></li>
|
||||||
|
</ul>
|
||||||
|
<p class="caption"><span class="caption-text">进阶例程</span></p>
|
||||||
|
<ul>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/shell_demo.html">1. SHELL 命令行调试</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/fatfs_demo.html">2. FATFS 文件系统读写</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/lowpower_demo.html">3. LowPower 低功耗评估</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/ble_scan_demo.html">4. BLE 客户端和服务端互连</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/boot2_iap_info.html">5. BOOT2 IAP</a></li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
|
||||||
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
||||||
|
|
||||||
|
|
||||||
|
<nav class="wy-nav-top" aria-label="top navigation">
|
||||||
|
|
||||||
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
||||||
|
<a href="../index.html">BL_MCU_SDK 开发指南</a>
|
||||||
|
|
||||||
|
</nav>
|
||||||
|
|
||||||
|
|
||||||
|
<div class="wy-nav-content">
|
||||||
|
|
||||||
|
<div class="rst-content">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div role="navigation" aria-label="breadcrumbs navigation">
|
||||||
|
|
||||||
|
<ul class="wy-breadcrumbs">
|
||||||
|
|
||||||
|
<li><a href="../index.html" class="icon icon-home"></a> »</li>
|
||||||
|
|
||||||
|
<li><a href="index.html"><span class="section-number">2. </span>开发环境搭建指南</a> »</li>
|
||||||
|
|
||||||
|
<li><a href="Windows_quick_start_cdk.html"><span class="section-number">2.1. </span>Windows 下使用 CDK (类 MDK Keil)开发指南</a> »</li>
|
||||||
|
|
||||||
|
<li>使用 CDK + CK-Link 编译调试</li>
|
||||||
|
|
||||||
|
|
||||||
|
<li class="wy-breadcrumbs-aside">
|
||||||
|
|
||||||
|
|
||||||
|
<a href="../_sources/get_started/cdk_ck_link.rst.txt" rel="nofollow"> View page source</a>
|
||||||
|
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
<hr/>
|
||||||
|
</div>
|
||||||
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||||
|
<div itemprop="articleBody">
|
||||||
|
|
||||||
|
<div class="section" id="cdk-ck-link">
|
||||||
|
<h1>使用 CDK + CK-Link 编译调试<a class="headerlink" href="#cdk-ck-link" title="永久链接至标题">¶</a></h1>
|
||||||
|
<div class="section" id="hello-world">
|
||||||
|
<h2>打开 Hello World<a class="headerlink" href="#hello-world" title="永久链接至标题">¶</a></h2>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>获取到 SDK 后，进入 sdk 中的 <code class="docutils literal notranslate"><span class="pre">examples/hellowd/helloworld/cdk</span></code> 目录下，双击 <code class="docutils literal notranslate"><span class="pre">helloworld.cdkproj</span></code>，即可打开 <code class="docutils literal notranslate"><span class="pre">Helloworld</span></code> 工程</p></li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="section" id="id1">
|
||||||
|
<h2>编译 Hello World<a class="headerlink" href="#id1" title="永久链接至标题">¶</a></h2>
|
||||||
|
<div class="figure align-default" id="id5">
|
||||||
|
<img alt="" src="../_images/cdk1.png" />
|
||||||
|
<p class="caption"><span class="caption-text">helloworld.cdkproj</span><a class="headerlink" href="#id5" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>在活动工程下拉菜单可以选择 <code class="docutils literal notranslate"><span class="pre">CK_Link_Debug</span></code> 或者 <code class="docutils literal notranslate"><span class="pre">OpenOCD_Debug</span></code> 工程，本教程基于 <code class="docutils literal notranslate"><span class="pre">CK_Link_Debug</span></code> 工程</p></li>
|
||||||
|
<li><p>在 CDK 工具栏中，点击编译图标即可编译工程</p>
|
||||||
|
<ul>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">1</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Build</span> <span class="pre">Project</span></code> 即可编译当前选中的工程</p></li>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">2</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Clean</span> <span class="pre">Project</span></code> 即可清除上次编译的结果</p></li>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">3</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Flash</span> <span class="pre">Download</span></code> 即可将编译好的代码下载到芯片中</p></li>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">4</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debug</span></code> 即可进行 debug 的相关操作（在使用 <code class="docutils literal notranslate"><span class="pre">CK-Link</span></code> 时可以先将代码 load 到 flash 中）</p></li>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">5</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debug</span> <span class="pre">whitout</span> <span class="pre">Download</span></code> 即可直接进行 debug , 不 load 当前 bin 文件</p></li>
|
||||||
|
<li><p>也可以在 <code class="docutils literal notranslate"><span class="pre">Project</span></code> 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作</p></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="section" id="id2">
|
||||||
|
<h2>烧写 Hello World<a class="headerlink" href="#id2" title="永久链接至标题">¶</a></h2>
|
||||||
|
<ul>
|
||||||
|
<li><p>由于目前 CDK 软件中还没有包含我们的 flash 算法，所以需要我们手动将 flash 算法放到 CDK 安装目录，具体操作如下：</p>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>进入 SDK 目录下 <code class="docutils literal notranslate"><span class="pre">tools\cdk_flashloader</span></code> 目录</p></li>
|
||||||
|
<li><p>将目录下的 <code class="docutils literal notranslate"><span class="pre">bl70x_flasher.elf</span></code> 文件，拷贝到 CDK 工具的 <code class="docutils literal notranslate"><span class="pre">C-Sky\CDK\CSKY\Flash</span></code> 目录中</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id6">
|
||||||
|
<img alt="" src="../_images/cdk7.png" />
|
||||||
|
<p class="caption"><span class="caption-text">CDK Flash Loader</span><a class="headerlink" href="#id6" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id7">
|
||||||
|
<img alt="" src="../_images/cdk8.png" />
|
||||||
|
<p class="caption"><span class="caption-text">CDK Project Setting</span><a class="headerlink" href="#id7" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">Project</span> <span class="pre">View</span></code> 中的项目设置按钮，打开 <code class="docutils literal notranslate"><span class="pre">Project</span> <span class="pre">Setting</span></code> 窗口，或者通过右击 <code class="docutils literal notranslate"><span class="pre">Project</span></code> 名称中右击菜单栏中打开</p></li>
|
||||||
|
<li><p>在打开的 <code class="docutils literal notranslate"><span class="pre">Project</span> <span class="pre">Setting</span></code> 窗口中，选择 <code class="docutils literal notranslate"><span class="pre">Flash</span></code> 标签，配置需要的 Flash 算法</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id8">
|
||||||
|
<img alt="" src="../_images/cdk9.png" />
|
||||||
|
<p class="caption"><span class="caption-text">CDK Project Flash setting</span><a class="headerlink" href="#id8" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>在 <code class="docutils literal notranslate"><span class="pre">Flash</span></code> 标签中，点击 <code class="docutils literal notranslate"><span class="pre">Add</span></code> 按纽，在打开的列表中选择 <code class="docutils literal notranslate"><span class="pre">bl70x_flash</span></code> 算法，点击 <code class="docutils literal notranslate"><span class="pre">Add</span></code> 添加到工程中，<code class="docutils literal notranslate"><span class="pre">Flash</span></code> 标签下的其他设置，如图所示：</p></li>
|
||||||
|
<li><p>点击 OK 后，如配置正确，点击 <code class="docutils literal notranslate"><span class="pre">Flash</span> <span class="pre">Download</span></code> 即可将编译好的代码下载到芯片中</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id9">
|
||||||
|
<img alt="" src="../_images/cdk5.png" />
|
||||||
|
<p class="caption"><span class="caption-text">CDK Flashdownload Success</span><a class="headerlink" href="#id9" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>如下载失败请检查：</p>
|
||||||
|
<ul>
|
||||||
|
<li><ol class="arabic simple">
|
||||||
|
<li><p>代码是否被正确编译，并生成 <code class="docutils literal notranslate"><span class="pre">.elf</span></code> <code class="docutils literal notranslate"><span class="pre">.bin</span></code> 等文件</p></li>
|
||||||
|
</ol>
|
||||||
|
</li>
|
||||||
|
<li><ol class="arabic simple" start="2">
|
||||||
|
<li><p>Flash 算法是否被正确设置</p></li>
|
||||||
|
</ol>
|
||||||
|
</li>
|
||||||
|
<li><ol class="arabic simple" start="3">
|
||||||
|
<li><p>CK-Link 与开发板是否正确连接</p></li>
|
||||||
|
</ol>
|
||||||
|
</li>
|
||||||
|
<li><ol class="arabic simple" start="4">
|
||||||
|
<li><p>开发板是否正常供电，电源指示灯是否点亮</p></li>
|
||||||
|
</ol>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="section" id="id3">
|
||||||
|
<h2>运行 Hello World<a class="headerlink" href="#id3" title="永久链接至标题">¶</a></h2>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>从 CDK 的菜单栏 <code class="docutils literal notranslate"><span class="pre">View->Serial</span> <span class="pre">Pane</span></code>，打开串口面板，在打开的 <code class="docutils literal notranslate"><span class="pre">Serial</span> <span class="pre">Pane</span></code> 中右击，进行串口设置，选择你对应的串口号和波特率</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default">
|
||||||
|
<img alt="../_images/cdk4.png" src="../_images/cdk4.png" />
|
||||||
|
</div>
|
||||||
|
<div class="figure align-default" id="id10">
|
||||||
|
<img alt="" src="../_images/cdk3.png" />
|
||||||
|
<p class="caption"><span class="caption-text">CDK Serial Pane setting</span><a class="headerlink" href="#id10" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>按下板子上的 <code class="docutils literal notranslate"><span class="pre">RST</span></code> 按键，即可在串口中看到代码的运行结果</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id11">
|
||||||
|
<img alt="" src="../_images/cdk6.png" />
|
||||||
|
<p class="caption"><span class="caption-text">HelloWorld！</span><a class="headerlink" href="#id11" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="section" id="id4">
|
||||||
|
<h2>调试 Hello World<a class="headerlink" href="#id4" title="永久链接至标题">¶</a></h2>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>点击工具栏上方的 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debugger</span></code> 按钮，进入 debug 界面，如下图所示</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id12">
|
||||||
|
<img alt="" src="../_images/cdk10.png" />
|
||||||
|
<p class="caption"><span class="caption-text">Debug HelloWorld！</span><a class="headerlink" href="#id12" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>在 debug 界面下，左侧的 <code class="docutils literal notranslate"><span class="pre">Register</span></code> 窗口中，可以查看 <code class="docutils literal notranslate"><span class="pre">CPU</span></code> 内部寄存器数据；右侧的 <code class="docutils literal notranslate"><span class="pre">Peripherals</span></code> 外设面板中，
|
||||||
|
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 <code class="docutils literal notranslate"><span class="pre">Peripherals->System</span> <span class="pre">Viewer</span></code> 选择；
|
||||||
|
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
||||||
|
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 <code class="docutils literal notranslate"><span class="pre">CDK</span> <span class="pre">Help</span></code>，这里就不作过多介绍了。</p></li>
|
||||||
|
<li><p>我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 <code class="docutils literal notranslate"><span class="pre">Hello</span> <span class="pre">World！</span></code></p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id13">
|
||||||
|
<img alt="" src="../_images/cdk11.png" />
|
||||||
|
<p class="caption"><span class="caption-text">Debug HelloWorld！</span><a class="headerlink" href="#id13" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<footer>
|
||||||
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
||||||
|
<a href="Windows_quick_start_eclipse.html" class="btn btn-neutral float-right" title="2.2. Windows 下使用 Eclipse 开发指南" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
||||||
|
<a href="cdk_rv_debugger_plus.html" class="btn btn-neutral float-left" title="使用 CDK + Sipeed RV-Debugger Plus 编译调试" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<hr/>
|
||||||
|
|
||||||
|
<div role="contentinfo">
|
||||||
|
<p>
|
||||||
|
© 版权所有 2021, BouffaloLab Co., Ltd.
|
||||||
|
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
|
||||||
|
|
||||||
|
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
|
||||||
|
|
||||||
|
provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
||||||
|
|
||||||
|
</footer>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
<script type="text/javascript">
|
||||||
|
jQuery(function () {
|
||||||
|
SphinxRtdTheme.Navigation.enable(true);
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@ -0,0 +1,340 @@
|
|||||||
|
|
||||||
|
|
||||||
|
<!DOCTYPE html>
|
||||||
|
<html class="writer-html5" lang="zh-CN" >
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8" />
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
|
|
||||||
|
<title>使用 CDK + Sipeed RV-Debugger Plus 编译调试 — BL_MCU_SDK 开发指南 0.2 文档</title>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
|
||||||
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!--[if lt IE 9]>
|
||||||
|
<script src="../_static/js/html5shiv.min.js"></script>
|
||||||
|
<![endif]-->
|
||||||
|
|
||||||
|
|
||||||
|
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
||||||
|
<script src="../_static/jquery.js"></script>
|
||||||
|
<script src="../_static/underscore.js"></script>
|
||||||
|
<script src="../_static/doctools.js"></script>
|
||||||
|
<script src="../_static/translations.js"></script>
|
||||||
|
|
||||||
|
<script type="text/javascript" src="../_static/js/theme.js"></script>
|
||||||
|
|
||||||
|
|
||||||
|
<link rel="index" title="索引" href="../genindex.html" />
|
||||||
|
<link rel="search" title="搜索" href="../search.html" />
|
||||||
|
<link rel="next" title="使用 CDK + CK-Link 编译调试" href="cdk_ck_link.html" />
|
||||||
|
<link rel="prev" title="2.1. Windows 下使用 CDK (类 MDK Keil)开发指南" href="Windows_quick_start_cdk.html" />
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body class="wy-body-for-nav">
|
||||||
|
|
||||||
|
|
||||||
|
<div class="wy-grid-for-nav">
|
||||||
|
|
||||||
|
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
|
||||||
|
<div class="wy-side-scroll">
|
||||||
|
<div class="wy-side-nav-search" >
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a href="../index.html" class="icon icon-home"> BL_MCU_SDK 开发指南
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</a>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div class="version">
|
||||||
|
0.2
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div role="search">
|
||||||
|
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
|
||||||
|
<input type="text" name="q" placeholder="Search docs" />
|
||||||
|
<input type="hidden" name="check_keywords" value="yes" />
|
||||||
|
<input type="hidden" name="area" value="default" />
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<p class="caption"><span class="caption-text">快速开发指南</span></p>
|
||||||
|
<ul class="current">
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="get_started.html">1. 开发前的准备</a></li>
|
||||||
|
<li class="toctree-l1 current"><a class="reference internal" href="index.html">2. 开发环境搭建指南</a><ul class="current">
|
||||||
|
<li class="toctree-l2 current"><a class="reference internal" href="Windows_quick_start_cdk.html">2.1. Windows_CDK</a><ul class="current">
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="Windows_quick_start_cdk.html#id2">2.1.1. 需要的软硬件环境</a></li>
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="Windows_quick_start_cdk.html#cdk">2.1.2. 下载剑池 CDK 软件安装包</a></li>
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="Windows_quick_start_cdk.html#bl-mcu-sdk">2.1.3. 下载 bl_mcu_sdk 软件开发包</a></li>
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="Windows_quick_start_cdk.html#id4">2.1.4. 硬件连接</a></li>
|
||||||
|
<li class="toctree-l3 current"><a class="reference internal" href="Windows_quick_start_cdk.html#hello-world">2.1.5. 测试 Hello World 工程</a><ul class="current">
|
||||||
|
<li class="toctree-l4 current"><a class="current reference internal" href="#">使用 Sipeed RV-Debugger</a></li>
|
||||||
|
<li class="toctree-l4"><a class="reference internal" href="cdk_ck_link.html">使用 CK-Link</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="toctree-l2"><a class="reference internal" href="Windows_quick_start_eclipse.html">2.2. Windows_eclipse</a></li>
|
||||||
|
<li class="toctree-l2"><a class="reference internal" href="Linux_quick_start_ubuntu.html">2.3. Linux</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="bl_dev_cube.html">3. BLDevCube 烧录工具指南</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="cmake_quick_start.html">4. 基于 cmake 框架新建工程指南</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="connecting_hardware.html">5. 硬件连接指南</a></li>
|
||||||
|
</ul>
|
||||||
|
<p class="caption"><span class="caption-text">API 手册</span></p>
|
||||||
|
<ul>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_structure.html">1. API 分层模型</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_clock.html">2. 时钟树</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_gpio.html">3. GPIO 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_uart.html">4. UART 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_pwm.html">5. PWM 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_dma.html">6. DMA 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_i2c.html">7. I2C 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_spi.html">8. SPI 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_adc.html">9. ADC 设备</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../api_reference/api_dac.html">10. DAC 设备</a></li>
|
||||||
|
</ul>
|
||||||
|
<p class="caption"><span class="caption-text">基础外设例程</span></p>
|
||||||
|
<ul>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/gpio/index.html">1. GPIO 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/uart/index.html">2. UART 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/pwm/index.html">3. PWM 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/mtimer/index.html">4. MTIMER 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/dma/index.html">5. DMA 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/spi/index.html">6. SPI 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/i2c/index.html">7. I2C 示例</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/basic%20samples/adc/index.html">8. ADC 示例</a></li>
|
||||||
|
</ul>
|
||||||
|
<p class="caption"><span class="caption-text">进阶例程</span></p>
|
||||||
|
<ul>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/shell_demo.html">1. SHELL 命令行调试</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/fatfs_demo.html">2. FATFS 文件系统读写</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/lowpower_demo.html">3. LowPower 低功耗评估</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/ble_scan_demo.html">4. BLE 客户端和服务端互连</a></li>
|
||||||
|
<li class="toctree-l1"><a class="reference internal" href="../samples/advance%20samples/boot2_iap_info.html">5. BOOT2 IAP</a></li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
|
||||||
|
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
|
||||||
|
|
||||||
|
|
||||||
|
<nav class="wy-nav-top" aria-label="top navigation">
|
||||||
|
|
||||||
|
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
|
||||||
|
<a href="../index.html">BL_MCU_SDK 开发指南</a>
|
||||||
|
|
||||||
|
</nav>
|
||||||
|
|
||||||
|
|
||||||
|
<div class="wy-nav-content">
|
||||||
|
|
||||||
|
<div class="rst-content">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<div role="navigation" aria-label="breadcrumbs navigation">
|
||||||
|
|
||||||
|
<ul class="wy-breadcrumbs">
|
||||||
|
|
||||||
|
<li><a href="../index.html" class="icon icon-home"></a> »</li>
|
||||||
|
|
||||||
|
<li><a href="index.html"><span class="section-number">2. </span>开发环境搭建指南</a> »</li>
|
||||||
|
|
||||||
|
<li><a href="Windows_quick_start_cdk.html"><span class="section-number">2.1. </span>Windows 下使用 CDK (类 MDK Keil)开发指南</a> »</li>
|
||||||
|
|
||||||
|
<li>使用 CDK + Sipeed RV-Debugger Plus 编译调试</li>
|
||||||
|
|
||||||
|
|
||||||
|
<li class="wy-breadcrumbs-aside">
|
||||||
|
|
||||||
|
|
||||||
|
<a href="../_sources/get_started/cdk_rv_debugger_plus.rst.txt" rel="nofollow"> View page source</a>
|
||||||
|
|
||||||
|
|
||||||
|
</li>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
<hr/>
|
||||||
|
</div>
|
||||||
|
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||||
|
<div itemprop="articleBody">
|
||||||
|
|
||||||
|
<div class="section" id="cdk-sipeed-rv-debugger-plus">
|
||||||
|
<h1>使用 CDK + Sipeed RV-Debugger Plus 编译调试<a class="headerlink" href="#cdk-sipeed-rv-debugger-plus" title="永久链接至标题">¶</a></h1>
|
||||||
|
<div class="section" id="hello-world">
|
||||||
|
<h2>打开 Hello World<a class="headerlink" href="#hello-world" title="永久链接至标题">¶</a></h2>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>获取到 SDK 后，进入 sdk 中的 <code class="docutils literal notranslate"><span class="pre">examples/hellowd/helloworld/cdk</span></code> 目录下，双击 <code class="docutils literal notranslate"><span class="pre">helloworld.cdkproj</span></code>，即可打开 <code class="docutils literal notranslate"><span class="pre">Helloworld</span></code> 工程</p></li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="section" id="id1">
|
||||||
|
<h2>编译 Hello World<a class="headerlink" href="#id1" title="永久链接至标题">¶</a></h2>
|
||||||
|
<div class="figure align-default" id="id5">
|
||||||
|
<img alt="" src="../_images/cdk1.png" />
|
||||||
|
<p class="caption"><span class="caption-text">helloworld.cdkproj</span><a class="headerlink" href="#id5" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>在活动工程下拉菜单选择 <code class="docutils literal notranslate"><span class="pre">OpenOCD_Debug</span></code> 工程，由于 Sipeed RV-Debugger Plus 是使用 OpenOCD 调试的，所以本教程基于 <code class="docutils literal notranslate"><span class="pre">OpenOCD_Debug</span></code> 工程；</p></li>
|
||||||
|
<li><p>如 Sipeed RV-Debugger Plus 没有正确安装驱动，请参考 <a class="reference internal" href="get_started.html#sipeed-rv-debugger-plus"><span class="std std-ref">调试器驱动安装设置</span></a> 部分，设置好驱动程序，在进行下面的步骤</p></li>
|
||||||
|
<li><p>在 CDK 工具栏中，点击编译图标即可编译工程</p>
|
||||||
|
<ul>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">1</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Build</span> <span class="pre">Project</span></code> 即可编译当前选中的工程</p></li>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">2</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Clean</span> <span class="pre">Project</span></code> 即可清除上次编译的结果</p></li>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">3</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Flash</span> <span class="pre">Download</span></code> 即可将编译好的代码下载到芯片中 （<strong>使用 OpenOCD Debug 不能使用 Flash 下载功能</strong>）</p></li>
|
||||||
|
<li><p>点击 <code class="docutils literal notranslate"><span class="pre">5</span></code> 处 图标 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debug</span> <span class="pre">whitout</span> <span class="pre">Download</span></code> 即可直接进行 debug , 不 load 当前 bin 文件</p></li>
|
||||||
|
<li><p>也可以在 <code class="docutils literal notranslate"><span class="pre">Project</span></code> 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作</p></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="section" id="id2">
|
||||||
|
<h2>烧写 Hello World<a class="headerlink" href="#id2" title="永久链接至标题">¶</a></h2>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>在 CDK 中使用 OpenOCD 模式的调试方式时，暂不支持直接使用 CDK 相关 <code class="docutils literal notranslate"><span class="pre">flash</span></code> 工具下载代码，所以请使用 BL Dev Cube 工具进行程序烧写，烧写代码请参考 <a class="reference internal" href="bl_dev_cube.html#bl-dev-cube"><span class="std std-ref">BLDevCube 烧录工具指南</span></a> 部分进行</p></li>
|
||||||
|
<li><p>代码烧写完成后使用 CDK 进行 Debug</p></li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div class="section" id="id3">
|
||||||
|
<h2>运行 Hello World<a class="headerlink" href="#id3" title="永久链接至标题">¶</a></h2>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>从 CDK 的菜单栏 <code class="docutils literal notranslate"><span class="pre">View->Serial</span> <span class="pre">Pane</span></code>，打开串口面板，在打开的 <code class="docutils literal notranslate"><span class="pre">Serial</span> <span class="pre">Pane</span></code> 中右击，进行串口设置，选择你对应的串口号和波特率</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default">
|
||||||
|
<img alt="../_images/cdk4.png" src="../_images/cdk4.png" />
|
||||||
|
</div>
|
||||||
|
<div class="figure align-default" id="id6">
|
||||||
|
<img alt="" src="../_images/cdk3.png" />
|
||||||
|
<p class="caption"><span class="caption-text">CDK Serial Pane setting</span><a class="headerlink" href="#id6" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>按下板子上的 <code class="docutils literal notranslate"><span class="pre">RST</span></code> 按键，即可在串口中看到代码的运行结果</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id7">
|
||||||
|
<img alt="" src="../_images/cdk6.png" />
|
||||||
|
<p class="caption"><span class="caption-text">HelloWorld！</span><a class="headerlink" href="#id7" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="section" id="id4">
|
||||||
|
<h2>调试 Hello World<a class="headerlink" href="#id4" title="永久链接至标题">¶</a></h2>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>点击工具栏上方的 <code class="docutils literal notranslate"><span class="pre">Start/Stop</span> <span class="pre">Debugger</span></code> 按钮，进入 debug 界面，如下图所示</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="figure align-default" id="id8">
|
||||||
|
<img alt="" src="../_images/cdk10.png" />
|
||||||
|
<p class="caption"><span class="caption-text">Debug HelloWorld！</span><a class="headerlink" href="#id8" title="永久链接至图片">¶</a></p>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>在 debug 界面下，左侧的 <code class="docutils literal notranslate"><span class="pre">Register</span></code> 窗口中，可以查看 <code class="docutils literal notranslate"><span class="pre">CPU</span></code> 内部寄存器数据；右侧的 <code class="docutils literal notranslate"><span class="pre">Peripherals</span></code> 外设面板中，
|
||||||
|
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 <code class="docutils literal notranslate"><span class="pre">Peripherals->System</span> <span class="pre">Viewer</span></code> 选择；
|
||||||
|
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
||||||
|
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 <code class="docutils literal notranslate"><span class="pre">CDK</span> <span class="pre">Help</span></code>，这里就不作过多介绍了。</p></li>
|
||||||
|
<li><p>我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 <code class="docutils literal notranslate"><span class="pre">Hello</span> <span class="pre">World！</span></code></p></li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
<footer>
|
||||||
|
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
||||||
|
<a href="cdk_ck_link.html" class="btn btn-neutral float-right" title="使用 CDK + CK-Link 编译调试" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
||||||
|
<a href="Windows_quick_start_cdk.html" class="btn btn-neutral float-left" title="2.1. Windows 下使用 CDK (类 MDK Keil)开发指南" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<hr/>
|
||||||
|
|
||||||
|
<div role="contentinfo">
|
||||||
|
<p>
|
||||||
|
© 版权所有 2021, BouffaloLab Co., Ltd.
|
||||||
|
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
|
||||||
|
|
||||||
|
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
|
||||||
|
|
||||||
|
provided by <a href="https://readthedocs.org">Read the Docs</a>.
|
||||||
|
|
||||||
|
</footer>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
<script type="text/javascript">
|
||||||
|
jQuery(function () {
|
||||||
|
SphinxRtdTheme.Navigation.enable(true);
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@ -258,10 +258,14 @@
|
|||||||
<p><strong>Windows</strong></p>
|
<p><strong>Windows</strong></p>
|
||||||
<ul>
|
<ul>
|
||||||
<li><p>Sipeed RV-Debugger Plus 调试器在 Windows 系统中所以时我们需要将驱动更换为 <code class="docutils literal notranslate"><span class="pre">Win</span> <span class="pre">USB</span></code> 驱动</p>
|
<li><p>Sipeed RV-Debugger Plus 调试器在 Windows 系统中所以时我们需要将驱动更换为 <code class="docutils literal notranslate"><span class="pre">Win</span> <span class="pre">USB</span></code> 驱动</p>
|
||||||
<ul class="simple">
|
<ul>
|
||||||
<li><ol class="arabic simple">
|
<li><ol class="arabic simple">
|
||||||
<li><p>首先，将调试器 Type-C USB 接口使用 USB 数据线连接到 PC 主机，打开 PC 的设备管理器，在端口一栏可以看到调试器被识别为两个串口（<em>注：不是开发板上的串口</em>），或者在 <code class="docutils literal notranslate"><span class="pre">通用串行总线控制器</span></code> 看到 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">A</span></code> 和 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">B</span></code></p></li>
|
<li><p>首先，将调试器 Type-C USB 接口使用 USB 数据线连接到 PC 主机，打开 PC 的设备管理器，在端口一栏可以看到调试器被识别为两个串口（<em>注：不是开发板上的串口</em>），或者在 <code class="docutils literal notranslate"><span class="pre">通用串行总线控制器</span></code> 看到 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">A</span></code> 和 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">B</span></code></p></li>
|
||||||
</ol>
|
</ol>
|
||||||
|
<div class="admonition important">
|
||||||
|
<p class="admonition-title">重要</p>
|
||||||
|
<p><strong>注意:</strong> 若在设备管理器中看到的串口名称为 “<code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">串行设备(COM*)</span></code>”，说明调试器进入了 <code class="docutils literal notranslate"><span class="pre">Boot</span></code> 模式。请将调试器断电重新上电，注意先不要将调试器连接到目标板；此时在到设备管理器中看是否正常</p>
|
||||||
|
</div>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
<div class="figure align-default">
|
<div class="figure align-default">
|
||||||
@ -317,6 +321,12 @@
|
|||||||
<li><p>在设备管理器中没有看到任何串口，但是在``通用串行总线控制器``中看到 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">A</span></code> 和 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">B</span></code>；遇到这种情况，请到 <a class="reference external" href="https://ftdichip.com/drivers/vcp-drivers/">FTDI 官网</a> 下载与系统匹配的驱动，将 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">B</span></code> 重新安装为串口；<code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">A</span></code> 也即 Interface 0，使用 <code class="docutils literal notranslate"><span class="pre">zadig-2.4.exe</span></code> 替换为 WinUSB 驱动。</p></li>
|
<li><p>在设备管理器中没有看到任何串口，但是在``通用串行总线控制器``中看到 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">A</span></code> 和 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">B</span></code>；遇到这种情况，请到 <a class="reference external" href="https://ftdichip.com/drivers/vcp-drivers/">FTDI 官网</a> 下载与系统匹配的驱动，将 <code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">B</span></code> 重新安装为串口；<code class="docutils literal notranslate"><span class="pre">USB</span> <span class="pre">Serial</span> <span class="pre">Converter</span> <span class="pre">A</span></code> 也即 Interface 0，使用 <code class="docutils literal notranslate"><span class="pre">zadig-2.4.exe</span></code> 替换为 WinUSB 驱动。</p></li>
|
||||||
</ol>
|
</ol>
|
||||||
</div>
|
</div>
|
||||||
|
<div class="admonition caution">
|
||||||
|
<p class="admonition-title">警告</p>
|
||||||
|
<ol class="arabic simple" start="3">
|
||||||
|
<li><p>如果经过上面的操作还是不能正常使用，没有出现正确的现象，那么建议从 Sipeed 官方 <a class="reference external" href="https://github.com/sipeed/RV-Debugger-BL702">GitHub</a> 仓库获取固件，重新烧写；按住调试器上的 <code class="docutils literal notranslate"><span class="pre">Boot</span></code> 键不要释放，将调试器插入电脑上电，使调试器进入 Boot 模式，重新刷入固件后；断电重启</p></li>
|
||||||
|
</ol>
|
||||||
|
</div>
|
||||||
<p><strong>Linux</strong></p>
|
<p><strong>Linux</strong></p>
|
||||||
<ul class="simple">
|
<ul class="simple">
|
||||||
<li><p>安装 Openocd 及其需要的依赖项</p></li>
|
<li><p>安装 Openocd 及其需要的依赖项</p></li>
|
||||||
|
|||||||
Binary file not shown.
File diff suppressed because one or more lines are too long
@ -54,186 +54,16 @@ Windows 下使用 CDK (类 MDK Keil)开发指南
|
|||||||
|
|
||||||
**使用 Sipeed RV-Debugger Plus 调试工程时请按照下面的步骤进行：**
|
**使用 Sipeed RV-Debugger Plus 调试工程时请按照下面的步骤进行：**
|
||||||
|
|
||||||
打开 Hello World
|
.. toctree::
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
:maxdepth: 1
|
||||||
|
|
||||||
- 获取到 SDK 后，进入 sdk 中的 ``examples/hellowd/helloworld/cdk`` 目录下，双击 ``helloworld.cdkproj``，即可打开 ``Helloworld`` 工程
|
|
||||||
|
|
||||||
编译 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
.. figure:: img/cdk1.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
helloworld.cdkproj
|
|
||||||
|
|
||||||
- 在活动工程下拉菜单选择 ``OpenOCD_Debug`` 工程，由于 Sipeed RV-Debugger Plus 是使用 OpenOCD 调试的，所以本教程基于 ``OpenOCD_Debug`` 工程；
|
|
||||||
- 如 Sipeed RV-Debugger Plus 没有正确安装驱动，请参考 :ref:`sipeed_rv_debugger_plus` 部分，设置好驱动程序，在进行下面的步骤
|
|
||||||
|
|
||||||
- 在 CDK 工具栏中，点击编译图标即可编译工程
|
|
||||||
|
|
||||||
- 点击 ``1`` 处 图标 ``Build Project`` 即可编译当前选中的工程
|
|
||||||
- 点击 ``2`` 处 图标 ``Clean Project`` 即可清除上次编译的结果
|
|
||||||
- 点击 ``3`` 处 图标 ``Flash Download`` 即可将编译好的代码下载到芯片中 （**使用 OpenOCD Debug 不能使用 Flash 下载功能**）
|
|
||||||
- 点击 ``4`` 处 图标 ``Start/Stop Debug`` 即可进行 debug 的相关操作
|
|
||||||
- 也可以在 ``Project`` 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作
|
|
||||||
|
|
||||||
|
|
||||||
烧写 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 在 CDK 中使用 OpenOCD 模式的调试方式时，暂不支持直接使用 CDK 相关 flash 工具下载代码，所以请使用 BL Dev Cube 工具进行程序烧写，烧写代码请参考 :ref:`bl_dev_cube` 部分进行
|
|
||||||
- 代码烧写完成后使用 CDK 进行 Debug
|
|
||||||
|
|
||||||
运行 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 从 CDK 的菜单栏 ``View->Serial Pane``，打开串口面板，在打开的 ``Serial Pane`` 中右击，进行串口设置，选择你对应的串口号和波特率
|
|
||||||
|
|
||||||
.. figure:: img/cdk4.png
|
|
||||||
.. figure:: img/cdk3.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Serial Pane setting
|
|
||||||
|
|
||||||
- 按下板子上的 ``RST`` 按键，即可在串口中看到代码的运行结果
|
|
||||||
|
|
||||||
.. figure:: img/cdk6.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
HelloWorld！
|
|
||||||
|
|
||||||
|
|
||||||
调试 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 点击工具栏上方的 ``Start/Stop Debugger`` 按钮，进入 debug 界面，如下图所示
|
|
||||||
|
|
||||||
.. figure:: img/cdk10.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
Debug HelloWorld！
|
|
||||||
|
|
||||||
- 在 debug 界面下，左侧的 ``Register`` 窗口中，可以查看 ``CPU`` 内部寄存器数据；右侧的 ``Peripherals`` 外设面板中，
|
|
||||||
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 ``Peripherals->System Viewer`` 选择；
|
|
||||||
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
|
||||||
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 ``CDK Help``，这里就不作过多介绍了。
|
|
||||||
|
|
||||||
- 我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 ``Hello World！``
|
|
||||||
|
|
||||||
|
使用 Sipeed RV-Debugger <cdk_rv_debugger_plus>
|
||||||
|
|
||||||
**使用 CK-Link 调试工程时请按照下面的步骤进行：**
|
**使用 CK-Link 调试工程时请按照下面的步骤进行：**
|
||||||
|
|
||||||
打开 Hello World
|
.. toctree::
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
:maxdepth: 1
|
||||||
|
|
||||||
- 获取到 SDK 后，进入 sdk 中的 ``examples/hellowd/helloworld/cdk`` 目录下，双击 ``helloworld.cdkproj``，即可打开 ``Helloworld`` 工程
|
|
||||||
|
|
||||||
编译 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
.. figure:: img/cdk1.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
helloworld.cdkproj
|
|
||||||
|
|
||||||
- 在活动工程下拉菜单可以选择 ``CK_Link_Debug`` 或者 ``OpenOCD_Debug`` 工程，本教程基于 ``CK_Link_Debug`` 工程
|
|
||||||
|
|
||||||
- 在 CDK 工具栏中，点击编译图标即可编译工程
|
|
||||||
|
|
||||||
- 点击 ``1`` 处 图标 ``Build Project`` 即可编译当前选中的工程
|
|
||||||
- 点击 ``2`` 处 图标 ``Clean Project`` 即可清除上次编译的结果
|
|
||||||
- 点击 ``3`` 处 图标 ``Flash Download`` 即可将编译好的代码下载到芯片中
|
|
||||||
- 点击 ``4`` 处 图标 ``Start/Stop Debug`` 即可进行 debug 的相关操作
|
|
||||||
- 也可以在 ``Project`` 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作
|
|
||||||
|
|
||||||
|
|
||||||
烧写 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 由于目前 CDK 软件中还没有包含我们的 flash 算法，所以需要我们手动将 flash 算法放到 CDK 安装目录，具体操作如下：
|
|
||||||
|
|
||||||
- 进入 SDK 目录下 ``tools\cdk_flashloader`` 目录
|
|
||||||
- 将目录下的 ``bl70x_flasher.elf`` 文件，拷贝到 CDK 工具的 ``C-Sky\CDK\CSKY\Flash`` 目录中
|
|
||||||
|
|
||||||
.. figure:: img/cdk7.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Flash Loader
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
.. figure:: img/cdk8.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Project Setting
|
|
||||||
|
|
||||||
- 点击 ``Project View`` 中的项目设置按钮，打开 ``Project Setting`` 窗口，或者通过右击 ``Project`` 名称中右击菜单栏中打开
|
|
||||||
|
|
||||||
- 在打开的 ``Project Setting`` 窗口中，选择 ``Flash`` 标签，配置需要的 Flash 算法
|
|
||||||
|
|
||||||
.. figure:: img/cdk9.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Project Flash setting
|
|
||||||
|
|
||||||
- 在 ``Flash`` 标签中，点击 ``Add`` 按纽，在打开的列表中选择 ``bl70x_flash`` 算法，点击 ``Add`` 添加到工程中，``Flash`` 标签下的其他设置，如图所示：
|
|
||||||
|
|
||||||
- 点击 OK 后，如配置正确，点击 ``Flash Download`` 即可将编译好的代码下载到芯片中
|
|
||||||
|
|
||||||
|
|
||||||
.. figure:: img/cdk5.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Flashdownload Success
|
|
||||||
|
|
||||||
- 如下载失败请检查：
|
|
||||||
|
|
||||||
- 1. 代码是否被正确编译，并生成 ``.elf`` ``.bin`` 等文件
|
|
||||||
- 2. Flash 算法是否被正确设置
|
|
||||||
- 3. CK-Link 与开发板是否正确连接
|
|
||||||
- 4. 开发板是否正常供电，电源指示灯是否点亮
|
|
||||||
|
|
||||||
运行 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 从 CDK 的菜单栏 ``View->Serial Pane``，打开串口面板，在打开的 ``Serial Pane`` 中右击，进行串口设置，选择你对应的串口号和波特率
|
|
||||||
|
|
||||||
.. figure:: img/cdk4.png
|
|
||||||
.. figure:: img/cdk3.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
CDK Serial Pane setting
|
|
||||||
|
|
||||||
- 按下板子上的 ``RST`` 按键，即可在串口中看到代码的运行结果
|
|
||||||
|
|
||||||
.. figure:: img/cdk6.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
HelloWorld！
|
|
||||||
|
|
||||||
|
|
||||||
调试 Hello World
|
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
- 点击工具栏上方的 ``Start/Stop Debugger`` 按钮，进入 debug 界面，如下图所示
|
|
||||||
|
|
||||||
.. figure:: img/cdk10.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
Debug HelloWorld！
|
|
||||||
|
|
||||||
- 在 debug 界面下，左侧的 ``Register`` 窗口中，可以查看 ``CPU`` 内部寄存器数据；右侧的 ``Peripherals`` 外设面板中，
|
|
||||||
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 ``Peripherals->System Viewer`` 选择；
|
|
||||||
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
|
||||||
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 ``CDK Help``，这里就不作过多介绍了。
|
|
||||||
|
|
||||||
- 我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 ``Hello World！``
|
|
||||||
|
|
||||||
.. figure:: img/cdk11.png
|
|
||||||
:alt:
|
|
||||||
|
|
||||||
Debug HelloWorld！
|
|
||||||
|
|
||||||
|
使用 CK-Link <cdk_ck_link>
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
116
docs/development_guide/source/get_started/cdk_ck_link.rst
Normal file
116
docs/development_guide/source/get_started/cdk_ck_link.rst
Normal file
@ -0,0 +1,116 @@
|
|||||||
|
使用 CDK + CK-Link 编译调试
|
||||||
|
=============================
|
||||||
|
|
||||||
|
|
||||||
|
打开 Hello World
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
- 获取到 SDK 后，进入 sdk 中的 ``examples/hellowd/helloworld/cdk`` 目录下，双击 ``helloworld.cdkproj``，即可打开 ``Helloworld`` 工程
|
||||||
|
|
||||||
|
编译 Hello World
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
.. figure:: img/cdk1.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
helloworld.cdkproj
|
||||||
|
|
||||||
|
- 在活动工程下拉菜单可以选择 ``CK_Link_Debug`` 或者 ``OpenOCD_Debug`` 工程，本教程基于 ``CK_Link_Debug`` 工程
|
||||||
|
|
||||||
|
- 在 CDK 工具栏中，点击编译图标即可编译工程
|
||||||
|
|
||||||
|
- 点击 ``1`` 处 图标 ``Build Project`` 即可编译当前选中的工程
|
||||||
|
- 点击 ``2`` 处 图标 ``Clean Project`` 即可清除上次编译的结果
|
||||||
|
- 点击 ``3`` 处 图标 ``Flash Download`` 即可将编译好的代码下载到芯片中
|
||||||
|
- 点击 ``4`` 处 图标 ``Start/Stop Debug`` 即可进行 debug 的相关操作（在使用 ``CK-Link`` 时可以先将代码 load 到 flash 中）
|
||||||
|
- 点击 ``5`` 处 图标 ``Start/Stop Debug whitout Download`` 即可直接进行 debug , 不 load 当前 bin 文件
|
||||||
|
- 也可以在 ``Project`` 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作
|
||||||
|
|
||||||
|
|
||||||
|
烧写 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 由于目前 CDK 软件中还没有包含我们的 flash 算法，所以需要我们手动将 flash 算法放到 CDK 安装目录，具体操作如下：
|
||||||
|
|
||||||
|
- 进入 SDK 目录下 ``tools\cdk_flashloader`` 目录
|
||||||
|
- 将目录下的 ``bl70x_flasher.elf`` 文件，拷贝到 CDK 工具的 ``C-Sky\CDK\CSKY\Flash`` 目录中
|
||||||
|
|
||||||
|
.. figure:: img/cdk7.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Flash Loader
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.. figure:: img/cdk8.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Project Setting
|
||||||
|
|
||||||
|
- 点击 ``Project View`` 中的项目设置按钮，打开 ``Project Setting`` 窗口，或者通过右击 ``Project`` 名称中右击菜单栏中打开
|
||||||
|
|
||||||
|
- 在打开的 ``Project Setting`` 窗口中，选择 ``Flash`` 标签，配置需要的 Flash 算法
|
||||||
|
|
||||||
|
.. figure:: img/cdk9.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Project Flash setting
|
||||||
|
|
||||||
|
- 在 ``Flash`` 标签中，点击 ``Add`` 按纽，在打开的列表中选择 ``bl70x_flash`` 算法，点击 ``Add`` 添加到工程中，``Flash`` 标签下的其他设置，如图所示：
|
||||||
|
|
||||||
|
- 点击 OK 后，如配置正确，点击 ``Flash Download`` 即可将编译好的代码下载到芯片中
|
||||||
|
|
||||||
|
|
||||||
|
.. figure:: img/cdk5.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Flashdownload Success
|
||||||
|
|
||||||
|
- 如下载失败请检查：
|
||||||
|
|
||||||
|
- 1. 代码是否被正确编译，并生成 ``.elf`` ``.bin`` 等文件
|
||||||
|
- 2. Flash 算法是否被正确设置
|
||||||
|
- 3. CK-Link 与开发板是否正确连接
|
||||||
|
- 4. 开发板是否正常供电，电源指示灯是否点亮
|
||||||
|
|
||||||
|
运行 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 从 CDK 的菜单栏 ``View->Serial Pane``，打开串口面板，在打开的 ``Serial Pane`` 中右击，进行串口设置，选择你对应的串口号和波特率
|
||||||
|
|
||||||
|
.. figure:: img/cdk4.png
|
||||||
|
.. figure:: img/cdk3.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Serial Pane setting
|
||||||
|
|
||||||
|
- 按下板子上的 ``RST`` 按键，即可在串口中看到代码的运行结果
|
||||||
|
|
||||||
|
.. figure:: img/cdk6.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
HelloWorld！
|
||||||
|
|
||||||
|
|
||||||
|
调试 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 点击工具栏上方的 ``Start/Stop Debugger`` 按钮，进入 debug 界面，如下图所示
|
||||||
|
|
||||||
|
.. figure:: img/cdk10.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
Debug HelloWorld！
|
||||||
|
|
||||||
|
- 在 debug 界面下，左侧的 ``Register`` 窗口中，可以查看 ``CPU`` 内部寄存器数据；右侧的 ``Peripherals`` 外设面板中，
|
||||||
|
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 ``Peripherals->System Viewer`` 选择；
|
||||||
|
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
||||||
|
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 ``CDK Help``，这里就不作过多介绍了。
|
||||||
|
|
||||||
|
- 我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 ``Hello World！``
|
||||||
|
|
||||||
|
.. figure:: img/cdk11.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
Debug HelloWorld！
|
||||||
|
|
||||||
@ -0,0 +1,70 @@
|
|||||||
|
使用 CDK + Sipeed RV-Debugger Plus 编译调试
|
||||||
|
==============================================
|
||||||
|
|
||||||
|
打开 Hello World
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
- 获取到 SDK 后，进入 sdk 中的 ``examples/hellowd/helloworld/cdk`` 目录下，双击 ``helloworld.cdkproj``，即可打开 ``Helloworld`` 工程
|
||||||
|
|
||||||
|
编译 Hello World
|
||||||
|
------------------------------
|
||||||
|
|
||||||
|
.. figure:: img/cdk1.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
helloworld.cdkproj
|
||||||
|
|
||||||
|
- 在活动工程下拉菜单选择 ``OpenOCD_Debug`` 工程，由于 Sipeed RV-Debugger Plus 是使用 OpenOCD 调试的，所以本教程基于 ``OpenOCD_Debug`` 工程；
|
||||||
|
- 如 Sipeed RV-Debugger Plus 没有正确安装驱动，请参考 :ref:`sipeed_rv_debugger_plus` 部分，设置好驱动程序，在进行下面的步骤
|
||||||
|
|
||||||
|
- 在 CDK 工具栏中，点击编译图标即可编译工程
|
||||||
|
|
||||||
|
- 点击 ``1`` 处 图标 ``Build Project`` 即可编译当前选中的工程
|
||||||
|
- 点击 ``2`` 处 图标 ``Clean Project`` 即可清除上次编译的结果
|
||||||
|
- 点击 ``3`` 处 图标 ``Flash Download`` 即可将编译好的代码下载到芯片中 （**使用 OpenOCD Debug 不能使用 Flash 下载功能**）
|
||||||
|
- 点击 ``5`` 处 图标 ``Start/Stop Debug whitout Download`` 即可直接进行 debug , 不 load 当前 bin 文件
|
||||||
|
- 也可以在 ``Project`` 中，右击工程名称，通过右击菜单中的选项对项目进行编译等操作
|
||||||
|
|
||||||
|
|
||||||
|
烧写 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 在 CDK 中使用 OpenOCD 模式的调试方式时，暂不支持直接使用 CDK 相关 ``flash`` 工具下载代码，所以请使用 BL Dev Cube 工具进行程序烧写，烧写代码请参考 :ref:`bl_dev_cube` 部分进行
|
||||||
|
- 代码烧写完成后使用 CDK 进行 Debug
|
||||||
|
|
||||||
|
运行 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 从 CDK 的菜单栏 ``View->Serial Pane``，打开串口面板，在打开的 ``Serial Pane`` 中右击，进行串口设置，选择你对应的串口号和波特率
|
||||||
|
|
||||||
|
.. figure:: img/cdk4.png
|
||||||
|
.. figure:: img/cdk3.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
CDK Serial Pane setting
|
||||||
|
|
||||||
|
- 按下板子上的 ``RST`` 按键，即可在串口中看到代码的运行结果
|
||||||
|
|
||||||
|
.. figure:: img/cdk6.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
HelloWorld！
|
||||||
|
|
||||||
|
|
||||||
|
调试 Hello World
|
||||||
|
----------------------------
|
||||||
|
|
||||||
|
- 点击工具栏上方的 ``Start/Stop Debugger`` 按钮，进入 debug 界面，如下图所示
|
||||||
|
|
||||||
|
.. figure:: img/cdk10.png
|
||||||
|
:alt:
|
||||||
|
|
||||||
|
Debug HelloWorld！
|
||||||
|
|
||||||
|
- 在 debug 界面下，左侧的 ``Register`` 窗口中，可以查看 ``CPU`` 内部寄存器数据；右侧的 ``Peripherals`` 外设面板中，
|
||||||
|
可以查看相应外设寄存器数据，外设的选择可以在顶部菜单栏的 ``Peripherals->System Viewer`` 选择；
|
||||||
|
点击上方工具栏中的相关调试按钮可以进行断点设置、单步调试、指令单步和全速运行等操作。
|
||||||
|
当然这些操作都有相应的快捷键和快捷设置方法，详情请参考 ``CDK Help``，这里就不作过多介绍了。
|
||||||
|
|
||||||
|
- 我们点击单步运行按钮，运行代码，即可看到指示光标移动到下一句代码，同时可以看到串口面板中显示了我们输出的 ``Hello World！``
|
||||||
|
|
||||||
@ -60,6 +60,8 @@ BL706_AVB 开发板如下图所示
|
|||||||
|
|
||||||
- 1. 首先，将调试器 Type-C USB 接口使用 USB 数据线连接到 PC 主机，打开 PC 的设备管理器，在端口一栏可以看到调试器被识别为两个串口（*注：不是开发板上的串口*），或者在 ``通用串行总线控制器`` 看到 ``USB Serial Converter A`` 和 ``USB Serial Converter B``
|
- 1. 首先，将调试器 Type-C USB 接口使用 USB 数据线连接到 PC 主机，打开 PC 的设备管理器，在端口一栏可以看到调试器被识别为两个串口（*注：不是开发板上的串口*），或者在 ``通用串行总线控制器`` 看到 ``USB Serial Converter A`` 和 ``USB Serial Converter B``
|
||||||
|
|
||||||
|
.. important:: **注意:** 若在设备管理器中看到的串口名称为 “``USB 串行设备(COM*)``”，说明调试器进入了 ``Boot`` 模式。请将调试器断电重新上电，注意先不要将调试器连接到目标板；此时在到设备管理器中看是否正常
|
||||||
|
|
||||||
.. figure:: img/sipeed_rv_debugger_1.png
|
.. figure:: img/sipeed_rv_debugger_1.png
|
||||||
|
|
||||||
.. figure:: img/sipeed_rv_debugger_4.png
|
.. figure:: img/sipeed_rv_debugger_4.png
|
||||||
@ -83,6 +85,8 @@ BL706_AVB 开发板如下图所示
|
|||||||
|
|
||||||
.. caution:: 2. 在设备管理器中没有看到任何串口，但是在``通用串行总线控制器``中看到 ``USB Serial Converter A`` 和 ``USB Serial Converter B``；遇到这种情况，请到 `FTDI 官网 <https://ftdichip.com/drivers/vcp-drivers/>`_ 下载与系统匹配的驱动，将 ``USB Serial Converter B`` 重新安装为串口；``USB Serial Converter A`` 也即 Interface 0，使用 ``zadig-2.4.exe`` 替换为 WinUSB 驱动。
|
.. caution:: 2. 在设备管理器中没有看到任何串口，但是在``通用串行总线控制器``中看到 ``USB Serial Converter A`` 和 ``USB Serial Converter B``；遇到这种情况，请到 `FTDI 官网 <https://ftdichip.com/drivers/vcp-drivers/>`_ 下载与系统匹配的驱动，将 ``USB Serial Converter B`` 重新安装为串口；``USB Serial Converter A`` 也即 Interface 0，使用 ``zadig-2.4.exe`` 替换为 WinUSB 驱动。
|
||||||
|
|
||||||
|
.. caution:: 3. 如果经过上面的操作还是不能正常使用，没有出现正确的现象，那么建议从 Sipeed 官方 `GitHub <https://github.com/sipeed/RV-Debugger-BL702>`_ 仓库获取固件，重新烧写；按住调试器上的 ``Boot`` 键不要释放，将调试器插入电脑上电，使调试器进入 Boot 模式，重新刷入固件后；断电重启
|
||||||
|
|
||||||
**Linux**
|
**Linux**
|
||||||
|
|
||||||
- 安装 Openocd 及其需要的依赖项
|
- 安装 Openocd 及其需要的依赖项
|
||||||
|
|||||||
Binary file not shown.
|
Before Width: | Height: | Size: 86 KiB After Width: | Height: | Size: 84 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 3.2 KiB |
@ -16,7 +16,7 @@ BL MCU SDK 将为您提供博流 BL70X 系列 MCU 开发的全方位支持。
|
|||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
:caption: 快速开发指南
|
:caption: 快速开发指南
|
||||||
:numbered:
|
:numbered: 3
|
||||||
|
|
||||||
get_started/get_started
|
get_started/get_started
|
||||||
get_started/index
|
get_started/index
|
||||||
|
|||||||
Reference in New Issue
Block a user