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