ROS技术空间

DAPLink开发人员使用指南

DAPLink开发人员指南

注意:该文件可能不是最新版本,最近更新日期2020-05-24

设定

可以使用Keil MDK-ARM或具有arm编译器的mbed cli工具来编译DAPLink源,它们可以在Linux和Windows上运行。

安装下面列出的必要使用的工具。如已安装则可跳过。

步骤 1. 初步设置.

获取源并创建虚拟环境

$ git clone https://github.com/mbedmicro/DAPLink
$ cd DAPLink
$ pip install virtualenv
$ virtualenv venv

步骤 2. 设置mbed-cli.

如果您打算使用mbed-cli方法构建,则仅需要执行此步骤一次。

首先运行下面的步骤3以激活虚拟环境之后再执行这些命令。

$ mbed deploy
$ mbed config root .
$ mbed config ARM_PATH <FULL_PATH_TO_ARMCC_FOLDER>

激活虚拟环境

步骤 3. 激活虚拟环境并更新需求。当您打开新的外壳时,这是必需的. 每次您进行更新时都需要做一次
注意下面指令需区分windows还是Linux

$ venv/Scripts/activate   (For Linux)
$ venv\Scripts\activate.bat   (For Windows)
$ pip install -r requirements.txt

编译

该指令每次您进行更新时都需要运行一次

现在你有两种构建DAPLink的方法。您可以生成Keil MDK项目文件并在MDK中构建。MDK还用于调试接口芯片上运行的DAPLink。或者,您可以使用mbedcli_compile.py脚本从命令行构建项目,而无需MDK。

步骤 4.1. 用于MDK后编译。

此命令将会在projectfiles/uvision目录下生成MDK项目文件。

$ progen generate -t uvision

如果只要生成一个特定项目,请使用如下命令:

progen generate -f projects.yaml -p stm32f103xb_stm32f746zg_if -t uvision

这些是 progen 设置参数:
-f 用于输入项目文件
-p 项目名称
-t 指定IDE名称

步骤 4.2. 对于mbed-CLI项目编译

此命令将构建所有项目:

$ tools/mbedcli_compile.py

要仅构建项目的子集,请在命令行末尾添加项目名称。有效的项目名称在使用方法文字中列出,并带有 --help. 每次PULL之后第一次构建时,都应添加 --clean 以执行完整的重新构建.

MDK

如果要使用MDK(uVision)IDE来处理DAPLink代码,则必须在正确的环境中启动它。否则该项目将无法构建。要正确启动uVision,请使用 tools/launch_uvision.bat

该脚本可以使用参数来覆盖要安装的默认虚拟环境和python软件包。例如 tools/launch_uvision.bat other_env other_requirements.txt

注意:需要使用此脚本启动MDK后才能在MDK编译成功

测试

DAPLink使用Python编写一套广泛的自动化测试功能,它可用于回归测试,您也可以使用它们来验证DAPLink端口。 详细信息 点此

可在uvision和mbedcli的构建文件夹中搜索daplink固件构建的选项。
python test/run_test.py --projecttool mbedcli ... or python test/run_test.py --projecttool uvision ....