DAPLink开发人员指南

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

设定

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

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

• 安装 Python 2, 2.7.11 or above . 添加到PATH.
• 安装 Git . 添加到PATH.
• 安装 Keil MDK-ARM, 最好是MDK5.
  如果不是安装到默认位置，则需将环境变量“UV4”设置为UV4的可执行文件的绝对路径。注意，“ UV4”用于MDK版本4和5。如果您计划使用mbed cli，则可以跳过此步骤，但是您仍然需要安装Arm Compiler 5，并且通过MDK进行调试。
• 在全局Python安装中安装virtualenv，例如: pip install virtualenv.

步骤 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 ....